UI Slider: Difference between revisions

From GiderosMobile
No edit summary
 
(9 intermediate revisions by 2 users not shown)
Line 2: Line 2:
Here you will find various resources to help you create sliders in Gideros Studio.
Here you will find various resources to help you create sliders in Gideros Studio.


'''note''':You may have to provide your own assets (fonts, gfx, …)
'''note''': You may have to provide your own assets (fonts, gfx, …)


=== Slider ===
=== Slider ===
<source lang="lua">
<syntaxhighlight lang="lua">
-- UI Slider class
-- UI Slider class
Slider = Core.class(Sprite)
Slider = Core.class(Sprite)
Line 76: Line 76:
--stage:addChild(myslider)
--stage:addChild(myslider)
--slider:setValue(75)
--slider:setValue(75)
</source>
</syntaxhighlight >


=== Slider with Increments ===
=== Another Slider ===
<source lang="lua">
You can download the ASlider Class here: '''[[Media:Aslider.lua]] (tip: right click and save link as)'''
Slider2 = Core.class(Sprite)


function Slider2:init(xparams)
'''You can rotate it as well (0 and 90° work best)'''
local params = xparams or {}
<syntaxhighlight lang="lua">
params.maximum = xparams.maximum or 100
--[[
params.steps = xparams.steps or params.maximum
-- ASlider
params.slitcolor = xparams.slitcolor or 0x0
-- mokalux, cc0, AI
params.slitalpha = xparams.slitalpha or 1
-- Slith, Knob, steps, text, ...
params.slitw = xparams.slitw or 64
v 0.1.0: 2026-10-10 AI correcting my mistakes (memory leaks)
params.slith = xparams.slith or 64
v 0.0.1: 2024-04-23 my take on a ui slider (no AI)
params.knobcolor = xparams.knobcolor or 0xffffff
]]
params.knobalpha = xparams.knobalpha or 1
params.knobw = xparams.knobw or 32
params.knobh = xparams.knobh or 32
-- parametrable slit and knob
local slit = Pixel.new(params.slitcolor, params.slitalpha, params.slitw, params.slith)
slit:setAnchorPoint(0, 0.5)
local knob = Pixel.new(params.knobcolor, params.knobalpha, params.knobw, params.knobh)
knob:setAnchorPoint(0.5, 0.5)
-- order
self.width = slit:getWidth()
self:addChild(slit)
self.knob = knob
self:addChild(self.knob)
-- class variables
self.maximum = params.maximum
self.steps = params.steps
self.value = 0
self.isFocus = false
-- event listeners
self:addEventListener(Event.MOUSE_DOWN, self.onMouseDown, self)
self:addEventListener(Event.MOUSE_MOVE, self.onMouseMove, self)
self:addEventListener(Event.MOUSE_UP, self.onMouseUp, self)
end


-- events
-- Class
function Slider2:onMouseDown(event)
ASlider = Core.class(Sprite) -- integers only slider
if self:hitTestPoint(event.x, event.y) then
local x, y = self:globalToLocal(event.x, event.y)
self.isFocus = true
self.knob:setX(self:setRange(x, self.steps))


self.value = self:round(self.maximum * self.knob:getX() / self.width)
local floor = math.floor
local e = Event.new("value_changed")
e.value = self.value
self:dispatchEvent(e)


event:stopPropagation()
local function round(val, n)
end
if (n) then return floor( (val * 10^n)+0.5 ) / (10^n)
end
else return floor(val+0.5)
 
function Slider2:onMouseMove(event)
if self.isFocus then
local x, y = self:globalToLocal(event.x, event.y)
self.knob:setX(self:setRange(x, self.steps))
 
self.value = self:round(self.maximum * self.knob:getX() / self.width)
local e = Event.new("value_changed")
e.value = self.value
self:dispatchEvent(e)
 
event:stopPropagation()
end
end
 
function Slider2:onMouseUp(event)
if self.isFocus then
self.isFocus = false
event:stopPropagation()
end
end
end
end


