IFXShaderLitTexture

The ShaderLitTexture interface serves as the primary shader for Shockwave 3D§. It supports texture mapping, environment mapping, bump mapping, and light mapping.

When to Use

Used when standard computer graphics shading models are required including texture maps, environment maps, bump maps, and light maps.

Interface Methods

Description

GetChannels

Returns which channels are enabled

SetChannels

Sets the channels

GetAlphaTextureChannels

Gets the alpha texture channel

SetAlphaTextureChannels

Sets the alpha texture channel

GetMaterialID

Gets ID of material in material palette

SetMaterialID

Sets ID of material in material palette

GetTextureID

Gets ID of the texture in the texture palette

SetTextureID

Sets ID of the texture in the texture palette

GetTextureIntensity

Gets texture intensity level

SetTextureIntensity

Sets texture intensity level

GetBlendFunction

Gets texture blend function

SetBlendFunction

Sets texture blend function

GetBlendSource

Gets texture blend source

SetBlendSource

Sets texture blend source

GetBlendConstant

Gets texture blend constant

SetBlendConstant

Sets texture blend constant

GetTextureMode

Gets texture mode

SetTextureMode

Sets texture mode

GetTextureTransform

Gets texture transform

SetTextureTransform

Sets texture transform

GetWrapTransform

Gets texture wrap transform

SetWrapTransform

Sets texture wrap transform

GetTextureRepeat

Queries whether texture repeats

SetTextureRepeat

Indicates whether texture repeats

GetUseDiffuse

Queries whether diffuse is used

SetUseDiffuse

Indicates whether diffuse is used

GetScengraph

Gets scenegraph


IFXShaderLitTexture::GetChannels()

This method gets the channels.

Parameters:

None

Return Values:

U32


IFXShaderLitTexture::SetChannels(U32 uInEnabledFlags)

This method sets the channels.

Parameters:

UInEnabledFlags

Sets a number indicating the flags that are currently enabled

Return Values:

U32


IFXShaderLitTexture::GetAlphaTextureChannels()

This method gets the alpha texture channels.

Parameters:

None

Return Values:

U32


IFXShaderLitTexture::SetAlphaTextureChannels(U32 uInEnabledFlags)

This method sets the alpha texture channels.

Parameters:

UInEnabledFlags

Sets a number indicating the flags that are currently enabled

Return Values:

U32


IFXShaderLitTexture::GetMaterialID()

This method gets the material ID.

Parameters:

None

Return Values:

U32


IFXShaderLitTexture::SetMaterialID(U32 uInMaterialID)

This method sets the material ID.

Parameters:

uInMaterialID

ID of material in material palette to be used by the shader

Return Values


IFXShaderLitTexture::GetTextureID(U32/Channels u/eInLayer, U32* puOutID)

This method gets the texture ID.

Parameters:

uInLayer

Texture Layer ID

puOutID

Pointer to the texture ID in the texture palette to be used by the shader

Return Values


IFXShaderLitTexture::SetTextureID(U32/Channels u/eInLayer, U32 uInID)

This method sets the texture ID.

Parameters:

uInLayer

Texture Layer ID

uInID

Texture ID in the texture palette to be used by the shader

Return Values


IFXShaderLitTexture::GetTextureIntensity(U32/Channels u/eInLayer, F32 *pfOutIntensity)

This method gets the texture intensity level.

Parameters:

uInLayer

Texture Layer ID

pfOutIntensity

Pointer to the texture intensity level amount

Return Values


IFXShaderLitTexture::SetTextureIntensity(U32/Channels u/eInLayer, F32 fInIntensity)

This method sets the texture intensity level.

Parameters:

uInLayer

Texture Layer ID

fInIntensity

Texture intensity level amount

Return Values


IFXShaderLitTexture::GetBlendFunction(U32/Channels u/eInLayer, BlendFunction *peOut)

This method gets the texture blend function.

Parameters:

uInLayer

Texture Layer ID

peOut

Pointer to the texture blend function

Return Values


IFXShaderLitTexture::SetBlendFunction(U32/Channels u/eInLayer, BlendFunction eInFn)

