IFXTextureInterfaces

IFXTextureInterfaces contains several classes of texture objects that are used by the texture manager. It inherits the IFXUnknown interface.

These classes are included in this interface:

Methods used across the interfaces follow.

IFXTextureChild

This class contains IFXUnknown methods only and is used as a marker.

IFXTextureParent

This class contains IFXUnknown methods and the following:

Interface Methods

Description

ResetChildren

Resets the children to the parent texture

GetMinChildren

Returns the minimum number of children

GetMaxChildren

Returns the maximum number of children

GetNumChildren

Returns the number of children

SetChild

Sets the IFXTextureChild to the parent

EnumChildren

Returns IFXTextureChild index entries

IFXTextureParent::ResetChildren()

This method resets the children to the parent texture.

Parameters:

None

Return Values


IFXTextureParent::GetMinChildren(U32 *puMinChildren)

This method returns the minimum number of children.

Parameters:

puMinChildren

Pointer to the minimum number of children integer

Return Values


IFXTextureParent::GetMaxChildren(U32 *puMaxChildren)

This method returns the maximum number of children.

Parameters:

puMaxChildren

Pointer to the maximum number of children integer

Return Values


IFXTextureParent::GetNumChildren(U32 *puNumChildren)

This method returns the number of children.

Parameters:

puNumChildren

Pointer to the number of children integer

Return Values


IFXTextureParent::SetChild(U32 uChildIndex, IFXTextureChild *pITextureChild)

This method sets a texture child to the parent.

Parameters:

uChildIndex

TextureChild Index ID

pITextureChild

Pointer to the TextureChild

Return Values


IFXTextureParent::EnumChildren(U32 uChildIndex, IFXTextureChild **ppITextureChild)

This method sets a texture child to the parent.

Parameters:

uChildIndex

TextureChild Index ID

pITextureChild

Handle to the TextureChild

Return Values


IFXTextureMap

This class contains IFXUnknown methods and the following:

Interface Methods

Description

GetWidth

Returns the width of the map

GetHeight

Returns the height of the map

GetFormat

Returns the format of the map

GetSize

Returns the size of the map

IsFormat

Sets the width, height, and format of the map

GetTexels

Returns the texels in the map

Reallocate

Resets the width, height, and format of the map

Reformat

Sets the width, height, and format of the map

IFXTextureMap::GetWidth(U32 *pWidth)

This method gets the width of the texture map.

Parameters:

pWidth

Pointer to the width amount of the texture map

Return Values


IFXTextureMap::GetHeight(U32 *pHeight)

This method gets the height of the texture map.

Parameters:

pHeight

Pointer to the height amount of the texture map

Return Values


IFXTextureMap::GetFormat(U32 *pFormat)

This method gets the format of the texture map.

Parameters:

pFormat

Pointer to the format of the texture map

Return Values


IFXTextureMap::GetSize(U32 *pSize)

This method gets the size of the texture map.

Parameters:

pSize

Pointer to the size amount of the texture map

Return Values


IFXTextureMap::IsFormat(U32 uWidth, U32 uHeight, U32 uFormat)

This method sets the dimensions of the texture map.

Parameters:

uWidth

Width of the map

uHeight

Height of the map

uFormat

Format of the map

Return Values


IFXTextureMap::GetTexels(**ppv)

This method gets the texels of the texture map.

Parameters:

**pv

Handle to the texels

Return Values


IFXTextureMap::Reallocate(U32 uWidth, U32 uHeight, U32 uFormat)

This method sets the dimensions of the texture map.

Parameters:

uWidth

Width of the map

uHeight

Height of the map

uFormat

Format of the map

Return Values


IFXTextureMap::Reformat(U32 uWidth, U32 uHeight, U32 uFormat)

This method sets the dimension of the texture map.

Parameters:

uWidth

Width of the map

uHeight

Height of the map

uFormat

Format of the map

Return Values


IFXTextureMapSrc

This class contains IFXUnknown methods and the following:

Interface Methods

Description

Evaluate

Returns map source data

IsDirty

Gets the IFXRenderLayer

IFXTextureMapSrc::Evaluate(U32 *pWidth, U32 *pHeight, U32 *pFormat, IFXTextureMap *ppTextureMap, IFXRenderLayer *pRenderLayer)

This method returns map source data.

Parameters:

pWidth

Pointer to the width of the map

pHeight

Pointer to the height of the map

pFormat

Pointer to the format of the map

ppTextureMap

Handle to the IFXTextureMap

pRenderLayer

Pointer to the IFXRenderLayer

Return Values


IFXTextureMapSrc::IsDirty(IFXRenderLayer *pRenderLayer)

This method gets the IFXRenderLayer.

Parameters:

pRenderLayer

Pointer to the IFXRenderLayer

Return Values


IFXTextureObject

This class contains IFXUnknown methods, IFXTextureParent methods, IFXTextureMapSrc methods, IFXAttributes methods, and the following:

