Geliştirici Kılavuzu

Aspose.3D FOSS for TypeScript, MIT lisanslı açık kaynak bir kütüphane olup Node.js geliştiricilerinin tam TypeScript tip güvenliğiyle 3D sahneleri yüklemelerine, oluşturmalarına, dönüştürmelerine ve dışa aktarmalarına olanak tanır. İster bir varlık boru hattı, format dönüşüm servisi, geometri doğrulama aracı ya da 3D içerik oluşturma betiği geliştiriyor olun, bu kütüphane, endüstri standardı 3D kavramlarını yansıtan bir sahne grafiği modeliyle desteklenen temiz, tutarlı bir API sunar.

Bu Geliştirici Rehberi, hızlı başlangıç kurulumunun ötesine geçmeniz ve üretim kalitesinde 3D işleme kodu yazmanız için ihtiyacınız olan her şeyi kapsar.

Bu Bölümde Bulacaklarınız

Özellikler ve İşlevsellikler

Bu Özellikler sayfası, Aspose.3D FOSS for TypeScript ile çalışmak için birincil referanstır. Şunları kapsar:

  • Biçim desteği: OBJ (.mtl malzemeleriyle), glTF 2.0 / GLB ikili, STL (ikili ve ASCII), COLLADA (DAE), 3MF ve FBX, her biçim için yükleme ve kaydetme seçenek sınıfları dahil ObjLoadOptions ve GltfSaveOptions.
  • Sahne grafiği: Nasıl Scene, Node, Entity, Transform, ve SceneObject tam bir sahne hiyerarşisi oluşturur, çocuk düğüm geçiş desenleri dahil.
  • Geometri ve mesh API’si: İle çalışmak Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, ve ReferenceMode geometri işleme için.
  • Malzeme sistemi: Uygulama LambertMaterial, PhongMaterial, ve PbrMaterial (PBR for glTF) sahne düğümlerine ve .mtl dosyalarından yüklenen malzeme özelliklerini okuma.
  • Matematik yardımcı programları: Kullanma Vector3, Vector4, Matrix4, Quaternion, ve BoundingBox için dönüşümler, sınırlayıcı kutu sorguları ve geometrik hesaplamalar.
  • Animasyon: Oluşturma ve okuma AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, ve Extrapolation veri.
  • Akış ve tampon desteği: Bellekten 3D sahneleri yükleme Buffer nesneler aracılığıyla scene.openFromBuffer() sunucusuz ve akış senaryoları için.
  • Tam kullanım örnekleri: OBJ yükleme, GLB dışa aktarma, STL döngüsel işleme ve sahne grafikleri üzerinde gezinme için uçtan uca TypeScript betikleri.
  • İpuçları, yaygın sorunlar ve SSS: Üretim kullanımında yaygın tuzaklardan kaçınmak için pratik rehberlik.
  • API referans özeti: Tüm ana sınıfların ve temel yöntemlerinin hızlı referans listesi.

Temel Kavramlar

Sahne grafiği: Aspose.3D FOSS içindeki tüm 3D içerik bir ağaç olarak temsil edilir Node nesneler köklenmiş scene.rootNode. Her düğüm bir Entity (örneğin bir Mesh, Camera, ya da Light) Transform bu, hiyerarşide konumlandırır.

Biçim bağımsız API: Desteklenen herhangi bir biçimi şununla açarsınız scene.open() veya scene.openFromBuffer() ve desteklenen herhangi bir biçime şununla kaydedersiniz scene.save(). Aynı sahne grafiği nesneleri, kaynak ya da hedef biçiminden bağımsız olarak kullanılır.

Güçlü TypeScript tipleri: Kütüphane, katı derleyici ayarlarıyla birlikte gelir (noImplicitAny, strictNullChecks) ve tam tip tanımları. Her sınıf, yöntem ve seçenek özelliği tamamen tiplenmiştir, bu da 3D işleme kodunuz boyunca IDE otomatik tamamlaması ve derleme zamanı güvenliği sağlar.

Tek bağımlılık: Tek çalışma zamanı bağımlılığı şudur xmldom, npm tarafından otomatik olarak kurulur. Derlenecek yerel eklentiler yoktur ve kurulacak sistem paketleri de yoktur.

Başlarken

Henüz kütüphaneyi kurmadıysanız, bakınız the Başlarken bölüm ve Kurulum daha fazla okumadan önce kılavuz.

Available Topics

 Türkçe