You are here: Home » Public » Software » Daz Studio » v4.x » Reference Guide » Scripting » API Reference » Object Index » DzFigure

Implements a weight mapped defined figure.

**Inherits :**

DAZ Script | |
---|---|

DzFigure | convertPropToFigure ( DzNode srcNode, String rootBoneName, Boolean localMaps=true, Boolean inheritSkeleton=true ) |

DAZ Script |
---|

DzFigure () |

void | followTargetHiddenListChanged () |

void | graftListChanged () |

void | weldListChanged () |

**TODO:**
Add detailed description.

*DzFigure* : **convertPropToFigure**( DzNode srcNode, String rootBoneName, Boolean localMaps=true, Boolean inheritSkeleton=true )

Attempts to convert a simple node with geometry into a figure.

**Parameter(s):**

*srcNode*- The source node to convert.*rootBoneName*- The name to assign to the root bone of the figure.*localMaps*- If`true`

(default), local weight maps will be created, otherwise a general weight map will be created.*inheritSkeleton*- If`true`

(default), …

**Return Value:**

- The figure produced by the conversion (if any), otherwise NULL.

void : **addFollowTargetHiddenFace**( Number faceIdx )

Adds a face in the figure that this figure is following (if any) to hide.

**Parameter(s):**

*faceIdx*- The index of the face to hide.

void : **addWeldPoint**( Number followerIdx, Number targetIdx, Boolean notifyChange=true )

Adds a pair of vertex indices in the geometry of this figure, and in the geometry of the figure that this figure is following (if any), to the list of vertices to weld together in order to “graft” (integrate) them.

**Parameter(s):**

*followerIdx*- The index of the vertex in the geometry of this figure.*targetIdx*- The index of the vertex in the geometry of the follow target.

void : **clearFollowTargetHiddenFaces**()

Clears the list of faces to hide in the figure that this figure is following (if any).

void : **clearWeldPoints**()

Clears the list of vertex index pairs used to weld vertices in the geometry of this figure to vertices in the geometry of another figure.

**Since:**

- 4.9.0.53

*DzFigure* : **getCullFigure**( Number which )

**Parameter(s):**

*which*- The index of the figure that is culling this figure.

**Return Value:**

- The figure that is culling (hiding geometry of) this figure at the specified index (if valid), otherwise null.

Number : **getFollowerWeldIndex**( Number which )

**Parameter(s):**

*which*- The index of the vertex index pair to weld.

**Return Value:**

- The index of the vertex in the geometry of this figure.

Number : **getFollowTargetFaceCount**()

**Return Value:**

- The face count of the figure that this figure is following (if any).

Number : **getFollowTargetVertexCount**()

**Return Value:**

- The vertex count of the figure that this figure is following (if any).

Number : **getFollowTargetWeldIndex**( Number which )

**Parameter(s):**

*which*- The index of the vertex index pair to weld.

**Return Value:**

- The index of the vertex in the geometry of the follow target.

*DzFigure* : **getGraftFigure**( Number which )

**Parameter(s):**

*which*- The index of the figure that is grafting into this figure.

**Return Value:**

- The figure that is grafting (integrating its geometry) into this figure at the specified index (if valid), otherwise null.

**Return Value:**

- The number of figures that are culling (hiding geometry of) this figure.

Number : **getNumFollowTargetHiddenFaces**()

**Return Value:**

- The number of faces in the figure that this figure is following (if any) to hide.

**Return Value:**

- The number of figures that are grafting (integrating their geometry) into this figure.

**Return Value:**

- The number of vertex index pairs in the list of vertices to weld together between the geometry of this figure, and the geometry of the figure that this figure is following (if any), in order to “graft” (integrate) them.

skinbinding_dz : **getSkinBinding**()

**Return Value:**

- The skin binding for this figure

**See Also:**

**Return Value:**

`true`

if a follower is grafting to this figure, otherwise`false`

.

Merges all current followers of this figure into a single follower.

**Attention:**

- It is the responsibility of a developer to perform the appropriate checks to ensure followers exist and can be merged prior to calling this function.

**Return Value:**

- DZ_NO_ERROR on success, otherwise an appropriate error code.

**See Also:**

- DzViewportMgr::lockRedraws()
- DzViewportMgr::unlockRedraws()

**Since:**

- 4.6.3.0

void : **optimizeWeldPoints**()

Optimizes the list of vertex index pairs used to weld vertices in the geometry of this figure to vertices in the geometry of another figure - removes duplicates and releases any memory not required to store the items.

**See Also:**

**Since:**

- 4.9.0.53

void : **presizeFollowTargetHiddenFaces**( Number num )

Pre-sizes the list of faces to hide in the figure that this figure is following (if any).

**Parameter(s):**

*num*- The number of faces that will be hidden.

void : **presizeWeldPoints**( Number num )

Pre-sizes the list of vertex index pairs used to “graft” (integrate) the geometry of this figure into the geometry of the figure that this figure is following (if any).

**Parameter(s):**

*num*- The number of vertex index pairs.

void : **removeDuplicateWeldPoints**()

Removes duplicates from the list of vertex index pairs used to weld vertices in the geometry of this figure to vertices in the geometry of another figure.

**Since:**

- 4.9.0.53

void : **removeWeldPoint**( Number which )

Removes a pair of vertex indices in the geometry of this figure, and in the geometry of the figure that this figure is following (if any), from the list of vertices to weld together in order to “graft” (integrate) them.

**Parameter(s):**

*which*- The index of the pair to remove.

**Since:**

- 4.9.0.53

void : **setFollowTargetFaceCount**( Number num )

Stores the face count of the figure that this figure is following (if any).

**Parameter(s):**

*num*- The number of faces.

void : **setFollowTargetVertexCount**( Number num )

Stores the vertex count of the figure that this figure is following (if any).

**Parameter(s):**

*num*- The number of vertices.

**Return Value:**

`true`

if this figure will graft during drawing operations, otherwise`false`

.

**Since:**

- 4.9.2.58

Boolean : **willGraftInRender**( DzRenderSettings settings=null )

**Parameter(s):**

*settings*- The render settings that will be used during the render operation.

**Return Value:**

`true`

if this figure will graft during rendering operations, otherwise`false`

.

**Since:**

- 4.9.2.58

void : **followTargetHiddenListChanged**()

**Signature:**`“followTargetHiddenListChanged()”`

Emitted when the list of hidden facets in the follow target has changed.

void : **graftListChanged**()

**Signature:**`“graftListChanged()”`

Emitted when the list of figures that “graft” (integrate) their geometries into this figure has changed.

void : **weldListChanged**()

**Signature:**`“weldListChanged()”`

Emitted when the list of vertex indices for the vertices to weld together in order to “graft” (integrate) their geometries has changed.

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution 3.0 Unported