Posuvník (Slider)
Slider je analogový posuvník na přímé dráze bez samostatného stavu stisku.
| Položka | Význam / výchozí hodnota |
|---|---|
| initial_value | Skutečná počáteční poloha 0..1; výchozí 0. |
jolt_control_slider(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 | {x:0.2, y:0.2, z:0.1} |
| mass / travel | 1 kg / 1 m |
| auto_return / target | false / 0.5 |
| drive | {max_force:20, frequency:4, damping:1} |
| detents | [] |
Origin je střed posuvníku na začátku dráhy. Hodnota roste od 0 do 1 při pohybu podél montážní −Z, travel musí být kladný. Factory vytváří jen pohyblivý box a vedení constraintem; kolejnici si vykreslete samostatně. cap_size a prahy Button nejsou podporované.
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#
slider = jolt_control_slider({
travel: 0.4,
rotation: {x: 0, y: -0.70710678, z: 0, w: 0.70710678},
output: {min: 0, max: 100},
resistance: 2
});
var volume_percent = slider.get_output_value();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_slider | jolt_control_slider(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. Posuv: size .2/.2/.1 m, mass1 kg, travel1 m, target.5, auto_return false. |