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

# fz_objt_attr_set_objt_refn

Description

Set the display resolution attribute of an object. Note, that the display resolution attribute is mandatory for all smooth objects and therefore cannot be removed. Likewise it is not allowed on a plain facetted object. Therefore an error will be returned if this function is called with a plain facetted object as input. The do_refacet argument determines, whether the facets of the object are generated by this function as well or not. If set to TRUE, facets are regenerated based on the display resolution attribute passed in. If set to FALSE, the facets are not regenerated. This may be useful when making other changes to the object and facetting needs to be delayed. Facets can be regenerated independently with the API .

Plugin Prototype

fzrt_error_td fz_objt_attr_set_objt_refn(

fzrt_int | windex,
fz_objt_ptr | obj,
fz_attr_refn_ptr | refn,
fzrt_boolean | do_refacet )

Parameters

windex [Input]

project window index

obj [Input]

object

refn [Input]

display resolution attribute

do_refacet [Input]

If set to TRUE, object is refacetted right away. Otherwise, just the attribute is set.

Returns

Error codes
MODEL_ERR_INVALID_REFN_ATTRIBUTE - Display resolution attribute cannot be assigned to a plain facetted object

Availability

5.0.0.0

Example Files

util_attr_refn.fsl

See Also

,

Function Set

fz_objt_attr_fset

Defined in

fz_objt_refn_api.h