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

# [name]

Telecamera che utilizza la [link:https://en.wikipedia.org/wiki/Perspective_(graphical) proiezione prospettica].
Questa modalità di proiezione è progettata per imitare il modo in cui l'occhio umano vede. È la proiezione più comunemente utilizzata per il rendering di una scena 3D.

## Codice di Esempio

`const camera = new THREE.PerspectiveCamera( 45, width / height, 1, 1000 ); scene.add( camera );`

## Esempi

[example:webgl_animation_skinning_blending animation / skinning / blending ]
[example:webgl_animation_skinning_morph animation / skinning / morph ]
[example:webgl_effects_stereo effects / stereo ]
[example:webgl_interactive_cubes interactive / cubes ]
[example:webgl_loader_collada_skinning loader / collada / skinning ]

## Costruttore

### [name]( [param:Number fov], [param:Number aspect], [param:Number near], [param:Number far] )

fov — Campo visivo verticale del frustum della telecamera.
aspect — Aspect ratio del frustum della telecamera.
near — Piano near del frustum della telecamera.
far — Piano far del frustum della telecamera.
Queste proprietà insieme definiscono il [link:https://en.wikipedia.org/wiki/Viewing_frustum frustum visivo] della telecamera.

## Proprietà

Vedi la classe base [page:Camera] per le proprietà comuni.
Si noti che dopo aver apportato modifiche alla maggior parte di queste proprietà sarà necessario chiamare il metodo [page:PerspectiveCamera.updateProjectionMatrix .updateProjectionMatrix] affinché le modifiche abbiano effetto.

### [property:Float aspect]

Aspect ratio del frustum della telecamera, di solito calcolato con la larghezza del canvas / l'altezza del canvas. Il valore predefinito è `1` (canvas quadrato).

### [property:Float far]

Piano far del frustum della telecamera. Il valore predefinito è `2000`.
Deve essere maggiore del valore corrente del piano [page:.near near].

### [property:Float filmGauge]

Dimensioni della pellicola utilizzata per l'asse maggiore. Il valore predefinito è 35 (millimetri). Questo parametro non influenza la matrice di proiezione a meno che .filmOffset non sia impostato su un valore diverso da zero.

### [property:Float filmOffset]

Offset orizzontale decentrato nella stessa unità di `.filmGauge`. Il valore predefinito è `0`.

### [property:Float focus]

Distanza dell'oggetto utilizzata per la stereoscopia e gli effetti di profondità di campo. Questo parametro non influenza la matrice di proiezione a meno che non venga utilizzata una [page:StereoCamera]. Il valore predefinito è `10`.

### [property:Float fov]

Campo visivo verticale del frustum della telecamera, dal basso all'alto della vista, in gradi. Il valore predefinito è `50`.

### [property:Boolean isPerspectiveCamera]

Flag di sola lettura che verifica se la telecamera è di tipo [name].

### [property:Float near]

Piano near del frustum della telecamera. Il valore predefinito è `0.1`.
L'intervallo valido è tra `0` e il valore corrente del piano [page:.far far]. Si noti che, diversamente dalla [page:OrthographicCamera], `0` non è un valore valido per il piano near della PerspectiveCamera.

### [property:Object view]

Specifica la window del frustum o null. Questo valore viene impostato utilizzando il metodo [page:PerspectiveCamera.setViewOffset .setViewOffset] e cancellato utilizzando il metodo [page:PerspectiveCamera.clearViewOffset .clearViewOffset].

### [property:number zoom]

Ottiene o imposta il fattore zoom della telecamera. Il valore predefinito è `1`.

## Metodi

Vedi la classe base [page:Camera] per i metodi comuni.

### [method:undefined clearViewOffset]()

Rimuove qualsiasi offset impostato dal metodo [page:PerspectiveCamera.setViewOffset .setViewOffset].

### [method:Float getEffectiveFOV]()

Restituisce l'angolo verticale del campo visivo corrente in gradi considerando .zoom.

### [method:Float getFilmHeight]()

Restituisce l'altezza dell'immagine sulla pellicola. Se .aspect è minore o uguale a uno (formato verticale), il risultato è uguale a .filmGauge.

### [method:Float getFilmWidth]()

Restituisce la larghezza dell'immagine sulla pellicola. Se .aspect è maggiore o uguale ad uno (formato orizzontale), il risultato è uguale a .filmGauge.

### [method:Float getFocalLength]()

Restituisce la lunghezza focale del .fov corrente rispetto a .filmGauge.

### [method:undefined setFocalLength]( [param:Float focalLength] )

Imposta il valore FOV in base alla lunghezza focale rispetto al [page:PerspectiveCamera.filmGauge .filmGauge] corrente.
Per impostazione predefinita, la lunghezza focale è specificata per una telecamera da 35mm (full frame).

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

fullWidth — larghezza totale dell'impostazione multiview
fullHeight — altezza totale dell'impostazione multiview
x — offset orizzontale della telecamera secondaria
y — offset verticale della telecamera secondaria
width — larghezza della telecamera secondaria
height — altezza della telecamera secondaria

Imposta un offset in un frustum più ampio. È utile per le configurazioni multi-window o multi-monitor/multi-machine.

Per esempio, se si dispone di 3x2 monitor e ogni monitor è un 1920x1080 e i monitor sono disposti in una griglia come questa:

    +---+---+---+
    | A | B | C |
    +---+---+---+
    | D | E | F |
    +---+---+---+

allora per ogni monitor il metodo verrebbe chiamato in questo modo:
`const w = 1920; const h = 1080; const fullWidth = w * 3; const 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 );` Si noti che non c'è motivo per cui i monitor debbano essere della stessa dimensione o in una griglia.

### [method:undefined updateProjectionMatrix]()

Aggiorna la matrice di proiezione della telecamera. Deve essere chiamato dopo ogni modifica dei parametri.

### [method:Object toJSON]([param:Object meta])

meta -- oggetto contenente metadati come texture o immagini nei discendenti degli oggetti.
Converte la fotocamera nel [link:https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 formato JSON Object/Scene] di three.js.

## Source

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