Cbump 3D example

From GiderosMobile

Available since: Gideros 2026.8
Class: Bump


Example

Full working example, just copy/paste 😉

Cuboid = Core.class(Mesh)

function Cuboid:init(w,h,d)
	self._va = { -- vertex array
		-w/2,h/2,-d/2, w/2,h/2,-d/2, w/2,-h/2,-d/2, -w/2,-h/2,-d/2,
		w/2,h/2,d/2, -w/2,h/2,d/2, -w/2,-h/2,d/2, w/2,-h/2,d/2,
		-w/2,-h/2,-d/2, w/2,-h/2,-d/2, w/2,-h/2,d/2, -w/2,-h/2,d/2,
		-w/2,h/2,d/2, w/2,h/2,d/2, w/2,h/2,-d/2, -w/2,h/2,-d/2,
		-w/2,h/2,d/2, -w/2,h/2,-d/2, -w/2,-h/2,-d/2, -w/2,-h/2,d/2,
		w/2,h/2,-d/2, w/2,h/2,d/2, w/2,-h/2,d/2, w/2,-h/2,-d/2,
	}
	self._ia = { -- index array
		1,2,3,1,3,4,
		5,6,7,5,7,8,
		9,10,11,9,11,12,
		13,14,15,13,15,16,
		17,18,19,17,19,20,
		21,22,23,21,23,24,
	}
	self:setVertexArray(self._va)
	self:setIndexArray(self._ia)
	self.dims={w=w, h=h, d=d}
end

function Cuboid:mapColor(color,alpha)
	for i = 1, #self._ia do
		self:setColor(i, color, alpha or 1)
	end
end

-- ***************************************
application:setBackgroundColor(0x323232)
application:configureFrustum(90) -- (fov, farplane)

local cbump = require "cbump"
local world = cbump.newWorld(nil, nil, true) -- (cellSize, precision>0, 3d)

-- ground
local plane = Cuboid.new(16*32, 0.01*32, 8*32) -- (w,h,d)
plane:mapColor(0x0000a1, 0.5) -- color,alpha

-- player1
local player1 = Cuboid.new(0.65*32, 1.3*32, 0.4*32) -- (w,h,d)
player1:mapColor(0xff0000, 0.5)
player1.isup, player1.isdown, player1.isleft, player1.isright, player1.isjump = false, false, false, false, false
player1.vx, player1.vy, player1.vz = 0*32, 0*32, 0*32
player1.speed, player1.jumpspeed = 0.06*32, 3.5*32
player1.filter = function(item, other)
	if other.name == "wop" then return "cross" end
	return "slide"
end

-- cubes
local cubes = {}
for i = 1, 4 do
	cubes[i] = Cuboid.new(1*32, 0.5*32, 0.5*32) -- (w,h,d)
	cubes[i]:mapColor(0x00a100, 0.5) -- color,alpha
	if i == 3 then
		cubes[i].name = "wop"
		cubes[i]:mapColor(0x00a1ff, 0.6) -- color,alpha
	end
end

-- anchor
plane:setAnchorPosition(-plane.dims.w/2, -plane.dims.h/2, -plane.dims.d/2)
player1:setAnchorPosition(-player1.dims.w/2, -player1.dims.h/2, -player1.dims.d/2)
for i = 1, #cubes do
	cubes[i]:setAnchorPosition(-cubes[i].dims.w/2, -cubes[i].dims.h/2, -cubes[i].dims.d/2)
end
-- position
plane:setPosition(0*32, 6.5*32, -plane.dims.d/2)
player1.x, player1.y, player1.z = 6*32, 2*32, 0*32
player1:setPosition(player1.x, player1.y, player1.z)
for i = 1, #cubes do
	cubes[i]:setPosition(i*3*32, plane:getY()-cubes[i].dims.h, 0*32)
end
-- order
stage:addChild(plane)
stage:addChild(player1)
for i = 1, #cubes do
	stage:addChild(cubes[i])
end
-- cbump world
world:add(
	plane,
	plane:getX(), plane:getY(), plane:getZ(),
	plane.dims.w, plane.dims.h, plane.dims.d
)
world:add(
	player1,
	player1.x, player1.y, player1.z,
	player1.dims.w, player1.dims.h, player1.dims.d
)
for i = 1, #cubes do
	world:add(
		cubes[i],
		cubes[i]:getX(), cubes[i]:getY(), cubes[i]:getZ(),
		cubes[i].dims.w, cubes[i].dims.h, cubes[i].dims.d
	)
end

-- game loop
function updatePlayer1(xsprite, dt)
	-- gravity
	xsprite.vy += 160 * dt
	-- cbump
	local goalx = xsprite.x + xsprite.vx * dt
	local goaly = xsprite.y + xsprite.vy * dt
	local goalz = xsprite.z + xsprite.vz * dt
	local nextx, nexty, nextz, collisions, len = world:move(xsprite, goalx, goaly, goalz, xsprite.filter)
	-- collisions
	for i = 1, len do
		local col = collisions[i]
		if (col.normal.x == -1 or col.normal.x == 1) and col.other.name ~= "wop" then -- continuous
			col.item.vx = 0
		elseif col.normal.y == -1 and col.other.name ~= "wop" then -- continuous
			col.item.vy = 0
			col.item.isonfloor = true -- actor is on floor
		elseif (col.normal.z == -1 or col.normal.z == 1) and col.other.name ~= "wop" then -- continuous
			col.item.vz = 0
		end
	end
	-- keyboard handling
	if xsprite.isleft then
		xsprite.vx -= xsprite.speed
	elseif xsprite.isright then
		xsprite.vx += xsprite.speed
	else
		xsprite.vx = 0
	end
	if xsprite.isup then
		xsprite.vz -= xsprite.speed
	elseif xsprite.isdown then
		xsprite.vz += xsprite.speed
	else
		xsprite.vz = 0
	end
	if xsprite.isaction1 then
		if xsprite.isonfloor then
			xsprite.vy = -xsprite.jumpspeed
			xsprite.isonfloor = false
			xsprite.isaction1 = false
		end
	end
	-- move
	xsprite.x = nextx
	xsprite.y = nexty
	xsprite.z = nextz
	xsprite:setPosition(xsprite.x, xsprite.y, xsprite.z)
end

stage:addEventListener(Event.ENTER_FRAME, function(e)
	updatePlayer1(player1, e.deltaTime)
end)

-- keys handler
stage:addEventListener(Event.KEY_DOWN, function(e)
	if e.keyCode == KeyCode.UP then player1.isup = true end
	if e.keyCode == KeyCode.DOWN then player1.isdown = true end
	if e.keyCode == KeyCode.LEFT then player1.isleft = true end
	if e.keyCode == KeyCode.RIGHT then player1.isright = true end
	if e.keyCode == KeyCode.SPACE then player1.isaction1 = true end
end)

stage:addEventListener(Event.KEY_UP, function(e)
	if e.keyCode == KeyCode.UP then player1.isup = false end
	if e.keyCode == KeyCode.DOWN then player1.isdown = false end
	if e.keyCode == KeyCode.LEFT then player1.isleft = false end
	if e.keyCode == KeyCode.RIGHT then player1.isright = false end
	if e.keyCode == KeyCode.SPACE then player1.isaction1 = false end
end)