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, firstly create some sections and specify the String. This option is used to look for Custom Properties or Shape Keys whose name contain this string. It is also important to specify if we want to look into the Custom Properties list of the selected Armature Object (not the Armature data or the Body mesh), or for the Shape Keys of the Body mesh.

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

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: 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.