3D Lingo Dictionary > A-B > blendSource

 

blendSource

Syntax

member(whichCastmember).shader(whichShader).blendSource
member(whichCastmember).model(whichModel).shader.blendSource
member(whichCastmember).model(whichModel).shaderList{[index]}.blendSource

Description

3D #standard shader property; indicates whether blending of the first texture layer in the shader's texture list is based on the texture's alpha information or a constant ratio.

If the shader's useDiffuseWithTexture property is set to TRUE, the texture blends with the color set by the shader's diffuse property. If useDiffuseWithTexture is FALSE, white is used for blending.

Each of the other texture layers blends with the texture layer below it. Use the blendSourceList property to control blending in those texture layers.

The blendSource property only works when the shader's blendFunction property is set to #blend. See blendFunction and blendFunctionList for more information.

The possible values of this property are as follows:

#alpha causes the alpha information in the texture to determine the blend ratio of each pixel of the texture with the color being used for blending (see above).

#constant causes the value of the shader's blendConstant property to be used as the blend ratio for all of the pixels of the texture. See blendConstant and blendConstantList for more information.

The default value of this property is #constant.

Example

In this example, the shader list of the model named MysteryBox contains six shaders. This statement sets the blendSource property of the first texture used by the second shader to #constant. This enables the settings of the blendConstant and blendConstantList properties.

member("Level2").model("MysteryBox").shaderList[2].blendSource = #constant

See also

blendSourceList, blendFunction, blendFunctionList, blendConstant, blendConstantList, useDiffuseWithTexture, diffuse, diffuseColor