formZ SDK | 5.0 API Reference | Project | Modeling | Attributes
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, |
obj, | |
refn, | |
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
See Also
,
Function Set
Defined in