Structs

typedef struct TQ3CameraTransformData {
    TQ3Matrix4x4                                localToWorld;
    TQ3Matrix4x4                                worldToCamera;
    TQ3Matrix4x4                                cameraToFrustum;
} TQ3CameraTransformData;

Discussion

State data for a transform object that manipulates the camera matrix state.

Vertices are passed through three transforms to convert them from local coordinates to the canonical viewing frustum.

The localToWorld transform converts local coordinates to the world coordinate system.

The worldToCamera transform converts world coordinates to the camera's coordinate system, which places the camera at the origin and establishes the camera's view of the world.

The cameraToFrustum converts the camera's coordinate system to the canonical viewing frustum. This frustum is a box centered on the origin, ranging from -1 to +1 in x and y. In z the frustum ranges from 0 at the near clipping plane to -1 at the far clipping plane.

Once vertices have been transformed to the canonical frustum, a portion of the frustum is then selected using the current camera's viewPort and that portion mapped to the draw context's pane. These two steps are controlled by the current camera and draw context, and are not affected by a camera transform object.

Field Descriptions

localToWorld

The local-to-world matrix.

worldToCamera

The world-to-camera matrix.

cameraToFrustum

The camera-to-frustum matrix.

typedef struct TQ3RotateAboutAxisTransformData {
    TQ3Point3D                                  origin;
    TQ3Vector3D                                 orientation;
    TQ3Float32                                  radians;
} TQ3RotateAboutAxisTransformData;

Discussion

State data for a transform object that rotates about an arbitrary axis. Note that the orientation vector must be normalized.

Field Descriptions

origin

A point on the axis of rotation.

orientation

A normal vector determining the direction of the axis.

radians

Number of radians to rotate about the axis.

typedef struct TQ3RotateAboutPointTransformData {
    TQ3Axis                                     axis;
    TQ3Float32                                  radians;
    TQ3Point3D                                  about;
} TQ3RotateAboutPointTransformData;

Discussion

State data for a rotate-about-point transform.

Field Descriptions

axis

Enumerated value specifying the x, y, or z axis.

radians

Number of radians to rotate about the axis.

about

A point on the desired axis of rotation.

typedef struct TQ3RotateTransformData {
    TQ3Axis                                     axis;
    TQ3Float32                                  radians;
} TQ3RotateTransformData;

Discussion

State data for a rotate transform.

Field Descriptions

axis

Enumerated value specifying the x, y, or z axis.

radians

Number of radians to rotate about the axis.

© 1999-2008 Quesa Developers (Last Updated 5/10/2008)