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

Aspose.3D FOSS for TypeScript

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 Kaynaklı 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 eklenti, kurulacak harici SDK veya gerekecek bir renderlayıcı yok.

Kütüphane, profesyonel 3D araçları tarafından kullanılan aynı kavramsal modeli temel alan Scene, Node, Entity, Mesh, Camera, Light ve Transform etrafında inşa edilmiş tam tipli bir sahne grafiği API’si sunar. Desteklenen formatlar arasında 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 bulunur. 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 hedef alır ve CommonJS’e 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.

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

  • OBJ / MTL: İlgili malzeme tanımlarıyla birlikte Wavefront OBJ dosyalarını yükleyin.
  • glTF 2.0 / GLB: GltfSaveOptions aracılığıyla PBR malzeme yükleme ve ikili GLB çıktısı.
  • STL: Tam dönüşüm doğrulamasıyla ikili ve ASCII STL dosyalarını okuyun ve yazın.
  • COLLADA, 3MF, FBX: Format‑özel 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 nerede kullanılabilir

  • Node.js asset pipelines: OBJ dosyalarını içe aktarın, doğrulayın ve geometriyi yeniden yönlendirin, ardından CI içinde GLB olarak dışa aktarın.
  • Game tooling: Yerel bir motor veya renderlayıcı olmadan 3D mesh’leri toplu işleyin.
  • 3D printing workflows: STL ve 3MF dosyalarını okuyun, doğrulayın ve yeniden dışa aktarın.
  • Sunucusuz arka uçlar: 3D dönüşüm uç noktalarını Lambda veya Cloud Functions içinde çalıştırın.
  • İçerik taşıma: Tek bir betikten ölçekli olarak format aileleri arasında dönüştürme yapın.

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

  • Coordinate-system orientation: Eksenleri ters çevirin ve format başına ölçeği ayarlayın.
  • Normal normalization: Yükleme veya kaydetme sırasında köşe normallerini otomatik olarak normalleştirin.
  • Binary vs. JSON output: GltfSaveOptions aracılığıyla kompakt GLB ya da okunabilir glTF’yi seçin.
  • Material loading control: Daha hızlı ayrıştırma için MTL/texture yüklemeyi etkinleştirin veya devre dışı bırakın.
  • Round-trip fidelity: Bilinmeyen sahne grafiği düğümleri yeniden kaydedildiğinde olduğu gibi korunur.

Geliştirici Deneyimi

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

Güçlü tiplenmiş API, her sahne grafiği sınıfı ve format seçeneği için tam IDE otomatik tamamlaması sağlar. Kütüphane, Node.js 18–22+ ve TypeScript 5.0+ hedefler, Linux CI çalıştırıcıları ve geliştirici istasyonlarında aynı şekilde çalışır ve GitHub’da açık bir sorun izleyicisiyle MIT lisanslıdır.

Bir OBJ sahnesi yükle ve glTF olarak dışa aktar

npm ile kurun, ardından ObjLoadOptions ile senkron scene.open() metodunu kullanarak ağı MTL malzeme dosyasıyla birlikte yükleyin. .gltf uzantısı ile scene.save() çağrısı 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());

// glTF 2.0 JSON olarak dışa aktar
scene.save("model.gltf");

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

Varsayılan JSON glTF yerine kompakt ikili bir GLB üretmek için, binaryMode = true ayarıyla GltfSaveOptions geçirin.

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

const scene = new Scene();
scene.open("mesh.stl");

// Kompakt ikili GLB olarak kaydet
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Sıkça Sorulan Sorular

Aspose.3D FOSS for TypeScript nedir?

Herhangi bir yerel eklenti veya harici SDK kurmadan 3D sahneleri yüklemek, işlemek ve kaydetmek için ücretsiz, MIT-licensed 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?

Hayır. 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 komutunu ç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’e derlenir ve sıkı TypeScript ayarlarıyla çalışır.

TypeScript tip tanımlarıyla birlikte mi geliyor?

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

Koordinat sistemi yönlendirmesini kontrol edebilir miyim?

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

Kaynak kodunu nerede bulabilirim?

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

  

Destek ve Öğrenme Kaynakları

 Türkçe