Package com.luciad.cameras

Class PerspectiveCamera.Builder

java.lang.Object

com.luciad.cameras.PerspectiveCamera.Builder

All Implemented Interfaces:

AutoCloseable

Enclosing class:

PerspectiveCamera

public static final class PerspectiveCamera.Builder
extends Object
implements AutoCloseable

Factory object that can create new PerspectiveCamera instances.

Constructor Summary

Constructors

Constructor	Description
Builder(PerspectiveCamera.Builder other)

Method Summary

Modifier and Type	Method	Description
PerspectiveCamera	build()	Returns a new perspective camera.
void	close()
PerspectiveCamera.Builder	eye(Coordinate eye)	Sets the eye the position of the new camera.
protected void	finalize()
PerspectiveCamera.Builder	fovY(Angle fovY)	Sets the vertical field of view.
PerspectiveCamera.Builder	look(Camera.Look look)	Sets the position and orientation of the new camera.
PerspectiveCamera.Builder	lookAt(Camera.LookAt lookAt)	Sets the description of what the camera is looking at and the orientation of the camera.
PerspectiveCamera.Builder	lookFrom(Camera.LookFrom lookFrom)	Sets the description of the position and orientation of the new camera.
PerspectiveCamera.Builder	orientation(Coordinate forward, Coordinate up)	Sets the forward the viewing direction of the new camera and the camera's up direction.

Methods inherited from class java.lang.Object

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

Constructor Details

Builder

public Builder(@NotNull
 PerspectiveCamera.Builder other)

Method Details

finalize

protected void finalize()

Overrides:

finalize in class Object

close

public void close()

Specified by:

close in interface AutoCloseable

eye

@NotNull
public PerspectiveCamera.Builder eye(@NotNull
 Coordinate eye)

Sets the eye the position of the new camera.

Parameters:

eye - the position of the new camera.

Returns:

this builder

orientation

@NotNull
public PerspectiveCamera.Builder orientation(@NotNull
 Coordinate forward,
 @NotNull
 Coordinate up)

Sets the forward the viewing direction of the new camera and the camera's up direction.

Parameters:

forward - the viewing direction of the new camera

up - the camera's up direction

Returns:

this builder

look

@NotNull
public PerspectiveCamera.Builder look(@NotNull
 Camera.Look look)

Sets the position and orientation of the new camera.

Parameters:

look - the position and orientation of the new camera.

Returns:

this builder

lookAt

@NotNull
public PerspectiveCamera.Builder lookAt(@NotNull
 Camera.LookAt lookAt)

Sets the description of what the camera is looking at and the orientation of the camera.

Parameters:

lookAt - the description of what the camera is looking at and the orientation of the camera.

Returns:

this builder

lookFrom

@NotNull
public PerspectiveCamera.Builder lookFrom(@NotNull
 Camera.LookFrom lookFrom)

Sets the description of the position and orientation of the new camera.

Parameters:

lookFrom - the description of the position and orientation of the new camera.

Returns:

this builder

fovY

@NotNull
public PerspectiveCamera.Builder fovY(@NotNull
 Angle fovY)

Sets the vertical field of view.

Note

The horizontal field of view will be derived from vertical field of view based on the aspect ratio. You can convert between horizontal and vertical field-of-view angles using the following formulae:

// Vertical -> horizontal field-of-view
double aspectRatio = (double) (camera.getWidth()) / camera.getHeight();
Angle cameraFovX = Angle.fromRadians(2.0 * Math.atan(Math.tan(camera.getFovY().getRadians() / 2.0) * aspectRatio));
 
// Horizontal -> vertical field-of-view
Angle newFovX = new Angle(60.0);
Angle newFovY = Angle.fromRadians(2 * Math.atan(Math.tan(newFovX.getRadians() / 2.0) / aspectRatio));

Parameters:

fovY - the new vertical field of view.

Returns:

this builder

build

@NotNull
public PerspectiveCamera build()

Returns a new perspective camera.

Returns:

a new perspective camera.