bvv.core.util

Class MatrixMath

java.lang.Object

bvv.core.util.MatrixMath

public class MatrixMath
extends Object

Method Summary

Modifier and Type	Method and Description
static org.joml.Matrix4f	affine(net.imglib2.realtransform.AffineTransform3D affine, org.joml.Matrix4f matrix) Apply a AffineTransform3D to the specified matrix.
static org.joml.Vector4f	homogPlane(net.imglib2.algorithm.kdtree.HyperPlane plane)
static net.imglib2.algorithm.kdtree.HyperPlane	hyperPlane(org.joml.Vector4f plane)
static org.joml.Matrix4f	perspective(double dCam, double dClipNear, double dClipFar, double screenWidth, double screenHeight, double screenPadding, org.joml.Matrix4f matrix) Setup projection frustum transformation such that the (BDV) screen plane at distance dCam exactly touches the frustum sides.
static org.joml.Matrix4f	screen(double dCam, double screenWidth, double screenHeight, org.joml.Matrix4f matrix) Set matrix to the "bdv screen transformation": translate the origin from the upper-left corner to the center of the screen (in XY).
static org.joml.Matrix4f	screenPerspective(double dCam, double dClipNear, double dClipFar, double screenWidth, double screenHeight, double screenPadding, org.joml.Matrix4f matrix) Setup view and projection frustum transformation such that a camera looks at (the center of) the (BDV) screen plane.
static org.joml.Matrix4f	screenPerspective(double dCam, double dClip, double screenWidth, double screenHeight, double screenPadding, org.joml.Matrix4f matrix) Setup view and projection frustum transformation such that a camera looks at (the center of) the (BDV) screen plane.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

homogPlane

public static org.joml.Vector4f homogPlane(net.imglib2.algorithm.kdtree.HyperPlane plane)

hyperPlane

public static net.imglib2.algorithm.kdtree.HyperPlane hyperPlane(org.joml.Vector4f plane)

screenPerspective

public static org.joml.Matrix4f screenPerspective(double dCam,
                                                  double dClip,
                                                  double screenWidth,
                                                  double screenHeight,
                                                  double screenPadding,
                                                  org.joml.Matrix4f matrix)

Setup view and projection frustum transformation such that a camera looks at (the center of) the (BDV) screen plane.

Parameters:

dCam - distance camera to z=0 plane

dClip - visible depth away from z=0 in both directions

screenWidth - the width of the screen

screenHeight - the height of the screen

screenPadding - additional padding on all sides of the screen plane

matrix - is set to the screenPerspective transformation and returned

screenPerspective

public static org.joml.Matrix4f screenPerspective(double dCam,
                                                  double dClipNear,
                                                  double dClipFar,
                                                  double screenWidth,
                                                  double screenHeight,
                                                  double screenPadding,
                                                  org.joml.Matrix4f matrix)

Setup view and projection frustum transformation such that a camera looks at (the center of) the (BDV) screen plane.

Parameters:

dCam - distance camera to z=0 plane

dClipNear - visible depth away from z=0 towards camera

dClipFar - visible depth away from z=0 away from camera

screenWidth - the width of the screen

screenHeight - the height of the screen

screenPadding - additional padding on all sides of the screen plane

matrix - is set to the screenPerspective transformation and returned

screen

public static org.joml.Matrix4f screen(double dCam,
                                       double screenWidth,
                                       double screenHeight,
                                       org.joml.Matrix4f matrix)

Set matrix to the "bdv screen transformation":

1. translate the origin from the upper-left corner to the center of the screen (in XY).
2. translate the origin back from the screen by dCam in Z

This corresponds to a camera in front of the screen, looking at (the center of) the (BDV) screen plane. It transforms coordinates in the BDV screen coordinate system (X left, Y down, Z into the screen, origin at the upper-left screen corner) to BVV camera coordinates (still X left, Y down, Z into the screen, but origin in XY center of the screen, and in front of the screen by z=dCam).

Parameters:

dCam - distance camera to z=0 plane

screenWidth - the width of the screen

screenHeight - the height of the screen

matrix - is set to the screen transformation and returned

perspective

public static org.joml.Matrix4f perspective(double dCam,
                                            double dClipNear,
                                            double dClipFar,
                                            double screenWidth,
                                            double screenHeight,
                                            double screenPadding,
                                            org.joml.Matrix4f matrix)

Setup projection frustum transformation such that the (BDV) screen plane at distance dCam exactly touches the frustum sides. Also invert the Y and Z axes to rotate from BVV camera coordinates (right-handed, X left, Y down, Z into screen) to OpenGL (right-handed, X left, Y up, Z out of screen) coordinates.

Parameters:

dCam - distance camera to z=0 plane

dClipNear - visible depth away from z=0 towards camera

dClipFar - visible depth away from z=0 away from camera

screenWidth - the width of the screen

screenHeight - the height of the screen

screenPadding - additional padding on all sides of the screen plane

matrix - is set to the screenPerspective transformation and returned

affine

public static org.joml.Matrix4f affine(net.imglib2.realtransform.AffineTransform3D affine,
                                       org.joml.Matrix4f matrix)

Apply a AffineTransform3D to the specified matrix.

Parameters:

affine - the affine transformation

matrix - affine transformation is applied to this matrix