SoGLRenderState

InventorModule
genre Shader
author MeVis Medical Solutions AG
package MeVisLab/Standard
dll SoShader
definition SoShader.def
keywords vertex, fragment, geometry, shader

Purpose

The low-level module SoGLRenderState allows for manually changing the OpenGL state in the Open Inventor scene. Use it only if you understand the implications, as manual changes to the OpenGL state are not recognized by Open Inventor and may lead to unexpected side effects.

This module is somewhat unusual because, by default, all fields are set to the ‘ignored’ state and do not affect the scene.

To enable a field’s functionality, access the field’s context menu and disable Set Open Inventor Ignore Flag.

Output Fields

self

name: self, type: SoNode

Parameter Fields

Field Index

attribSaveMode: Enum Point Sprites: Bool
Blend Mode: Enum Poly Back Mode: Enum
Blending: Bool Poly Front Mode: Enum
Cull Mode: Enum Write Mask Depth: Bool
Depth Enable: Bool  
Depth Function: Enum  
Line Smooth: Bool  
Line Width: Float  

Visible Fields

Cull Mode

name: cullMode, type: Enum, default: BACK

Defines the cull mode.

Values:

Title Name
None NONE
Back BACK
Front FRONT
Front And Back FRONT_AND_BACK

Depth Enable

name: depthEnable, type: Bool, default: TRUE

If checked, the depth buffer is enabled.

Depth Function

name: depthFunction, type: Enum, default: LESS

Defines the depth compare function.

Values:

Title Name
Never NEVER
Less LESS
Equal EQUAL
Less Equal LESS_EQUAL
Greater GREATER
Not Equal NOT_EQUAL
Greater Equal GREATER_EQUAL
Always ALWAYS

Write Mask Depth

name: writeMaskDepth, type: Bool, default: TRUE

If checked, the writing to the depth buffer is enabled.

Poly Front Mode

name: polyFrontMode, type: Enum, default: FILL

Defines the draw style of the front side of polygons.

Values:

Title Name
Points POINTS
Lines LINES
Fill FILL

Poly Back Mode

name: polyBackMode, type: Enum, default: FILL

Defines the draw style of the back side of polygons.

Values:

Title Name
Points POINTS
Lines LINES
Fill FILL

Line Width

name: lineWidth, type: Float, default: 1

Sets the line width.

Line Smooth

name: lineSmooth, type: Bool, default: FALSE

If checked, the use of line smoothing should is enabled.

NOTE: Typically, you should enable Blending as well; otherwise, line smoothing will not function correctly, as it requires alpha blending.

Point Sprites

name: pointSprites, type: Bool, default: FALSE

If checked, the point sprite mode for GL_POINTS is enabled.

Blending

name: blending, type: Bool, default: FALSE

If checked, blending is enabled.

This overrides the blending settings of all following Open Inventor nodes: the blending will not be changed according to the transparency in the colors of shapes anymore.

Blend Mode

name: blendMode, type: Enum, default: BLEND_BLEND

Defines the blend mode that should be used if blending is enabled.

Values:

Title Name
Replace BLEND_REPLACE
Add BLEND_ADD
Blend BLEND_BLEND
Premultiplied Blend BLEND_PREMULTIPLIED_BLEND

Hidden Fields

attribSaveMode

name: attribSaveMode, type: Enum, default: PUSH

Values:

Title Name
Push PUSH
Pop POP