Kurulum

Bu kılavuz, TypeScript için Aspose.3D FOSS’u kurmak için ihtiyacınız olan her şeyi kapsar ve ilk 3D işleme betiğinizi yazmadan önce düzgün çalıştığını doğrulamanıza yardımcı olur.

Ön Koşullar

Aşağıdakilerin kurulu ve sisteminizde olduğundan emin olun PATH devam etmeden önce:

Sürümlerinizi kontrol etmek için:

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

Adım 1: Bir Proje Oluşturun (gerekirse)

Eğer Aspose.3D’yi mevcut bir TypeScript projesine ekliyorsanız, bu adımı atlayın ve doğrudan Adım 2’ye geçin.

Yeni bir proje için:

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

Adım 2: @aspose/3d’yi kurun

npm install @aspose/3d

Bu, paketi ve tek geçişli bağımlılığını kurar, xmldom, otomatik olarak. Ek sistem paketleri, yerel eklentiler veya derleyiciler gerekmez. Kurulum, olduğunda @aspose/3d göründüğünde package.json altında dependencies.

Kurulumu doğrulayın:

ls node_modules/@aspose/3d

Paket dizinini şu öğelerle görmelisiniz: package.json, tip tanım dosyaları (.d.ts), ve derlenmiş JavaScript.

Adım 3: TypeScript’i yapılandırın

Ekle veya güncelle tsconfig.json proje kök dizininizde aşağıdaki ayarlarla. Bunlar, kütüphanenin tip tanımları ve CommonJS çıktısı ile tam uyumluluk için gereklidir:

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

Önemli ayarlar ve neden önemli oldukları:

Adım 4: Kurulumu doğrulayın

Oluştur src/verify.ts aşağıdaki minimal ithalat testiyle:

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);

Derleyin ve çalıştırın:

npx tsc
node dist/verify.js

Beklenen çıktı:

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

Kök düğüm adı varsayılan olarak boş bir dizedir — scene.rootNode ad argümanı olmadan oluşturulur.

Geliştirme sırasında derleme adımını atlamayı tercih ederseniz, doğrudan şununla çalıştırın ts-node:

npx ts-node src/verify.ts

Adım 5: Hızlı Başlangıç: Bir Sahneyi Yükleyin ve Düğüm Bilgilerini Yazdırın

Aşağıdaki betik bir 3D dosyasını yükler ve sahnedeki her düğümün adını ve varlık tipini yazdırır. OBJ, glTF, GLB, STL, 3MF, FBX veya COLLADA gibi desteklenen herhangi bir formatta çalışır.

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);

Bunu şu adla kaydedin src/quickstart.ts ve çalıştırın:

npx ts-node src/quickstart.ts

Bir OBJ dosyasında tek bir mesh ‘…’? Cube, çıktı şu şekilde görünecek:

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

Kök düğümün adı boştur (boş bir önek olarak yazdırılır). Alt düğümler adlarını yüklenen dosyadan devralır.

Bağımlılık Notları

Aspose.3D FOSS for TypeScript tam olarak bir çalışma zamanı bağımlılığına sahiptir:

Kurmanız gerekmez xmldom manuel olarak. Kendi … içinde görünecek node_modules ana kurulum komutundan sonra. Yerel eklentiler (.node dosyaları) ve sistem kütüphaneleri gerekmez.

Sonraki Adımlar

Kütüphane kuruldu ve doğrulandı:

• Okuyun Geliştirici Kılavuzu tüm özellik alanlarının eksiksiz bir rehberi için.
• Bkz. Özellikler ve İşlevsellikler format desteği ayrıntıları, sahne grafiği desenleri, malzeme ve animasyon API’leri ve tam TypeScript kod örnekleri için.