Aspose.3D FOSS
TypeScript
はじめに
インストール

インストール

このガイドでは、TypeScript 用の Aspose.3D FOSS をインストールし、最初の 3D 処理スクリプトを書く前に正しく動作していることを確認するために必要なすべての手順をカバーしています。.

前提条件

以下がインストールされ、あなたの PATH 続行する前に:

ツール最低注記
Node.js18 LTS20 or 22 LTS recommended
npm7Node.js に同梱
TypeScript5.0以下でインストール npm install -D typescript

バージョンを確認するには：:

node --version   # v18.x.x or later
npm --version    # 7.x or later
npx tsc --version  # Version 5.x.x

ステップ 1: プロジェクトを作成する（必要な場合）

既存の TypeScript プロジェクトに Aspose.3D を追加する場合は、このステップをスキップして直接ステップ 2 に進んでください。.

新規プロジェクトの場合：:

mkdir my-3d-project && cd my-3d-project
npm init -y
npm install -D typescript ts-node @types/node

ステップ 2: @aspose/3d をインストールする 

npm install @aspose/3d

これによりパッケージとその単一の遷移依存関係がインストールされ、, xmldom,、自動的に行われます。追加のシステムパッケージ、ネイティブアドオン、またはコンパイラは必要ありません。インストールが完了するのは @aspose/3d があなたの package.json 以下に dependencies.

インストールを確認する：:

ls node_modules/@aspose/3d

パッケージディレクトリが表示されるはずです package.json, 型定義ファイル (.d.ts), およびコンパイル済みの JavaScript.

ステップ 3: TypeScript を設定する

追加または更新してください tsconfig.json プロジェクトのルートに以下の設定で。これらはライブラリの型定義と CommonJS 出力との完全な互換性を確保するために必要です:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true,
    "outDir": "dist",
    "rootDir": "src"
  },
  "include": ["src/**/*.ts"],
  "exclude": ["node_modules", "dist"]
}

重要な設定とその理由：:

設定項目値理由
targetES2020内部で使用されているオプショナルチェイニング、null 合体演算子などの ES2020 機能を有効にします
modulecommonjsライブラリは CommonJS 出力を提供しています。これに合わせる必要があります
moduleResolutionnode正しい解決のために必要です @aspose/3d サブパスインポート
esModuleInteroptrue名前空間の回避策なしで CommonJS モジュールからデフォルトインポートを有効にします
stricttrueこのライブラリは以下で作成されています noImplicitAny および strictNullChecks; この設定はオンのままにしてください

ステップ 4: インストールを検証する

作成 src/verify.ts 以下の最小限のインポートテストで：:

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

const scene = new Scene();
console.log('Aspose.3D FOSS for TypeScript is installed correctly.');
console.log('rootNode name:', scene.rootNode.name);

コンパイルして実行する：:

npx tsc
node dist/verify.js

期待される出力：:

Aspose.3D FOSS for TypeScript is installed correctly.
rootNode name:

ルートノード名はデフォルトで空文字列です — scene.rootNode は名前引数なしで作成されます。.

開発中にコンパイルステップをスキップしたい場合は、直接以下で実行してください ts-node:

npx ts-node src/verify.ts

ステップ5：クイックスタート：シーンをロードしてノード情報を出力

以下のスクリプトは3Dファイルを読み込み、シーン内のすべてのノードの名前とエンティティタイプを出力します。OBJ、glTF、GLB、STL、3MF、FBX、またはCOLLADAといった、サポートされている任意のフォーマットで動作します。.

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

function printNode(node: Node, depth: number = 0): void {
  const indent = '  '.repeat(depth);
  const entityType = node.entity ? node.entity.constructor.name : '(no entity)';
  console.log(`${indent}${node.name} [${entityType}]`);
  for (const child of node.childNodes) {
    printNode(child, depth + 1);
  }
}

const scene = new Scene();

// Replace 'model.obj' with any supported 3D file path.
// Format is detected automatically from binary magic numbers.
scene.open('model.obj');

console.log('Scene loaded. Node hierarchy:');
printNode(scene.rootNode);

これを次の名前で保存してください src/quickstart.ts そして実行してください:

npx ts-node src/quickstart.ts

メッシュが1つだけのOBJファイルで、名前が付けられている場合 Cube, 出力は次のようになります:

Scene loaded. Node hierarchy:
 [(no entity)]
  Cube [Mesh]

ルートノードは名前が空です（空白のプレフィックスとして出力されます）。子ノードはロードされたファイルから名前を継承します。.

依存関係に関する注意点

Aspose.3D FOSS for TypeScript にはランタイム依存関係がちょうど1つあります：:

パッケージ目的自動的にインストールされます
xmldomCOLLADA（DAE）および3MFフォーマットのサポートのためのXMLパースはい、以下を介して npm install @aspose/3d

インストールする必要はありません xmldom 手動で行う必要はありません。あなたの node_modules メインのインストールコマンドの後に表示されます。ネイティブアドオンはありません（.node ファイル) で、システムライブラリは不要です。.

次のステップ

ライブラリがインストールされ、検証が完了したので：:

  • 以下をご覧ください 開発者ガイド すべての機能領域の完全なウォークスルーについては。.
  • 参照してください 機能と特長 フォーマットサポートの詳細、シーングラフパターン、マテリアルおよびアニメーション API、そして完全な TypeScript コード例については。.
 日本語