Morphs - Mustard2/MustardUI GitHub Wiki

This panel shows a list of Blender Custom properties or shape keys, that can be divided into sections. For instance, if you have a Diffeomorphic model, you can include some morphs from Diffeomorphic on MustardUI.

There are three different type of Morph implemented:

  • Generic
    For generic models without built-in support for specific configurations as in the other modes

  • Diffeomorphic Genesis 8
    for models imported to Blender from Daz with Diffeomorphic, whose version is Genesis 8

  • Diffeomorphic Genesis 9
    for models imported to Blender from Daz with Diffeomorphic, whose version is Genesis 9

The non-Generic models are simply preset import settings that help the setup. But it is also possible to use the Generic mode for Diffeomorphic models and setup the Morphs manually.

Generic

In this mode, morphs can be added for generic models without built-in support for specific configurations as in the other modes.

The procedure is the following:

  • Create a section

  • Specify the String
    This option is used to look for Custom Properties or Shape Keys whose name contain this string. Write the string with entries separated by commas, and remember that spaces are considered. If you write "A, B", it will search for properties which contain "A" and " B" (note the space): therefore if you want to search for "A" and "B" (without space), write "A,B".

  • Specify the Morphs source
    Either as Custom Properties on the Armature Object/Armature Data/Body Object/Body Data (Mesh data); or as Shape Keys from the Body Object.

  • Search and Add Morphs
    Once the Sections has been setup, the Search and Add Morphs button should become available to populate the sections with the Morphs found.

  • Customize Order or Delete Morphs
    When some Morphs are found, clicking on the Section on the list makes a list of Morphs appear. From that list you can re-order, rename or delete the Morphs.

Note
If no Morph were found, check again the string and the Morph source (Shape Keys or Custom Properties). Also remember to run the Search and Add Morphs after creating the sections.

Note
Changes to the Sections Strings and Custom Properties/Shape Keys options are not applied automatically. If you change those options, or add more Custom properties/Shape Keys that you want to add to the Morphs panel, re-run the Search and Add Morphs operator.

Diffeomorphic Genesis 8/9

In this mode, a first run with the Search and Add Morphs button is necessary. You can select in the windows that appears, which Morphs you would like to see on the UI. Some default morphs are automatically checked, but you can add new morphs writing their initials on the Custom Morphs. Create them separated by commas, and remember that spaces are considered. If you write "A, B", it will search for properties which contain "A" and " B" (note the space): therefore if you want to search for "A" and "B" (without space), write "A,B".

After this first configuration, you can also add new custom Sections with the same procedure as in the Generic case (see above).

Note
Changes to the Sections Strings and Custom Properties/Shape Keys options are not applied automatically. If you change those options, or add more Custom properties/Shape Keys that you want to add to the Morphs panel, re-run the Search and Add Morphs operator.

Prevent Drivers disabling on Morphs disabling

Since the Diffeomorphic support of MustardUI includes the possibility to disable the Morphs entirely (to get better performance), we might also want to define exceptions to this process. In fact, with Disable Exceptions it is possible to specify some specific morphs to not disable when morphs are disabled.

Finally note that an External Morphs enable/disable button will be added near the name of the new tab. This disables all body drivers. To prevent some drivers to be disabled, insert the string MustardUINotDisable in the shape key name.

Morph Disable and Freezable option

Disable Morphs

Available: Diffeomorphic models

This operator is only available when using Diffeomorphic models. Near the Morphs panel name a button will appear to disable all Morphs and their drivers, increasing the performance of the model.

Freeze Morphs

Available: Generic and Diffeomorphic models

When the Freezable option is active, the Morphs in this section can be disabled by Freeze Morph operator in the Morph panel. Disable this if the Morphs in the section are supposed to change during an animation (e.g. face morphs), and enable it if the Morphs in the section are supposed to keep the same value during an animaion (e.g. body Morphs).

By default in Diffeomorphic models, the correctives and the facial morphs are never frozen.