[page:Object3D] → [page:Camera] →

# [name]

Camera with perspective projection.

## Example

[example:canvas_geometry_birds geometry / birds ]
[example:canvas_geometry_cube geometry / cube ]
[example:webgl_animation_skinning_blending animation / skinning / blending ]
[example:webgl_animation_skinning_morph animation / skinning / blending ]
[example:webgl_effects_stereo effects / stereo ]
[example:webgl_interactive_cubes interactive / cubes ]
[example:webgl_loader_collada_skinning loader / collada / skinning ]
`var camera = new THREE.PerspectiveCamera( 45, width / height, 1, 1000 ); scene.add( camera );`

## Constructor

### [name]( [page:Float fov], [page:Float aspect], [page:Float near], [page:Float far] )

fov — Camera frustum vertical field of view.
aspect — Camera frustum aspect ratio.
near — Camera frustum near plane.
far — Camera frustum far plane.

## Properties

### [property:Float fov]

Camera frustum vertical field of view, from bottom to top of view, in degrees.

### [property:number zoom]

Gets or sets the zoom factor of the camera.

### [property:Float near]

Camera frustum near plane.

### [property:Float far]

Camera frustum far plane.

### [property:Float focus]

Object distance used for stereoscopy and depth-of-field effects. This parameter does not influence the projection matrix unless a StereoCamera is being used.

### [property:Float aspect]

Camera frustum aspect ratio, window width divided by window height.

### [property:Object view]

Frustum window specification or null.

### [property:Float filmGauge]

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.

### [property:Float filmOffset]

Horizontal off-center offset in the same unit as .filmGauge.

## Methods

### [method:Float getEffectiveFOV]()

Returns the current vertical field of view angle in degrees considering .zoom.

### [method:Float getFocalLength]()

Returns the focal length of the current .fov in respect to .filmGauge.

### [method:Float getFilmWidth]()

Returns the width of the image on the film. If .aspect is greater than or equal to one (landscape format), the result equals .filmGauge.

### [method:Float getFilmHeight]()

Returns the height of the image on the film. If .aspect is less than or equal to one (portrait format), the result equals .filmGauge.

### [method:null setFocalLength]( [page:Float focalLength] )

Sets the FOV by focal length in respect to the current .filmGauge.
By default, the focal length is specified for a 35mm (full frame) camera.

### [method:null setLens]( [page:Float focalLength], [page:Float filmGauge] )

focalLength — focal length
frameGauge — film gauge
Sets .fov by focal length. Optionally also sets .filmGauge. This method is deprecated, please use .setFocalLength instead.

### [method:null setViewOffset]( [page:Float fullWidth], [page:Float fullHeight], [page:Float x], [page:Float y], [page:Float width], [page:Float height] )

fullWidth — full width of multiview setup
fullHeight — full height of multiview setup
x — horizontal offset of subcamera
y — vertical offset of subcamera
width — width of subcamera
height — height of subcamera
Sets 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:
`var w = 1920; var h = 1080; var fullWidth = w * 3; var fullHeight = h * 2; // A camera.setViewOffset( fullWidth, fullHeight, w * 0, h * 0, w, h ); // B camera.setViewOffset( fullWidth, fullHeight, w * 1, h * 0, w, h ); // C camera.setViewOffset( fullWidth, fullHeight, w * 2, h * 0, w, h ); // D camera.setViewOffset( fullWidth, fullHeight, w * 0, h * 1, w, h ); // E camera.setViewOffset( fullWidth, fullHeight, w * 1, h * 1, w, h ); // F camera.setViewOffset( fullWidth, fullHeight, w * 2, h * 1, w, h );` Note there is no reason monitors have to be the same size or in a grid.

### [method:null clearViewOffset]()

Removes any offset set by the .setViewOffset method.

### [method:null updateProjectionMatrix]()

Updates the camera projection matrix. Must be called after change of parameters.

### [method:PerspectiveCamera clone]()

It returns a clone of PerspectiveCamera.

### [method:JSON toJSON]()

Return camera data in JSON format.

## Source

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]