Pomocné skripty · Fyzické ovládací prvky

Ruční kolo (Hand Wheel)

Wheel je soustředné otočné kolo bez koncových dorazů s průběžným počítáním otáček.

GML
jolt_control_wheel(options=undefined)

Před vytvořením zavolejte jolt_start(). Každá factory přijímá jeden volitelný options struct a vrací JoltControl, při chybě undefined. Společné options: parent, position/rotation nebo local_position/local_rotation, mass, resistance a output. Rozměry jsou celé délky v metrech, hmotnost v kg; úhly tohoto API jsou ve stupních. Detaily společného nastavení najdete v kapitole Uchycení, velikost a vykreslování.

PoložkaVýznam / výchozí hodnota
size{radius:0.25, depth:0.08}
mass / resistance1 kg / 0 N·m
periodic_detents / absolute_detentsfalse / []
speed_motor / position_motor / phase_motor / torque_mode{enabled:false}

Origin, pivot a těžiště splývají. Kladný úhel sleduje pravidlo pravé ruky kolem lokální +Z. Po vytvoření je logický úhel 0. get_value() je fáze 0..1 s přechodem zpět na 0 při celé otáčce; pro neomezenou polohu používejte get_angle() a get_turns().

Wheel a Crank přijímají periodic_detents, absolute_detents, speed_motor, position_motor, phase_motor a torque_mode. Ve výchozím stavu jsou všechny vypnuté. Nepřijímají auto_return, target, drive, detents, min_angle, max_angle, initial_phase ani initial_turns. Použijte příslušné metody kontinuálního pohonu.

Příklad#

GML
wheel = jolt_control_wheel({
    speed_motor: {speed: 90, max_torque: 5},
    resistance: 0.1
});
var angle_degrees = wheel.get_angle();
var speed_degrees_per_second = wheel.get_speed();

Integrace s aktuálním projektem#

Nové související postupy#

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íkSignaturaKontrakt operace
jolt_control_wheeljolt_control_wheel(options=undefined)Vyžaduje managed svět, options volitelné, vrací vlastněný JoltControl nebo undefined. Bez parent světové position/rotation; s parent místní local_position/local_rotation, nekombinuj. Wheel: radius.25/depth.08m, mass1kg, volná osa +Z; motory/detents vypnuté. Žádné scalar auto_return/target/min/max.