PerspectiveCamera
Camera that uses perspective projection. This projection mode is designed to mimic the way the human eye sees. It is the most common projection mode used for rendering a 3D scene.
Hierarchy
- Camera3D
- PerspectiveCamera
Constructors
constructor
- new PerspectiveCamera(
fov?: number,
aspect?: number,
near?: number,
far?: number,
): PerspectiveCameraParameters
- fov: number
- aspect: number
- near: number
- far: number
Returns PerspectiveCamera
Properties
StaticDefaultVector3(0, 1, 0)
Every objects in 3D space must have a default up direction.
id
Unique number for each object3D instance.
category
Reserved attribute
source
Record the object rendered as instance or other type.
scene
The scene which this object belong to.
update-1
The number is the frame id which this object is changed or participates change of scene graph. If this value equals to frame id - 1,
name
The name of this object, it is empty if useless.
is
Used to check type of this or extended instance. This value should not be changed by user.
parent
Object's parent node in the scene graph. An object can have at most one parent.
children
Array with object's children.
up
This is used by the lookAt method, for example, to determine the orientation of the result. Default is DefaultUp .
world
Record when this object's world matrix last updated.
transform
Record whether the object's any attribute| attribute is updated.
visible
matrix
The global transform of the object. If the Object3D has no parent, then it's identical to the local transform matrix.
matrixfalse
When this is set, it calculates the matrixWorld in that frame and resets this property to false.
net
Record if the object is really visible in rendering process. If the Object3D has no parent, it would be set by visible ;
localfalse
When this is set, it calculates the model matrix in that frame and resets this property to false.
enable
enable
is
Check the type whether it belongs to Camera3D. This value should not be changed by user.
type
The type of this Object3D.
matrix
This is the inverse of matrixWorld. MatrixWorld contains the Matrix which has the world transform of the Camera3D.
world
world
projection
This matrix decides the method of projection such as perspective and orthographic.
projection
The inverse matrix of projectionMatrix .
bounds
This is used to adapt the bounds of camera to canvas.
Readonlyis
Check the type whether it belongs to PerspectiveCamera. This value should not be changed by user.
view
Frustum window specification or null. This is set using the setViewOffset method and cleared using clearViewOffset .
film
Film size used for the larger axis. Default is 35 (millimeters). This parameter does not influence the projection matrix unless filmOffset is set to a nonzero value.
film0
Horizontal off-center offset in the same unit as filmGauge .
Readonlyuser
_
uuid
_
Accessors
layers
interaction
group
position
Returns Vector3
rotation
Returns Euler
quaternion
Returns Quaternion
Object's local rotation as a Quaternion.
Parameters
- _quaternion: Quaternion
Returns void
Remarks
See Quaternion for more details.
scaleVector3( 1, 1, 1 )
Returns Vector3
matrix
Parameters
- value: Matrix4
Returns void
visibletrue
- get visible(): boolean
Object gets rendered if true.
Returns boolean
- set visible(value: boolean): void
Parameters
- value: boolean
Returns void
is
- get isTwoPointPerspectiveViewEnabled(): boolean
This effect can elongate models when camera looks up or down.
Returns boolean
- set isTwoPointPerspectiveViewEnabled(v: boolean): void
Parameters
- v: boolean
Returns void
fov
- get fov(): number
Camera frustum vertical field of view, from bottom to top of view, in degrees.
Returns number
- set fov(v: number): void
Parameters
- v: number
Returns void
zoom
- get zoom(): number
Scale width and height of view frustum.
Returns number
- set zoom(v: number): void
Parameters
- v: number
Returns void
near
- get near(): number
Distance from camera position to small plane of view frustum.
Returns number
- set near(v: number): void
Parameters
- v: number
Returns void
far
- get far(): number
Distance from camera position to big plane of view frustum.
Returns number
- set far(v: number): void
Parameters
- v: number
Returns void
focus10
- get focus(): number
Object distance used for stereoscopy and depth-of-field effects.
Returns number
- set focus(v: number): void
Parameters
- v: number
Returns void
aspect
- get aspect(): number
Full screen width divided by its height in case of more view, this value equals to fov when there was only one viewer.
Returns number
- set aspect(v: number): void
Parameters
- v: number
Returns void
business
- get businessTag(): string
Returns string
- set businessTag(v: string): void
Parameters
- v: string
Returns void
Methods
destroy
Returns void
free
Returns void
sync
Returns void
update
Scene will check the object's visibility in each render and make change netVisibility based on its and parent's visible .
Returns boolean
clear
set
If the local matrix is changed, use this method to manually refresh data in scene graph.
Returns void
Tips
It's better to use notifySceneChange() as an alternative.
notify
Use this method to manually refresh data in scene graph and draw again. The engine may not notify every change of the scene. If any effect is not changed with the parameters, use this may solve.
Returns void
set
If the local matrix or world matrix is changed, use this method to make engine refresh data in scene graph automatically. This method will set matrixWorldNeedsUpdate and localMatrixNeedUpdate to true.
Returns void
update
Change matrixWorldNeedsUpdate and worldMatrixUpdateTimestamp state. This method will refresh data of world matrix by updateMatrixWorld
Parameters
- updateID: number
This number is used to identify the render.
Returns boolean
- updateID: number
is
If there are zero or two negative numbers in xyz, return false, otherwise return true.
Returns boolean
local
world
apply
Applies the matrix transform to the object and updates the object's position, rotation and scale.
Parameters
- matrix: Matrix4
A matrix represents the information of transform.
Returns void
- matrix: Matrix4
apply
Applies the rotation represented by the quaternion to the object.
Parameters
- q: Quaternion
A Quaternion represents the information of rotation.
Returns this
- q: Quaternion
set
Calls setFromAxisAngle ( axis, angle ) on the Quaternion.
Parameters
- axis: Vector3
A normalized vector in object space.
- angle: number
Angle in radians.
Returns void
- axis: Vector3
set
Calls Quaternion.setRotationFromEuler| setRotationFromEuler(euler, true) on the Quaternion.
Parameters
- euler: Euler
Euler angle specifying rotation amount.
Returns void
- euler: Euler
set
Calls setFromRotationMatrix (m) on the Quaternion.
Parameters
- m: Matrix4
Euler angle specifying rotation amount.
Returns void
- m: Matrix4
set
Copy the given quaternion to object's quaternion .
Parameters
- q: Quaternion
Euler angle specifying rotation amount.
Returns void
- q: Quaternion
rotate
Rotate an object along an axis in object space. The axis is assumed to be normalized.
Parameters
- axis: Vector3
A normalized vector in object space.
- angle: number
Angle in radians.
Returns this
- axis: Vector3
rotate
Rotate an object along an axis in world space. The axis is assumed to be normalized. Method Assumes no rotated parent.
Parameters
- axis: Vector3
A normalized vector in object space.
- angle: number
Angle in radians.
Returns this
- axis: Vector3
rotate
Rotates the object around x axis in local space.
Parameters
- angle: number
The angle to rotate in radians.
Returns this
- angle: number
rotate
Rotates the object around x axis in local space.
Parameters
- angle: number
The angle to rotate in radians.
Returns this
- angle: number
rotate
Rotates the object around x axis in local space.
Parameters
- angle: number
The angle to rotate in radians.
Returns this
- angle: number
translate
Translate an object by distance along an axis in object space. The axis is assumed to be normalized.
Parameters
- axis: Vector3
A normalized vector in object space.
- distance: number
The distance to translate.
Returns this
- axis: Vector3
translate
Translates object along x axis in object space by distance units.
Parameters
- distance: number
The distance to translate.
Returns this
- distance: number
translate
Translates object along y axis in object space by distance units.
Parameters
- distance: number
The distance to translate.
Returns this
- distance: number
translate
Translates object along z axis in object space by distance units.
Parameters
- distance: number
The distance to translate.
Returns this
- distance: number
look
Rotates the object to face to a point in world space. This method does not support objects having non-uniformly-scaled parent(s)
Parameters
- _x: Vector3
A vector representing position of target in world space.
Returns void
- _x: Vector3
look
Rotates the object to face a point in local space.
Parameters
- _x: Vector3
A vector representing position of target in local space.
Returns void
- _x: Vector3
add
Adds object as child of this object. An arbitrary number of objects may be added. Any current parent on an object passed in here will be removed, since an object can have at most one parent. The scene graph change will be immediately notify by engine after adding nodes.
Parameters
Returns this
remove
Remove the specified object form children.
Parameters
- object: Object3D
The object which needs to be removed.
Returns this
- object: Object3D
remove
Returns void
remove
Remove all children of this object.
Returns Object3D[]
remove
Remove all children in specified objects from this objects. Migrate from tools common
Parameters
- objects: Object3D[]
An array of objects which need to be removed.
Returns this
- objects: Object3D[]
get
Searches through an object and its children, starting with the object itself, and returns the first with a matching id. Note that ids are assigned in chronological order: 1, 2, 3, ..., incrementing by one for each new object.
Parameters
- id: number
Unique number of the object instance.
Returns Object3D
- id: number
get
Searches through an object and its children, starting with the object itself, and returns the first with a matching name. Note that for most objects the name is an empty string by default. You will have to set it manually to make use of this method.
Parameters
- name: string
String to match to the children's Object3D.name property.
Returns Object3D
- name: string
get
Searches through an object and its children, starting with the object itself, and returns the first with a property that matches the value given.
Parameters
- name: string
The property name to search for.
- value: any
Value of the given property.
Returns Object3D
- name: string
get
get
Return a quaternion representing the rotation of the object in world space.
Parameters
- target: Quaternion
the result will be copied into this Quaternion.
Returns Quaternion
- target: Quaternion
get
traverse
Execute the callback on this object and all descendants.
Parameters
- callback: (object: Object3D) => any
A function with as first argument an object3D object.
Returns void
- callback: (object: Object3D) => any
traverse
Execute the callback when return is false, stop traverse the object's descendants.
Parameters
- callback: (object: Object3D) => boolean
A function with as first argument an object3D object, return boolean.
Returns void
- callback: (object: Object3D) => boolean
traverse
Execute the callback on this object and all descendants which is visible.
Parameters
- callback: (object: Object3D) => any
A function with as first argument an object3D object.
Returns void
- callback: (object: Object3D) => any
traverse
Execute the callback on this object and all ancestors.
Parameters
- callback: (object: Object3D) => any
A function with as first argument an object3D object.
Returns void
- callback: (object: Object3D) => any
update
Update the matrix local transform.
Returns void
get
get
Get UUID of this object instance. This value is automatically assigned, so this shouldn't be edited.
Returns string
notify
Make the engine to render the scene again.
Returns void
get
update
Update the camera's matrixWorld and matrixWorldInverse .
Parameters
- updateParents: boolean
if true, it also updates all the parents.
- updateChildren: boolean
if true, it also updates all the children.
- force: boolean
Whether or not force to updates the matrix.
Returns void
- updateParents: boolean
update
Parameters
- jitter: ReadonlyVector2
Returns void
get
- getJitter(): Readonly<
Pick<
ReadonlyMarked,
| "_readonly_mark"
| "cloneReadonly"
| "clone"
| "equals"
| "getSerializeData"
| "x"
| "y"
| "getNumberCount"
| "toArray"
| "width"
| "height"
| "isVector2"
| "dot"
| "cross"
| "lengthSq"
| "length"
| "angle"
| "manhattanLength"
| "distanceTo"
| "distanceToSquared"
| "manhattanDistanceTo"
| "intoSize",
>,
>Returns Readonly<
Pick<
ReadonlyMarked,
| "_readonly_mark"
| "cloneReadonly"
| "clone"
| "equals"
| "getSerializeData"
| "x"
| "y"
| "getNumberCount"
| "toArray"
| "width"
| "height"
| "isVector2"
| "dot"
| "cross"
| "lengthSq"
| "length"
| "angle"
| "manhattanLength"
| "distanceTo"
| "distanceToSquared"
| "manhattanDistanceTo"
| "intoSize",
>,
>
update
Returns void
pixels
return a function that compute pixelsPerUnit
Parameters
- viewHeight: number
Returns (distance: number) => number
get
Calculate a scale value that keep one object's screen unit size match it's world unit size
Parameters
- distance: number
the distance from camera to object.
- viewHeight: number
the hight of view window.
Returns number
- distance: number
update
Update the camera's Object3D.matrixWorld| matrixWorld and matrixWorldInverse .
Parameters
- force: boolean
Whether or not force to updates the matrix.
Returns void
- force: boolean
class
The name of instance's class.
Returns string
copy
Copy the data to this camera instance from source. This method need override in derived classes to copy extended data.
Parameters
- source: PerspectiveCamera
the data source.
- recursive: boolean
if true, descendants of the object are also cloned. Default is true.
Returns this
- source: PerspectiveCamera
get
The tangent value of camera frustum's vertical angle.
Returns number
get
As name says
Parameters
- viewHeight: number
Returns number
pixels
Calculate how many screen pixel match one world unit at given distance.
Parameters
- distance: number
the distance from camera to object.
- viewHeight: number
the hight of view window.
Returns number
- distance: number
cast
setThe default film gauge is 35, so that the focal length can be specified for a 35mm (full frame) camera.
Sets the FOV by focal length in respect to the current filmGauge . Values for focal length and film gauge must have the same unit.
Parameters
- focalLength: number
Returns void
get
get
Returns the current vertical field of view angle in degrees considering zoom .
Returns number
get
Returns the width of the image on the film. If .aspect is greater than or equal to one (landscape format), the result equals filmGauge .
Returns number
get
Returns the height of the image on the film. If .aspect is less than or equal to one (portrait format), the result equals filmGauge .
Returns number
set
- setViewOffset(
fullWidth: number,
fullHeight: number,
x: number,
y: number,
width: number,
height: number,
): voidSets an offset in a larger frustum. This is useful for multi-window or multi-monitor/multi-machine setups. For example, if you have 3x2 monitors and each monitor is 1920x1080 and the monitors are in grid like this:
+---+---+---+
| A | B | C |
+---+---+---+
| D | E | F |
+---+---+---+
then for each monitor you would call it like this:let w = 1920; let h = 1080; let fullWidth = w * 3; let fullHeight = h * 2; // A camera.setOffset( fullWidth, fullHeight, w * 0, h * 0, w, h ); // B camera.setOffset( fullWidth, fullHeight, w * 1, h * 0, w, h ); // C camera.setOffset( fullWidth, fullHeight, w * 2, h * 0, w, h ); // D camera.setOffset( fullWidth, fullHeight, w * 0, h * 1, w, h ); // E camera.setOffset( fullWidth, fullHeight, w * 1, h * 1, w, h ); // F camera.setOffset( fullWidth, fullHeight, w * 2, h * 1, w, h );Parameters
- fullWidth: number
full width of multi-view setup.
- fullHeight: number
full height of multi-view setup.
- x: number
horizontal offset of sub-camera.
- y: number
vertical offset of sub-camera.
- width: number
width of sub-camera.
- height: number
height of sub-camera.
Returns void
- fullWidth: number
clear
Removes any offset set by the setViewOffset method.
Returns void
update
Updates the camera's projectionMatrix and projectionMatrixInverse . When user change the attribute such as far, top ..., this method will have to be called for the changes to take effect.
Parameters
Returns void
serialize
Store the attributes of this class into string as serializing format.
Parameters
- ctx: Serializer
an instance used to store the data of scene objects.
Returns void
- ctx: Serializer
deserialize
Parse the data for this class from string according to serializing format.
Parameters
- ctx: Deserializer
an instance give the method to take the data for attribute.
Returns void
- ctx: Deserializer
clone
mark
Parameters
- v: string
Returns this
is
Returns boolean
validate
Returns void
destroy
Returns void
free
Returns void
on
once
has
off
emit
Active the event and call the registered listener.
Parameters
- type: EventType<never>
Returns void
clear
Removes all listeners from listening list.
Returns void
Camera that uses perspective projection. This projection mode is designed to mimic the way the human eye sees. It is the most common projection mode used for rendering a 3D scene.