3D Lingo Dictionary > A-B > blendSourceList

 

blendSourceList

Syntax

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

Description

3D #standard shader property; indicates whether blending of a texture layer with the texture layers below it is based on the texture's alpha information or a constant ratio.

The shader's texture list and the blend source list both have eight index positions. Each index position in the blend source list controls blending for the texture at the corresponding index position in the texture list. You can set all index positions of the list to the same value at one time by not specifying the optional index parameter. Use the index parameter to set the list one index position at a time.

The blendSourceList property only works when the blendFunction property of the corresponding texture layer 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 layer with the layer below it.

#constant causes the value of the blendConstant property of the corresponding texture layer to be used as the blend ratio for all of the pixels of the texture layer. 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 MysteryBox contains six shaders. Each shader has a texture list that contains up to eight textures. This statement shows that the blendSource property of the fourth texture used by the second shader is set to #constant. This enables the settings of the blendConstant, blendConstantList, and useDiffuseWithTexture properties.

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

See also

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