import {Ortho} from '@xeokit/xeokit-sdk/src/viewer/scene/camera/Ortho.js'

public class | source

Ortho

Extends:

Component → Ortho

Defines its Camera's orthographic projection as a box-shaped view volume.

Located at Camera#ortho.
Works like Blender's orthographic projection, where the positions of the left, right, top and bottom planes are implicitly indicated with a single Ortho#scale property, which causes the frustum to be symmetrical on X and Y axis, large enough to contain the number of units given by Ortho#scale.
Ortho#near and Ortho#far indicated the distances to the WebGL clipping planes.

Member Summary

Public Members
public	camera: Camera The Camera this Ortho belongs to.
public set	far(value: Number) Sets the position of the Ortho's far plane on the positive View-space Z-axis. Fires a "far" event on change. Default value is `10000.0`.
public get	far: Number: * Gets the position of the Ortho's far plane on the positive View-space Z-axis. Default value is `10000.0`.
public get	inverseMatrix: Number[]: * Gets the inverse of Ortho#matrix.
public get	matrix: Number[]: * Gets the Ortho's projection transform matrix. Fires a "matrix" event on change. Default value is `[1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]`.
public set	near(value: Number) Sets the position of the Ortho's near plane on the positive View-space Z-axis. Fires a "near" emits on change. Default value is `0.1`.
public get	near: Number: * Gets the position of the Ortho's near plane on the positive View-space Z-axis. Default value is `0.1`.
public set	scale(value: Number) Sets scale factor for this Ortho's extents on X and Y axis. Clamps to minimum value of `0.01. Fires a "scale" event on change. Default value is `1.0`
public get	scale: Number: * Gets scale factor for this Ortho's extents on X and Y axis. Clamps to minimum value of `0.01. Default value is `1.0`
public get	transposedMatrix: Number[]: * Gets the transpose of Ortho#matrix.

Method Summary

Public Methods
public	unproject(canvasPos: Number[], screenZ: Number, screenPos: Number[], viewPos: Number[], worldPos: Number[]): * Un-projects the given Canvas-space coordinates, using this Ortho projection.

Inherited Summary

From class Component
public get	owner: Component The Component that owns the lifecycle of this Component, if any.
public	destroyed: Boolean True as soon as this Component has been destroyed
public	id: String \| Number ID of this Component, unique within the Scene.
public	meta: * Arbitrary, user-defined metadata on this component.
public	scene: Scene The parent Scene that contains this Component.
public	viewer: Viewer The viewer that contains this Scene.
public	clear() Destroys all Components that are owned by this.
public	destroy() Destroys this component.
public	error(message: String) Logs an error for this component to the JavaScript console.
public	fire(event: String, value: Object, forget: Boolean) Fires an event on this component.
public	hasSubs(event: String): Boolean Returns true if there are any subscribers to the given event on this component.
public	isType(type: ): : Boolean Tests if this component is of the given type, or is a subclass of the given type.
public	log(message: String) Logs a console debugging message for this component.
public	off(subId: String) Cancels an event subscription that was previously made with Component#on or Component#once.
public	on(event: String, callback: Function, scope: Object): String Subscribes to an event on this component.
public	once(event: String, callback: Function, scope: Object) Subscribes to the next occurrence of the given event, then un-subscribes as soon as the event is subIdd.
public	scheduleTask(task: *) Schedule a task to perform on the next browser interval
public	warn(message: String) Logs a warning for this component to the JavaScript console.

Public Members

public camera: Camera source

The Camera this Ortho belongs to.

Properties:

Name	Type	Attribute	Description
camera	*

public set far(value: Number) source

Sets the position of the Ortho's far plane on the positive View-space Z-axis.

Fires a "far" event on change.

Default value is 10000.0.

public get far: Number: * source

Gets the position of the Ortho's far plane on the positive View-space Z-axis.

Default value is 10000.0.

Return:

Number

New far ortho plane position.

public get inverseMatrix: Number[]: * source

Gets the inverse of Ortho#matrix.

Return:

Number[]

The inverse of Ortho#matrix.

public get matrix: Number[]: * source

Gets the Ortho's projection transform matrix.

Fires a "matrix" event on change.

Default value is [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1].

Return:

Number[]

The Ortho's projection matrix.

public set near(value: Number) source

Sets the position of the Ortho's near plane on the positive View-space Z-axis.

Fires a "near" emits on change.

Default value is 0.1.

public get near: Number: * source

Gets the position of the Ortho's near plane on the positive View-space Z-axis.

Default value is 0.1.

Return:

Number

New Ortho near plane position.

public set scale(value: Number) source

Sets scale factor for this Ortho's extents on X and Y axis.

Clamps to minimum value of `0.01.

Fires a "scale" event on change.

Default value is 1.0

public get scale: Number: * source

Gets scale factor for this Ortho's extents on X and Y axis.

Clamps to minimum value of `0.01.

Default value is 1.0

Return:

Number

New Ortho scale value.

public get transposedMatrix: Number[]: * source

Gets the transpose of Ortho#matrix.

Return:

Number[]

The transpose of Ortho#matrix.

Public Methods

public unproject(canvasPos: Number[], screenZ: Number, screenPos: Number[], viewPos: Number[], worldPos: Number[]): * source

Un-projects the given Canvas-space coordinates, using this Ortho projection.

Params:

Name	Type	Attribute	Description
canvasPos	Number[]		Inputs 2D Canvas-space coordinates.
screenZ	Number		Inputs Screen-space Z coordinate.
screenPos	Number[]		Outputs 3D Screen/Clip-space coordinates.
viewPos	Number[]		Outputs un-projected 3D View-space coordinates.
worldPos	Number[]		Outputs un-projected 3D World-space coordinates.