Implements the loading and application of a batch of morphs.

More...

Inherits :

• QObject

This class implements a batch of morph loader objects that will be applied to the same node(s).

Since:

• 4.9.3.46

Attention:

• This object is provided by the Morph Loader Pro plugin. It is only available when the Morph Loader Pro plugin is activated and enabled.

DzMorphLoaderBatch()

Default Constructor. Creates a morph loader batch that will be applied to the given node.

void : addFromConfigFile( String filename )

Adds a morph to the list to load.

Parameter(s):

• filename - The filename of the object configuration file to load.

Attention:

• setNode() must be called before this is.

Since:

• 4.9.3.47

void : addFromFile( String file )

Adds a morph to the list to load.

Parameter(s):

• file - The filename of the morph file to load.

Attention:

• setNode() must be called before this is.

void : addFromFiles( Array files )

Adds a list of morphs to the list to load.

Parameter(s):

• files - A list of the filenames of the morph files to load.

Attention:

• setNode() must be called before this is.

See Also:

• addFromFile()

void : addFromMesh( DzVertexMesh mesh )

Adds a morph to the list to load.

Parameter(s):

• mesh - The vertex mesh with the morph to load.

Attention:

• setNode() must be called before this is.

void : addMorph( DzMorphLoader morph )

Adds a morph to the list to load.

Parameter(s):

• morph - The morph to add.

void : clear()

Clears the list of morphs to load.

String : createMorphs( DzFileIOSettings settings, DzNode node, Boolean onlyErrorsOrWarnings=true, Boolean plainText=true )

Creates morphs on a node for geometry loaded from files. This function supports morph creation from vertex-only geometries.

Parameter(s):

• settings - The scale to apply to the geometry that is read from the file.
• node - The node containing the geometry to create the morph for.
• onlyErrorsOrWarnings - If true (default), only errors and warnings will be returned.
• plainText - If true (default), the returned string will be plain text, otherwise the returned string will contain HTML.

Return Value:

• The log containing messages about the creation of the morph.

See Also:

• DzMorphLoader()
• DzMorphLoader::setFilename()

String : createMorphs( DzVertexMesh mesh, DzNode node, Boolean onlyErrorsOrWarnings=true, Boolean plainText=true )

Creates morphs on a node provided by a geometry. This function supports morph creation from vertex-only geometries.

Parameter(s):

• mesh - The geometry for the morphs.
• node - The node containing the geometry to create the morphs for.
• onlyErrorsOrWarnings - If true (default), only errors and warnings will be returned.
• plainText - If true (default), the returned string will be plain text, otherwise the returned string will contain HTML.

Return Value:

• The log containing messages about the creation of the morphs.

See Also:

• DzMorphLoader()

Number : findMorph( DzMorphLoader morph )

Parameter(s):

• morph - The morph to find.

Return Value:

• The index of the found morph (if any), otherwise -1.

DzMorphLoader : getMorph( Number index )

Parameter(s):

• index - The index of the morph to get.

Return Value:

• The morph in the list at the given index (if valid), otherwise Null.

DzNode : getNode()

Return Value:

• The node with the object that morphs will be loaded for (if set), otherwise NULL.

Number : getNumMorphs()

Return Value:

• The number of morphs in the list to load.

void : moveMorph( DzMorphLoader morph, Boolean upDown )

Moves the position of a morph in the list.

Parameter(s):

• morph - The morph to move.
• upDown - If true, the morph is moved to the position earlier in the list. If false, the morph is moved to the position later in the list.

String : presetConfigurationFile()

Return Value:

• The filename of the preset configuration file to use (if any) to setup a morph added from file, otherwise an empty string.

See Also:

• setPresetConfigurationFile()
• setUsePresetConfiguration()
• addFromFile()
• addFromFiles()

void : removeMorph( DzMorphLoader morph )

Removes a morph from the list to load.

Parameter(s):

• morph - The morph to remove.

Boolean : saveProjectSettingsToConfigFile( String filename, Boolean saveRelative, Boolean saveObjects )

Saves project (and potentially object) settings to configuration files (*.dsx).

Parameter(s):

• filename - The full path of the file to write to.
• saveRelative - If true, object settings files are saved relative to the project file. If false, object settings files are saved adjacent to their respective source.
• saveObjects - If true, object settings will be saved to their respective files. If false, object settings files are not saved.

Return Value:

• true if the save was successful, otherwise false. (since 4.15.0.4)

Since:

• 4.9.3.47

void : setNode( DzNode node )

Sets the node with the object to load morphs for.

Parameter(s):

• node - The node to set.

void : setPresetConfigurationFile( String filename )

Sets the filename of a preset configuration file to use to setup morphs that are added to the list from file.

Parameter(s):

• filename - The filename of the preset configuration file to use.

See Also:

• setUsePresetConfiguration()
• addFromFile()
• addFromFiles()

void : setUsePresetConfiguration( Boolean onOff )

Sets whether or not a preset configuration file should be used to setup morphs that are added from file.

Parameter(s):

• onOff - If true, a preset configuration file should be used.

See Also:

• presetConfigurationFile()
• setPresetConfigurationFile()
• addFromFile()
• addFromFiles()

Boolean : usePresetConfiguration()

Return Value:

• true if a preset configuration file should be used to setup morphs that are added from file, otherwise false.

See Also:

• addFromFile()
• addFromFiles()

void : morphAdded( DzMorphLoader morph )

void : morphListChanged()

void : morphMoved( Number srcIdx, Number destIdx )

void : morphRemoved( DzMorphLoader morph, Number formerIndex )