formZ SDK | 4.0 Call Back Reference | Surface Style Representation

fz_srep_cbak_list_tmas_embd

Description

Fils in a list of embedded tmaps (tmap_embd_ptr). This function is called to report to formz, how many embedded texture maps (tmaps) are used by a Surface Style Representation, and which texture maps they are. The number of texture maps is returned in the parameter ntmaps. The tmap_list array is a pre allocated array of texture maps pointers. Note, that either parameter may be passed as NULL, and, if so, must be ignored. If the tmap_list parameter is passed in, the callback fucntion should assign the the tmap pointers to their local copies of the tmaps. For example :

Plugin Prototype

fzrt_error_td fz_srep_cbak_list_tmas_embd(

fzrt_int

windex,

fz_rmtl_ptr

rmtl,

void *

srep_data,

fzrt_int *

ntmaps,

fz_tmap_embd_ptr *

tmap_list,

fz_string_td *

tmap_type_name )

Parameters

windex [Input]

project window index

rmtl [Input]

the surface style to which the srep belongs

srep_data [Input]

The source Surface Style Representation data.

ntmaps [Input, Optional]

The number of texture maps used by this Surface Style Representation

tmap_list [Input, Optional]

If passed in as non NULL this is an array of embedded texture maps pointers

tmap_type_name [Input, Optional]

If passed in as non NULL this is an array of names. For each texture map, the name of the type of texture should be set. For example "Color Map" or "Bump Map". It is ok (although not encouraged) to not set the name, in which case formZ assumes a generic type (i.e. "Texture Map")

Returns

Error codes

Availability

7.0.0.0

Plugin Example

fz_tmap_embd_ptr my_tmap;
fz_tmap_embd_allocate(zone_ptr,&my_tmap);
for(i = 0; i < ntmaps; i++) { ... tmap_list[i] = my_tmap; ...
}
fz_tmap_embd_free(zone_ptr,&my_tmap);

Function Set

fz_srep_cbak_fset


Defined in

fz_srep_api.h