Úvod · Obsah · kin3 – 3D modely s Kinectem

kin3 – 3D modely s Kinectem

Obsah dokumentace · Provoz – bat soubory · Kalibrace mapování →

Režim kin3 zobrazuje rigovaný 3D model (GLB) a řídí ho pohybem z Kinectu přes stejný bridge jako kin1/kin2. Každý model má vlastní .bat soubor ve složce app\.

Kalibrace: humanoidní modely (CesiumMan, RiggedFigure, GreyFrog Skeleton, KayKit postavy…) je nutné před provozem zkalibrovat – viz samostatná kapitola Kalibrace mapování kin3. Technické zdroje GLB, převod FBX a Mixamo: návod FBX → GLB · 3D modely – zdroje.

Přehled modelů a kalibrace

ModelSpuštěníSoubor GLBKinect humanoidKalibrace
CesiumMan app\start-kin3-cesiumman.bat app\www\assets\models\CesiumMan.glb Ano Ano – nutná
RiggedFigure app\start-kin3-riggedfigure.bat app\www\assets\models\RiggedFigure.glb Ano Ano
RiggedSimple app\start-kin3-riggedsimple.bat app\www\assets\models\RiggedSimple.glb Omezeně Ne
Fox app\start-kin3-fox.bat app\www\assets\models\Fox.glb Ne (animace) Ne
GreyFrog Skeleton app\start-kin3-greyfrogskeleton.bat app\www\assets\models\GreyFrogSkeleton.glb Ano Ano – nutná
KayKit Warrior app\start-kin3-kaykitwarrior.bat app\www\assets\models\KayKit_Skeleton_Warrior.glb Ano Ano
KayKit Mage app\start-kin3-kaykitmage.bat app\www\assets\models\KayKit_Skeleton_Mage.glb Ano Ano
KayKit Rogue app\start-kin3-kaykitrogue.bat app\www\assets\models\KayKit_Skeleton_Rogue.glb Ano Ano
KayKit Minion app\start-kin3-kaykitminion.bat app\www\assets\models\KayKit_Skeleton_Minion.glb Ano Ano
Body Block (Mixamo) app\start-kin3-bodyblock.bat app\www\assets\models\BodyBlock.glb Ano Ano
TurboSquid Lowpoly Skeleton (placený) app\start-kin3-turbosquidskeleton.bat app\www\assets\models\TurboSquid_LowpolySkeleton.glb Ano Ano – po stažení GLB

CesiumMan – humanoid (doporučený test)

Licence: CC-BY 4.0 (Cesium / Khronos) · Velikost: ~430 KB

Plně rigovaná postava s texturou a vestavěnou animací. Vhodná jako hlavní ukázka kin3 na veletrhu nebo v muzeu. Kinect mapuje 20 kloubů na kosti modelu – postava kopíruje pohyb návštěvníka (ruce, nohy, trup, hlava).

  • Spuštění: app\start-kin3-cesiumman.bat
  • Kalibrace: app\start-kin3-kalibrace-cesiumman.bat – viz návod ke kalibraci
  • Kdy použít: produkční demo 3D avatara, prezentace pro zákazníka
  • Poznámka: na hrudi je logo Cesium – u finálního kiosku nahraďte vlastní postavou (např. Mixamo)
  • Ladění: při zrcadlení nastavte "kin3_invert_x": true v kinect.json

RiggedFigure – lehká postava

Licence: CC-BY 4.0 (Khronos) · Velikost: ~50 KB

Jednoduchá rigovaná postava s menším počtem polygonů. Načte se rychleji než CesiumMan – vhodná pro slabší kiosk PC nebo vertikální displej s nižším rozlišením.

  • Spuštění: app\start-kin3-riggedfigure.bat
  • Kalibrace: app\start-kin3-kalibrace-riggedfigure.bat
  • Kdy použít: starší mini PC, dlouhodobý provoz 24/7
  • Výhoda: nižší zátěž GPU, stabilnější snímková frekvence

RiggedSimple – minimální rig (vývoj)

Licence: CC-BY 4.0 (Khronos) · Velikost: ~15 KB

Nejjednodušší humanoidní model pro ověření, že kin3, bridge a WebSocket fungují správně. Ideální první krok po otestování kostry kin1. Kalibrace není potřeba – model má jen dvě kosti.

  • Spuštění: app\start-kin3-riggedsimple.bat
  • Kdy použít: ladění mapování kloubů, test nového PC před instalací Kinect SDK
  • Demo bez senzoru: "kin3_mock_mode": true v configu

Fox – liška (test animace, ne humanoid)

Licence: CC-BY 4.0 (Khronos) · Velikost: ~160 KB

Rigovaná liška se třemi vestavěnými animacemi. Není humanoid – Kinect nedokáže přirozeně řídit čtyřnoží kostru z 20 lidských kloubů. Při spuštění s Kinectem běží vestavěná animace; při sledování návštěvníka se zobrazí zelená kostra v 3D prostoru jako vizuální zpětná vazba.

  • Spuštění: app\start-kin3-fox.bat
  • Kdy použít: test GLB loaderu a animací, atraktivní „maskot“ bez mapování na tělo
  • Pro kiosk s Kinectem: raději CesiumMan, RiggedFigure nebo skeleton packy z itch.io

GreyFrog Skeleton – rigovaná kostra (Halloween)

GreyFrog Skeleton
GreyFrog Skeleton
GreyFrogGames (itch.io), CC-BY 4.0

