Repository navigation
3 Adding New Bones and Blender Workflow
OpenVetAtlas Android (oVa) uses a non-destructive pipeline where source .fbx files inside Assets/Models/Bones/ are treated as strictly READ-ONLY. Anatomical landmarks are read directly from child Node3D (Blender Empty) objects inside the .fbx hierarchy at runtime.
- Open your 3D bone mesh in Blender and center/orient its origin cleanly.
- For each anatomical landmark, create an Empty (
Plain Axes) parented to the main bone mesh object. - Name each Empty with its Latin anatomical term (e.g.,
caput humeri,tuberculum majus,foramen infraorbitale).-
Paired / Duplicate Structures: If an anatomical structure appears at two points on the same bone (such as cranial and caudal
facies serrataon the scapula, or left and rightcondylus occipitalison the cranium), both Empties are preserved as separate 3D spheres and automatically grouped under a single canonical term (Facies serrata (×2)).
-
Paired / Duplicate Structures: If an anatomical structure appears at two points on the same bone (such as cranial and caudal
- Export the model as
.fbx(and its optional texture.png) into:Assets/Models/Bones/
All raw node names from Blender are resolved through Assets/data/landmark_dictionary.json into canonical Nomina Anatomica Veterinaria (NAV) Latin terms:
{
"version": "2.1",
"aliases_and_typos": {
"tubeculum majoris": "tuberculum_majus",
"condylus occipitalis": "condylus_occipitalis"
},
"landmarks": {
"caput_humeri": {
"latin": "Caput humeri"
},
"condylus_occipitalis": {
"latin": "Condylus occipitalis"
}
}
}To verify that every landmark in your new .fbx file maps cleanly with zero unmapped nodes, run:
godot --headless --import
godot --headless --quit -s res://scripts/dump_fbx_landmarks.gdOpen src/ui/atlas_main_controller.gd and add your new bone (or a new animal taxon such as Ruminantia) to TAXON_CATALOG:
const TAXON_CATALOG: Array[Dictionary] = [
{
"taxon_id": "canidae",
"latin_title": "Canidae",
"specimens": [
{
"id": "dog_humerus",
"latin_title": "Humerus",
"path": "res://Assets/Models/Bones/Dog_humerus.fbx",
"texture_path": ""
},
# Add new Canidae bones here...
]
},
{
"taxon_id": "equidae",
"latin_title": "Equidae",
"specimens": [
{
"id": "horse_cranium",
"latin_title": "Cranium",
"path": "res://Assets/Models/Bones/horse_cranium.fbx",
"texture_path": "res://Assets/Models/Bones/horse_cranium.png"
}
]
}
]The TopBar TaxonSelector, BoneSelector, 3D surface sphere spawner, camera auto-framing, and Quiz Mode will automatically include the new entry without any scene or UI code changes!
OpenVetAtlas Android (oVa) — Aydın Adnan Menderes Üniversitesi Veteriner Fakültesi Anatomi Anabilim Dalı (DijiLab) | ADÜ-BAP — Code: AGPL-3.0 | 3D Models & Textures: CC BY-NC-SA 4.0
- 🏠 Home / Genel Bakış
-
📱 1. User Guide & Touch Controls
- Dokunmatik Kontroller & Quiz
-
⚙️ 2. Architecture & Optimization
- Mimari & Mobil Optimizasyon
-
🦴 3. Adding Bones & Landmarks
- Yeni Tür, Kemik & Pin Ekleme
-
📦 4. APK Build & Installation
- APK Derleme & Cihaza Kurulum
Links / Bağlantılar