1. Ürünler
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS for TypeScript

Node.js’ten 3D sahneleri yükleyin, oluşturun, dönüştürün ve dışa aktarın — tek bir npm kurulumu ile tam tipli, açık kaynak ve üretim ortamına hazır.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

Belgelendirme GitHub

3D Dosya İşleme için Açık Kaynak TypeScript Kütüphanesi

Aspose.3D FOSS for TypeScript, Node.js uygulamalarında 3D dosya formatlarıyla çalışmak için MIT lisanslı bir kütüphanedir. Tek bir npm install @aspose/3d komutuyla kurun ve TypeScript’te 3D sahneleri hemen okumaya, oluşturmaya ve yazmaya başlayın; derlenecek yerel eklentiler, kurulacak harici SDK’lar ve gerekecek bir renderlayıcı yok.

Kütüphane, Scene, Node, Entity, Mesh, Camera, Light ve Transform etrafında inşa edilmiş tam tipli bir sahne grafiği API sunar; bu, profesyonel 3D araçları tarafından kullanılan aynı kavramsal modeldir. Format desteği OBJ (Wavefront, .mtl malzeme yüklemesiyle), glTF 2.0 ve GLB ikili (PBR malzemeleri), STL (ikili ve ASCII, tam dönüşüm), COLLADA (DAE), 3MF ve FBX içerir. ObjLoadOptions ve GltfSaveOptions gibi format‑özel seçenek sınıfları, koordinat sistemi yönelimi, ölçek, normal normalizasyonu, ikili vs. JSON çıktısı ve malzeme yüklemesi üzerinde hassas kontrol sağlar.

Aspose.3D FOSS, Node.js 18, 20 ve 22+ sürümlerini TypeScript 5.0+ ile hedefler ve CommonJS’e derlenir. Kütüphane, sıkı TypeScript derleyici ayarları (noImplicitAny, strictNullChecks) ile gelir, böylece IDE’niz tam otomatik tamamlama ve derleme zamanı güvenliği sağlar. Tek çalışma zamanı bağımlılığı xmldom, otomatik olarak kurulur. Kurumsal ürün ailesi için Aspose.3D — Enterprise Product Family‘a bakın.

3D Format Destek ve Tipleştirilmiş Sahne-Graf API

  • ** OBJ / MTL:** Wavefront OB J dosyalarını eşlik eden malzeme tanımlarıyla yükleyin.
  • glTF 2.0 / GLB: PBR malzemesi yüklenmesi ve GltfSaveOptions aracılığıyla ikili GDB çıkışı.
  • STL: Tam dönüş doğrulama ile ikili ve ASCII STL’yi okuyun ve yazın.
  • COLLADA, 3MF, FBX: Format seçeneği sınıfları ile ek format desteği.
  • Tam TypeScript türleri: Her sınıf, yöntem ve seçenek güçlü noImplicitAny ve strictNullChecks ile yazılır.

Aspose.3D KOSS'un Kullanılabileceği Yerler

  • Node.js varlık boru hattı: OBJ dosyalarını aktarın, geometrileri doğrulayın ve yeniden yönlendirin ve CI’de GLB olarak ihraç edin.
  • ** Oyun araçları:** Yerel motor veya render kullanmadan 3D ağlar.
  • 3D baskı iş akışları: STL ve 3MF dosyalarını okuyun, doğrulayın ve yeniden ihraç edin.
  • Serverless arka uçlar: Lambda veya Bulut Fonksiyonlarında 3D dönüşüm son noktalarını çalıştırın.
  • ** İçerik göçü:** Tek bir senaryodan ölçekli olarak format aileleri arasında dönüştür.

Per-format seçenekleri ve koordinat kontrolü

  • Koordinat sistemi yönelimi: Düzeltme eksenleri ve seçenek sınıfları ile format başına ölçek ayarlayın.
  • Normal normalleştirme: yükleme veya kaydetme sırasında otomatik olarak en yüksek normalleri normalleştirilir.
  • Divman vs. JSON çıkışı: GltfSaveOptions üzerinden kompakt GLB veya okunur glTF seçin.
  • Materyal yükleme kontrolü: Daha hızlı ayrıştırma için MTL/teksür yüklemesini etkinleştirin veya devre dışı bırakın.
  • Yürüyüş sadakati: Bilinmeyen sahne-graf düğümleri yeniden kaydetme sırasında kelimenin tam anlamıyla korunur.

