User Guide

579
sds (modifier)
Syntax
member(whichCastmember).model(whichModel).sds.whichProperty
Description
3D modifier; adds geometric detail to models and synthesizes additional details to smooth out
curves as the model moves closer to the camera. After you have added the sds modifier to a model
using
addModifier(), you can set the properties of the sds modifier.
The
sds modifier directly affects the model resource. Be careful when using the sds and lod
modifiers together, because they perform opposite functions (the
sds modifier adds geometric
detail and the
lod modifier removes geometric detail). Before adding the sds modifier, it is
recommended that you set the lod.auto modifier property to FALSE and set the lod.level modifier
property to the desired resolution, as follows:
member("myMember").model("myModel").lod.auto = 0
member("myMember").model("myModel").lod.level = 100
member("myMember").model("myModel").addmodifier(#sds)
The sds modifier cannot be used with models that already use either the inker or toon modifiers.
After you have added the sds modifier to a model resource you can get or set the
following properties:
enabled indicates whether subdivision surfaces functionality is enabled (TRUE) or disabled (FALSE).
The default setting for this property is
TRUE.
depth specifies the maximum number of levels of resolution that the model can display when
using the
sds modifier.
error indicates the level of error tolerance for the subdivision surfaces functionality. This property
applies only when the
sds.subdivision property is set to #adaptive.
subdivision indicates the mode of operation of the subdivision surfaces modifier. Possible values
are as follows:
#uniform specifies that the mesh is uniformly scaled up in detail, with each face subdivided the
same number of times.
#adaptive specifies that additional detail is added only when there are major face orientation
changes and only to those areas of the mesh that are currently visible.
Note: For more detailed information about these properties, see the individual property entries.
Example
The statement displays the sds.depth property value for the model named Terrain:
put member(“3D”).model(“Terrain”).sds.depth
-- 2
See also
lod (modifier), toon (modifier), inker (modifier), depth (3D), enabled (sds), error,
subdivision, addModifier