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 LambertMaterial Phong 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

 Türkçe