Aspose.3D FOSS for TypeScript
API referansı için @aspose/3d sürüm 24.12.0. Şu şekilde kurun:
npm install @aspose/3dÇalışma zamanı: Node.js 18, 20, 22+ · Dil: TypeScript 5.0+ / JavaScript (CommonJS) · Lisans: MIT
Çekirdek Sahne Grafiği
Enumerations
3D sahne için kök kapsayıcı. Şunu çağırın scene.open() veya scene.openFromBuffer() bir dosyayı yüklemek için, ve scene.save() çıktıyı yazmak için. Şunları ortaya çıkarır scene.rootNode düğüm hiyerarşisine giriş noktası olarak.
Enumerations
Sahne ağacındaki adlandırılmış bir düğüm. Şunu tutar Transform, isteğe bağlı bir entity (mesh, kamera, ışık veya diğer SceneObject), ve sıfır veya daha fazla alt düğüm, şunun aracılığıyla erişilebilir childNodes.
Enumerations
Bir şeye bağlanabilen tüm nesneler için temel sınıf Node birincil varlığı olarak. Şu sınıflar tarafından alt sınıflandırılmıştır Mesh, Camera, Light, ve diğerleri.
SceneObject
Bir sahneye ait adlandırılmış nesneler için soyut temel. Şunu sağlar name düğümler, varlıklar ve asset-level nesneler tarafından paylaşılan property ve scene-membership takibi.
A3DObject
Tüm Aspose.3D nesneleri için kök temel sınıf. Property sistemini sağlar (getProperty, setProperty) ve name field her public sınıf tarafından miras alınan.
Geometri ve Mesh
Enumerations
Bir poligon örgüsünü temsil eder. Bir controlPoints dizisi Vector4 düğümler ve poligon tanımları, şu yoluyla oluşturulur createPolygon(). Çağır triangulate() tüm poligonları dışa aktarmadan önce üçgenlere dönüştürmek için.
Enumerations
Tüm geometri tipleri için temel sınıf. Tutar controlPoints ve geometriye eklenmiş köşe öğeleri (normaller, UV’ler, renkler) koleksiyonunu.
VertexElement
Bir köşe başına öznitelik kanallarına eklenmiş bir Geometry. Alt sınıflar tiplenmiş veri dizilerini ve mappingMode / referenceMode üst verileri.
VertexElementNormal
Bir VertexElement yüzey normallerini depolayan bir alt sınıf. Veri dahili olarak şu şekilde depolanır FVector4[] (şu sınıftan miras alınan VertexElementFVector). Doğru aydınlatma için çoğu render tarafından gereklidir.
VertexElementUV
Bir VertexElement 2B doku koordinatlarını depolayan bir alt sınıf. Tek bir örgü, farklı doku katmanları için birden fazla UV setine sahip olabilir.
VertexElementVertexColor
A VertexElement her-vertex RGBA renk değerlerini depolayan alt sınıf.
VertexElementType
Bir …nin temsil edebileceği öznitelik kanal türlerinin sayımı VertexElement temsil edebilir (örneğin,., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).
MappingMode
Eleman verilerinin geometriye nasıl eşlendiğini kontrol eden numaralandırma: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, ya da ALL_SAME.
ReferenceMode
Eleman indekslerinin veriye nasıl referans verdiğini kontrol eden numaralandırma: DIRECT (bire bir) ya da INDEX_TO_DIRECT (bir indeks dizisi aracılığıyla).
TextureMapping
Doku kanal semantiklerinin listesi: DIFFUSE, SPECULAR, NORMAL, EMISSIVE, BUMP, ve daha fazlası.
Transform ve Spatial
Enumerations
Yerel konumu tutar (translation), rotasyon (rotation olarak Quaternion), ve ölçek (scaling) bir Node. Buradaki değişiklikler düğümü ve tüm alt düğümlerini etkiler.
GlobalTransform
Bir düğümün dünya uzayı dönüşümünün yalnızca okunabilir görünümü, tüm ata düğümlerin birikimiyle hesaplanır Transform değerler. Şu aracılığıyla erişin node.globalTransform.
BoundingBox
Bir eksen hizalı sınırlayıcı kutu, bir minimum ve maximum Vector3 köşe. Bir ağın veya sahnenin uzamsal kapsamını tanımlamak için kullanılır.
Enumerations
Material, LambertMaterial, PhongMaterial, PbrMaterial
Material, tüm malzeme türleri için soyut temel sınıftır. Üç somut uygulama mevcuttur:
- LambertMaterial — sadece difüz, ortam, difüz ve ışıldayan renk kanallarıyla. Speküler olmayan yüzeyler için uygundur.
- PhongMaterial — genişletir
LambertMaterialPhong gölgelendirme için speküler renk ve parlaklık özellikleriyle. - PbrMaterial — metalik, pürüzlülük, temel renk ve normal harita kanallarına sahip fiziksel tabanlı render malzemesi. Doğrudan glTF 2.0 PBR malzeme modeline eşlenir.
Kamera ve Aydınlatma
Enumerations
Projeksiyon tipi, görüş alanı, yakın/uzak kırpma mesafeleri ve en‑boy oranı özelliklerine sahip bir bakış noktası düğüm varlığı.
Enumerations
Bir ışık kaynağı düğüm varlığı. Tür, şun tarafından kontrol edilir: LightType enumerasyon.
LightType
Desteklenen ışık türlerinin enumerasyonu: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionType
Kamera projeksiyon modlarının enumerasyonu: PERSPECTIVE ve ORTHOGRAPHIC.
Matematik Yardımcıları
Enumerations
Üç bileşenli kayan nokta vektörü, şu x, y, z alanlar ve ortak aritmetik yöntemler (dot, cross, normalize, minus, times). Şuradan dışa aktarıldı @aspose/3d/utilities.
Enumerations
Dört bileşenli kayan nokta vektörü, şu x, y, z, w alanlar. Şunlardaki girişlerin tipi olarak kullanılır Mesh.controlPoints.
Enumerations
İki bileşenli çift hassasiyetli vektör, şu x ve y alanlar. UV doku koordinatları için kullanılır.
FVector3
Normal ve teğetler için vertex eleman veri dizilerinde kullanılan kompakt üç bileşenli tek hassasiyetli kayan nokta vektörü.
Enumerations
4×4 bir dönüşüm matrisi. Birleştirme, tersine çevirme, transpoz ve çeviri, dönüş ve ölçek bileşenlerine ayrıştırmayı destekler. Şuradan dışa aktarıldı @aspose/3d/utilities.
Enumerations
Gimbal kilidi olmadan dönüşleri temsil etmek için bir birim kuaternion. Sağlar slerp() pürüzsüz ara değerleme ve Euler açılarına/ açıları arasındaki dönüşüm için Matrix4. Şuradan dışa aktarıldı @aspose/3d/utilities.
Enumerations
AnimationClip
Adlandırılmış, zaman sınırlı bir koleksiyon AnimationNode izler. FBX veya COLLADA dosyalarından yüklenen anahtar kare animasyon verileri için birincil kapsayıcı.
AnimationNode
Belirli bir sahne nesnesindeki özellik yolunu hedefleyen adlandırılmış bir animasyon izi. Bir veya daha fazla AnimationChannel nesneler.
AnimationChannel
Bir içinde tek bir animasyonlu özellik kanalı AnimationNode. Bir … tutar KeyframeSequence zaman/değer çiftlerinden oluşur.
KeyFrame
Bir içinde tek bir zaman/değer örneği KeyframeSequence. Zaman damgasını (saniye cinsinden), değeri ve enterpolasyon için teğet bilgilerini taşır.
KeyframeSequence
Sıralı bir liste KeyFrame bir özellik kanalı için örnekler, ayrıca Interpolation ve Extrapolation oynatımı yöneten ayarlar.
Enumerations
Anahtar kare enterpolasyon modlarının sayımı. Bilinen üyeler şunlardır LINEAR ve CONSTANT. Ek üyeler, örneğin BEZIER mevcut olabilir.
Enumerations
Anahtar kare aralığının dışındaki davranışı tanımlar (ilk anahtardan önce ve son anahtardan sonra). Kontrol eden: ExtrapolationType.
StepMode
Sınır noktalarında adımlı (sabit) ara değerlemenin nasıl uygulanacağını kontrol eden enum.
WeightedMode
Bezier teğet ağırlık işleme için enum: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT, ya da BOTH.
ExtrapolationType
Aralık dışı davranışların sayımı: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, ve OSCILLATE.
Biçim G/Ç
FileFormat
3B dosya formatı için temel tanımlayıcı. Desteklenen her format, şu aracılığıyla somut bir tekil nesne sağlar: getInstance().
Enumerations
Biçime özgü içe aktarma uygulamaları için temel sınıf. Doğrudan örneklenmez; şu tarafından dahili olarak çağrılır: scene.open().
Enumerations
Biçime özgü dışa aktarma uygulamaları için temel sınıf. Doğrudan örneklenmez; şu tarafından dahili olarak çağrılır: scene.save().
LoadOptions
Biçime özgü yükleme seçeneği nesneleri için temel sınıf. Bir alt sınıf örneğini şu yere gönderin: scene.open() veya scene.openFromBuffer().
SaveOptions
Biçime özgü kaydetme seçeneği nesneleri için temel sınıf. Bir alt sınıf örneğini şu yere gönderin: scene.save().
IOService
İçe aktarıcılar ve dışa aktarıcılar için dosya sistemi ve tampon G/Ç’yi soyutlayan iç hizmet arayüzü.
OBJ Biçimi
OBJ hem içe aktarmayı hem de dışa aktarmayı destekler. OBJ olarak kaydederken, malzeme kütüphanesi (.mtl) otomatik olarak şunun yanında yazılır: .obj dosya.
ObjImporter
Wavefront OBJ dosyalarını okuyan dahili içe aktarıcı, çözer .mtl malzeme kütüphanelerini ve doldurur bir Scene. Şu zaman otomatik olarak çağrılır: ObjLoadOptions şuna geçirildiğinde scene.open().
ObjExporter
Wavefront OBJ dosyalarını yazan dahili dışa aktarıcı. Bir eşlikçi .mtl malzeme kütüphanesi otomatik olarak yazılır. Çağrıldığında scene.save() hedefi bir .obj yol.
ObjLoadOptions
OBJ dosyaları için yükleme seçenekleri. Ana özellikler: enableMaterials (boolean, varsayılan true), flipCoordinateSystem (boolean), normalizeNormal (boolean, varsayılan true), scale (sayı). Bakınız Format Yükleme ve Kaydetme Seçenekleri tam ayrıntılar için.
ObjSaveOptions
OBJ dışa aktarma için kaydetme seçenekleri. Şuraya geçirin scene.save() OBJ çıktı davranışını kontrol etmek için. Bakınız Format Yükleme ve Kaydetme Seçenekleri tam ayrıntılar için.
ObjFormat
OBJ için biçim tanımlayıcı tek örnek. Her iki canImport ve canExport şunlardır true.
glTF Formatı
GltfImporter
glTF 2.0 JSON’i okur (.gltf) ve ikili GLB (.glb) dosyalarını. Gömülü ve harici tampon referanslarını, PBR malzemelerini, derileri ve animasyon kliplerini işler.
GltfExporter
glTF 2.0 çıktısı yazar. Ne zaman GltfSaveOptions.binaryMode dır true, kendinden bağımsız bir GLB üretir; aksi takdirde bir JSON yazar .gltf bir eşlik eden .bin tampon.
GltfLoadOptions
glTF/GLB dosyaları için yükleme seçenekleri. Tampon çözümlemesini ve doku yükleme davranışını kontrol eder.
GltfSaveOptions
glTF/GLB dışa aktarma için kaydetme seçenekleri. Dikkate değer özellikler: binaryMode (boolean, true → GLB, varsayılan false), flipTexCoordV (boolean, UV dikey eksenini ters çevirir, varsayılan true). Bkz Format Yükleme ve Kaydetme Seçenekleri tam ayrıntılar için.
GltfFormat
Biçim tanımlayıcı singleton. Şu yolla elde edin GltfFormat.getInstance() ve şuna aktar scene.save() ikinci argüman olarak.
STL Formatı
StlImporter
ASCII ve ikili STL dosyalarını bir Scene içeren tek bir Mesh varlık.
StlExporter
İkili STL yazar. Çıktı, sahnedeki üçgenleştirilmiş ağı içerir; üçgen olmayan çokgenler otomatik olarak üçgenleştirilir.
StlLoadOptions
STL için yükleme seçenekleri. İçe aktarıcının içe aktarım sırasında normalleri ters çevirip çevirmeyeceğini kontrol eder.
StlSaveOptions
STL dışa aktarma için kaydetme seçenekleri. Ana özellik: binaryMode (boolean, varsayılan false). Çıktının ASCII mi yoksa ikili STL mi olacağını kontrol eder. Bkz Format Yükleme ve Kaydetme Seçenekleri tam ayrıntılar için.
StlFormat
Biçim tanımlayıcı singleton. Şu yolla elde edin StlFormat.getInstance().
3MF Format
ThreeMfImporter
Open Packaging Convention 3MF arşivlerini okur ve bir Scene örgü nesneleri, renkler ve malzeme özellikleriyle.
ThreeMfExporter
Mevcut sahneden geçerli bir 3MF arşivi yazar. 3D baskı iş akışları için uygundur.
ThreeMfLoadOptions
3MF dosyaları için yükleme seçenekleri.
ThreeMfSaveOptions
3MF dışa aktarma için kaydetme seçenekleri.
ThreeMfFormat
Biçim tanımlayıcı tek örnek. Şu yolla elde edin ThreeMfFormat.getInstance().
FBX Biçimi
FbxImporter
Geometri, malzemeler, iskeletler, blend şekilleri ve animasyon klipleri dahil olmak üzere FBX ikili ve ASCII dosyalarını okur.
FbxExporter
Mevcut sahneden FBX dosyaları yazar. Seçeneklere bağlı olarak ikili ve ASCII FBX çıktısı desteklenir.
FbxLoadOptions
FBX için yükleme seçenekleri. Animasyon, skinler ve blend şekillerinin içe aktarılıp aktarılmayacağını kontrol eder.
FbxSaveOptions
FBX dışa aktarma için kaydetme seçenekleri. Ana özellik: embedTextures (boolean, varsayılan false). Görün Format Yükleme ve Kaydetme Seçenekleri tam detaylar için.
FbxFormat
Biçim tanımlayıcı tek örnek. Şu yolla edinin FbxFormat.getInstance().
COLLADA Biçimi
COLLADA içe ve dışa aktarma, şunu gerektirir xmldom eş bağımlılık, bu da otomatik olarak şununla kurulur @aspose/3d.
ColladaImporter
Okur COLLADA (.dae) XML dosyalarını kullanarak xmldom. Geometri, malzemeler, kameralar, ışıklar ve animasyonu işler.
ColladaExporter
Mevcut sahneden COLLADA XML çıktısı yazar. DCC araçları (Blender, Maya vb.) ile değiş tokuş için uygundur.
ColladaFormat
Biçim tanımlayıcı tek örnek. Şu yolla edinin ColladaFormat.getInstance().
Özellikler Sistemi
Enumerations
Herhangi bir şeye eklenebilen tiplenmiş ad/değer çifti A3DObject. Skaler ve vektör değer tiplerini destekler.
PropertyCollection
Sıralı bir kapsayıcı Property nesneler. Herhangi bir A3DObject aracılığıyla properties erişici.
CustomObject
Genişletilen serbest biçimli bir özellik çantası A3DObject. Standart bir sınıfa eşlenmeyen rastgele meta verileri depolamak için kullanılır.
Varlık Bilgisi
AssetInfo
Kaynak dosyadan yüklenen sahne düzeyindeki meta verileri taşır: yazar, uygulama adı, oluşturma tarihi, birim ölçeği ve koordinat ekseni bilgileri.
ImageRenderOptions
Görüntü verilerini gömen formatlara (ör. GLB ile) kaydederken dokuların ve resimlerin nasıl çözümleneceğini ve kodlanacağını kontrol eden seçenekler binaryMode: true).
Ayrıca Bakınız
- Bilgi Tabanı: Nasıl Yapılır Kılavuzları
- Detaylı API Genel Bakışı
- Scene sınıfı
- Node sınıfı
- Mesh sınıfı
- Transform sınıfı
- GlobalTransform sınıfı
- Camera sınıfı
- Light sınıfı
- Vector3 sınıfı
- Quaternion sınıfı
- Matrix4 sınıfı
- BoundingBox sınıfı
- Material, LambertMaterial, PhongMaterial, PbrMaterial
- Format Yükleme ve Kaydetme Seçenekleri
- Vector2, Vector4 referansı
- Property, PropertyCollection, AssetInfo referansı
- A3DObject, SceneObject, Entity referansı
- VertexElement, VertexElementNormal, VertexElementUV referansı
- Enumerations referansı
- npm: @aspose/3d
- GitHub: aspose-3d-node