Fyzikální ovladače z Blenderu

Otočný knoflík (Knob)

Omezená rotace kolem Z, nulová ryska +Y. Kladná rotace vede rysku k Blender lokální +X a runtime lokální −X podle mirror-X převodu.

JoltPhysics Asset Editor 0.31.1 · ověřeno podle zdrojů projektu 27. září 2026.

Nastavení v Blenderu#

Dostupné od addonu 0.18.0; podporované ve verzi 0.31.1. Přidejte typ přes Physical Controls, přiřaďte Key a ponechte scale 1.

Pole / operaceVýznam a validace
Geometrie a pivotPlný válec se středem v montážním bodě; Radius a celková Depth.
PohybOmezená rotace kolem Z, nulová ryska +Y. Kladná rotace vede rysku k Blender lokální +X a runtime lokální −X podle mirror-X převodu.
Počáteční stav a čteníInitial Angle leží v limitech. get_value() je 0 v Min Angle a 1 v Max Angle. Výchozí limity jsou −80° až +80°.
Limity a možnostiLimity musí obsahovat nulu a mít rozsah menší než 180°. Tento prvek má dorazy; pro neomezené otáčení použijte Hand Wheel. Skalární zarážky používají normalizované hodnoty, nikoli stupně.
JSON v3size:{radius,depth}, min_angle, max_angle, initial_angle

Vytvoření z assetu#

Příklad předpokládá načtená data assetu, živé machine_body a autorovaný knob s Key control_main. Přepsání geometrie je volitelné; pro hodnoty z Blenderu settings vynechte.

GML
var settings = jolt_asset_control_settings();
settings.set_radius(0.25);
settings.set_depth(0.12);
settings.set_min_angle(-70);
settings.set_max_angle(80);
settings.set_initial_angle(20);
control = jolt_asset_create_control(asset, "control_main", machine_body, settings);
if (is_undefined(control)) show_debug_message(jolt_get_error_message());
// Step, after the physics update:
if (!is_undefined(control) && control.is_valid()) {
    var value = control.get_value();
}

Chování za běhu#

Živé set_auto_return, set_target, set_resistance, set_detents a set_locked upravují podporované chování. Auto Return má přednost před zarážkami. Mapování výstupu a inverze patří do runtime nastavení. Tyto operace nepřestavují geometrii ani nenahrazují původní konstrukční polohu.

Simulace, vykreslení a životnost#

Použijte stávající smyčku jolt_update() a poté čtěte fyzikální stav ovladače. Vizuální model řiďte přes control.get_transform() nebo stávající vykreslovací API ovladačů. Asset helper vytvoří stejné JoltControl těleso a vazbu jako přímá factory; nevykresluje váš model a nepřiřazuje herní akce. Každé vytvoření je samostatné.

control.destroy() odstraní mechanismus a zachová rodiče. Zničení rodiče a jolt_stop() uklidí připojené ovladače. Používejte spravovanou životnost. Blender integrace ovladačů nevyžaduje další změnu nativního bridge; použijte odpovídající aktuální GML loader a skripty jolt_asset_controls.