Tlačítko (Button)

Button je krátké lineární tlačítko se samostatným stavem stisku a hysterezí.

jolt_control_button(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 uvolněného víčka. +Z míří ven, stisk probíhá podél −Z; get_value() vrací 0 v klidu a 1 na konci dráhy. is_pressed() sepne při dosažení pressed_threshold a vypne až při poklesu na released_threshold. Platí 0 ≤ released_threshold < pressed_threshold ≤ 1. Tato metoda existuje pouze u Button.

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#

button = jolt_control_button({auto_return: true, target: 0});
// Po simulaci; was_pressed inicializujte jednou na false.
var pressed = button.is_pressed();
if (pressed && !was_pressed) show_debug_message("Activate");
was_pressed = pressed;

Integrace s aktuálním projektem#

• Tlačítko — Control Button›

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.