SoBlendMode

InventorModule

genre	Shader
author	MeVis Medical Solutions AG
package	MeVisLab/Standard
dll	SoShader
definition	SoShader.def

Purpose

The SoBlendMode allows for overriding the OpenGL blending function. It provides useful defaults but also offers all GL blending functionality using the custom blend modes.

Parameter Fields

Field Index

Alpha Blend Function Dst: Enum	Enabled: Bool
Alpha Blend Function Src: Enum
Blend Equation: Enum
Blend Function Dst: Enum
Blend Function Src: Enum
Blend Mode: Enum
Constant Blend Alpha: Float
Constant Blend Color: Color

Visible Fields

Enabled

name: enabled, type: Bool, default: FALSE

If checked, the module is enabled.

Blend Mode

name: blendMode, type: Enum, default: BLEND_BLEND

Defines the blend mode.

Values:

Title	Name	Description
Off	BLEND_OFF	Turns blending off.
Replace	BLEND_REPLACE	Replaces the target value.
Add	BLEND_ADD	Adds the source to the destination.
Blend	BLEND_BLEND	Blends back-to-front.
Premultiplied Blend	BLEND_PREMULTIPLIED_BLEND	Blend back-to-front. Source color is expected to have premultiplied alpha.
Min	BLEND_MIN	Min blending (for each component separately).
Max	BLEND_MAX	Max blending (for each component separately).
Custom	BLEND_CUSTOM	Custom blend mode, see equation and functions.
Custom Separate	BLEND_CUSTOM_SEPARATE	Custom blend mode with separate alpha settings, see equation and functions.
Screen	BLEND_SCREEN

Blend Equation

name: blendEquation, type: Enum, default: ADD

Defines the custom blend equation.

Values:

Title	Name
Add	ADD
Subtract	SUBTRACT
Reverse Subtract	REVERSE_SUBTRACT

Blend Function Src

name: blendFunctionSrc, type: Enum, default: SRC_ALPHA

Defines the source function.

Values:

Title	Name
Zero	ZERO
One	ONE
Src Color	SRC_COLOR
One Minus Src Color	ONE_MINUS_SRC_COLOR
Dst Color	DST_COLOR
One Minus Dst Color	ONE_MINUS_DST_COLOR
Src Alpha	SRC_ALPHA
One Minus Src Alpha	ONE_MINUS_SRC_ALPHA
Dst Alpha	DST_ALPHA
One Minus Dst Alpha	ONE_MINUS_DST_ALPHA
Constant Color	CONSTANT_COLOR
One Minus Constant Color	ONE_MINUS_CONSTANT_COLOR
Constant Alpha	CONSTANT_ALPHA
One Minus Constant Alpha	ONE_MINUS_CONSTANT_ALPHA
Src Alpha Saturate	SRC_ALPHA_SATURATE

Blend Function Dst

name: blendFunctionDst, type: Enum, default: ONE_MINUS_SRC_ALPHA

Defines the destination function.

Values:

Title	Name
Zero	ZERO
One	ONE
Src Color	SRC_COLOR
One Minus Src Color	ONE_MINUS_SRC_COLOR
Dst Color	DST_COLOR
One Minus Dst Color	ONE_MINUS_DST_COLOR
Src Alpha	SRC_ALPHA
One Minus Src Alpha	ONE_MINUS_SRC_ALPHA
Dst Alpha	DST_ALPHA
One Minus Dst Alpha	ONE_MINUS_DST_ALPHA
Constant Color	CONSTANT_COLOR
One Minus Constant Color	ONE_MINUS_CONSTANT_COLOR
Constant Alpha	CONSTANT_ALPHA
One Minus Constant Alpha	ONE_MINUS_CONSTANT_ALPHA
Src Alpha Saturate	SRC_ALPHA_SATURATE

Alpha Blend Function Src

name: alphaBlendFunctionSrc, type: Enum, default: SRC_ALPHA

Defines the alpha source function.

Values:

Title	Name
Zero	ZERO
One	ONE
Src Color	SRC_COLOR
One Minus Src Color	ONE_MINUS_SRC_COLOR
Dst Color	DST_COLOR
One Minus Dst Color	ONE_MINUS_DST_COLOR
Src Alpha	SRC_ALPHA
One Minus Src Alpha	ONE_MINUS_SRC_ALPHA
Dst Alpha	DST_ALPHA
One Minus Dst Alpha	ONE_MINUS_DST_ALPHA
Constant Color	CONSTANT_COLOR
One Minus Constant Color	ONE_MINUS_CONSTANT_COLOR
Constant Alpha	CONSTANT_ALPHA
One Minus Constant Alpha	ONE_MINUS_CONSTANT_ALPHA
Src Alpha Saturate	SRC_ALPHA_SATURATE

Alpha Blend Function Dst

name: alphaBlendFunctionDst, type: Enum, default: ONE_MINUS_SRC_ALPHA

Defines the alpha destination function.

Values:

Title	Name
Zero	ZERO
One	ONE
Src Color	SRC_COLOR
One Minus Src Color	ONE_MINUS_SRC_COLOR
Dst Color	DST_COLOR
One Minus Dst Color	ONE_MINUS_DST_COLOR
Src Alpha	SRC_ALPHA
One Minus Src Alpha	ONE_MINUS_SRC_ALPHA
Dst Alpha	DST_ALPHA
One Minus Dst Alpha	ONE_MINUS_DST_ALPHA
Constant Color	CONSTANT_COLOR
One Minus Constant Color	ONE_MINUS_CONSTANT_COLOR
Constant Alpha	CONSTANT_ALPHA
One Minus Constant Alpha	ONE_MINUS_CONSTANT_ALPHA
Src Alpha Saturate	SRC_ALPHA_SATURATE

Constant Blend Color

name: constantBlendColor, type: Color, default: 1 1 1

Sets the constant blend color.

Constant Blend Alpha

name: constantBlendAlpha, type: Float, default: 1

Sets the constant blend alpha.