Aktuální projekt
Výběr měkkého tělesa
Procedurální a importovaná látka jsou otevřené plochy. Koule a uzavřený importovaný model jsou tlakové pláště. Procedurální kvádr má vnitřní částice a tetraedrické objemové vazby. Vybírejte podle fyzikálního chování, nikoli vzhledu.
Použití a omezení#
Spusťte Jolt, vytvořte/nastavte objekt před prvním krokem a jednou registrujte BBMOD renderer. Ponechte stávající jolt_update; síť se obnovuje podle fyzikální revize a sdílí mezi renderovacími průchody. Vykreslování nepotřebuje druhou aktualizaci fyziky.
Používejte settery objektu; veřejné továrny nastavení byly odstraněny. get_position průměruje polohy částic. Deformovaný objekt nemá jedinou pevnou rotaci popisující celý tvar. Společné funkce zahrnují úchyty, volitelné Carry, lokální síly a vítr. Samokolize, trhání a kolize Soft Body–Soft Body nejsou dodány.
destroy()/jolt_stop uklidí fyziku, úchyty a vlastní renderovací buffery. Půjčené materiály/textury musí zůstat platné do konce vykreslování; vlastní zdrojové prostředky ukliďte potom.
Přehled API#
Signatury veřejných funkcí a metod. Metody volejte na vrácené instanci; parametry s výchozí hodnotou jsou volitelné.
Související návody#
- Převod staršího kódu
- Měkká koule
- Objemový měkký kvádr
- Import uzavřeného modelu
- Látkový model a pojmenované úchyty
- Prostorové úchyty
- Oddělená vizuální síť
- Lokální síla a impulz
- Vítr
- Přenášení měkkých těles
Ověřené kontrakty operací#
Následující kontrakty rozlišují jednotky, návratové hodnoty, chyby a životnost podle aktuální implementace. Nevynechávej kontrolu výsledku: false, 0 a undefined mohou mít u různých metod odlišný význam.
| Symbol / vlastník | Signatura | Kontrakt operace |
|---|---|---|
| JoltBBMODSoftBody.add_force | JoltBBMODSoftBody.add_force(x,y,z) | Konečné světové složky síly x/y/z v N; Boolean. Předává celkovou sílu nativnímu soft body, není to lokální výběr částic. Pro lokální účinek použij jolt_soft_body_force. |
| JoltBBMODSoftBody.destroy | JoltBBMODSoftBody.destroy() | Boolean, opakovaně true po úspěšném zničení. Nejprve odstraní fyziku, pak registraci rendereru, vlastní meshe/materiály, attachmenty, wind a force helpery. Vypůjčené materiály ani hostitelská tělesa neničí. |
| JoltBBMODSoftBody.draw | JoltBBMODSoftBody.draw() | Vykreslí aktuální deformovanou geometrii, pokud je objekt živý a viditelný; bez návratové hodnoty. draw je alias render. Při registraci v rendereru je navíc ručně nevolej. |
| JoltBBMODSoftBody.get_collision_thickness | JoltBBMODSoftBody.get_collision_thickness() | Aktuální poloměr částice v m; undefined při neplatném wrapperu, nativní chybu kontroluj zvlášť. |
| JoltBBMODSoftBody.get_damping | JoltBBMODSoftBody.get_damping() | Lineární tlumení: aktuální číslo v 1/s. Selhání: undefined (invalid wrapper); inspect native errors separately; neplatný objekt není nulové měření. |
| JoltBBMODSoftBody.get_friction | JoltBBMODSoftBody.get_friction() | Součinitel tření: aktuální číslo v bezrozměrné stupnici. Selhání: undefined (invalid wrapper); inspect native errors separately; neplatný objekt není nulové měření. |
| JoltBBMODSoftBody.get_gravity_factor | JoltBBMODSoftBody.get_gravity_factor() | Násobek gravitace: aktuální číslo v bezrozměrné stupnici. Selhání: undefined (invalid wrapper); inspect native errors separately; neplatný objekt není nulové měření. |
| JoltBBMODSoftBody.get_layer | JoltBBMODSoftBody.get_layer() | Vrací číselný handle vrstvy, nikoliv JoltLayer; undefined při neplatném wrapperu. |
| JoltBBMODSoftBody.get_mass | JoltBBMODSoftBody.get_mass() | Celková hmotnost: aktuální číslo v kg. Selhání: undefined; neplatný objekt není nulové měření. |
| JoltBBMODSoftBody.get_native_handle | JoltBBMODSoftBody.get_native_handle() | Platný soft-body handle, jinak 0. Nejde o JoltBody handle pro rigid metody. |
| JoltBBMODSoftBody.get_position | JoltBBMODSoftBody.get_position() | Světový průměr pozic částic {x, y, z} v m, nikoliv rigid transform; undefined při neplatném wrapperu. |
| JoltBBMODSoftBody.get_stretch | JoltBBMODSoftBody.get_stretch() | Tuhost natažení: aktuální číslo v bezrozměrné stupnici. Selhání: undefined; neplatný objekt není nulové měření. |
| JoltBBMODSoftBody.get_vertex_position | JoltBBMODSoftBody.get_vertex_position(index) | Celočíselný index 0 ≤ index < vertex_count. Vrací světové {x, y, z} v m, při neplatném indexu/wrapperu undefined. |
| JoltBBMODSoftBody.get_volume | JoltBBMODSoftBody.get_volume() | Objem v m³ z aktuální deformace; otevřená modelová látka vrací 0. undefined při neplatném objektu nebo selhání čtení. |
| JoltBBMODSoftBody.is_valid | JoltBBMODSoftBody.is_valid() | Boolean podle wrapperu, handle a původního managed světa. Není to dotaz na existenci každé nativní částice; nemíchej ruční raw destrukci s managed vlastnictvím. |
| JoltBBMODSoftBody.render | JoltBBMODSoftBody.render() | Vykreslí aktuální deformovanou geometrii, pokud je objekt živý a viditelný; bez návratové hodnoty. draw je alias render. Při registraci v rendereru je navíc ručně nevolej. |
| JoltBBMODSoftBody.set_collision_thickness | JoltBBMODSoftBody.set_collision_thickness(v) | Poloměr kolize částice v m, konečný ≥0. Horní mez: poloměr Sphere, polovina nejmenšího rozměru Box, polovina nejkratší hrany modelu. Boolean; výchozí 0.02 Sphere/Box, model 0.01 nebo menší hodnota přizpůsobená hraně při vynechání options. |
| JoltBBMODSoftBody.set_damping | JoltBBMODSoftBody.set_damping(v) | Lineární tlumení: konečné číslo 0..1000 1/s; výchozí 0.1 Sphere, 0.5 Box, 0.2 closed model / 0.1 model cloth. Vrací true při přijetí, false při neplatném vstupu nebo neplatném objektu. Mění živý objekt. |
| JoltBBMODSoftBody.set_debug | JoltBBMODSoftBody.set_debug(v) | Zapne diagnostické vykreslení, výchozí false; vrací true. Nemění fyziku ani životnost objektu. |
| JoltBBMODSoftBody.set_friction | JoltBBMODSoftBody.set_friction(v) | Součinitel tření: konečné číslo 0..1000 ; výchozí 0.5. Vrací true při přijetí, false při neplatném vstupu nebo neplatném objektu. Mění živý objekt. |
| JoltBBMODSoftBody.set_gravity_factor | JoltBBMODSoftBody.set_gravity_factor(v) | Násobek gravitace: konečné číslo 0..1000 ; výchozí 1. Vrací true při přijetí, false při neplatném vstupu nebo neplatném objektu. Mění živý objekt. |
| JoltBBMODSoftBody.set_layer | JoltBBMODSoftBody.set_layer(layer) | JoltLayer nebo kladný celočíselný handle vrstvy; vrstva musí existovat v tomto světě. Boolean. Nemění kolizní matici vrstev. |
| JoltBBMODSoftBody.set_mass | JoltBBMODSoftBody.set_mass(v) | Celková hmotnost: konečné číslo 0.01..1000000 kg; výchozí 2 (Sphere/Box), 2 closed model / 1 model cloth. Vrací true při přijetí, false při neplatném vstupu nebo neplatném objektu. Mění živý objekt. |
| JoltBBMODSoftBody.set_material | JoltBBMODSoftBody.set_material(material) | BBMOD_BaseMaterial nebo undefined pro automatický vlastní oboustranný materiál. Boolean; uživatelský materiál se vypůjčuje a neničí, předchozí vlastní materiál se uvolní. |
| JoltBBMODSoftBody.set_renderer | JoltBBMODSoftBody.set_renderer(renderer) | Živý BBMOD_BaseRenderer nebo undefined pro odpojení. Boolean; registruje/odregistruje tentýž objekt, nepřidávej jej navíc ručně. Vyžaduje živé soft body. |
| JoltBBMODSoftBody.set_stretch | JoltBBMODSoftBody.set_stretch(v) | Tuhost natažení: konečné číslo 0..1 ; výchozí 0.8 Sphere/closed model, 0.3 Box, 0.9 model cloth. Vrací true při přijetí, false při neplatném vstupu nebo neplatném objektu. Mění živý objekt. |
| JoltBBMODSoftBody.set_visible | JoltBBMODSoftBody.set_visible(value) | Převod vstupu na Boolean, výchozí true. Vrací Boolean úspěchu. Skryje render, nevypne fyziku. |
| JoltBBMODSoftBody.update_mesh | JoltBBMODSoftBody.update_mesh(force=false) | Boolean úspěchu; force=false využívá cache fyzikální revize. force=true vynutí aktualizaci i při ručním native kroku. Pozice jsou již světové, nepřidávej znovu transformační matici tělesa. |