API Overview — @aspose/3d for TypeScript

Paquete: @aspose/3d (v24.12.0) Lenguaje: TypeScript / Node.js 18+ Licencia: MIT

@aspose/3d es una biblioteca bajo licencia MIT para leer, construir y exportar escenas 3D en Node.js. Se distribuye con definiciones de tipos TypeScript completas, una única dependencia en tiempo de ejecución (xmldom), y soporta siete formatos de archivo 3D principales. Todo I/O es sincrónico. No se requieren complementos nativos.

Example

npm install @aspose/3d

Example tsconfig.json configuraciones para la resolución correcta de subrutas:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true
  }
}

BoundingBox representa una caja delimitadora alineada con los ejes (AABB) en el espacio 3D. Almacena una esquina minimum y una esquina maximum como objetos simples con campos x, y, z. Un BoundingBox() recién construido sin argumentos está en estado “null” — minimum devuelve +Infinity y maximum devuelve -Infinity — y se expande correctamente cuando se añaden puntos mediante merge(). BoundingBox se exporta desde la subruta @aspose/3d/utilities.

Example

El contenedor raíz para una escena 3D. Todo el contenido; nodos, geometría, materiales y animaciones; se almacena en un árbol cuya raíz es scene.rootNode.Usa open() / openFromBuffer() para cargar un archivo y save() / saveToBuffer() para exportar.

Example

Un nodo de árbol con nombre en el grafo de escena. Los nodos llevan un opcional Entity (malla, cámara, luz) y un Transform que posiciona el nodo respecto a su padre.

Example

Malla poligonal; el tipo de geometría principal. Extends Geometry.

Example

Propiedades estáticas.

Clases de Material

Clases de Matemáticas

merge(point)

Example

contains(arg)

Las clases de opciones específicas de formato se exportan desde módulos de subruta. Impórtalas por separado:

import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { GltfSaveOptions, GltfFormat } from '@aspose/3d/formats/gltf';
import { StlLoadOptions, StlSaveOptions } from '@aspose/3d/formats/stl';
import { FbxLoadOptions, FbxSaveOptions } from '@aspose/3d/formats/fbx';
import { ColladaLoadOptions } from '@aspose/3d/formats/collada';
import { ThreeMfSaveOptions } from '@aspose/3d/formats/3mf';

Módulo OBJ (@aspose/3d/formats/obj)

Módulo glTF/GLB (@aspose/3d/formats/gltf)

Módulo STL (@aspose/3d/formats/stl)

Módulo FBX (@aspose/3d/formats/fbx)

Formatos compatibles

Devuelve el valor absoluto máximo de coordenada entre todas las esquinas, representando la escala dominante de la caja delimitadora. Devuelve 0 cuando la caja está en estado null.

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { GltfSaveOptions } from '@aspose/3d/formats/gltf';

// Load OBJ with materials
const scene = new Scene();
const loadOpts = new ObjLoadOptions();
loadOpts.enableMaterials = true;
scene.open('input.obj', loadOpts);

// Inspect root nodes
for (const node of scene.rootNode.childNodes) {
    console.log(`Node: ${node.name}, entity: ${node.entity?.constructor.name}`);
}

// Export as GLB (binary glTF)
const saveOpts = new GltfSaveOptions();
saveOpts.binaryMode = true;
scene.save('output.glb', saveOpts);

Ver también

• BoundingBoxExtent es una clase compañera devuelta por BoundingBox.extent. Almacena medias extensiones a lo largo de cada eje.
• Clase Node
• Clase Mesh
• Características y funcionalidades
• Soporte de formatos