com.bonzaiengine.camera

Class VolumeManipulator

java.lang.Object

com.bonzaiengine.camera.VolumeManipulator

All Implemented Interfaces:

ICamera, ICameraController, IInputListener

public class VolumeManipulator
extends java.lang.Object
implements ICameraController

Constructor Summary

Constructors

Constructor and Description
VolumeManipulator(Projection projection, Viewport viewport)
VolumeManipulator(SceneView sceneView)
VolumeManipulator(View view)

Method Summary

Modifier and Type	Method and Description
void	adjustProjection()
void	discardEdition(IInput input)
boolean	fitToFrustum() Fit a model, rotating around y axis, to the frustum.
boolean	fitToFrustum(IBoundable boundable)
Mat4x4	getLookAt(Mat4x4 dst) | -left.x -left.y -left.z -( left.dot.position) | | up.x up.y up.z ( up.dot.position) | | -forward.x -forward.y -forward.z -(forward.dot.position) | | 0 0 0 1 |
Projection	getProjection()
Viewport	getViewport()
IBoundable	getVolume()
float	getZoomOutFactor()
boolean	hasChanged()
boolean	isEditing()
boolean	isMouseControlledInEdition()
void	moveToCenter() Move the view (camera) to model center.
void	processInput(SceneView sceneView, IInput input) Must be called to process input actions
void	reset()
void	rotate(Vec3 vector) Rotate the camera.
void	setLookAt(Mat4x4 matrix)
void	setMouseControlledInEdition(boolean mouseControlledInEdition)
void	setProjectionParameters(float zNearRatio, float minZNear, float zFarRatio, float maxZFar)
void	setRotateXButton(boolean button1, boolean button2, boolean button3, boolean ctrl, boolean shift) set false to all arguments to disable rotation around x and y vectors
void	setRotateXYButton(boolean button1, boolean button2, boolean button3, boolean ctrl, boolean shift) set false to all arguments to disable rotation around x and y vectors
void	setRotateZButton(boolean button1, boolean button2, boolean button3, boolean ctrl, boolean shift) set false to all arguments to disable rotation around z vector
void	setRotation(Vec3 vector)
void	setStrafeButtons(boolean button1, boolean button2, boolean button3, boolean ctrl, boolean shift) set false to all arguments to disable strafe
void	setViewForward(Vec3 forward, Vec3 up)
boolean	setVolume(IBoundable boundable)
void	setZoomButtons(boolean button1, boolean button2, boolean button3, boolean ctrl, boolean shift) set false to all arguments to disable zooming
void	setZoomOutFactor(float zoomOutFactor)
void	translate(Vec3 vector) Translate the camera.
void	update(long timePassedMs) Update the camera

Methods inherited from class java.lang.Object

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

Constructor Detail

VolumeManipulator

public VolumeManipulator(SceneView sceneView)

VolumeManipulator

public VolumeManipulator(View view)

VolumeManipulator

public VolumeManipulator(Projection projection,
                         Viewport viewport)

Method Detail

getViewport

public final Viewport getViewport()

getProjection

public final Projection getProjection()

setVolume

public boolean setVolume(IBoundable boundable)

getVolume

public IBoundable getVolume()

setProjectionParameters

public final void setProjectionParameters(float zNearRatio,
                                          float minZNear,
                                          float zFarRatio,
                                          float maxZFar)

reset

public void reset()

moveToCenter

public void moveToCenter()

Move the view (camera) to model center.

setViewForward

public void setViewForward(Vec3 forward,
                           Vec3 up)

adjustProjection

public final void adjustProjection()

fitToFrustum

public boolean fitToFrustum()

Fit a model, rotating around y axis, to the frustum.
It is assumed the FOVY was the value passed in the constructor ...

fitToFrustum

public boolean fitToFrustum(IBoundable boundable)

processInput

public void processInput(SceneView sceneView,
                         IInput input)

Must be called to process input actions

Specified by:

processInput in interface IInputListener

hasChanged

public final boolean hasChanged()

setStrafeButtons

public void setStrafeButtons(boolean button1,
                             boolean button2,
                             boolean button3,
                             boolean ctrl,
                             boolean shift)

set false to all arguments to disable strafe

Parameters:

button1 -

button2 - deprecated: all mouses don't have button 2

button3 -

ctrl -

shift -

setZoomButtons

public void setZoomButtons(boolean button1,
                           boolean button2,
                           boolean button3,
                           boolean ctrl,
                           boolean shift)

set false to all arguments to disable zooming

Parameters:

button1 -

button2 - deprecated: all mouses don't have button 2

button3 -

ctrl -

shift -

setRotateZButton

public void setRotateZButton(boolean button1,
                             boolean button2,
                             boolean button3,
                             boolean ctrl,
                             boolean shift)

set false to all arguments to disable rotation around z vector

Parameters:

button1 -

button2 - deprecated: all mouses don't have button 2

button3 -

ctrl -

shift -

setRotateXYButton

public void setRotateXYButton(boolean button1,
                              boolean button2,
                              boolean button3,
                              boolean ctrl,
                              boolean shift)

set false to all arguments to disable rotation around x and y vectors

Parameters:

button1 -

button2 - deprecated: all mouses don't have button 2

button3 -

ctrl -

shift -

setRotateXButton

public void setRotateXButton(boolean button1,
                             boolean button2,
                             boolean button3,
                             boolean ctrl,
                             boolean shift)

set false to all arguments to disable rotation around x and y vectors

Parameters:

button1 -

button2 - deprecated: all mouses don't have button 2

button3 -

ctrl -

shift -

setZoomOutFactor

public final void setZoomOutFactor(float zoomOutFactor)

getZoomOutFactor

public final float getZoomOutFactor()

isEditing

public final boolean isEditing()

discardEdition

public final void discardEdition(IInput input)

setMouseControlledInEdition

public final void setMouseControlledInEdition(boolean mouseControlledInEdition)

isMouseControlledInEdition

public final boolean isMouseControlledInEdition()

update

public void update(long timePassedMs)

Description copied from interface: ICameraController

Update the camera

Specified by:

update in interface ICameraController

Parameters:

timePassedMs - elapsed time in milliseconds used to update/animate the camera.
This is usually the frame duration.

getLookAt

public Mat4x4 getLookAt(Mat4x4 dst)

Description copied from interface: ICamera

 |    -left.x    -left.y    -left.z -(   left.dot.position) |
 |       up.x       up.y       up.z  (     up.dot.position) |
 | -forward.x -forward.y -forward.z -(forward.dot.position) |
 |        0          0          0               1           |
 

Specified by:

getLookAt in interface ICamera

Parameters:

dst - destination matrix to store the look at matrix

setLookAt

public void setLookAt(Mat4x4 matrix)

Specified by:

setLookAt in interface ICameraController

Parameters:

matrix - a look at matrix

translate

public void translate(Vec3 vector)

Translate the camera. The vector is expressed in the eye axis system.

Specified by:

translate in interface ICameraController

Parameters:

vector - a translation vector in the view coordinate system

rotate

public void rotate(Vec3 vector)

Rotate the camera.

Specified by:

rotate in interface ICameraController

Parameters:

vector - rotation in radians.
Equivalent quaternion rotate: Quaternion4f.fromEulerAngles(vector.getX(), vector.getY(), vector.getZ())

setRotation

public void setRotation(Vec3 vector)