-- functions
function ASlider:init(xparams)
function Slider2:setValue(value)
local value = math.floor(value)
-- check within a range of [0, max]
if value < 0 then value = 0 end
if value > self.maximum then value = self.maximum end
local posX = self.width * value / self.maximum
self.knob:setPosition(posX, 0)
self.value = value
end
 
function Slider2:setRange(x, xstep)
for s = 0, self.width do
if x <= 0 then
return 0
elseif x >= s * self.width / xstep and x <= (s + 1) * self.width / xstep then
return s * self.width / xstep
elseif x >= self.width then
return self.width
end
end
end
 
function Slider2:round(num)
return num + (2^52 + 2^51) - (2^52 + 2^51)
end
 
--[[
---- usage
-- bg
application:setBackgroundColor(0x333333)
-- a volume slider
local volumeslider = Slider2.new({
maximum=20, steps=4,
slitcolor=0x330033, slitalpha=1, slitw=512 - 64 * 2, slith=48,
knobcolor=0xff00ff, knobalpha=0.7, knobw=40, knobh=30,
})
volumeslider:setValue(10)
tfsfxvolume = TextField.new(nil, "VOLUME: "..volumeslider.value)
tfsfxvolume:setScale(4)
tfsfxvolume:setTextColor(0xffffff)
-- positions
tfsfxvolume:setPosition(64, 128)
volumeslider:setPosition(64, 196)
-- order
stage:addChild(tfsfxvolume)
stage:addChild(volumeslider)
-- listeners
function onVolumeValueChanged(ev)
tfsfxvolume:setText("VOLUME: "..ev.value)
g_sfxvolume = ev.value
end
volumeslider:addEventListener("value_changed", onVolumeValueChanged)
]]
</source>
 
=== Slider with Text (Increments) ===
'''You can rotate it as well (0 and 90° work best)'''
<source lang="lua">
SliderText = Core.class(Sprite)
 