Licence: CC-BY 4.0 (GreyFrogGames) · Velikost: ~3,1 MB · Zdroj: greyfroggames.itch.io/skeleton (Tier 1 zdarma)

Plně rigovaná 3D kostra s animacemi Idle / Walk / Jump v souboru GLB. Vhodná pro Halloween, muzeum nebo tematický veletrh – návštěvník „obleče“ kostru pohybem těla.

  • Spuštění: app\start-kin3-greyfrogskeleton.bat
  • Kalibrace: app\start-kin3-kalibrace-greyfrogskeleton.bat
  • Výchozí kyčelní kost: Root (ověřte v kalibraci)
  • Kdy použít: atraktivní kiosk bez vlastního 3D modeláře, CC-BY s uvedením autora

Stažení a obnovení modelu: app\setup-skeleton-models.bat nebo návod – skeleton packy z itch.io.

KayKit Skeleton Warrior – stylizovaný válečník

KayKit Warrior
KayKit Warrior
Kay Lousberg / KayKit, CC0

Licence: CC0 (Kay Lousberg) · Velikost: ~360 KB · Zdroj: kaylousberg.itch.io/kaykit-skeletons (Free 1.1)

Low-poly kostra s brněním a zbraněmi. Lehký model, dobře čitelný na displeji z dálky. Doporučená první volba z KayKit balíčku pro kalibraci a provoz.

  • Spuštění: app\start-kin3-kaykitwarrior.bat
  • Kalibrace: app\start-kin3-kalibrace-kaykitwarrior.bat
  • Výchozí kyčelní kost: hips
  • Kosti rigu: upperarm.l, lowerarm.l, upperleg.l… (malá písmena)

KayKit Skeleton Mage – mág

KayKit Mage
KayKit Mage
Kay Lousberg / KayKit, CC0

Licence: CC0 · Soubor: KayKit_Skeleton_Mage.glb

  • Spuštění: app\start-kin3-kaykitmage.bat
  • Kalibrace: app\start-kin3-kalibrace-kaykitmage.bat
  • Kdy použít: fantasy téma, varianta postavy vedle Warrior

KayKit Skeleton Rogue – lučištník

KayKit Rogue
KayKit Rogue
Kay Lousberg / KayKit, CC0

Licence: CC0 · Soubor: KayKit_Skeleton_Rogue.glb

  • Spuštění: app\start-kin3-kaykitrogue.bat
  • Kalibrace: app\start-kin3-kalibrace-kaykitrogue.bat

KayKit Skeleton Minion – základní kostra

KayKit Minion
KayKit Minion
Kay Lousberg / KayKit, CC0

Licence: CC0 · Soubor: KayKit_Skeleton_Minion.glb

  • Spuštění: app\start-kin3-kaykitminion.bat
  • Kalibrace: app\start-kin3-kalibrace-kaykitminion.bat
  • Kdy použít: nejlehčí KayKit varianta pro slabší PC

Body Block – vlastní postava z Mixamo

Licence: Mixamo / Adobe · Soubor: BodyBlock.glb

Vlastní humanoid stažený z Mixamo a převedený z FBX na GLB. Registrace a převod: návod FBX → GLB.

  • Spuštění: app\start-kin3-bodyblock.bat
  • Kalibrace: app\start-kin3-kalibrace.bat bodyblock
  • Výchozí kyčelní kost: mixamorig:Hips

TurboSquid Lowpoly Skeleton – placená anatomická kostra

3D Lowpoly Human Skeleton Rigged
Základní model · Product 1907610

Licence: TurboSquid Standard License (placený) · id v kin3: turbosquidskeleton · Model není v balíčku – po zakoupení převedete FBX na GLB.

  • Soubor GLB: app\www\assets\models\TurboSquid_LowpolySkeleton.glb
  • Příprava: app\setup-turbosquid-skeleton.bat
  • Spuštění: app\start-kin3-turbosquidskeleton.bat
  • Kalibrace: app\start-kin3-kalibrace-turbosquidskeleton.bat
  • Výchozí kyčelní kost: Hips

Kompletní návod (nákup, stažení, katalog dalších modelů Anatomy, licence, krok za krokem): turbosquid-anatomie.php

Nastavení kin3 v kinect.json

PoleVýznam
kin3_ws_urlWebSocket bridge (výchozí ws://127.0.0.1:8765)
kin3_modelVýchozí model (cesiumman) – bat soubor model přepíše parametrem
kin3_invert_x / kin3_invert_yZrcadlení os
kin3_smoothVyhlazení pohybu 1–10
kin3_mock_modetrue = demo animace bez Kinectu

Postup prvního spuštění kin3

  1. Ověřte kin1 – musí reagovat na pohyb (nebo zapněte mock mode).
  2. Kalibrace (doporučeno u humanoidních modelů): spusťte příslušný bat kalibrace (CesiumMan, GreyFrog Skeleton, KayKit…) – podrobně v kapitole Kalibrace – postup krok za krokem.
  3. Dvojklik na bat vybraného modelu (např. app\start-kin3-greyfrogskeleton.bat nebo app\start-kin3-kaykitwarrior.bat).
  4. Počkejte na načtení 3D modelu a badge „Kinect připojen“.
  5. Postavte se 1,5–2,5 m od senzoru – postava by měla kopírovat pohyb.
  6. Ukončení: Ctrl+Shift+Q.

Problémy s pohybem modelu, prázdnou obrazovkou kalibrace nebo špatným mapováním kloubů: Řešení problémů.