MorphDecomposer
Many great looks depend on hundreds of custom morphs, often merged into one big "morph-in-one" (MIO). That makes them heavy to load, fragile when a package is missing, and impossible to compare or combine with other looks.
MorphDecomposer rebuilds the shape of a look with VaM's built-in morphs only. The result is a new appearance preset that:
- looks (almost) the same as the original;
- no longer needs the custom morph packages;
- uses the same morph set as every other converted look, so looks can be analysed and combined.
Why would you want this?
- Use your looks with DreamGirlGenerator, the Evolutionary Character Creator and the Character Fusion tool.
- See how a beautiful look is built from VaM's basic morphs.
- Share a look without a long list of morph packages it depends on.
- Keep your looks working when you remove or lose morph packages.
- Get lighter scenes: fewer morph packages to load.
- Fine-tune a look with VaM's own sliders, instead of hundreds of custom ones.
Important: what you see is what you get
If a look uses custom morphs that are not installed, VaM leaves them out when it loads the look, and MorphDecomposer converts the look without them. Install the morph packages a look needs first and check that the look is right when you load it.
Highlights
- One look or a whole folder, unattended. Stop and continue whenever you want.
- The face is fitted part by part (nose, eyes, lips, ears), and the skeleton is fitted too.
- Error per part in mm, plus before/after comparison photos for every look.
- QUALITY (~10 min per look) or SPEED (~7 min per look).
- Perfectly symmetric result.
How to use
- Open a scene with one Person. Its current look will be replaced.
- Person → Plugins → Add Plugin → pinosante.MorphDecomposer → MorphDecomposer.cs → Open Custom UI...
- Single look: load the look, press Convert this look, switch Show converted look on and off to compare, then press Save converted look.
- Folder: press Select folder..., set Test run: first N to 1, check the comparison photo, then convert the rest. 100 looks take about 12 h in SPEED.
Good to know
- A converted look holds 700 to 800 built-in morphs with a small value. That is normal.
- Status "copied" means the look had no custom morphs, usually because the packages are not installed.
- To check a result, load the converted look and press Convert this look. It should say "Nothing to convert".
How it decides what to convert
The conversion is based on what you see on your screen. A look whose custom morphs are all missing has nothing to convert: Convert this look reports "Nothing to convert" and a folder run saves it with its built-in morphs (status "copied"). The same happens with a look that is already converted: it has no custom morphs left.
All features
Setup
A · Convert this look
B · Convert a folder
Where the results are
What the converted look contains
The converted look keeps everything else of the original (skin, hair, clothing, other settings). Only the morphs change, and the result holds built-in morphs only:
Tips
Notes
The conversion is based on what you see on your screen. A look whose custom morphs are all missing has nothing to convert: Convert this look reports "Nothing to convert" and a folder run saves it with its built-in morphs (status "copied"). The same happens with a look that is already converted: it has no custom morphs left.
All features
- One look or a whole folder. Convert the look on your Person, or convert a complete folder of presets (with subfolders) unattended.
- Stop and continue later. Stop, close VaM or even crash: press Convert again and finished looks are skipped. Run it a few hours tonight and continue tomorrow.
- Tells you what a run means: how many looks, how long it takes and where the results go, before you start.
- The face gets extra care. After the whole body, the face is fitted again part by part: nose, eyes, lips and ears. One part may lose a tiny bit only when the others gain more.
- The skeleton is fitted too. Custom morphs also move the bones (shoulders, neck, eyes). The plugin matches the bones as well as the skin, so the look stays right in other poses, from other angles and when the eyes follow the camera, and the hair sits as on the original.
- Shows the difference per part: after a conversion you see the average and worst difference in mm for body, nose, eyes, lips, ears and the rest of the face, so a small difference at the lips or nose does not hide in one overall percentage.
- Before/after comparison photos for every look: full body, face from the front and face at 30°, original on top and converted below, shot from exactly the same camera positions.
- Two modes: QUALITY (~10 min per look) and SPEED (~7 min per look, about 30% faster, with a slightly less exact body; the face is fitted just as carefully).
- Perfect symmetry (on by default): only morphs that act on both sides are used, so the result is exactly symmetric.
- Keep original genital morphs if you want to keep those custom morphs as they are. A look whose only custom morphs are genital ones then has nothing to convert; switch the setting off to convert them too.
- Waits for VaM, not for a timer: after loading a look it waits until VaM has finished loading and the body has stopped moving.
Setup
- Open a scene with one Person. The plugin loads looks onto this Person, so its current look will be replaced.
- Person → Plugins → Add Plugin → pinosante.MorphDecomposer → MorphDecomposer.cs → Open Custom UI...
A · Convert this look
- Load the look on the Person as usual. The line at the top of A tells you how many custom morphs the look on your Person uses now, and from how many packages (for example "This look: 567 custom morphs from 12 packages, plus 1 genital morph"). Genital morphs are counted apart.
- Press Convert this look. Below the button you see the progress, the match in percent and the time. When it is done, the converted look is switched on and you see the difference per part (body, nose, eyes, lips, ears, rest of the face) in mm.
- Switch Show converted look off and on to compare the original with the result, as often as you like; the line below it tells you which one you see. This works for the look you just converted: once you load another look, the earlier result is dropped and the new look is left as it is. Press Convert this look again for the new look.
- Press Save converted look to store the result in Appearance\Decomposed\single\, with a face thumbnail.
B · Convert a folder
- Press Select folder... and pick a folder inside Custom\Atom\Person\Appearance. The folder bar shows what a run would do ("N to do · M looks · K done"), and below it how long it takes and where the results go.
- Try it first: set Test run: first N to 1, press Convert 1 look and check the comparison photo. 0 = all looks.
- Press Convert N looks for the rest. At the end you see the total time and the time per look.
Where the results are
- Converted looks: Custom\Atom\Person\Appearance\Decomposed\<same folders and name as the original>.vap
- Single saved looks: Custom\Atom\Person\Appearance\Decomposed\single\
- Comparison photos: Saves\PluginData\MorphDecomposer\Batch\compare\
- Progress per look (status, time, error in mm, number of morphs): Saves\PluginData\MorphDecomposer\Batch\progress.json
- Logs per look: Saves\PluginData\MorphDecomposer\Batch\logs\
What the converted look contains
The converted look keeps everything else of the original (skin, hair, clothing, other settings). Only the morphs change, and the result holds built-in morphs only:
- custom copies of VaM's own sliders ("knob" morphs such as Jaw Height from the Morphs Mega Pack) are moved to the built-in slider;
- expressions are set to neutral during the fit and are not saved (appearance presets never load them);
- pose knobs (curled fingers, eye or toe rotation) are left out and listed in the log;
- if a custom morph would still be needed, the look is not saved and is marked as failed.
Tips
- Many looks marked "copied"? Their custom morph packages are probably not installed on your system.
- Once converted, a look no longer needs those morph packages: you can use it in any VaM, also a clean one.
- Want to check a result? Load the converted look and press Convert this look: it should say "Nothing to convert: this look has no custom morphs".
- A converted look holds about 700 to 800 built-in morphs with a value. That is normal: the fit spreads the shape over many small values.
- Look at the comparison photos before you use or share results. Most looks match closely; check looks with extreme custom shapes extra carefully.
- A large folder takes many hours (100 looks ≈ 12 h in SPEED, 17 h in QUALITY). Start with SPEED and a short test run, and spread the rest over a few sessions.
- Times depend on your PC and on the look.
- Settings and the chosen folder are saved with the scene.
Notes
- Developed and tested in VaM 1.22 with female characters.
- The plugin only writes inside Custom\Atom\Person\Appearance\Decomposed and Saves\PluginData\MorphDecomposer.
- No dependencies.
- Licence: CC BY-NC-ND.