function SliderText:init(xparams)
local params = xparams or {}
local params = xparams or {}
params.initialvalue = xparams.initialvalue or 0
params.slitw = xparams.slitw or 64
params.maximum = xparams.maximum or 100
params.slith = xparams.slith or 64
params.steps = xparams.steps or params.maximum
params.slitcolor = xparams.slitcolor or 0x0
params.slitcolor = xparams.slitcolor or 0x0
params.slitalpha = xparams.slitalpha or 1
params.slitalpha = xparams.slitalpha or 1
params.slitw = xparams.slitw or 64
params.knobw = xparams.knobw or 32
params.slith = xparams.slith or 64
params.knobh = xparams.knobh or 32
params.knobcolor = xparams.knobcolor or 0xffffff
params.knobcolor = xparams.knobcolor or 0xffffff
params.knobalpha = xparams.knobalpha or 1
params.knobalpha = xparams.knobalpha or 1
params.knobw = xparams.knobw or 32
params.minimum = xparams.minimum or 0
params.knobh = xparams.knobh or 32
params.maximum = xparams.maximum or 100
params.initvalue = xparams.initvalue or params.minimum
params.steps = xparams.steps or (params.maximum - params.minimum)
params.text = xparams.text or nil
params.text = xparams.text or nil
params.showvalue = xparams.showvalue or nil
params.font = xparams.font or nil
params.font = xparams.font or nil
params.textscale = xparams.textscale or 1
params.textscale = xparams.textscale or 1
Line 239: Line 130:
self.knob = Pixel.new(params.knobcolor, params.knobalpha, params.knobw, params.knobh)
self.knob = Pixel.new(params.knobcolor, params.knobalpha, params.knobw, params.knobh)
self.knob:setAnchorPoint(0.5, 0.5)
self.knob:setAnchorPoint(0.5, 0.5)
-- text
-- textfield
self.textfield = TextField.new(params.font, params.text)
if params.text and params.showvalue then
self.textfield:setRotation(params.textrotation)
self.textfield = TextField.new(params.font, params.text.." \e[color=#ddc]"..params.initvalue.."\e[color]")
self.textfield:setScale(params.textscale)
elseif params.text then
self.textfield:setTextColor(params.textcolor)
self.textfield = TextField.new(params.font, params.text)
elseif params.showvalue then
self.textfield = TextField.new(params.font, "\e[color=#ddc]"..params.initvalue.."\e[color]")
end
-- order
-- order
self:addChild(self.slit)
self:addChild(self.slit)
self:addChild(self.knob)
self:addChild(self.knob)
self:addChild(self.textfield)
if self.textfield then
-- positions
self.textfield:setRotation(params.textrotation)
self.textfield:setPosition(self.slit:getX() + params.textoffsetx, self.slit:getY() + params.textoffsety)
self.textfield:setScale(params.textscale)
self.textfield:setTextColor(params.textcolor)
self.textfield:setPosition(self.slit:getX() + params.textoffsetx, self.slit:getY() + params.textoffsety)
self:addChild(self.textfield)
end
-- class variables
-- class variables
self.value = params.initialvalue
self.minimum = params.minimum
self.maximum = params.maximum
self.maximum = params.maximum
-- if self.minimum >= self.maximum then self.maximum = self.minimum + 100 end -- XXX
if self.minimum >= self.maximum then
print("ASlider minimum: "..self.minimum.." equals to maximum: "..self.maximum)
self.maximum = self.minimum + self.maximum
end
self.steps = params.steps
self.steps = params.steps
self.width = self.slit:getWidth()
self.value = params.initvalue
self.width = params.slitw
self.text = params.text
self.text = params.text
self.showvalue = params.showvalue
self.isFocus = false
self.id = params.id
self.id = params.id
self.isFocus = false
-- let's go!
self.textfield:setText(self.text..self.value)
self:setValue(self.value)
-- event listeners
-- event listeners
self:addEventListener(Event.MOUSE_DOWN, self.onMouseDown, self)
self:addEventListener(Event.MOUSE_DOWN, self.onMouseDown, self)
self:addEventListener(Event.MOUSE_MOVE, self.onMouseMove, self)
self:addEventListener(Event.MOUSE_MOVE, self.onMouseMove, self)
self:addEventListener(Event.MOUSE_UP, self.onMouseUp, self)
self:addEventListener(Event.MOUSE_UP, self.onMouseUp, self)
-- let's go!
self:setValue(self.value)
end
-- helper function
function ASlider:calculateKnobPosition(x)
if x <= 0 then return self.minimum end
if x >= self.width then return self.maximum end
-- 1. Track percentage across visual slider width
local pct = x / self.width
-- 2. Snap to nearest available stepped interval percentage
local nearestStep = floor((pct * self.steps) + 0.5)
local snappedPct = nearestStep / self.steps
-- 3. Interpolate the percentage against actual numerical range bounds
local valueRange = self.maximum - self.minimum
local calculatedValue = self.minimum + (snappedPct * valueRange)
return round(calculatedValue, 3)
end
end


-- events
-- events
function SliderText:onMouseDown(event)
function ASlider:onMouseDown(event)
-- if self:hitTestPoint(event.x, event.y) then
if self.slit:hitTestPoint(event.x, event.y) or self.knob:hitTestPoint(event.x, event.y) then
if self.slit:hitTestPoint(event.x, event.y) or self.knob:hitTestPoint(event.x, event.y) then
local x, y = self:globalToLocal(event.x, event.y)
local localX, _ = self:globalToLocal(event.x, event.y)
self.isFocus = true
self.isFocus = true
self.knob:setX(self:setRange(x, self.steps))
 
local targetValue = self:calculateKnobPosition(localX)
self.value = self:round(self.maximum * self.knob:getX() / self.width)
self:setValue(targetValue)
local e = Event.new("value_changed")
local e = Event.new("value_just_changed")
e.value = self.value
e.value = self.value
e.id = self.id
e.id = self.id
self:dispatchEvent(e)
self:dispatchEvent(e)
self.textfield:setText(self.text..self.value)
event:stopPropagation()
event:stopPropagation()
end
end
end
end