This method sets the texture blend function.

Parameters:

uInLayer

Texture Layer ID

eInFn

Texture blend function

Return Values


IFXShaderLitTexture::GetBlendSource(U32/Channels u/eInLayer, BlendSource *peOut)

This method gets the texture blend source.

Parameters:

uInLayer

Texture Layer ID

peOut

Pointer to the texture source

Return Values


IFXShaderLitTexture::SetBlendSource(U32/Channels u/eInLayer, BlendSource eIn)

This method sets the texture blend source.

Parameters:

uInLayer

Texture Layer ID

eIn

Texture blend source

Return Values


IFXShaderLitTexture::GetBlendConstant(U32/Channels u/eInLayer, F32 *pfOutConstant)

This method gets the texture blend constant.

Parameters:

uInLayer

Texture Layer ID

peOut

Pointer to the texture blend constant

Return Values


IFXShaderLitTexture::SetBlendConstant(U32/Channels u/eInLayer, F32 fInConstant)

This method sets the texture blend constant.

Parameters:

uInLayer

Texture Layer ID

fInConstant

Texture blend constant

Return Values


IFXShaderLitTexture::GetTextureMode(U32/Channels u/eInLayer, TextureMode *peOut)

This method gets the texture mode.

Parameters:

uInLayer

Texture Layer ID

peOut

Pointer to the texture mode

Return Values


IFXShaderLitTexture::SetTextureMode(U32/Channels u/eInLayer, TextureMode eInMode)

This method sets the texture blend source.

Parameters:

uInLayer

Texture Layer ID

eInMode

Texture blend source

Return Values


IFXShaderLitTexture::GetTextureTransform(U32/Channels u/eInLayer, IFXMatrix4x4** ppmOutTextureTransform)

This method gets the texture transform.

Parameters:

uInLayer

Texture Layer ID

ppmOUtTextureTransform

Pointer to the texture transform

Return Values


IFXShaderLitTexture::SetTextureTransform(U32/Channels u/eInLayer, IFXMatrix4x4 pmInTextureTransform)

This method sets the texture transform.

Parameters:

uInLayer

Texture Layer ID

pmInTextureTransform

Texture transform

Return Values


IFXShaderLitTexture::GetWrapTransform(U32/Channels u/eInLayer, IFXMatrix4x4** ppmOutWrapTransform)

This method gets the texture wrap transform.

Parameters:

uInLayer

Texture Layer ID

ppmOutWrapTransform

Pointer to the texture wrap transform

Return Values


IFXShaderLitTexture::SetWrapTransform(U32/Channels u/eInLayer, IFXMatrix4x4 pmInWrapTransform)

This method sets the texture transform.

Parameters:

uInLayer

Texture Layer ID

pmInWrapTransform

Texture wrap transform

Return Values


IFXShaderLitTexture::GetTextureRepeat(U32/Channels u/eInLayer, BOOL* pbOutTextureRepeat)

This method determines whether the texture is repeated.

Parameters:

uInLayer

Texture Layer ID

pbOutTextureRepeat

Pointer to texture repeat boolean

Return Values


IFXShaderLitTexture::SetTextureRepeat(U32/Channels u/eInLayer, BOOL bInTextureRepeat)

This method declares whether the texture is repeated.

Parameters:

uInLayer

Texture Layer ID

bInTextureRepeat

Texture repeat boolean

Return Values


IFXShaderLitTexture::GetUseDiffuse()

This method gets the value of whether or not diffuse color is used.

Parameters:

None

Return Values:

BOOL


IFXShaderLitTexture::SetUseDiffuse( BOOL bUseDiffuse )

This method gets the value of whether or not diffuse color is used.

Parameters:

bUseDiffuse

Indicates whether or not diffuse is used

Return Values:

None


IFXShaderLitTexture::GetSceneGraph(IFXSceneGraph** ppOutSceneGraph)

Parameters:

ppOutSceneGraph

Returns pointer to the scenegraph used by the shader

Return Values


 

§See asterisked (*) statement at Legal Information © 2001 Intel Corporation.