Camera API

Screen projection and camera functions.

Functions

get_screen_size()

Get the screen dimensions.

local screen = kinetic.camera.get_screen_size()

Returns: Table with width and height

Example:

local screen = kinetic.camera.get_screen_size()
print("Screen: " .. screen.width .. "x" .. screen.height)

-- Draw at center
local center_x = screen.width / 2
local center_y = screen.height / 2
kinetic.draw.circle({center_x, center_y}, {255, 0, 0}, 10)

world_to_screen()

Project a 3D world position to 2D screen coordinates.

Have fun with this.

local screen_pos = kinetic.camera.world_to_screen(x, y, z)

Parameters:

• x, y, z (numbers) - World coordinates

Returns: Table with x, y, and visible or nil if behind camera

Example:

local players = kinetic.players.get_all()

for _, player in ipairs(players) do
    if player.position then
        local screen = kinetic.camera.world_to_screen(
            player.position.x,
            player.position.y,
            player.position.z
        )
        
        if screen and screen.visible then
            -- Draw on screen
            kinetic.draw.text({screen.x, screen.y}, {255, 255, 255}, player.name)
        end
    end
end

Complete Example

3D ESP

kinetic.on_frame = function(delta_time)
    local players = kinetic.players.get_all()
    
    for _, player in ipairs(players) do
        if player.position then
            -- Project to screen
            local screen = kinetic.camera.world_to_screen(
                player.position.x,
                player.position.y + 3,  -- Offset for head
                player.position.z
            )
            
            if screen and screen.visible then
                -- Draw box
                local size = 1000 / player.distance  -- Scale by distance
                kinetic.draw.box(
                    {screen.x - size, screen.y - size * 2},
                    {screen.x + size, screen.y + size},
                    {255, 255, 255}
                )
                
                -- Draw name
                kinetic.draw.text({screen.x, screen.y - size * 2 - 15}, 
                    {255, 255, 255}, player.name)
            end
        end
    end
end

Next Steps

• Drawing API - Draw projected positions

• Players API - Get player positions