math/camera.h

#include <modkit/math/camera.h>20 functions · 1 structs · 1 enums · 2 typedefs

Camera abstraction for 2D ortho and 3D perspective.

Handles backend-specific projection matrix generation based on renderer capabilities (homogeneousDepth for OpenGL vs D3D/Vulkan/Metal). Uses right-hand coordinate system with Y-up, -Z forward.

Functions

mk_camera_2dfunction

mk_camera mk_camera_2d(float width, float height)

Create simple 2D ortho camera centered at origin.

Parameter	Type	Description
width	float	Viewport width in pixels
height	float	Viewport height in pixels

Returns The resulting value.

mk_camera_dollyfunction

void mk_camera_dolly(mk_camera *cam, float distance)

Dolly camera (move toward/away from target).

Parameter	Type	Description
cam	mk_camera *	Camera to modify
distance	float	Positive = closer, negative = farther

mk_camera_get_distancefunction

float mk_camera_get_distance(const mk_camera *cam)

Get distance from camera to target.

Parameter	Type	Description
cam	const mk_camera *	Value for cam.

Returns The resulting value.

mk_camera_get_projectionfunction

void mk_camera_get_projection(const mk_camera *cam, mk_mat4 *dest)

Get projection matrix (camera -> clip space) Automatically uses correct variant based on renderer backend:

OpenGL: [-1, 1] depth range (homogeneousDepth = true)D3D/Vulkan/Metal: [0, 1] depth range (homogeneousDepth = false)

Parameter	Type	Description
cam	const mk_camera *	Value for cam.
dest	mk_mat4 *	Value for dest.

mk_camera_get_viewfunction

void mk_camera_get_view(const mk_camera *cam, mk_mat4 *dest)

Get view matrix (world -> camera space) Uses glm_lookat_rh for right-hand coordinate system.

Parameter	Type	Description
cam	const mk_camera *	Value for cam.
dest	mk_mat4 *	Value for dest.

mk_camera_get_view_projectionfunction

void mk_camera_get_view_projection(const mk_camera *cam, mk_mat4 *dest)

Get combined view-projection matrix.

Parameter	Type	Description
cam	const mk_camera *	Value for cam.
dest	mk_mat4 *	Value for dest.

mk_camera_move_forwardfunction

void mk_camera_move_forward(mk_camera *cam, float distance)

Move camera forward/backward along view direction.

Parameter	Type	Description
cam	mk_camera *	Camera to modify
distance	float	Positive = forward, negative = backward

mk_camera_move_rightfunction

void mk_camera_move_right(mk_camera *cam, float distance)

Strafe camera left/right.

Parameter	Type	Description
cam	mk_camera *	Camera to modify
distance	float	Positive = right, negative = left

mk_camera_move_upfunction

void mk_camera_move_up(mk_camera *cam, float distance)

Move camera up/down along world up axis.

Parameter	Type	Description
cam	mk_camera *	Camera to modify
distance	float	Positive = up, negative = down

mk_camera_orbitfunction

void mk_camera_orbit(mk_camera *cam, float yaw, float pitch)

Orbit camera around target point.

Parameter	Type	Description
cam	mk_camera *	Camera to modify
yaw	float	Horizontal rotation in radians
pitch	float	Vertical rotation in radians

mk_camera_orthofunction

mk_camera mk_camera_ortho(mk_vec3 position, mk_vec3 target, float ortho_size, float aspect, float near_plane, float far_plane)

Create orthographic camera (2D or isometric 3D).

Parameter	Type	Description
position	mk_vec3	Camera position in world space
target	mk_vec3	Point to look at
ortho_size	float	Half-height of the view in world units
aspect	float	Viewport width / height
near_plane	float	Near clip plane distance
far_plane	float	Far clip plane distance

Returns The resulting value.

mk_camera_panfunction

void mk_camera_pan(mk_camera *cam, float right, float up)

Pan camera (move camera and target together).

