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 () |
A specialization of DzSkeleton that represents a figure where the associated geometry is bound to its bones using a set of weight maps.
When serving the role of “follower”, this type of figure supports “culling” (hiding) facets in the geometry of another figure (i.e., a “follow target”). This can be useful for purposes of hiding areas of an underlying figure to mitigate occurrences of “poke-through” (visible intersection of meshes), where an inner-layer mesh is revealed through an outer-layer mesh.
Further, this type of figure also supports “grafting” (integrating) its geometry into the geometry of another figure (i.e., a “follow target”). In horticultural terms, the “follower” serves the role of “scion” and the “follow target” serves the role of “stock.”
“Grafting” between the geometries of figures relies on them each having vertices that are exactly coincident in their respective base shapes. “Culling” can be used to create an open edge in the “stock” that matches an open edge in the “scion” in order to establish a “graft” that blends smoothly, when a “follower” is assigned a “follow target.”
See Also:
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):
true
(default), local weight maps will be created, otherwise a general weight map will be created.true
(default) and srcNode
is parented to a bone, the skeleton that bone belongs to and the bone hierarchy up to that bone will be used to create the new figure.Return Value:
void : addFollowTargetHiddenFace( Number faceIdx )
Adds a face in the figure that this figure is following (if any) to hide.
Parameter(s):
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):
true
(default), notifies listeners of the weldListChanged() signal.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:
DzFigure : getCullFigure( Number which )
Parameter(s):
Return Value:
Number : getFollowerWeldIndex( Number which )
Parameter(s):
Return Value:
Number : getFollowTargetFaceCount()
Return Value:
Number : getFollowTargetVertexCount()
Return Value:
Number : getFollowTargetWeldIndex( Number which )
Parameter(s):
Return Value:
DzFigure : getGraftFigure( Number which )
Parameter(s):
Return Value:
Return Value:
Number : getNumFollowTargetHiddenFaces()
Return Value:
Return Value:
Return Value:
DzSkinBinding : getSkinBinding()
Return Value:
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:
Return Value:
Since:
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:
void : presizeFollowTargetHiddenFaces( Number num )
Pre-sizes the list of faces to hide in the figure that this figure is following (if any).
Parameter(s):
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):
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:
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):
Since:
void : setFollowTargetFaceCount( Number num )
Stores the face count of the figure that this figure is following (if any).
Parameter(s):
void : setFollowTargetVertexCount( Number num )
Stores the vertex count of the figure that this figure is following (if any).
Parameter(s):
Return Value:
true
if this figure will graft during drawing operations, otherwise false
.Since:
Boolean : willGraftInRender( DzRenderSettings settings=null )
Parameter(s):
Return Value:
true
if this figure will graft during rendering operations, otherwise false
.Since:
void : followTargetHiddenListChanged()
Signature:“followTargetHiddenListChanged()”
Emitted when the list of hidden facets in the geometry of a follow target has changed.
void : graftListChanged()
Signature:“graftListChanged()”
Emitted when the list of figures that “graft” (integrate) their geometries into the geometry of this figure has changed.
void : weldListChanged()
Signature:“weldListChanged()”
Emitted when 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 follow target (if any), has changed.