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.
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žka | Význam / výchozí hodnota |
|---|---|
| size | {radius:0.25, depth:0.08} |
| mass / resistance | 1 kg / 0 N·m |
| periodic_detents / absolute_detents | false / [] |
| 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#
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ík | Signatura | Kontrakt operace |
|---|---|---|
| jolt_control_wheel | jolt_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. |