API referansı için aspose-3d-foss 26.1.0 (Java 21+, MIT lisansı).
tüm sınıflar şurada bulunur com.aspose.threed kök paket. Kök içe aktarma şudur:
Paket düzeni: Neredeyse tüm genel sınıflar şurada bulunur com.aspose.threed. Tipik olarak kullanılan tek alt paket şudur com.aspose.threed.shading (için PbrMaterial). Bu com.aspose.threed.formats alt paket, dahili içe aktarıcıları/dışa aktarıcıları içerir ve genellikle doğrudan içe aktarılmaz.
Java adlandırma konvansiyonu: Tüm özellikler getter/setter metodlarını kullanır. Örneğin, şunu kullanın node.getTransform() şunun yerine node.transform, ve transform.setTranslation(...) şunun yerine transform.translation = .... Şunu not edin Vector3, Vector4, Quaternion, Matrix4, ve FVector türleri kullanır genel alanlar (v.x, v.y, v.z) bileşen erişimi için getter’lar yerine.
Temel Sahne Grafiği
| Example | Example |
|---|
Scene | Tüm 3D sahne verileri için üst düzey kapsayıcı. Kök düğümü, varlık meta verilerini ve animasyon kliplerini tutar. Sunar fromFile(), open(), ve save() birincil G/Ç giriş noktaları olarak. |
Node | Sahne hiyerarşisinde adlandırılmış bir düğüm. Çocuk düğüm listesine ve eklenmiş Entity örgüler, kameralar ve ışıklar gibi nesneler. Yerel bir Transform. |
Entity | Bir şeye eklenebilen tüm nesneler için soyut temel sınıf Node. Kendi adı ve kimliğini sağlar ancak kendi geometrisini içermez. |
SceneObject | Tarafından paylaşılan temel sınıf Node ve Entity. Kullanıcı tanımlı meta veriler için kullanılan özellik koleksiyonu arayüzünü sağlar. |
A3DObject | Aspose.3D yönetilen tüm nesneler için kök temel sınıf. Ad özelliğini ve Properties koleksiyonu. |
INamedObject | Bir … garantileyen arayüz getName() metod. Tarafından uygulanır Node, Entity, ve çeşitli format‑özel tanımlayıcı tipleri. |
Geometri ve Ağ
| Example | Example |
|---|
Mesh | Poligon ağ varlığı. Kontrol noktalarını (köşe konumları olarak Vector4), poligon yüz listeleri (kontrol nokta indekslerinin listeleri), ve köşe eleman katmanları (normaller, UV’ler, köşe renkleri). |
Geometry | Ağ benzeri geometri tipleri için soyut temel. Kontrol nokta dizisini ve koleksiyonunu tanımlar VertexElement katmanlar. Mesh şu sınıftan miras alır Geometry. |
VertexElement | Geometriye (normaller, UV’ler, renkler vb.) eklenen bir veri katmanı için soyut temel. Taşır getMappingMode(), getReferenceMode(), ve bir veri listesi. |
VertexElementNormal | Haritalama moduna bağlı olarak, her köşe ya da her çokgen köşesi için bir normal vektörü depolar. Veri değerleri Vector4 örnekleri w kullanılmıyor. |
VertexElementUV | Doku koordinat çiftlerini depolar (Vector2) her köşe ya da her çokgen köşesi için. Bir ağ, farklı doku kanalları için birden fazla UV katmanı taşıyabilir. |
VertexElementVertexColor | Köşe başına ya da köşe köşesi başına RGBA renk verisini olarak depolar Vector4 (r, g, b, a 0–1 aralığında). |
VertexElementType | Bir köşe öğesi katmanının anlamsal rolünü tanımlayan enum: NORMAL, UV, VERTEX_COLOR, ve diğerleri. Değerleri şuraya gönder: Mesh.getElement(). |
MappingMode | Bir köşe öğesi değerinin hangi ilkelere eşleneceğini kontrol eden enum: CONTROL_POINT, POLYGON_VERTEX, ya da POLYGON. |
ReferenceMode | Değerlerin nasıl indeksleneceğini kontrol eden enum: DIRECT (her haritalama ilkeline bir değer) ya da INDEX_TO_DIRECT (değerler dizisi ve ayrı bir indeks dizisi). |
Dönüşüm ve Uzaysal
| Example | Example |
|---|
Transform | Bir şeye eklenmiş yerel dönüşüm Node. Çeviri, döndürme (şu şekilde Quaternion), ve ölçek bileşenleri, ayrıca Euler açıları için kullanışlı yöntemler. |
GlobalTransform | Tüm üst düğüm dönüşümleri birleştirildikten sonra bir düğümün dünya uzayı dönüşümünün yalnızca okunabilir görünümü. Şu aracılığıyla erişilir node.getGlobalTransform(). |
AssetInfo | Bir …’e eklenmiş meta veri bloğu Scene. Yazar uygulama adını, birim adını, birim ölçek faktörünü, koordinat sistemi eksen tanımlarını ve oluşturma/değiştirme zaman damgalarını depolar. |
Malzemeler ve Gölgelendirme
| Example | Example |
|---|
Material | Tüm malzeme türleri için soyut temel sınıf. Sayısal ve renk parametreleri için bir ad ve bir özellik koleksiyonu sağlar. |
PbrMaterial | Fiziksel Tabanlı Render (PBR) malzemesi. Albedo, metalik faktör, pürüzlülük faktörü, yayılış rengi, şeffaflık ve ilişkili dokuları depolar. glTF 2.0 ve diğer PBR‑uyumlu formatlar tarafından kullanılır. İçe aktar: com.aspose.threed.shading.PbrMaterial. |
Example
| Example | Example |
|---|
Camera | Kamera varlığı. Şu sınıftan miras alır Entity. Java FOSS sürümünde, miras alınan ad ve özellik koleksiyonunun ötesinde format‑özel özellikler sunulmaz. Bir …’e eklenir Node görüş noktası dönüşümlerini tanımlamak için. |
Not: Example Light sınıf, Java Aspose.3D FOSS sürümünde mevcut değildir. İçe aktarılan dosyalardan gelen sahne aydınlatma verileri genel olarak depolanır Entity nesneler.
Matematik Yardımcıları
| Example | Example |
|---|
Vector2 | Çift duyarlıklı 2 bileşenli vektör (x, y). UV doku koordinatları için kullanılır. |
Vector3 | Çift duyarlıklı 3 bileşenli vektör (x, y, z). Konumlar, yönler ve ölçek için kullanılır. |
Vector4 | Çift duyarlıklı 4 bileşenli vektör (x, y, z, w). Kontrol noktaları (homojen konumlar) ve normal verileri için kullanılır. |
FVector3 | Tek duyarlıklı 3 bileşenli float vektör. Normal ve teğetler için vertex eleman veri dizilerinde görünür. |
FVector4 | Tek duyarlıklı 4 bileşenli float vektör. Depolama türü VertexElementFVector veri. |
Quaternion | Dönüşümleri temsil eden birim kuaternion (w, x, y, z). Kullanılan Transform.getRotation(). |
Matrix4 | 4x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions. |
BoundingBox | Eksen hizalı sınırlayıcı kutu tanımlayan getMinimum() ve getMaximum() Vector3 köşeler. Uzamsal sorgular ve frustum temizleme yardımcıları için kullanılır. |
Example
| Example | Example |
|---|
AnimationClip | Animasyon aralığı için adlandırılmış kapsayıcı. Bir Scene birden fazla klip tutabilir (ör. “Walk”, “Run”). Deklarasyon taslağı — anahtar kare verileri ve oynatma henüz uygulanmadı. |
Biçim G/Ç
| Example | Example |
|---|
Scene.fromFile(path) | Statik yöntem. Şu konumdaki dosyayı açar path, uzantıdan formatı algılar ve doldurulmuş bir Scene. Dosya bulunamadığında veya desteklenmeyen formatta hata fırlatır. |
Scene.open(path, options) | Örnek yöntemi. Mevcut bir Scene örnek içine, isteğe bağlı olarak format‑özel LoadOptions alt sınıf. |
Scene.save(path, options) | Örnek yöntemi. Sahneyi şuraya serileştirir path uzantıdan çıkarılan biçimi kullanarak, isteğe bağlı olarak biçim‑özel SaveOptions alt sınıf. |
FileFormat | Desteklenen dosya biçimlerinin kaydı. Şu gibi girişler içerir FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | Dahili G/Ç soyutlaması, biçim içe aktarıcıları ve dışa aktarıcıları tarafından kullanılır. Genellikle uygulama kodu tarafından doğrudan kullanılmaz. |
LoadOptions | Tüm biçim‑özel yükleme seçeneği nesneleri için temel sınıf. Alt sınıflar tarafından türetilir. ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Tüm biçim‑özel kaydetme seçeneği nesneleri için temel sınıf. Alt sınıflar tarafından türetilir. ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
OBJ Biçimi
| Example | Example |
|---|
ObjImporter | Wavefront OBJ ve MTL dosyalarını ayrıştıran dahili içe aktarıcı sınıf. Şu tarafından otomatik olarak çağrılır. Scene.fromFile() için .obj uzantılar. |
ObjLoadOptions | Wavefront OBJ dosyaları için yükleme seçenekleri. Ana özellikler: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | Wavefront OBJ çıktısı için kaydetme seçenekleri. Normalleri, UV’leri, malzeme referanslarını ve nokta bulutu modunu kontrol eder. |
ObjFormat | Wavefront OBJ için biçim tanımlayıcısı. Şu şekilde erişilebilir: FileFormat.WAVEFRONT_OBJ(). |
STL Biçimi
| Example | Example |
|---|
StlImporter | İkili ve ASCII STL dosyalarını okuyan dahili içe aktarıcı. Uzantıya göre otomatik olarak seçilir. |
StlExporter | STL yazan dahili dışa aktarıcı. |
StlLoadOptions | STL dosyaları için yükleme seçenekleri. Şunları destekler: setFlipCoordinateSystem(), setRecalculateNormal(), ve setContentType(). |
StlSaveOptions | STL çıktısı için kaydetme seçenekleri. Kontrol eder: setFlipCoordinateSystem(), setAxisSystem(), ve setContentType(). |
StlFormat | STL için biçim tanımlayıcısı. |
glTF Biçimi
| Example | Example |
|---|
GltfLoadOptions | glTF 2.0 ve GLB dosyaları için yükleme seçenekleri. Ana özellikler: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | glTF 2.0 ve GLB çıktısı için kaydetme seçenekleri. Kullan setContentType(FileContentType.BINARY) bağımsız bir .glb paket. |
GltfFormat | glTF 2.0 / GLB için biçim tanımlayıcısı. Şu şekilde erişilebilir: FileFormat.GLTF2(). |
FBX Biçimi
FBX şu amaçla desteklenir: yalnızca içe aktarma. FBX’ye dışa aktarma, Java FOSS sürümünde mevcut değildir.
| Example | Example |
|---|
FbxLoadOptions | FBX dosyaları için yükleme seçenekleri. Ana özellik: setFlipCoordinateSystem(). |
FbxFormat | FBX için biçim tanımlayıcısı. Şu şekilde erişilebilir: FileFormat.FBX7400ASCII(). |
Example
| Example | Example |
|---|
Axis | Bir koordinat eksenini tanımlar: X_AXIS, Y_AXIS, Z_AXIS. Koordinat sistemi yeniden eşleme seçeneklerinde kullanılır. |
CoordinateSystem | El yönü (handedness) kuralını belirtir: RIGHT_HANDED veya LEFT_HANDED. |
TextureMapping | Bir dokunun geometriye nasıl eşlendiğini tanımlar: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, vb. |
BooleanOperation | CSG Boolean işlem türü: UNION, DIFFERENCE, INTERSECTION. |
Özellikler Sistemi
| Example | Example |
|---|
Property | Bir … üzerindeki tek adlandırılmış tipli özellik A3DObject. Özellik adını, tip tanımlayıcısını ve mevcut değeri depolar. |
PropertyCollection | İterlenebilir koleksiyon Property birine eklenmiş nesneler A3DObject. İsimle arama ve tanımlı tüm özellikler üzerinde yineleme destekler. |
CustomObject | Hafif bir A3DObject yalnızca bir ad ve keyfi bir PropertyCollection. Sahne nesnelerinde kullanıcı tanımlı meta verileri depolamak için kullanılır. |
Görüntü ve Render
| Example | Example |
|---|
ImageRenderOptions | Bir sahneyi görüntü tamponuna render ederken yazılım rasterleştirme seçenekleri. Arka plan rengini, görüntü boyutlarını ve kamera referansını depolar. Bu özellik desteklenen yapılandırmalarda mevcuttur. |
Ayrıca Bakınız