Geliştiricinin Deneyimi

Aspose.3D TypeScript kurulumları için tek bir npm install @aspose/3d komutuyla FOSS. Derlenecek yerel eklenti yok. Kütüphane, tek bir otomatik kurulan bağımlılık (xmldom) ile saf TypeScript/JavaScript’tir.

Güçlü tipli API, her scene-graph sınıfı ve format seçeneği için tam IDE otomatik tamamlama sağlar. Kütüphane, Node.js 18–22+ ve TypeScript 5.0+ hedefler, Linux CI koşucularında ve geliştirici iş istasyonlarında aynı şekilde çalışır ve MIT-licensed, GitHub’da açık bir issue tracker ile lisanslanmıştır.

Bir OBJ Sahne yükle ve glTF olarak Dışarıya aktar

npm ile kurun, ardından scene.open() ile ObjLoadOptions kullanarak mesh’i MTL malzeme dosyasıyla birlikte yükleyin. Hem open() hem de save() eşzamanlıdır — await veya Promise zincirlemesi gerekmez. scene.save() fonksiyonunu .gltf uzantısıyla çağırmak, standart glTF 2.0 JSON yazar — format dosya uzantısından otomatik olarak çıkarılır.

npm install @aspose/3d

import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";
const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

STL’yi ikili GLB’ye dönüştürün.

Varsayılan JSON glTF yerine kompakt ikili GLB oluşturmak için GltfSaveOptions ile binaryMode = true geçin. open() ve save() her ikisi de senkrondur hiçbir await gerekmez.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Sıkça Sorulan Sorular

TypeScript için Aspose.3D FOSS nedir?

Bu, herhangi bir yerel eklenti veya harici SDK yüklemeden 3B sahneleri yüklemek, manipüle etmek ve kaydetmek için ücretsiz, MIT lisanslı TypeScript / Node.js kütüphanesi.

Hangi 3D formatları destekleniyor?

OBJ (.mtl ile), glTF 2.0 ve GLB, STL (ikili ve ASCII), COLLADA (DAE), 3MF ve FBX . Her bir biçim özel bir tiplenmiş seçenek sınıfına sahiptir.

Node.js’in yerel eklentisi gerekmiyor mu?

Hayır. Aspose.3D FOSS for TypeScript saf JavaScript/TypeScript’tir. Hiçbir derleme adımı gerektirmez ve otomatik olarak npm tarafından yüklenen tek bir çalıştırma süresi bağımlılığı (xmldom) vardır.

Nasıl yüklerim?

npm install @aspose/3d çalıştır. Ek sistem paketleri veya yerel eklentiler gerekmez.

Hangi Node.js ve TypeScript sürümleri desteklenir?

Node.js 18, 20 ve 22+. TypeScript 5.0+ Kütüphane CommonJS’e derliyor ve sıkı Type Script ayarlarıyla çalışır.

TypeScript tür tanımları ile birlikte mi?

Evet. Tüm sınıflar, yöntemler, enumlar ve seçenek türleri noImplicitAny ile tam olarak yazılır ve strictNullChecks etkinleştirilmiştir.

Koordinat sistemini kontrol edebilir miyim?

ObjLoadOptions ve GltfSaveOptions gibi biçim başına seçenek sınıfları, eksenleri çevirmenize, ölçek ayarlamanıza ve özel ayrıştırma kodu olmadan normallerin normalleştirilmesine izin verir.

Kaynak kodunu nerede bulabilirim?

Kütüphane MIT lisanslı ve GitHub’da barındırılmıştır. Hata raporları ve çekme istekleri hoş karşılanmaktadır.

  

Destek ve Öğrenme Kaynakları

 Türkçe