クイックスタート
クイックスタート
このガイドは、@aspose/3d を使用して TypeScript のインストールから 3D ファイルのロードおよび保存までの最速の手順を示します。パッケージは MIT ライセンスで、純粋な JavaScript/TypeScript であり、ネイティブバイナリやプラットフォーム固有のビルドツールは不要です。
前提条件
| 要件 | 詳細 |
|---|---|
| Node.js | 18 以降 |
| OS | Windows、macOS、Linux、Docker |
| Package | @aspose/3d(ソースからビルド) |
Install
パッケージをソースからビルドします。型定義はパッケージに同梱されているため、別個の @types パッケージは必要ありません:
git clone https://github.com/aspose-3d-foss/Aspose.3D-FOSS-for-TypeScript.git
cd Aspose.3D-FOSS-for-TypeScript
npm install
npm run build3D ファイルをロード
scene.open() をパスとともに呼び出して、サポートされている任意の形式をロードします。ライブラリはファイル拡張子から形式を検出します。シーン階層には scene.rootNode を通じてアクセスします:
import { Scene } from "@aspose/3d";
const scene = new Scene();
scene.open("model.obj");
console.log(`Root node: ${scene.rootNode.name}`);シーングラフを走査する
ロードされたシーンは、scene.rootNode をルートとする Node オブジェクトのツリーです。再帰的なウォークを使用して各ノードとその子ノードを処理します:
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 = new Scene();
scene.open("model.glb");
walk(scene.rootNode);別の形式で保存
ライブラリはファイル拡張子から出力形式を検出します。scene.save() を出力パスとともに呼び出して、形式間の変換を行います:
import { Scene } from "@aspose/3d";
const scene = new Scene();
scene.open("model.obj");
scene.save("output.glb");
console.log("Converted to GLB.");新しいシーンを作成して保存
引数なしで Scene を構築して空の状態で開始し、scene.rootNode に子ノードを追加し、最後に scene.save() を呼び出してファイルを書き出します:
import { Scene, Node } from "@aspose/3d";
const scene = new Scene();
const box = scene.rootNode.createChildNode("box");
scene.save("new_scene.obj");