function SliderText:onMouseMove(event)
function ASlider:onMouseMove(event)
if self.isFocus then
if self.isFocus then
local x, y = self:globalToLocal(event.x, event.y)
local localX, _ = self:globalToLocal(event.x, event.y)
self.knob:setX(self:setRange(x, self.steps))
 
local targetValue = self:calculateKnobPosition(localX)
self.value = self:round(self.maximum * self.knob:getX() / self.width)
self:setValue(targetValue)
local e = Event.new("value_changed")
local e = Event.new("value_changing")
e.value = self.value
e.value = self.value
e.id = self.id
e.id = self.id
self:dispatchEvent(e)
self:dispatchEvent(e)
self.textfield:setText(self.text..self.value)
event:stopPropagation()
event:stopPropagation()
end
end
end
end


function SliderText:onMouseUp(event)
function ASlider:onMouseUp(event)
if self.isFocus then
if self.isFocus then
self.isFocus = false
self.isFocus = false
local e = Event.new("value_changed")
e.value = self.value
e.id = self.id
self:dispatchEvent(e)
event:stopPropagation()
event:stopPropagation()
end
end
end
end


-- functions
-- function
function SliderText:setValue(xvalue)
function ASlider:setValue(xvalue)
local value = math.floor(xvalue)
-- Clamp values safely inside bounds
-- check within a range of [0, max]
if xvalue < self.minimum then xvalue = self.minimum end
if value < 0 then value = 0 end
if xvalue > self.maximum then xvalue = self.maximum end
if value > self.maximum then value = self.maximum end
self.value = xvalue
local posX = self.width * value / self.maximum
self.knob:setPosition(posX, 0)
-- Position knob based on relative value offset distance
self.value = value
local totalRange = self.maximum - self.minimum
end
local relativeOffset = (self.value - self.minimum) / totalRange
 
local posX = self.width * relativeOffset
function SliderText:setRange(x, xstep)
self.knob:setX(posX)
for s = 0, self.width do
if x <= 0 then
if self.textfield then
return 0
if self.text and self.showvalue then  
elseif x >= s * self.width / xstep and x <= (s + 1) * self.width / xstep then
self.textfield:setText(self.text.." \e[color=#ddc]"..self.value.."\e[color]")
return s * self.width / xstep
elseif self.showvalue then  
elseif x >= self.width then
self.textfield:setText("\e[color=#ddc]"..self.value.."\e[color]")
return self.width
end
end
end
end
end
end
</syntaxhighlight >
==== Example ====
<syntaxhighlight lang="lua">
Options = Core.class(Sprite)


function SliderText:round(num)
function Options:init()
return num + (2^52 + 2^51) - (2^52 + 2^51)
-- global var
g_bgmvolume = 10
g_difficulty = 1
-- SLIDERS
local slitcolor, knobcolor = 0x3a1d20, 0x8d595d
self.bgmvolumeslider = ASlider.new({
initvalue=g_bgmvolume, maximum=100, --steps=2,
slitcolor=slitcolor, slitalpha=1, slitw=5*myappwidth/10, slith=24,
knobcolor=knobcolor, knobalpha=0.6, knobw=12, knobh=26,
text="BGM VOLUME: ", textscale=2, textoffsetx=-26*8, textoffsety=7,
id=1,
})
self.difficultyslider = ASlider.new({
initvalue=g_difficulty, maximum=2, --steps=2,
slitcolor=slitcolor, slitalpha=1, slitw=5*myappwidth/10, slith=24,
knobcolor=knobcolor, knobalpha=0.6, knobw=12, knobh=26,
text="DIFFICULTY: ", textscale=2, textoffsetx=-26*8, textoffsety=7, textrotation=0,
id=3,
})
-- position
self.bgmvolumeslider:setPosition(29*8, 2.5*myappheight/10)
self.difficultyslider:setPosition(29*8, 4.5*myappheight/10)
-- order
self:addChild(self.bgmvolumeslider)
self:addChild(self.difficultyslider)
-- sliders listeners
self.bgmvolumeslider:addEventListener("value_just_changed", self.onValueJustChanged, self)
self.bgmvolumeslider:addEventListener("value_changing", self.onValueChanging, self)
self.bgmvolumeslider:addEventListener("value_changed", self.onValueChanged, self)
self.difficultyslider:addEventListener("value_just_changed", self.onValueJustChanged, self)
self.difficultyslider:addEventListener("value_changing", self.onValueChanging, self)
self.difficultyslider:addEventListener("value_changed", self.onValueChanged, self)
-- let's go!
self:difficulty(g_difficulty)
end
end


