camera3d

Creates a new 3D camera with default state: position (0, 1, -5), target (0, 0, 0), up (0, 1, 0), 60° FOV, 16:9 aspect ratio, and near/far planes of 0.1/1000.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
print("fov: {cam.get_fov()}")  // 60

Sets the camera eye position in world space. The camera keeps looking at its current target.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.set_position(10, 5, -10)

Returns the current eye position as a table with x, y, and z number fields.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
let pos = cam.get_position()
print("camera at ({pos["x"]}, {pos["y"]}, {pos["z"]})")

Sets the world-space point the camera is looking at.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.set_target(0, 2, 0)

Returns the current look-at target as a table with x, y, and z number fields.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
let t = cam.get_target()
print("looking at ({t["x"]}, {t["y"]}, {t["z"]})")

Sets the vertical field of view in degrees. The value is clamped to the range 1–179.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.set_fov(90)
print("fov: {cam.get_fov()}")  // 90

Returns the current vertical field of view in degrees.

Sets the viewport aspect ratio (width divided by height) used by the projection matrices. Update this whenever the window is resized.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.set_aspect(1920.0 / 1080.0)

Sets the near and far clip plane distances used by the projection matrices.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.set_near_far(0.01, 500)

Sets the camera up vector used for view matrix computation and strafing. Defaults to (0, 1, 0).

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.set_up(0, 0, 1)  // Z-up convention

Returns the current up vector as a table with x, y, and z number fields.

Returns the normalized forward direction (from position toward target) as a table with x, y, and z number fields. Useful for raycasting or spawning objects in front of the camera.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
let dir = cam.get_direction()
print("forward: ({dir["x"]}, {dir["y"]}, {dir["z"]})")

Rotates the camera around its target by the given yaw and pitch deltas, in degrees, keeping the distance constant. Pitch is clamped to ±89° to avoid flipping over the poles. Ideal for mouse-drag orbit controls.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.orbit(45, 0)    // rotate 45 degrees around the target
cam.orbit(0, -15)   // tilt down 15 degrees

Moves the camera along the line to its target, changing the orbit radius by delta world units. Positive values move away, negative values move closer. Distance is clamped to a minimum of 0.01.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.zoom(-2)  // move 2 units closer
print("distance: {cam.get_distance()}")

Translates both the camera position and its target along the view direction by amount units (fly-style movement). Negative values move backward.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.move_forward(1.5)   // W key
cam.move_forward(-1.5)  // S key

Strafes both the camera position and its target sideways, along the cross product of the view direction and the up vector. Negative values strafe left.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.move_right(2)   // D key
cam.move_right(-2)  // A key

Translates both the camera position and its target along the normalized up vector. Negative values move down.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.move_up(1)

Computes the look-at view matrix from the current position, target, and up vector. Returns a table of 16 numbers indexed 0–15 in column-major order, ready to upload to a GPU uniform.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
let view = cam.get_view_matrix()
print("m[0] = {view[0]}")

Computes the perspective projection matrix from the current FOV, aspect ratio, and near/far planes. Returns a table of 16 numbers indexed 0–15 in column-major order.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.set_fov(75)
let proj = cam.get_projection_matrix()

Computes an orthographic projection matrix using the camera's aspect ratio and near/far planes, where size is the vertical extent of the view volume in world units (width is size * aspect). Returns a table of 16 numbers in column-major order. Useful for 2D overlays or isometric views.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
let ortho = cam.get_ortho_matrix(10)

Returns the distance between the camera position and its target, i.e. the current orbit radius.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
print("distance: {cam.get_distance()}")

Aims the camera at the given world-space point without moving its position. Equivalent to set_target.

use plugin camera3d::{Camera3D}

let cam = Camera3D.new()
cam.set_position(5, 5, 5)
cam.look_at(0, 1, 0)