3D Lingo Dictionary > O-S > sds (modifier) |  |

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 (using `addModifier`) to a model, 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 (sds) 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, enabled (sds)`, `error`, `subdivision`, `addModifier`