Parameter	Type	Description
cam	mk_camera *	Camera to modify
right	float	Horizontal pan amount
up	float	Vertical pan amount

mk_camera_perspectivefunction

mk_camera mk_camera_perspective(mk_vec3 position, mk_vec3 target, float fov_y, float aspect, float near_plane, float far_plane)

Create perspective camera.

Parameter	Type	Description
position	mk_vec3	Camera position in world space
target	mk_vec3	Point to look at
fov_y	float	Vertical field of view in radians (use glm_rad() to convert degrees)
aspect	float	Viewport width / height
near_plane	float	Near clip plane distance
far_plane	float	Far clip plane distance

Returns The resulting value.

mk_camera_rotate_pitchfunction

void mk_camera_rotate_pitch(mk_camera *cam, float angle)

Rotate camera pitch (around right axis).

Parameter	Type	Description
cam	mk_camera *	Camera to modify
angle	float	Rotation in radians (clamped to avoid gimbal lock)

mk_camera_rotate_yawfunction

void mk_camera_rotate_yaw(mk_camera *cam, float angle)

Rotate camera yaw (around up axis).

Parameter	Type	Description
cam	mk_camera *	Camera to modify
angle	float	Rotation in radians

mk_camera_set_aspectfunction

void mk_camera_set_aspect(mk_camera *cam, float width, float height)

Update aspect ratio (call on window resize).

Parameter	Type	Description
cam	mk_camera *	Value for cam.
width	float	Value for width.
height	float	Value for height.

mk_camera_set_distancefunction

void mk_camera_set_distance(mk_camera *cam, float distance)

Set distance from camera to target (dolly to specific distance).

Parameter	Type	Description
cam	mk_camera *	Value for cam.
distance	float	Value for distance.

mk_camera_set_fovfunction

void mk_camera_set_fov(mk_camera *cam, float fov_y)

Set field of view (radians).

Parameter	Type	Description
cam	mk_camera *	Value for cam.
fov_y	float	Value for fov y.

mk_camera_set_ortho_sizefunction

void mk_camera_set_ortho_size(mk_camera *cam, float size)

Set ortho size (half-height).

Parameter	Type	Description
cam	mk_camera *	Value for cam.
size	float	Size in bytes.

mk_camera_set_zoomfunction

void mk_camera_set_zoom(mk_camera *cam, float zoom)

Set zoom level (clamped to > 0.01).

Parameter	Type	Description
cam	mk_camera *	Value for cam.
zoom	float	Value for zoom.

Structs

mk_camerastruct

Camera for view and projection matrices.

Perspective mode:fov_y: vertical field of view in radiansnear/far: clip planeszoom: affects fov (smaller = zoom in) Ortho mode:ortho_size: half-height of view in world unitsnear/far: clip planeszoom: affects ortho_size (smaller = zoom in)

Field	Type	Description
position	mk_vec3	Camera position in world space.
target	mk_vec3	Look-at target position.
up	mk_vec3	Up direction (usually 0,1,0).
mode	mk_camera_mode	The mode.
aspect	float	Width / height.
near_plane	float	Near clip plane.
far_plane	float	Far clip plane.
fov_y	float	Vertical FOV in radians.
ortho_size	float	Half-height of ortho view.
zoom	float	1.0 = normal, <1 = zoom in, >1 = zoom out

Enums

mk_camera_modeenum

Values for camera mode.

Value	Description
MK_CAMERA_PERSPECTIVE	3D perspective projection
MK_CAMERA_ORTHO	2D/3D orthographic projection

Typedefs

mk_cameratypedef

typedef struct mk_camera mk_camera

Camera for view and projection matrices.

Perspective mode:fov_y: vertical field of view in radiansnear/far: clip planeszoom: affects fov (smaller = zoom in) Ortho mode:ortho_size: half-height of view in world unitsnear/far: clip planeszoom: affects ortho_size (smaller = zoom in)

mk_camera_modetypedef

typedef enum mk_camera_mode mk_camera_mode

Values for camera mode.