--[[
---- usage
application:setBackgroundColor(0x333333)
-- sliders
-- sliders
local sliderA = SliderText.new({
function Options:difficulty(x)
initialvalue=2, maximum=10, -- steps=2,
if x >= 2 then self.difficultyslider.textfield:setText("DIFFICULTY: \e[color=#ddc]HARD\e[color]")
slitcolor=0x330033, slitalpha=1, slitw=256*1.5, slith=48,
elseif x >= 1 then self.difficultyslider.textfield:setText("DIFFICULTY: \e[color=#ddc]MEDIUM\e[color]")
knobcolor=0xff00ff, knobalpha=0.7, knobw=40, knobh=30,
else self.difficultyslider.textfield:setText("DIFFICULTY: \e[color=#ddc]EASY\e[color]")
text="SLIDER A: ", textscale=3, textoffsetx=64*0.2, textoffsety=48, textrotation=45,
end
id=1,
})
local sliderB = SliderText.new({
initialvalue=15, maximum=100, steps=5,
slitcolor=0x330033, slitalpha=1, slitw=256*1.5, slith=48,
knobcolor=0xff00ff, knobalpha=0.7, knobw=40, knobh=30,
text="SLIDER B: ", textscale=3, textoffsetx=64*0.2, textoffsety=48,
id=2,
})
-- positions
sliderA:setPosition(64, 256*1.7)
sliderA:setRotation(-90)
sliderB:setPosition(64*2.5, 256*0.3)
-- order
stage:addChild(sliderA)
stage:addChild(sliderB)
-- listeners
function onValueChanged(ev)
print(ev.id, ev.value)
end
end
sliderA:addEventListener("value_changed", onValueChanged)
function Options:onValueJustChanged(e)
sliderB:addEventListener("value_changed", onValueChanged)
if e.id == 1 then
]]
g_bgmvolume = e.value -- keep actual value, change in setVolume()
</source>
self.bgmvolumeslider:setValue(g_bgmvolume)
elseif e.id == 3 then
g_difficulty = e.value
self:difficulty(g_difficulty)
end
end
function Options:onValueChanging(e)
if e.id == 1 then -- bgm volume
g_bgmvolume = e.value -- keep actual value, change in setVolume()
self.bgmvolumeslider:setValue(g_bgmvolume)
elseif e.id == 3 then
self:difficulty(e.value)
end
end
function Options:onValueChanged(e)
if e.id == 1 then
g_bgmvolume = e.value -- keep actual value, change in setVolume()
local audio = Sound.new("audio/sfx/sfx_wpn_laser4.wav") -- feedback
local channel = audio:play()
channel:setVolume(g_bgmvolume)
self.bgmvolumeslider:setValue(g_bgmvolume)
elseif e.id == 3 then
g_difficulty = e.value
self:difficulty(g_difficulty)
end
end
</syntaxhighlight >
 
{{GIDEROS IMPORTANT LINKS}}

Latest revision as of 01:15, 10 October 2026

Here you will find various resources to help you create sliders in Gideros Studio.

note: You may have to provide your own assets (fonts, gfx, …)

Slider

-- UI Slider class
Slider = Core.class(Sprite)

