TipScript için Aspose.3D FOSS ile Nasıl Başlatılır

@aspose/3d TypeScript için, yükleme, manipülasyon ve Node.js’te 3D dosyaları kaydetmek - npm’den yüklü yerli binary gerektirmez.

Adım-Adım Rehberi

Adım 1: Paketi Kurun

Npm’den yükleme (Node.js 18 veya sonraki gerekli):

npm install @aspose/3d@24.12.0

Doğru yüklü yüklemeyi kontrol edin:

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

Adım 2: İthalat Gerekli Sınıflar

İhtiyacınız olan sınıfları içe aktarın:

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

Adım 3: 3D dosyayı yükleme

Kullanım scene.open() Desteklenen herhangi bir biçim yüklemek için. kütüphane biçimi tespit eder Dosya uzantısından otomatik olarak:

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

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

Ya da statik fabrika yöntemi kullanın:

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

Adım 4: Sahne grafiklerini geçin

Bir sahne bir ağaçtır, bir Node ırkçı olan nesneler 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);

5. Adım: Farklı bir formatta kaydetmek

Kullanım scene.save() Herhangi bir destekleyici çıkış biçimine ihraç etmek için. kütüphane, Dosya uzantısından çıkış biçimi:

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

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

Yaygın Sorunlar ve Çözümler

Error: ENOENT çağrıldığında scene.open() Geçtiğiniz yol yok. mutlak bir yolu kullanın veya path.resolve() emin olmak için Dosya yolu doğru.

Bilinmeyen format hatası Dosya uzantısı gerçek formatla eşleşir. kütüphane biçimi tespit eder Uzantısı için open() ve fromFile().* Bir parametreyi aşmak için açık bir biçim belirleyin.

Yükleme sonrası boş sahne Bazı ikili biçimler belirli yük seçenekleri gerekebilir. açık aşırı yükleme kullanmaya çalışın Format özel seçenekleri ile varsayılan yük boş bir sahne üretir.

TipScript İthalat Hataları Tip tanımları paketle bağlantılıdır.Güvenlik "moduleResolution": "bundler" veya "node16" senin içinde yerleştirilmiştir tsconfig.json.

Sık Sorulan Sorular

@aspose/3d herhangi bir yerli binary gerektirir?

No. Paket saf JavaScript/TypeScript ve hiçbir yerli bağımlılık yoktur. Node.js 18 veya sonraki destekli herhangi bir platformda çalışır.

Node.js hangi versiyonları destekliyor?

Node.js 18 veya daha sonraki. paket Windows, macOS ve Linux’ta çalışır.

Kütüphane ticari kullanım için ücretsiz mi?

Evet. MIT Lisansı altında yayınlanmaktadır. ticari uygulamalar da dahil olmak üzere herhangi bir amaç için kullanabilir, değiştirebilir ve yeniden dağıtabilirsiniz.

Hangi 3D formatı okuyabilir ve yazabilirim?

Paket, OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA ve PLY’yi hem okuma için destekler. Yorum yapın. uzantı tabanlı kullanın scene.save() Herhangi bir destekleyici formatta ihraç edilebilir.

3D sahneyi çarpışmadan yapabilir miyim?

Evet. yapılandırma a Scene Hiçbir sebeple, çocuk düğümlerini ekleyin. scene.rootNode,ve İstediğiniz formatta kaydedilir.