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

Aspose.3D FOSS TypeScript için

Node.js üzerinden 3D sahneleri yükleyin, oluşturun, dönüştürün ve dışa aktarın — tam tipli, açık kaynaklı ve tek bir npm kurulumu ile üretime 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 renderlayıcı gerekmiyor.

Kütüphane, Scene, Node, Entity, Mesh, Camera, Light ve Transform etrafında inşa edilmiş tam tipli bir sahne‑grafiği API’si sunar, profesyonel 3D araçları tarafından kullanılan aynı kavramsal model.
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’ye derlenir. Kütüphane, sıkı TypeScript derleyici ayarları (noImplicitAny, strictNullChecks) ile birlikte 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 bölümüne bakın.

3D Format Desteği ve Tipli Sahne Grafiği API’si

  • OBJ / MTL: Wavefront OBJ dosyalarını eşlik eden malzeme tanımlarıyla yükleyin.
  • glTF 2.0 / GLB: PBR malzeme yükleme ve ikili GLB çıktısı GltfSaveOptions aracılığıyla.
  • STL: İkili ve ASCII STL’yi tam tur dönüşüm doğrulamasıyla okuyun ve yazın.
  • COLLADA, 3MF, FBX: Her format için ek seçenek sınıflarıyla ek format desteği.
  • Tam TypeScript tipleri: Her sınıf, yöntem ve seçenek, noImplicitAny ve strictNullChecks ile güçlü bir şekilde tiplenmiştir.

Aspose.3D FOSS Kullanılabileceği Yer

  • Node.js varlık boru hatları: OBJ dosyalarını içe aktar, geometriyi doğrula ve yeniden yönlendir, ve CI’de GLB olarak dışa aktar.
  • Oyun araçları: Yerel bir motor veya renderlayıcı olmadan 3D ağları toplu işleyin.
  • 3D baskı iş akışları: STL ve 3MF dosyalarını okuyun, doğrulayın ve yeniden dışa aktarın.
  • Sunucusuz arka uçlar: Lambda veya Cloud Functions içinde 3D dönüşüm uç noktalarını çalıştırın.
  • İçerik taşıma: Tek bir betikten ölçekli olarak format aileleri arasında dönüştürün.

Format Başına Seçenekler ve Koordinat Kontrolü

  • Koordinat sistemi yönelimi: Eksenleri ters çevirin ve format başına seçenek sınıflarıyla ölçeği ayarlayın.
  • Normal normalizasyonu: Yükleme veya kaydetme sırasında köşe normallerini otomatik olarak normalleştir.
  • İkili vs. JSON çıktısı: Kompakt GLB’yi veya okunabilir glTF’yi GltfSaveOptions aracılığıyla seçin.
  • Malzeme yükleme kontrolü: Daha hızlı ayrıştırma için MTL/doku yüklemeyi etkinleştirin veya devre dışı bırakın.
  • Round-trip fidelity: Bilinmeyen sahne grafiği düğümleri yeniden kaydetme sırasında kelimesi kelimesine korunur.

Geliştirici Deneyimi

Aspose.3D FOSS for TypeScript tek bir npm install @aspose/3d komutuyla kurulur. Derlenecek yerel eklentiler yoktur. Kütüphane, bir otomatik kurulan bağımlılık (xmldom) ile saf TypeScript/JavaScript’tir.

Güçlü tiplenmiş API, her sahne‑grafik 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+ hedef alır, 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 Sahnesi Yükle ve glTF Olarak Dışa 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()‘i .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 Binary GLB’ye dönüştür

Kompakt bir ikili GLB üretmek için varsayılan JSON glTF yerine, GltfSaveOptions ile binaryMode = true geçirin. Hem open() hem de save() eşzamanlıdır — 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

Aspose.3D FOSS for TypeScript nedir?

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

Hangi 3D formatları destekleniyor?

OBJ (.mtl ile), glTF 2.0 ve GLB, STL (ikili ve ASCII), COLLADA (DAE), 3MF ve FBX. Her formatın kendine özgü tiplenmiş seçenek sınıfı vardır.

Yerel Node.js eklentileri gerektiriyor mu?

No. Aspose.3D FOSS for TypeScript saf JavaScript/TypeScript’tir. Derleme adımı gerektirmez ve npm tarafından otomatik olarak kurulan tek bir çalışma zamanı bağımlılığı (xmldom) vardır.

Bunu nasıl kurarım?

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

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

Node.js 18, 20 ve 22+. TypeScript 5.0+. Kütüphane CommonJS’ye derlenir ve katı TypeScript ayarlarıyla çalışır.

TypeScript tip tanımlarıyla birlikte mi geliyor?

Evet. Tüm sınıflar, yöntemler, enum’lar ve seçenek tipleri, noImplicitAny ve strictNullChecks etkinleştirilmiş olarak tam tiplenmiştir.

Koordinat sistemi yönelimini kontrol edebilir miyim?

Evet. ObjLoadOptions ve GltfSaveOptions gibi format bazlı seçenek sınıfları, özel ayrıştırma kodu yazmadan eksenleri tersine çevirebilir, ölçeği ayarlayabilir ve normalleri normalleştirebilir.

Kaynak kodunu nereden bulabilirim?

Kütüphane MIT lisanslıdır ve GitHub’da barındırılmaktadır. Hata raporları ve çekme istekleri (pull request) memnuniyetle karşılanır.

  

Destek ve Öğrenme Kaynakları

 Türkçe