Aspose.3D FOSS
TypeScript
Class Camera

Class Camera

Pacote: @aspose/3d (v24.12.0)

Camera é um Entity que pode ser anexado a um Node para definir um ponto de vista na cena. Ele suporta projeções tanto em perspectiva quanto ortográficas, controladas pelo projectionType propriedade. Os parâmetros da câmera são armazenados no arquivo 3D quando a cena é salva em um formato que suporta câmeras (FBX, COLLADA, glTF).

export class Camera extends Entity

ImageRenderOptions

A3DObject ← SceneObject ← Entity ← Camera

ImageRenderOptions

Adicione uma câmera em perspectiva a uma cena e configure seu frustum.

import { Scene, Node, Camera, ProjectionType } from '@aspose/3d';

const scene = new Scene();

const camNode = scene.rootNode.createChildNode('mainCamera');
const camera = new Camera('mainCamera', ProjectionType.PERSPECTIVE);
camNode.entity = camera;

camera.nearPlane = 0.1;
camera.farPlane = 500;
camera.fieldOfView = 60;
camera.aspect = 16 / 9;

scene.save('output.gltf');
console.log(`Camera projection: ${camera.projectionType}`);
// Camera projection: PERSPECTIVE

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
namestring''O nome desta câmera, usado para identificá‑la no grafo da cena.
projectionType`ProjectionTypestring`ProjectionType.PERSPECTIVE
nearPlanenumber0.1Distância da câmera ao plano de recorte próximo. Objetos mais próximos que este valor não são renderizados.
farPlanenumber1000.0Distância da câmera ao plano de recorte distante. Objetos mais distantes que este valor não são renderizados.
aspectnumber1.0A proporção largura/altura da viewport da câmera.
fieldOfViewnumber0.0Campo de visão diagonal em graus (projeção em perspectiva).
fieldOfViewXnumber0.0Campo de visão horizontal em graus.
fieldOfViewYnumber0.0Campo de visão vertical em graus.
orthoHeightnumber100.0A altura do volume de projeção ortográfica. Relevante apenas quando projectionType é 'ORTHOGRAPHIC'.
widthnumber0.0Largura do sensor ou da viewport, usada quando apertureMode controla a derivação do FOV.
heightnumber0.0Altura do sensor ou da viewport.
aspectRationumber1.0Alias para a proporção de aspecto, fornecido para compatibilidade com algumas cenas originadas de FBX.

ImageRenderOptions

moveForward(distance)

Move a câmera para frente ao longo da sua direção de visualização pela distância especificada.

moveForward(distance: number): void

ImageRenderOptions

distance number

A distância a ser avançada. Valores negativos movem a câmera para trás.

ImageRenderOptions

void

ImageRenderOptions 

import { Scene, Camera, ProjectionType } from '@aspose/3d';

const scene = new Scene();
const camNode = scene.rootNode.createChildNode('cam');
const camera = new Camera('cam', ProjectionType.PERSPECTIVE);
camNode.entity = camera;

camera.moveForward(10);
console.log('Camera moved forward by 10 units.');

ImageRenderOptions

  • No código-fonte, Camera herda de Entity. Light também estende Camera, o que significa Light os objetos possuem todas as propriedades de câmera na hierarquia de tipos; isso reflete o modelo de dados FBX onde luzes e câmeras compartilham um tipo de nó base comum.
  • Use o ProjectionType constantes de classe (ProjectionType.PERSPECTIVE, ProjectionType.ORTHOGRAPHIC) em vez de literais de string brutas para segurança de tipo.
 Português