Searches for the named texture. If the current search mode is rwLOCAL, the function searches only the current dictionary. If the current search mode is rwGLOBAL, the function searches the whole of the texture dictionary stack. If the search fails, an attempt is made to read the named texture from disk. If the named texture is found, it is stored into the current texture dictionary.
name Name of a texture.
A pointer to the named texture if successful, and NULL otherwise.
The string supplied as the texture name should form the leaf part (i.e., without path or extension) of the filename of the texture file. Furthermore, for the sake of portability of texture files across the different platforms supported by RenderWare, it is best to choose texture file names that are a maximum of eight characters long and which are acceptable to MS-DOS as file names.
If the function cannot find the named texture in the texture dictionary stack, it will look for a texture file in the directories whose names appear in the shape path. Furthermore, if the specified name does not have a file extension, then this function will also search for the specified name followed by the extensions ".ras", ".env", ".tex", ".bmp" and ".rle".
An example of a valid texture is "marble", which will match with file names "marble", "marble.tex", "marble.ras", "marble.env", "marble.bmp" and "marble.rle".