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.

• Function calls
• UI Elements

---

algorithms.py

Contains various functions for every engine.

Example - https://github.com/animate1978/MB-Lab/blob/3994f37e33699bd0d082a4f9f076724e4f0d40ba/algorithms.py#L1332

---

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 Caucasion data entry

---

retarget_knowledge.json

Retargetting data

---

anthropometry

Contains measurement data for male and female base models

assets

Contains the demo asset files, as well as associated texture maps.

bboxes

(?) Bounding Box?

expressions_comb

excited01.json

expressions_morphs

joints

measures

https://github.com/animate1978/MB-Lab/blob/master/data/measures/human_female_measures.json

morphs

pgroups

phenotypes

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

Example euroartic.json

poses

Pose JSON files for each base model

Example glamour02.json

presets

Morphs to describe different body types

Example type_common01.json

textures

The texture maps for MB-Lab

Example human_female_diffuse.png

transformations

vertices

vgroups