RenderWare V2.1

Previous Page Index Next Page

RwTexture *

RwFindNamedTexture(char *name);

Description

Searches for a texture with the name name. If the current search mode is rwLOCAL, only the current dictionary is searched. If the current search mode is rwGLOBAL, the entire texture dictionary stack is searched. In the latter case, the search starts with the current texture dictionary, i.e., the top element of the stack, and proceeds downwards until a texture with the specified name is found or there are no more dictionaries to be examined.

Arguments

name The texture name.

Return Value

A pointer to a texture. If there is an error or if no texture with that name is found, NULL is returned. Errors can be checked for using RwGetError().

Comments

This function only searches the current dictionary or dictionary stack. It will not attempt to load a texture from disk.

See Also

RwCreateTexture()

RwDestroyTexture()

RwForAllNamedTextures()

RwGetError()

RwGetNamedTexture()

RwReadNamedTexture()

RwReadTexture()

RwSetMaterialTexture()

RwSetPolygonTexture()

RwSetTextureDictSearchMode()

RwTextureDictBegin()

RwTextureDictEnd()