The modifier component of dForm deformers.

More...

Inherits :

• QObject
  • DzBase
    • DzElement
      • DzModifier

The dForm modifier is the modifier component of a dForm deformer. The others are the DzDFormBase, DzDFormZone and DzDForm.

A DzDFormModifier generates a local space delta for the vertices in the target geometry based on the dForm component parameters. It also draws the vertex weight points.

It can be used to spawn a morph from the dForm on the target geometry.

The dForm modifier is coded for one-to-one dForm and target relationships. Setting a new dForm/target pair replaces the old pair.

Generally a DzDFormModifier should not be created by the user but rather generated by a DzDForm node itself using DzDForm::applyToNode().

DzAuthor : assetAuthor

Holds the author of the file for this modifier. (Read Only)

Since:

• 4.8.1.21

DzVersion : assetFileRevision

Holds the revision version of the asset file for this modifier. (Read Only)

Since:

• 4.8.1.21

String : assetId

Holds the asset id for this modifier.

Since:

• 4.8.1.18

Date : assetModifiedDate

Holds the modified date of the asset file for this modifier. (Read Only)

Since:

• 4.8.1.21

Boolean : assetNeedSave

Holds whether or not the asset for this modifier needs to be saved. (Read Only)

Since:

• 4.11.0.249

DzUri : assetSource

Holds the URI of the asset source for this modifier; only valid when the asset is in an embedded state - i.e. modified. (Read Only)

Since:

• 4.8.1.21

DzUri : assetUri

Holds the asset URI for this modifier. (Read Only)

Since:

• 4.8.1.18

DzDFormModifier()

Default Constructor.

void : clearAltDFormer()

DzDFormModifier : createAltGeomDFormer( Boolean atFront=true )

DzDForm : getDForm()

Return Value:

• The dForm node that this modifier is driven by.

See Also:

• setDForm()

DzWeightMap : getInfluenceWeights()

DzBone : getMaskBone()

DzFloatProperty : getValueControl()

Return Value:

• The property that controls the strength of this modifier.

Since:

• 4.9.3.137

void : invalidateInfluenceWeights()

Boolean : isAppliedAsLegacy()

Boolean : modifyAsset()

Marks the asset as being modified.

Return Value:

• true on success, otherwise false.

Boolean : modifyAsset( DzUri newUri )

Marks the asset as being modified.

Parameter(s):

• newUri - The new file URI for the asset.

Return Value:

• true on success, otherwise false.

void : setApplyAsLegacy( Boolean onOff )

void : setDForm( DzDForm dform )

Sets the dForm node that this modifier is driven by.

Parameter(s):

• dform - The dForm node that will control this modifier.

See Also:

• getDForm()

DzError : setInfluenceWeights( DzWeightMap map )

void : setMaskBone( DzBone bone )

DzError : setWeightMapFromZone( DzWeightMap map, DzNode node )

DzMorph : spawnMorph( DzNode node, String name )

Generates a morph from this modifier. It searches for a morph of the same name and if it exists it adds its values to the allready existing morph. This was down to allow generation of a morph that is made from more than one dForm.

Parameter(s):

• node - The target node.
• name - The name to assign to the morph.

Return Value:

• The newly generated morph.

void : assetModified()

Signature:“assetModified()”

Emitted when this modifier has been modified.

void : assetWasSaved()

Signature:“assetWasSaved()”

Emitted after this modifier has been saved.

void : dformChanged( DzDForm newDForm )

Signature:“dformChanged(DzDForm*)”

Emitted when the dForm node that is associated with this modifier has changed.

Parameter(s):

• newDForm - The new dForm node associated with this modifier.

void : weightListChanged()

Signature:“weightListChanged()”

Emitted when the weight list for this modifier has changed.

void : weightsChanged()

Signature:“weightsChanged()”

Emitted when the weights on this modifier have changed.