Aspose.3D FOSS for Java

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:

import com.aspose.threed.*;

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

ExampleExample
SceneTü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.
NodeSahne 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.
EntityBir ş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.
SceneObjectTarafı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.
A3DObjectAspose.3D yönetilen tüm nesneler için kök temel sınıf. Ad özelliğini ve Properties koleksiyonu.
INamedObjectBir … garantileyen arayüz getName() metod. Tarafından uygulanır Node, Entity, ve çeşitli format‑özel tanımlayıcı tipleri.

Geometri ve Ağ

ExampleExample
MeshPoligon 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).
GeometryAğ 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.
VertexElementGeometriye (normaller, UV’ler, renkler vb.) eklenen bir veri katmanı için soyut temel. Taşır getMappingMode(), getReferenceMode(), ve bir veri listesi.
VertexElementNormalHaritalama 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.
VertexElementUVDoku 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.
VertexElementVertexColorKöş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).
VertexElementTypeBir 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().
MappingModeBir köşe öğesi değerinin hangi ilkelere eşleneceğini kontrol eden enum: CONTROL_POINT, POLYGON_VERTEX, ya da POLYGON.
ReferenceModeDeğ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

ExampleExample
TransformBir ş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.
GlobalTransformTü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().
AssetInfoBir …’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

ExampleExample
MaterialTü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.
PbrMaterialFiziksel 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

ExampleExample
CameraKamera 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ı

ExampleExample
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.
FVector3Tek duyarlıklı 3 bileşenli float vektör. Normal ve teğetler için vertex eleman veri dizilerinde görünür.
FVector4Tek duyarlıklı 4 bileşenli float vektör. Depolama türü VertexElementFVector veri.
QuaternionDönüşümleri temsil eden birim kuaternion (w, x, y, z). Kullanılan Transform.getRotation().
Matrix44x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxEksen 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

ExampleExample
AnimationClipAnimasyon 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/Ç

ExampleExample
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.
FileFormatDesteklenen dosya biçimlerinin kaydı. Şu gibi girişler içerir FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII().
IOServiceDahili 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.
LoadOptionsTü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.
SaveOptionsTü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

ExampleExample
ObjImporterWavefront 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.
ObjLoadOptionsWavefront OBJ dosyaları için yükleme seçenekleri. Ana özellikler: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal().
ObjSaveOptionsWavefront OBJ çıktısı için kaydetme seçenekleri. Normalleri, UV’leri, malzeme referanslarını ve nokta bulutu modunu kontrol eder.
ObjFormatWavefront OBJ için biçim tanımlayıcısı. Şu şekilde erişilebilir: FileFormat.WAVEFRONT_OBJ().

STL Biçimi

ExampleExample
StlImporterİkili ve ASCII STL dosyalarını okuyan dahili içe aktarıcı. Uzantıya göre otomatik olarak seçilir.
StlExporterSTL yazan dahili dışa aktarıcı.
StlLoadOptionsSTL dosyaları için yükleme seçenekleri. Şunları destekler: setFlipCoordinateSystem(), setRecalculateNormal(), ve setContentType().
StlSaveOptionsSTL çıktısı için kaydetme seçenekleri. Kontrol eder: setFlipCoordinateSystem(), setAxisSystem(), ve setContentType().
StlFormatSTL için biçim tanımlayıcısı.

glTF Biçimi

ExampleExample
GltfLoadOptionsglTF 2.0 ve GLB dosyaları için yükleme seçenekleri. Ana özellikler: setFlipCoordinateSystem(), setPrettyPrint().
GltfSaveOptionsglTF 2.0 ve GLB çıktısı için kaydetme seçenekleri. Kullan setContentType(FileContentType.BINARY) bağımsız bir .glb paket.
GltfFormatglTF 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.

ExampleExample
FbxLoadOptionsFBX dosyaları için yükleme seçenekleri. Ana özellik: setFlipCoordinateSystem().
FbxFormatFBX için biçim tanımlayıcısı. Şu şekilde erişilebilir: FileFormat.FBX7400ASCII().

Example

ExampleExample
AxisBir koordinat eksenini tanımlar: X_AXIS, Y_AXIS, Z_AXIS. Koordinat sistemi yeniden eşleme seçeneklerinde kullanılır.
CoordinateSystemEl yönü (handedness) kuralını belirtir: RIGHT_HANDED veya LEFT_HANDED.
TextureMappingBir dokunun geometriye nasıl eşlendiğini tanımlar: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, vb.
BooleanOperationCSG Boolean işlem türü: UNION, DIFFERENCE, INTERSECTION.

Özellikler Sistemi

ExampleExample
PropertyBir … ü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.
CustomObjectHafif 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

ExampleExample
ImageRenderOptionsBir 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

 Türkçe