Pomocné skripty · Fyzické ovládací prvky

Posuvník (Slider)

Slider je analogový posuvník na přímé dráze bez samostatného stavu stisku.

PoložkaVýznam / výchozí hodnota
initial_valueSkutečná počáteční poloha 0..1; výchozí 0.
GML
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žkaVýznam / výchozí hodnota
size{x:0.2, y:0.2, z:0.1}
mass / travel1 kg / 1 m
auto_return / targetfalse / 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#

GML
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íkSignaturaKontrakt operace
jolt_control_sliderjolt_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.