function Slider:init(slit, knob)
	self.slit = slit
	self.width = self.slit:getWidth()
	self:addChild(self.slit)

	self.knob = knob
	self:addChild(self.knob)

	self.value = 0
	self.isFocus = false

	self:addEventListener(Event.MOUSE_DOWN, self.onMouseDown, self)
	self:addEventListener(Event.MOUSE_MOVE, self.onMouseMove, self)
	self:addEventListener(Event.MOUSE_UP, self.onMouseUp, self)
end

function Slider:onMouseDown(event)
	if self.knob:hitTestPoint(event.x, event.y) then
		self.isFocus = true
		self.x0 = event.x
		event:stopPropagation()
	end
end

function Slider:onMouseMove(event)
	if self.isFocus then
		local dx = event.x - self.x0
		self.knob:setX(self.knob:getX() + dx)
		self.x0 = event.x
		
		-- keep the knob position within its range
		if self.knob:getX() < 0 then self.knob:setX(0) end
		if self.knob:getX() > self.width then self.knob:setX(self.width) end
		self.value = math.floor(100 * self.knob:getX() / self.width)
		event:stopPropagation()
	end
end

function Slider:onMouseUp(event)
	if self.isFocus then
		self.isFocus = false
		event:stopPropagation()
	end
end

function Slider:setValue(value)
	local value = math.floor(value)
	-- check within a range of [0, 100]
	if value < 0 then value = 0 end
	if value > 100 then value = 100 end
	local posX = self.width * value / 100
	self.knob:setPosition(posX, 0)
	self.value = value
end

function Slider:getValue()
	return self.value
end

---- USAGE
--local slit = Bitmap.new(Texture.new("Images/slit.png"))
--slit:setAnchorPoint(0, 0.5)
--local knob = Bitmap.new(Texture.new("Images/knob.png"))
--knob:setAnchorPoint(0.5, 0.5)
--local myslider = Slider.new(slit, knob)
--stage:addChild(myslider)
--slider:setValue(75)

Another Slider

You can download the ASlider Class here: Media:Aslider.lua (tip: right click and save link as)

You can rotate it as well (0 and 90° work best)

--[[
-- ASlider
-- mokalux, cc0, AI
-- Slith, Knob, steps, text, ...
v 0.1.0: 2026-10-10 AI correcting my mistakes (memory leaks)
v 0.0.1: 2024-04-23 my take on a ui slider (no AI)
]]

-- Class
ASlider = Core.class(Sprite) -- integers only slider

local floor = math.floor

local function round(val, n)
	if (n) then return floor( (val * 10^n)+0.5 ) / (10^n)
	else return floor(val+0.5)
	end
end

function ASlider:init(xparams)
	local params = xparams or {}
	params.slitw = xparams.slitw or 64
	params.slith = xparams.slith or 64
	params.slitcolor = xparams.slitcolor or 0x0
	params.slitalpha = xparams.slitalpha or 1
	params.knobw = xparams.knobw or 32
	params.knobh = xparams.knobh or 32
	params.knobcolor = xparams.knobcolor or 0xffffff
	params.knobalpha = xparams.knobalpha or 1
	params.minimum = xparams.minimum or 0
	params.maximum = xparams.maximum or 100
	params.initvalue = xparams.initvalue or params.minimum
	params.steps = xparams.steps or (params.maximum - params.minimum)
	params.text = xparams.text or nil
	params.showvalue = xparams.showvalue or nil
	params.font = xparams.font or nil
	params.textscale = xparams.textscale or 1
	params.textcolor = xparams.textcolor or 0xffffff
	params.textoffsetx = xparams.textoffsetx or 0
	params.textoffsety = xparams.textoffsety or 0
	params.textrotation = xparams.textrotation or 0
	params.id = xparams.id or nil
	-- slit and knob
	self.slit = Pixel.new(params.slitcolor, params.slitalpha, params.slitw, params.slith)
	self.slit:setAnchorPoint(0, 0.5)
	self.knob = Pixel.new(params.knobcolor, params.knobalpha, params.knobw, params.knobh)
	self.knob:setAnchorPoint(0.5, 0.5)
	-- textfield
	if params.text and params.showvalue then
		self.textfield = TextField.new(params.font, params.text.." \e[color=#ddc]"..params.initvalue.."\e[color]")
	elseif params.text then
		self.textfield = TextField.new(params.font, params.text)
	elseif params.showvalue then
		self.textfield = TextField.new(params.font, "\e[color=#ddc]"..params.initvalue.."\e[color]")
	end
	-- order
	self:addChild(self.slit)
	self:addChild(self.knob)
	if self.textfield then
		self.textfield:setRotation(params.textrotation)
		self.textfield:setScale(params.textscale)
		self.textfield:setTextColor(params.textcolor)
		self.textfield:setPosition(self.slit:getX() + params.textoffsetx, self.slit:getY() + params.textoffsety)
		self:addChild(self.textfield)
	end
	-- class variables
	self.minimum = params.minimum
	self.maximum = params.maximum
