Aspose.3D FOSS
TypeScript
Aspose.3D FOSS for TypeScript の開始方法

Aspose.3D FOSS for TypeScript の開始方法

@aspose/3d for TypeScript は、Node.js で 3D ファイルを読み込み、操作、保存するための無料で MIT ライセンスのパッケージです — ネイティブバイナリは不要で、ソースからビルドされます。

ステップバイステップガイド

ステップ 1: パッケージをインストール

ソースからビルド (Node.js 18 以上が必要):

git clone https://github.com/aspose-3d-foss/Aspose.3D-FOSS-for-TypeScript.git
cd Aspose.3D-FOSS-for-TypeScript
npm install
npm run build

インストールが正しくロードされたことを確認:

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

ステップ2：必要なクラスをインポート

必要なクラスをパッケージからインポートしてください:

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

ステップ3：3Dファイルをロード

任意のサポートされた形式をロードするには scene.open() を使用します。ライブラリはファイル拡張子から形式を自動的に検出します:

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

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

または静的ファクトリメソッドを使用します:

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

ステップ4：シーン グラフを走査

ロードされたシーンは、Node オブジェクトのツリーで、ルートは 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：別の形式で保存

scene.save() を使用して、サポートされている任意の出力形式へエクスポートします。ライブラリはファイル拡張子から出力形式を検出します：

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

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

一般的な問題と対処法

Error: ENOENT 呼び出す際に scene.open() 指定したパスは存在しません。絶対パスを使用するか、 path.resolve() ファイルパスが正しいことを確認してください。

不明な形式エラー ファイル拡張子が実際の形式と一致していることを確認してください。ライブラリは拡張子で形式を検出します。 open() and fromFile(). 明示的な format パラメータを渡して上書きしてください。

ロード後にシーンが空です 一部のバイナリ形式では特定のロードオプションが必要になる場合があります。デフォルトのロードでシーンが空になる場合は、フォーマット固有のオプションを使用した明示的なオーバーロードを試してください。

TypeScript インポートエラー 型定義はパッケージに同梱されています。確認してください "moduleResolution": "bundler" or "node16" が設定されています tsconfig.json.

よくある質問

@aspose/3d はネイティブバイナリを必要としますか？

いいえ。このパッケージは純粋な JavaScript/TypeScript で、ネイティブ依存はありません。Node.js 18 以降をサポートする任意のプラットフォームで動作します。

サポートされている Node.js のバージョンはどれですか？

Node.js 18 以降です。このパッケージは Windows、macOS、Linux で動作します。

商用利用は無料ですか？

はい。MIT ライセンスでリリースされています。商用アプリケーションを含むあらゆる目的で使用、変更、再配布が可能です。

どの 3D フォーマットを読み書きできますか？

このパッケージは OBJ、STL、glTF 2.0 / GLB、FBX、COLLADA、3MF を読み書きの両方でサポートしています。拡張子ベースの scene.save() を使用して、サポートされている任意のフォーマットへエクスポートできます。

最初から3Dシーンを作成できますか？

はい。Scene を引数なしで構築し、scene.rootNode に子ノードを追加して、目的のフォーマットで保存します。

参照

 日本語