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 following

Mesh

• MBLab_human_female
• MBLab_human_male
• MBLab_anime_female
• MBLab_anime_male

Armatures

• MBLab_skeleton_base_fk
• MBLab_skeleton_base_ik
• MBLab_skeleton_muscle_fk
• MBLab_skeleton_muscle_ik

Shaders

Realistic Shaders

• MBlab_pupil
• MBlab_human_teeth
• MBlab_fur
• MBlab_generic
• MBlab_human_eyes
• MBlab_cornea
• MBlab_human_skin

Cell Shaders

• MBlab_toon_black
• MBlab_generic
• MBlab_anime_skin
• MBlab_anime_eyes

FaceRig

• Face_Rig_widgets
• Phenome_rig
• MBLab_skeleton_face_rig

WARNING! Editing humanoid_library.blend can cause irreversible damage! Do not edit unless you know exactly what you are doing!

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

Contains human readable expressions

• excited01.json

expressions_morphs

joints

Contains some kind of data related to joints between bones of the armature, is called by skeletonengine.py

measures

Contains measurement data

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

morphs

pgroups

Polygon Indices?

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_albedo.png

transformations

vertices

Contains vertice info?

• Example - Female Caucaisan

vgroups

Contains vertice group data

• Example - Human Female Base VGroups

• Data seems to be [Polygon Indice, Weight Value]