--	if self.minimum >= self.maximum then self.maximum = self.minimum + 100 end -- XXX
	if self.minimum >= self.maximum then
		print("ASlider minimum: "..self.minimum.." equals to maximum: "..self.maximum)
		self.maximum = self.minimum + self.maximum
	end
	self.steps = params.steps
	self.value = params.initvalue
	self.width = params.slitw
	self.text = params.text
	self.showvalue = params.showvalue
	self.isFocus = false
	self.id = params.id
	-- event listeners
	self:addEventListener(Event.MOUSE_DOWN, self.onMouseDown, self)
	self:addEventListener(Event.MOUSE_MOVE, self.onMouseMove, self)
	self:addEventListener(Event.MOUSE_UP, self.onMouseUp, self)
	-- let's go!
	self:setValue(self.value)
end

-- helper function
function ASlider:calculateKnobPosition(x)
	if x <= 0 then return self.minimum end
	if x >= self.width then return self.maximum end
	
	-- 1. Track percentage across visual slider width
	local pct = x / self.width
	
	-- 2. Snap to nearest available stepped interval percentage
	local nearestStep = floor((pct * self.steps) + 0.5)
	local snappedPct = nearestStep / self.steps
	
	-- 3. Interpolate the percentage against actual numerical range bounds
	local valueRange = self.maximum - self.minimum
	local calculatedValue = self.minimum + (snappedPct * valueRange)
	
	return round(calculatedValue, 3)
end

-- events
function ASlider:onMouseDown(event)
	if self.slit:hitTestPoint(event.x, event.y) or self.knob:hitTestPoint(event.x, event.y) then
		local localX, _ = self:globalToLocal(event.x, event.y)
		self.isFocus = true
		
		local targetValue = self:calculateKnobPosition(localX)
		self:setValue(targetValue)
		
		local e = Event.new("value_just_changed")
		e.value = self.value
		e.id = self.id
		self:dispatchEvent(e)
		event:stopPropagation()
	end
end

function ASlider:onMouseMove(event)
	if self.isFocus then
		local localX, _ = self:globalToLocal(event.x, event.y)
		
		local targetValue = self:calculateKnobPosition(localX)
		self:setValue(targetValue)
		
		local e = Event.new("value_changing")
		e.value = self.value
		e.id = self.id
		self:dispatchEvent(e)
		event:stopPropagation()
	end
end

function ASlider:onMouseUp(event)
	if self.isFocus then
		self.isFocus = false
		local e = Event.new("value_changed")
		e.value = self.value
		e.id = self.id
		self:dispatchEvent(e)
		event:stopPropagation()
	end
end

-- function
function ASlider:setValue(xvalue)
	-- Clamp values safely inside bounds
	if xvalue < self.minimum then xvalue = self.minimum end
	if xvalue > self.maximum then xvalue = self.maximum end
	self.value = xvalue
	
	-- Position knob based on relative value offset distance
	local totalRange = self.maximum - self.minimum
	local relativeOffset = (self.value - self.minimum) / totalRange
	local posX = self.width * relativeOffset
	self.knob:setX(posX)
	
	if self.textfield then
		if self.text and self.showvalue then 
			self.textfield:setText(self.text.." \e[color=#ddc]"..self.value.."\e[color]")
		elseif self.showvalue then 
			self.textfield:setText("\e[color=#ddc]"..self.value.."\e[color]")
		end
	end
