MB Lab Developer Guide

This is the start of a reference for MB-Lab internals, where each sections is described (as best we can tell) what MB-Lab does and why.

MB-Lab Modules

---

_ init _.py

This is the core of the addon.

• UI Elements

---

algorithms.py

Contains various functions for every engine.

---

animationengine.py

Handles the animation import and assigning to skeleton...

• Retargeting
• Identifies Bones
• Similar functions (expand)
• Loads BVH files, saves and loads poses.

---

humanoid.py

Handles much of the character changing functions including Auto-Modelling.

---

materialengine.py

This is where the image textures get loaded and applied to nodes

---

morphengine.py

This is where the morphs of the character are loaded from JSON files

---

proxyengine.py

Handles the Proxy Fitting functions

---

skeletonengine.py

Loads and applies the skeleton (either FK or IK) to the character

---

MB-Lab Data

---

humanoid_library.blend

Contains the base models, skeletons and shaders for MB-Lab

---

characters_config.json

The base models, textures and JSON data are referenced from this file

Example (Female Caucasian data)

https://github.com/animate1978/MB-Lab/blob/00e91d33012924c2f2276b3a7ab9cd2327cedad1/data/characters_config.json#L61

---

retarget_knowledge.json

Retargetting data

---

anthropometry

assets

Contain the demo hair asset files plus texture maps

bboxes

(?) Bounding Box?

expressions_comb

expressions_morphs

joints

measures

morphs

pgroups

phenotypes

Morphs for each base model that change the character based on geographic location

poses

Pose JSON files for each base model

presets

Morphs to describe different body types

textures

The texture maps for MB-Lab

transformations

vertices

vgroups