Camera

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

Camera è un Entity che può essere collegato a un Node per definire un punto di vista nella scena. Supporta sia proiezioni prospettiche che ortografiche, controllate dalla projectionType proprietà. I parametri della fotocamera sono memorizzati nel file 3D quando la scena viene salvata in un formato che supporta le fotocamere (FBX, COLLADA, glTF).

export class Camera extends Entity

Example

yaw number — Rotazione attorno all’asse Y in radianti.

Example

Aggiungi una camera prospettica a una scena e configura il suo 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

Example

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`

Example

moveForward(distance)

Sposta la camera in avanti lungo la sua direzione di visualizzazione della distanza fornita.

moveForward(distance: number): void

Example

distance number

La distanza da spostare in avanti. I valori negativi spostano la camera all’indietro.

Example

void

Example

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.');

Example

Nel sorgente, Camera eredita da Entity. Light estende anche Camera, il che significa Light gli oggetti hanno tutte le proprietà della fotocamera nella gerarchia dei tipi; ciò riflette il modello dati FBX in cui luci e fotocamere condividono un tipo di nodo base comune.
Usa il ProjectionType costanti di classe (ProjectionType.PERSPECTIVE, ProjectionType.ORTHOGRAPHIC) invece di stringhe letterali grezze per la sicurezza dei tipi.