end

Example

Options = Core.class(Sprite)

function Options:init()
	-- global var
	g_bgmvolume = 10
	g_difficulty = 1
	-- SLIDERS
	local slitcolor, knobcolor = 0x3a1d20, 0x8d595d
	self.bgmvolumeslider = ASlider.new({
		initvalue=g_bgmvolume, maximum=100, --steps=2,
		slitcolor=slitcolor, slitalpha=1, slitw=5*myappwidth/10, slith=24,
		knobcolor=knobcolor, knobalpha=0.6, knobw=12, knobh=26,
		text="BGM VOLUME: ", textscale=2, textoffsetx=-26*8, textoffsety=7,
		id=1,
	})
	self.difficultyslider = ASlider.new({
		initvalue=g_difficulty, maximum=2, --steps=2,
		slitcolor=slitcolor, slitalpha=1, slitw=5*myappwidth/10, slith=24,
		knobcolor=knobcolor, knobalpha=0.6, knobw=12, knobh=26,
		text="DIFFICULTY: ", textscale=2, textoffsetx=-26*8, textoffsety=7, textrotation=0,
		id=3,
	})
	-- position
	self.bgmvolumeslider:setPosition(29*8, 2.5*myappheight/10)
	self.difficultyslider:setPosition(29*8, 4.5*myappheight/10)
	-- order
	self:addChild(self.bgmvolumeslider)
	self:addChild(self.difficultyslider)
	-- sliders listeners
	self.bgmvolumeslider:addEventListener("value_just_changed", self.onValueJustChanged, self)
	self.bgmvolumeslider:addEventListener("value_changing", self.onValueChanging, self)
	self.bgmvolumeslider:addEventListener("value_changed", self.onValueChanged, self)
	self.difficultyslider:addEventListener("value_just_changed", self.onValueJustChanged, self)
	self.difficultyslider:addEventListener("value_changing", self.onValueChanging, self)
	self.difficultyslider:addEventListener("value_changed", self.onValueChanged, self)
	-- let's go!
	self:difficulty(g_difficulty)
end

-- sliders
function Options:difficulty(x)
	if x >= 2 then self.difficultyslider.textfield:setText("DIFFICULTY: \e[color=#ddc]HARD\e[color]")
	elseif x >= 1 then self.difficultyslider.textfield:setText("DIFFICULTY: \e[color=#ddc]MEDIUM\e[color]")
	else self.difficultyslider.textfield:setText("DIFFICULTY: \e[color=#ddc]EASY\e[color]")
	end
end
function Options:onValueJustChanged(e)
	if e.id == 1 then
		g_bgmvolume = e.value -- keep actual value, change in setVolume()
		self.bgmvolumeslider:setValue(g_bgmvolume)
	elseif e.id == 3 then
		g_difficulty = e.value
		self:difficulty(g_difficulty)
	end
end
function Options:onValueChanging(e)
	if e.id == 1 then -- bgm volume
		g_bgmvolume = e.value -- keep actual value, change in setVolume()
		self.bgmvolumeslider:setValue(g_bgmvolume)
	elseif e.id == 3 then
		self:difficulty(e.value)
	end
end
function Options:onValueChanged(e)
	if e.id == 1 then
		g_bgmvolume = e.value -- keep actual value, change in setVolume()
		local audio = Sound.new("audio/sfx/sfx_wpn_laser4.wav") -- feedback
		local channel = audio:play()
		channel:setVolume(g_bgmvolume)
		self.bgmvolumeslider:setValue(g_bgmvolume)
	elseif e.id == 3 then
		g_difficulty = e.value
		self:difficulty(g_difficulty)
	end
end