Interface Methods

Description

UpdateAndMakeCurrent

Updates IFXRenderLayer

MakeDirty

Gets the IFXRenderLayer

GetSceneGraph

Gets the scenegraph

GetUserData

Gets user data

SetUserData

Sets user data

IFXTextureObject::UpdateAndMakeCurrent(IFXRenderLayer *pRenderLayer, U32 uInTextureUnitId)

This method updates the IFXRenderLayer with the current texture ID.

Parameters:

pRenderLayer

Pointer to the IFXRenderLayer

uInTextureUnitId

Texture unit ID number

Return Values


IFXTextureObject::MakeDirty(IFXRenderLayer *pRenderLayer)

This method gets the IFXRenderLayer.

Parameters:

pRenderLayer

Pointer to the IFXRenderLayer

Return Values


IFXTextureObject::GetSceneGraph(IFXSceneGraph **ppSceneGraph)

This method gets the scenegraph.

Parameters:

ppSceneGraph

Handle to the scenegraph

Return Values


IFXTextureObject::GetUserData()

This method gets user data.

Parameters:

None

Return Values:

U32


IFXTextureObject::SetUserData(U32 uData)

This method sets user data.

uData

User data ID

Return Values:

None


IFXTextureOperator

This class contains IFXUnknown methods, IFXTextureParent methods, IFXTextureMapSrc methods, and IFXAttributes methods.


IFXTextureSource

This class contains IFXUnknown methods, IFXTextureMapSrc methods, and IFXAttributes methods.


IFXCompressedTextureSource

This class contains the following methods.

Interface Methods

Description

SetRawImage

Sets the raw image data

GetRawImage

Gets the raw image data

ForceCompressionState

Gets the scenegraph

GetCompressedState

Gets user data

IFXCompressedTextureSource::SetRawImage(STextureSourceInfo *pInfo, void *pImage)

This method sets the raw image data. This data will be in the form of unaligned scanlines with all the pixels packed tightly together, rather than longword aligned scanlines.

Parameters:

pInfo

Pointer to the texture source info

pImage

Pointer to the image

Return Values


IFXCompressedTextureSource::GetRawImage(STextureSourceInfo **ppInfo, void *pImage)

This method sets the raw image data.

Parameters:

ppInfo

Handle to the texture source info

pImage

Pointer to the image

Return Values


IFXCompressedTextureSource::ForceCompressionState(IFXTextureCompresionState eCompressionState)

This method sets compression.

Parameters:

eCompressionState

Compression

Return Values


IFXCompressedTextureSource::GetCompressedState(IFXTextureCompresionState *eCompressionState)

This method gets compression.

Parameters:

eCompressionState

Compression

Return Values


IFXTextureManager

 

Interface Methods

Description

BeginFrame

Starts a new frame

DeselectCurrentTexture

Stops rendering with textures

SetPriorityAdjustmentInterval

Sets the period of priority adjustment

CreateTextureObject

Creates a texture object to be rendered

CreateTextureOperator

Creates a texture operator to manipulate textures

CreateTextureSource

Creates a texture source

IFXTextureManager::BeginFrame(IFXRenderLayer *pRenderLayer)

This method starts a new frame.

Parameters:

pRenderLayer

Pointer to the IFXRenderLayer

Return Values


IFXTextureManager::DeselectCurrentTexture(IFXRenderLayer *pRenderLayer)

This method stops rendering with textures.

Parameters:

pRenderLayer

Pointer to the IFXRenderLayer

Return Values


IFXTextureManager::SetPriorityAdjustmentInterval(U32 uFrame)

This method sets the period of priority adjustment.

Parameters:

uFrame

Frame interval

Return Values


IFXTextureManager::CreateTextureObject(IFXTextureObject **ppITextureObject)

This method creates a texture object to be rendered.

Parameters:

ppITextureObject

Handle to a texture object

Return Values


IFXTextureManager::CreateTextureOperator(IFXTextureParent *pIParent, IFX_Texture_OP opCode, IFXTextureOperator **ppTextureOperator)

This method creates a texture operator to manipulate textures.

Parameters:

pIParent

Pointer to a texture parent

opCode

Operator code
Colorblend=1
ColorSaturate=2
Blur=3
Sharpen=4
Distort=5
Add=6
Blend=7
Difference=8
Mask=9
Colorsharpen=10
Composite=11

ppTextureOperator

Handle to a texture operator

Return Values


IFXTextureManager::CreateTextureSource(IFXTextureParent *pIParent, IFX_Texture_SRC sourceCode, IFXTextureSource **ppTextureSource)

This method creates a texture source.

Parameters:

pIParent

Pointer to a texture parent

sourceCode

Source code

JPEG=1
PNG=2
WDE_Additive=3
Raw=4
Compressed=5

ppTextureSource

Handle to a texture source

Return Values

 

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