com.io7m.jcanephora.core

Interface JCGLViewMatricesType

All Known Implementing Classes:

JCGLViewMatrices

public interface JCGLViewMatricesType

Functions for producing view matrices.

Method Summary

Modifier and Type	Method and Description
void	lookAt(com.io7m.jtensors.MatrixWritable4x4FType out, com.io7m.jtensors.VectorReadable3FType camera, com.io7m.jtensors.VectorReadable3FType target, com.io7m.jtensors.VectorReadable3FType up) Calculate a view matrix representing a camera looking from the point camera to the point target.

Method Detail

lookAt

void lookAt(com.io7m.jtensors.MatrixWritable4x4FType out,
            com.io7m.jtensors.VectorReadable3FType camera,
            com.io7m.jtensors.VectorReadable3FType target,
            com.io7m.jtensors.VectorReadable3FType up)

Calculate a view matrix representing a camera looking from the point camera to the point target. target must represent the "up" vector for the camera. Usually, this is simply a unit vector (0, 1, 0) representing the Y axis.

The view is expressed as a translation and a rotation matrix, which is multiplied with the contents of out. Therefore, for most use cases, out should be set to the 4x4 identity matrix before calling the function.

Parameters:

out - The input/output matrix.

camera - The position of the viewer.

target - The target being viewed.

up - The up vector.