Class GameCamera

CodenameOne/src/com/codename1/gaming/GameCamera.java:54–242

/// pixels -- use `Sprite#setSize(float, float)` or `Sprite#setScale(float)` to pick a
/// world-space size.
public class GameCamera {
    /// Orthographic, pixel-space 2D rendering (the default).
    public static final int MODE_ORTHO_2D = 0;
    /// Perspective 3D rendering with billboarded sprites.
    public static final int MODE_PERSPECTIVE = 1;

    private int mode = MODE_ORTHO_2D;

    private float fov = 60f;
    private float near = 0.1f;
    private float far = 1000f;

    private float eyeX;
    private float eyeY;
    private float eyeZ = 10f;
    private float targetX;
    private float targetY;
    private float targetZ;
    private float upX;
    private float upY = 1f;
    private float upZ;

    // billboard basis, recomputed by #updateBasis(); columns right | up | toCamera
    private final float[] basis = new float[16];

    public int getMode() {
        return mode;
    }

    /// Switches to perspective 3D rendering and sets the lens.
    ///
    /// #### Parameters
    ///
    /// - `fovYDegrees`: vertical field of view in degrees (e.g. 60)
    ///
    /// - `near`: near clip distance (> 0)
    ///
    /// - `far`: far clip distance
    public GameCamera setPerspective(float fovYDegrees, float near, float far) {
        this.mode = MODE_PERSPECTIVE;
        this.fov = fovYDegrees;
        this.near = near;
        this.far = far;
        return this;
    }

    /// Switches back to the default orthographic 2D mode.
    public GameCamera setOrthographic2D() {
        this.mode = MODE_ORTHO_2D;
        return this;
    }

    /// The eye position in world space (perspective mode).
    public GameCamera setPosition(float x, float y, float z) {
        eyeX = x;
        eyeY = y;
        eyeZ = z;
        return this;