A3DGE - Amateur 3D Game Engine

Class Hierarchy

Classes, Interfaces, Objects and Records

Functions and Procedures

Class TCamera

Fields

Unit

Declaration

type TCamera = class(TEntity3D)

Description

Camera description.

It defines the fustrum by setting the viewport (SetViewport), and the FarPlane and the NearPlane properties, so the height is 2 units and width is proportial to the viewport height/width relation.

See also

TWorld3D.Camera: Reference to the active camera.
TWorld3D.Render: Renders the world.

Hierarchy

TObject
TEntity3D
TCamera

Overview

Methods

	`CONSTRUCTOR Create; override;`
	`DESTRUCTOR Destroy; OVERRIDE;`
	`PROCEDURE SetViewport (CONST x, y, w, h: INTEGER);`
	`PROCEDURE ApplyViewport; VIRTUAL;`
	`procedure SetPerspectiveProjection;`
	`procedure SetOrthographicProjection;`
	`PROCEDURE Update; VIRTUAL;`
	`PROCEDURE ApplyMatrix; VIRTUAL;`
	`PROCEDURE ApplyRotationMatrix; INLINE;`
	`PROCEDURE ApplyInverseRotationMatrix; INLINE;`

Properties

	`property NearPlane: GLfloat READ fNear WRITE fNear;`
	`property FarPlane: GLfloat READ fFar WRITE fFar;`
	`property Light: TLight READ fLight;`

Description

Methods

	`CONSTRUCTOR Create; override;`
Creates and initialises the camera.

DESTRUCTOR Destroy; OVERRIDE;

Destroys the camera.

It also destroys the Light.

PROCEDURE SetViewport (CONST x, y, w, h: INTEGER);

Define the viewport used by this camera.

The viewport definition may affect the frustrum angle.

Parameters

x: Horizontal position of the viewport on the screen in pixels.
y: Vertical position of the viewport on the screen in pixels.
w: Width position of the viewport in pixels.
h: Height of the viewport in pixels.

See also

ApplyViewport: Apply the viewport configuration.

PROCEDURE ApplyViewport; VIRTUAL;

Apply the viewport configuration.

See also

SetViewport: Define the viewport used by this camera.
FarPlane: The far plane distance.
NearPlane: The near plane distance.

procedure SetPerspectiveProjection;

Change the camera projection matrix for perspective projection.

Note this affects the viewport only.

This method also call glLoadIdentity so it cleans the transformation matrix stack.

See also

TCamera.SetOrthographicProjection: Change the camera projection matrix for orthographic (paralel) projection.

procedure SetOrthographicProjection;

Change the camera projection matrix for orthographic (paralel) projection.

Note this affects the viewport only.

For OpenGL, screen coordinates are -1 to 1 in both height and width. For Allegro, it is pixel coordinates.

This method also call glLoadIdentity so it cleans the transformation matrix stack.

See also

TCamera.SetPerspectiveProjection: Change the camera projection matrix for perspective projection.
TDisplay.SetOrthographicProjection: Set orthogonal projection for full display.

	`PROCEDURE Update; VIRTUAL;`
Updates the camera, if needed.

PROCEDURE ApplyMatrix; VIRTUAL;

Build an apply the camera matrix.

ApplyMatrix builds the camera matrix using current Position and Rotation then adds it to the matrix stack.

Note it doesn't loads the Identity matrix so previous applied matrices will affect the scene transformations.

See also

TCamera.ApplyRotationMatrix: Apply only the rotation matrix without translation.
ApplyInverseRotationMatrix: Apply the inverse rotation matrix.

PROCEDURE ApplyRotationMatrix; INLINE;

Apply only the rotation matrix without translation.

This can be used to implement skyboxes and other special effects.

See also

MultiplyVectorMatrix: Multiply the given vector with the given matrix.
ApplyInverseRotationMatrix: Apply the inverse rotation matrix.

PROCEDURE ApplyInverseRotationMatrix; INLINE;

Apply the inverse rotation matrix.

This can be used to implement billboards, 3D sprites and other special effects.

See also

MultiplyVectorMatrix: Multiply the given vector with the given matrix.
ApplyRotationMatrix: Apply only the rotation matrix without translation.

Properties

property NearPlane: GLfloat READ fNear WRITE fNear;

The near plane distance. It modifies FOV.

By default it's 1.5. You must call ApplyViewport after setting it.

See also

FarPlane: The far plane distance.

property FarPlane: GLfloat READ fFar WRITE fFar;

The far plane distance. It doesn't modifies FOV.

By default it's 1000. You must call ApplyViewport after setting it.

See also

NearPlane: The near plane distance.

property Light: TLight READ fLight;

A light attached to the camera, so its position and angle are relative to the camera.

You don't have to create this light because the camera creates one automatically.

The camera owns this light so if you assing a new one, the previous will be destroyed. If you need to change this light it's better to change the properties of the light than assign one.

If you don't want to use a camera light just assign Nil.

Generated by PasDoc 0.15.0. Generated on 2025-07-31 11:41:01.