Výsuvný úchyt (Pull Handle)

Pull Handle je táhlo, jehož hodnota roste při vysouvání ven z montážního bodu.

jolt_control_pull_handle(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í.

Origin je střed zasunutého táhla. Na rozdíl od Slideru se při rostoucí hodnotě pohybuje podél montážní +Z: 0 znamená zasunuto, 1 plně vysunuto. Používá size a kladný travel; nemá is_pressed(), cap_size ani prahy Button. Konstrukce je jeden pohyblivý box, nikoli teleskopický model.

target je kanonická hodnota 0..1. Samotný set_target() pouze uloží cíl; pohon zapíná auto_return: true nebo set_auto_return(true). Těleso k cíli dojede fyzikálně, není při vytvoření přesunuto do targetu.

Příklad#

handle = jolt_control_pull_handle({
    travel: 0.25,
    auto_return: true,
    target: 0,
    drive: {max_force: 25, frequency: 4, damping: 1}
});
var extension = handle.get_value();

Integrace s aktuálním projektem#

• Výsuvný úchyt — Control Pull Handle›

Nové související postupy#

• Ovládání prvků myší›

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.