formZ SDK | 5.0 API Reference | System | Texture Maps

fz_tmap_find_file

Description

Locates a texture map on file. This function should be called for a given texture map before any of the other texture map related functions are used. It makes sure that the texture map does indeed exist in the location specified in the path stored with the texture map. If it does not, this function searches in the file search paths associated with the project. If it still cannot be found, and the silent argument is set to FALSE, a dialog is invoked to ask for the location of the texture map. If the silent argument is TRUE, this step is skipped. An error is returned if the texture map cannot be located after any of the searches or by asking the user.

Plugin Prototype

fzrt_error_td fz_tmap_find_file(

fzrt_int

windex,

fz_tmap_ptr

tmap,

fzrt_boolean

silent )

Parameters

windex [Input]

project window index

tmap [Input]

the texture map to be found

silent [Input]

Set to FALSE, if allowing to ask the user to locate it if it cannot be found. Set to TRUE, if no dialogs are to be presented to the user.

Returns

error codes

Availability

5.5.0.0

See Also

Function Set

fz_tmap_fset


Defined in

fz_tmap_api.h