formZ SDK | 5.0 API Reference | Project | Modeling | Attributes

# fz_objt_attr_set_objt_tctl_parm

Description

Sets the parameter of a texture map control attribute of an object. The tgrp_indx argument identifies the texture group within the texture map control attribute. If -1 is passed, the object level texture group is used. Otherwise, the face level texture group identified by tgrp_indx is used.
When assigning the name parameter, a face texture group must be selected (i.e. tgrp_indx must not be passed as -1). No checks are made whether the texture group name is unique. It is up to the calling function to assure this. The name cannot be larger than 32 characters.
When setting the origin parameter and the texture group uses parametric mapping, the x and y value of the fz_xyz_td passed in must be in the range of 0.0 to 1.0. If the texture group uses uv coordinates mapping, no origin needs specified and the values passed in are ignored.
When setting the rotation parameter and the texture group uses parametric or uv coordinates mapping, the rotation values are ignored.
When setting the map type parameter, the following rules apply :
Only nurbz and analytic primitives can be assigned the parametric mapping type. When setting the mapping type to uv coordinates, parametric and smooth objects are dropped to plain facetted objects. Size and repetition parameters are adjusted to conform to the mapping type selected.
When setting the size parameters, the repetition parameters are automatically updated and vice versa.

Plugin Prototype

fzrt_error_td fz_objt_attr_set_objt_tctl_parm(

fzrt_int | windex,
fz_objt_ptr | obj,
fzrt_int | tgrp_indx,
fz_attr_tctl_parm_enum | which,
fz_type_td * | data )

Parameters

windex [Input]

project window index

obj [Input]

object

tgrp_indx [Input]

texture group index

which [Input]

parameter identifier

data [Input]

parameter data

Availability

5.0.0.0

Example Files

util_attr_tctl.fsl

See Also

Function Set

fz_objt_attr_fset

Defined in

fz_objt_tctl_api.h