Aspose.3D FOSS
TypeScript
Kā sākt ar Aspose.3D FOSS priekš TypeScript

Kā sākt ar Aspose.3D FOSS priekš TypeScript

@aspose/3d priekš TypeScript ir bezmaksas, MIT licences pakotne, kas ļauj ielādēt, manipulēt un saglabāt 3D failus Node.js — nav vajadzīgas vietējās bināras, instalējama no npm.

Solim pa solim ceļvedis

1. solis: instalēt pakotni

Instalējiet no npm (nepieciešams Node.js 18 vai jaunāks):

npm install @aspose/3d@24.12.0

Pārbaudiet, vai instalācija ielādējās pareizi:

import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");

2. solis: Importējiet nepieciešamās klases

Importējiet vajadzīgās klases:

import { Scene, Node } from "@aspose/3d";

Kā ielādēt 3D failu?

Izmantojiet statisko metodi Scene.from_file(), lai atvērtu jebkuru atbalstītu formātu. Bibliotēka automātiski noteiks formātu no faila paplašinājuma.

import { Scene } from "@aspose/3d";

const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);

Vai arī izmantojiet statisko ražotāju:

const scene = Scene.fromFile("model.glb");

Kā pārlūkot ainas grafu?

Ielādēta aina ir Node objektu koks, kura sakne ir scene.rootNode:

import { Scene, Node } from "@aspose/3d";

function walk(node: Node, depth: number = 0): void {
    const indent = " ".repeat(depth * 2);
    console.log(`${indent}Node: ${node.name}`);
    for (const child of node.childNodes) {
        walk(child, depth + 1);
    }
}

const scene = Scene.fromFile("model.obj");
walk(scene.rootNode);

3. solis: Saglabājiet mērķa formātā

Izsauciet scene.save() ar izvades ceļu. Izvades formāts tiek noteikts no faila paplašinājuma.

import { Scene } from "@aspose/3d";

const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");

Biežāk sastopamās problēmas un to risinājumi

Error: ENOENT izsaucot scene.open() Norādītais ceļš neeksistē. Izmantojiet absolūto ceļu vai path.resolve() , lai pārliecinātos, ka faila ceļš ir pareizs.

Nezināmas formāta kļūda. Pārliecinieties, ka faila paplašinājums atbilst faktiskajam formātam. Bibliotēka nosaka formātu pēc paplašinājuma funkcijām open() un fromFile(). Nododiet konkrētu formāta parametru, lai pārrakstītu.

Tukša aina pēc ielādes. Daži binārie formāti var prasīt specifiskas ielādes opcijas. Mēģiniet izmantot konkrētu pārsniegumu ar formātam specifiskām opcijām, ja noklusējuma ielāde rada tukšu ainu.

TypeScript importēšanas kļūdas. Tipu definīcijas ir iekļautas paketē. Pārliecinieties, ka jūsu tsconfig.json ir iestatīts "moduleResolution": "bundler" vai "node16".

Biežāk uzdotie jautājumi

Vai @aspose/3d pieprasa kādus vietējos bināros failus?

Nē. Pakete ir tīri JavaScript/TypeScript bez vietējām atkarībām. Tā darbojas jebkurā platformā, kas atbalsta Node.js 18 vai jaunāku.

Kādas Node.js versijas tiek atbalstītas?

Node.js 18 vai jaunāks. Pakete darbojas Windows, macOS un Linux.

Vai bibliotēka ir bezmaksas komerciālai lietošanai?

Jā. Tā ir izlaista zem MIT licences. Jūs varat izmantot, modificēt un izplatīt to jebkuram nolūkam, ieskaitot komerciālas lietojumprogrammas.

Kādus 3D formātus varu lasīt un rakstīt?

Pakotne atbalsta OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA un PLY gan lasīšanai, gan rakstīšanai. Izmantojiet paplašinājuma balstīto scene.save(), lai eksportētu uz jebkuru atbalstītu formātu.

Vai varu izveidot 3D ainu no nulles?

Jā. Izveidojiet Scene bez argumentiem, pievienojiet bērna mezglus scene.rootNode un saglabājiet vēlamajā formātā.

Skatīt arī

  • BUJ — Aspose.3D FOSS priekš TypeScript
  • Kā ielādēt 3D modeļus TypeScript valodā
  • Kā konvertēt 3D modeļus TypeScript
  • Ievades dokumentācija
  • API atsauce
 Latviešu