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

Name	Type	Access	Description
`name`	`string`	Read/Write	Gets the name.
`parentNodes`	`any[]`	Read	Gets the parent nodes.
`excluded`	`boolean`	Read/Write	Gets the excluded.
`parentNode`	`any`	Read/Write	Gets the parent node.
`rotationMode`	`any`	Read/Write	Gets the rotation mode.
`nearPlane`	`number`	Read/Write	Gets the near plane.
`farPlane`	`number`	Read/Write	Gets the far plane.
`aspect`	`number`	Read/Write	Gets the aspect.
`orthoHeight`	`number`	Read/Write	Gets the ortho height.
`up`	`any`	Read/Write	Gets the up.
`lookAt`	`any`	Read/Write	Gets the look at.
`direction`	`any`	Read/Write	Gets the direction.
`target`	`any`	Read/Write	Gets the target.
`apertureMode`	`any`	Read/Write	Gets the aperture mode.
`fieldOfView`	`number`	Read/Write	Gets the field of view.
`fieldOfViewX`	`number`	Read/Write	Gets the field of view x.
`fieldOfViewY`	`number`	Read/Write	Gets the field of view y.
`width`	`number`	Read/Write	Gets the width.
`height`	`number`	Read/Write	Gets the height.
`aspectRatio`	`number`	Read/Write	Gets the aspect ratio.
`magnification`	`any`	Read/Write	Gets the magnification.
`projectionType`	`string`	Read/Write	Gets the projection type.

Signature	Description
`constructor(name: string	null, projectionType: any)`
`moveForward(_distance: number)`	Moves the camera forward by the specified distance
`getBoundingBox()` → `any`	Returns the bounding box.
`getEntityRendererKey()` → `any`	Not implemented in the FOSS edition — throws at runtime. Returns the entity renderer key.
`removeProperty(_prop: Property	string) `→` boolean`
`getProperty(_property: string)` → `any`	Returns the value of the specified property
`setProperty(_property: string, _value: any)`	Sets the property value.
`findProperty(_property: string)` → `Property	null`

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.