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

[name]

Câmera que usa projeção [link:https://en.wikipedia.org/wiki/Perspective_(graphical) perspectiva].

Este modo de projeção é desenvolvido para imitar a forma como o olho humano enxerga. É o modo de projeção mais comum usado para renderizar uma cena 3D.

Exemplo de Código

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

Exemplos

[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 ]

Construtor

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

fov — Campo de visão vertical do tronco da câmera.
aspect — Taxa de proporção do tronco da câmera.
near — Plano próximo do tronco da câmera.
far — Plano distante do tronco da câmera.

Juntos, eles definem a visão do [link:https://en.wikipedia.org/wiki/Viewing_frustum tronco] (frustrum) da câmera.

Propriedades

Veja a classe base [page:Camera] para propriedades comuns.
Observe que depois de fazer alterações na maioria dessas propriedades, você terá que chamar [page:PerspectiveCamera.updateProjectionMatrix .updateProjectionMatrix] para que as alterações tenham efeito.

[property:Float aspect]

Taxa de proporção do tronco da câmera, geralmente a largura do canvas / altura do canvas. O padrão é `1` (canvas quadrado).

[property:Float far]

Plano distante do tronco da câmera. O padrão é `2000`.

Deve ser maior que o valor atual do plano [page:.near near] (próximo).

[property:Float filmGauge]

Tamanho do filme usado para o eixo maior. O padrão é 35 (milímetros). Este parâmetro não influencia a matriz de projeção, a menos que .filmOffset seja definido como um valor diferente de zero.

[property:Float filmOffset]

Deslocamento horizontal descentralizado na mesma unidade que `.filmGauge`. O padrão é '0'.

[property:Float focus]

Distância do objeto usada para efeitos de estereoscopia e profundidade de campo. Este parâmetro não influencia a matriz de projeção a menos que uma [page:StereoCamera] esteja sendo usada. O padrão é `10`.

[property:Float fov]

Campo de visão vertical do tronco da câmera, de baixo para cima, em graus. O padrão é `50`.

[property:Boolean isPerspectiveCamera]

Sinalizador somente leitura para verificar se um determinado objeto é do tipo [name].

[property:Float near]

Plano próximo do tronco da câmera. O padrão é `0.1`.

O intervalo válido é maior que 0 e menor que o valor atual do plano [page:.far far] (distante). Observe que, diferentemente da [page:OrthographicCamera], `0` não é um valor válido para um plano próximo da PerspectiveCamera.

[property:Object view]

Especificação do tronco da janela ou null. Isso é definido usando o método [page:PerspectiveCamera.setViewOffset .setViewOffset] e limpo usando [page:PerspectiveCamera.clearViewOffset .clearViewOffset].

[property:number zoom]

Obtém ou define o fator de zoom da câmera. O padrão é `1`.

Métodos

Veja a classe base [page:Camera] para métodos comuns.

[method:undefined clearViewOffset]()

Remove qualquer deslocamento definido pelo método [page:PerspectiveCamera.setViewOffset .setViewOffset].

[method:Float getEffectiveFOV]()

Retorna o ângulo de visão vertical atual em graus considerando .zoom.

[method:Float getFilmHeight]()

Retorna a altura da imagem no filme. Se .aspect for menor ou igual a um (formato retrato), o resultado é igual a .filmGauge.

[method:Float getFilmWidth]()

Retorna a largura da imagem no filme. Se .aspect for maior ou igual a um (formato paisagem), o resultado é igual a .filmGauge.

[method:Float getFocalLength]()

Retorna a distância focal do .fov atual em relação ao .filmGauge.

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

Define o FOV por distância focal em relação ao [page:PerspectiveCamera.filmGauge .filmGauge] atual.

Por padrão, a distância focal é especificada para uma câmera de 35 mm (full frame).

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

fullWidth — largura total da configuração multiview
fullHeight — altura total da configuração multiview
x — deslocamento horizontal da subcâmera
y — deslocamento vertical da subcâmera
width — largura da subcâmera
height — altura da subcâmera

Define um deslocamento em um tronco maior. Isso é útil para configurações de várias janelas ou vários monitores/várias máquinas.

Por exemplo, se você tem monitores 3x2, cada um com 1920x1080, distribuídos em um grid assim:

+---+---+---+
| A | B | C |
+---+---+---+
| D | E | F |
+---+---+---+
então, para cada monitor, você chamaria:
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 ); Observe que não há motivo para que os monitores tenham o mesmo tamanho ou estejam em um grid.

[method:undefined updateProjectionMatrix]()

Atualiza a matriz de projeção da câmera. Deve ser chamado após qualquer alteração de parâmetros.

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

meta -- objeto contendo metadados como texturas ou imagens em descendentes de objetos.
Converte a câmera para o formato [link:https://github.com/mrdoob/three.js/wiki/JSON-Object-Scene-format-4 JSON Object/Scene] three.js.

Source

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