RenderWare V2.1

Previous Page Index Next Page

RwBool

RwSetTextureDictSearchMode(RwSearchMode mode);

Description

Sets the mode for searching the texture dictionary stack.

Arguments

mode The texture dictionary stack search mode.

Return Value

TRUE if successful, and FALSE otherwise.

Comments

This function affects how textures are searched for in the texture dictionary stack. In particular, it affects the behavior of RwFindNamedTexture(), RwGetNamedTexture(), RwGetNumNamedTextures() and the RwForAllNamedTextures…() functions.

If the texture dictionary search mode is rwLOCAL, then only the current texture dictionary (the top element of the texture dictionary stack) is searched. If the search mode is rwGLOBAL, all dictionaries on the dictionary stack, from the current dictionary down, are searched until the named texture is found or there are no more dictionaries left to search.

The texture dictionary search modes are:

• rwLOCAL Search only the top most dictionary in the texture dictionary stack.

• rwGLOBAL Search all the dictionaries in the texture dictionary stack.

See Also

RwFindNamedTexture()

RwForAllNamedTextures()

RwGetNamedTexture()

RwGetNumNamedTextures()

RwGetTextureDictSearchMode()

RwTextureDictBegin()

RwTextureDictEnd()