Aspose.3D FOSS for Python

API referansı için aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, MIT lisansı).

Tüm sınıflar şuradan içe aktarılır aspose.threed paket veya alt paketlerinden. Kök içe aktarma şu şekildedir:

import aspose.threed
##or selectively:
from aspose.threed import Scene, Node
from aspose.threed.entities import Mesh, Camera, Light
from aspose.threed.formats import ObjLoadOptions, StlSaveOptions, GltfSaveOptions
from aspose.threed.utilities import Vector3, Matrix4, BoundingBox
from aspose.threed.animation import AnimationClip, KeyFrame

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. Şunları sunar `from_file()`, `open()`, ve `save()` birincil G/Ç giriş noktaları olarak.
`Node`	Sahne hiyerarşisinde adlandırılmış bir düğüm. Çocuk düğümlerin bir listesini 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`. Ad ve kimlik 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 `name` özellik. Tarafından uygulanır `Node`, `Entity`, ve birkaç format‑özel tanımlayıcı türü.

Geometri ve Ağ

Example	Example
`Mesh`	Poligon ağ varlığı. Kontrol noktalarını (vertex positions as `Vector4`), poligon yüz listeleri (kontrol nokta indekslerinin listeleri) ve tepe öğe katmanları (normals, UVs, vertex colours).
`Geometry`	Ağ benzeri geometri türleri için soyut temel. Kontrol nokta dizisini ve koleksiyonunu tanımlar `VertexElement` katmanlar. `Mesh` şunu miras alır `Geometry`.
`VertexElement`	Geometriye (normals, UVs, colours, vb.) eklenen bir veri katmanı için soyut temel. Şunları taşır `mapping_mode`, `reference_mode`, ve bir `data` liste.
`VertexElementNormal`	Her tepe ya da poligon köşesi başına bir normal vektör saklar, şu şeye bağlı olarak `mapping_mode`. Veri değerleri `FVector4` örnekler (single-precision) ile `w` kullanılmayan.
`VertexElementUV`	Doku koordinatı verilerini şu şekilde saklar `FVector4` her tepe ya da poligon köşesi başına (sadece `x` ve `y` bileşenler UV için kullanılır). Bir ağ, farklı doku kanalları için birden fazla UV katmanı taşıyabilir.
`VertexElementVertexColor`	per-vertex veya per-corner RGBA renk verisini şu şekilde depolar `FVector4` (r, g, b, a 0–1 aralığında).
`VertexElementSmoothingGroup`	per-polygon pürüzsüzleştirme grubu tamsayı kimliklerini depolar, OBJ içe aktarıcı tarafından kaynak dosyadan orijinal pürüzsüzleştirme grubu atamalarını yeniden üretmek için kullanılır.
`VertexElementType`	Bir vertex öğe katmanının anlamsal rolünü tanımlayan enum: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, ve diğerleri. Değerleri şuraya gönder `Mesh.get_element()`.
`MappingMode`	Hangi ilkelere bir köşe öğesi değerinin eşleneceğini kontrol eden enum: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, ya da `ALL_SAME`.
`ReferenceMode`	Değerlerin nasıl indeksleneceğini kontrol eden enum: `DIRECT` (her eşleme ilkeline bir değer) ya da `INDEX_TO_DIRECT` (değerler dizisi ve ayrı bir indeks dizisi).
`PolygonModifier`	Üçgenleştirme için yöntemler içeren statik yardımcı sınıf `Mesh` nesneler ve tüm `Scene` grafiklerini.

Dönüşüm ve Uzaysal

Example	Example
`Transform`	Bir şeye eklenmiş yerel dönüşüm `Node`. Çeviri, döndürme (şu şekilde) sağlar `Quaternion`), ölçek bileşenleri ve Euler açıları için kullanışlı özellikler.
`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.global_transform`.
`AssetInfo`	Bir şeye 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. Bir ad ve sayısal ve renk parametreleri için bir özellik koleksiyonu sağlar.
`LambertMaterial`	Yalnızca difüz malzeme modeli. Ortam rengi, difüz renk, yayılış rengi ve şeffaflığı depolar. Temel `Ka`/`Kd`/`Ke` deklarasyonlar.
`PhongMaterial`	Example `LambertMaterial` Yansıtıcı renk ve parlaklık (yansıtıcı üs) ile. OBJ dosyalarından yüklenir ve kullanan `Ks`/`Ns` deklarasyonlar.
`PbrMaterial`	Fiziksel Tabanlı Render (PBR) malzemesi. Albedo, metalik faktör, pürüzlülük faktörü ve ilişkili dokuları depolar. glTF 2.0 ve diğer PBR‑uyumlu formatlar tarafından kullanılır.

Kamera ve Aydınlatma

Example	Example
`Camera`	Kamera varlığı. Sadece `projection_type` ve `name` bu sürümde işlevseldir; diğer tüm sayısal özellikler (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) varsayılan değerler döndüren taslaklardır. Birine eklenir `Node` görüş noktası dönüşümlerini tanımlamak için.
`Light`	Işık kaynağı varlığı. Şu sınıftan miras alır `Camera` taslak sınıf olarak; `Light` sınıf kendisi bu sürümde ek özellikler sunmaz.
`LightType`	Desteklenen ışık kategorilerinin numaralandırması: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Kamera projeksiyon modlarının numaralandırması: `PERSPECTIVE` ve `ORTHOGRAPHIC`.

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.
`FVector2`	Tek duyarlıklı 2 bileşenli float vektör. Düğüm öğesi veri dizilerinde kompakt depolama için dahili olarak kullanılır.
`FVector3`	Tek duyarlıklı 3 bileşenli float vektör. Normal ve teğetler için vertex element veri dizilerinde görünür.
`FVector4`	Tek duyarlıklı 4 bileşenli float vektörü. Depolama türü `VertexElementFVector.data`.
`Quaternion`	Dönüşümleri temsil eden birim kuaternion (`w`, `x`, `y`, `z`). Tarafından kullanılır `Transform.rotation`.
`Matrix4`	4×4 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 `minimum` ve `maximum` `Vector3` köşeler. Uzamsal sorgular ve frustum elenmesi yardımcıları için kullanılır.

Example

Example	Example
`AnimationClip`	Tek bir oynatma aralığını kapsayan animasyon kanallarının bir kümesi için adlandırılmış kapsayıcı. Bir `Scene` birden fazla klip tutabilir (ör. “Walk”, “Run”).
`AnimationNode`	Bağlar bir `AnimationClip` belirli bir sahne düğümüne veya özelliğe. Klip verileri ile sahne grafiği nesneleri arasındaki köprü görevi görür.
`AnimationChannel`	Bir klip içinde tek bir animasyonlu özellik akışı, bir nesnedeki adlandırılmış bir özelliği hedef alır (ör.., `Transform.translation.x`).
`KeyFrame`	Bir … içinde tek bir zaman‑değer örneği `KeyframeSequence`. Zamanı (saniye cinsinden) ve o andaki değeri saklar.
`KeyframeSequence`	Sıralı bir liste `KeyFrame` tek bir skaler kanal için nesneler, interpolasyon ve ekstrapolasyon ayarlarıyla birlikte.
`Interpolation`	Anahtar kareler arasındaki interpolasyon modlarının listesi: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	İlk ve son anahtar karelerin ötesindeki davranışların sayımı: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

Biçim G/Ç

Example	Example
`Scene.from_file(path)`	Statik yöntem. Dosyayı şu konumda açar `path`, uzantıdan formatı algılar ve doldurulmuş bir `Scene`. Dosya bulunamadığında veya desteklenmeyen formatta hata yükseltir.
`Scene.open(path, options=None)`	Örnek metodu. Bir dosyayı mevcut bir `Scene` örneğe, isteğe bağlı olarak format‑spesifik `LoadOptions` alt sınıf.
`Scene.save(path, options=None)`	Örnek metodu. Sahneyi şuraya serileştirir `path` uzantıdan çıkarılan formatı kullanarak, isteğe bağlı olarak format‑spesifik `SaveOptions` alt sınıf.
`FileFormat`	Desteklenen dosya formatlarının kaydı. Şu gibi girişler içerir `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`. Format‑spesifik varyantlara seçenek sınıfları aracılığıyla erişilir (örneğin,., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Format içe ve dışa aktarıcıları tarafından kullanılan dahili G/Ç soyutlaması. Genellikle uygulama kodu tarafından doğrudan kullanılmaz.
`LoadOptions`	Tüm format‑spesifik yükleme‑seçeneği nesneleri için temel sınıf. Şu sınıflar tarafından alt sınıflandırılır `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Tüm format‑spesifik kaydetme‑seçeneği nesneleri için temel sınıf. Şu sınıflar tarafından alt sınıflandırılır `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

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.from_file()` için `.obj` uzantılar.
`ObjLoadOptions`	Wavefront OBJ dosyaları için yükleme seçenekleri. Ana özellikler: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`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 format 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. Destekler `flip_coordinate_system` ve `scale`.
`StlSaveOptions`	STL çıktısı için kaydetme seçenekleri. Kontroller `binary_mode`, `scale`, ve `flip_coordinate_system`.
`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 özellik: `flip_tex_coord_v`.
`GltfSaveOptions`	glTF 2.0 çıktısı için kaydetme seçenekleri. Kullan `binary_mode=True` kendinden bağımsız bir GLB paketi için.
`GltfFormat`	glTF 2.0 / GLB için biçim tanımlayıcısı. Şu şekilde erişilebilir: `FileFormat.GLTF2()`.

FBX Biçimi

Example	Example
`FbxLoadOptions`	FBX dosyaları için yükleme seçenekleri. Ana özellikler: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	FBX çıktısı için kaydetme seçenekleri. Sıkıştırma, doku gömme ve malzeme özelliklerini kontrol eder.
`FbxFormat`	FBX için biçim tanımlayıcısı. Şu şekilde erişilebilir: `FileFormat.FBX7400ASCII()`.

COLLADA Formatı

Example	Example
`ColladaLoadOptions`	COLLADA ( için yükleme seçenekleri`.dae`) dosyaları. İçe aktarırken eksen yeniden eşlemesini ve birim ölçeğini kontrol eder.
`ColladaSaveOptions`	COLLADA çıktısı için kaydetme seçenekleri. Kontroller `indented`, `flip_coordinate_system`, ve malzeme dışa aktarımını.
`ColladaFormat`	COLLADA için biçim tanımlayıcısı. Otomatik olarak dosya uzantısından çözülür `.dae` dosya uzantısı.

3MF Format

Example	Example
`ThreeMfLoadOptions`	3MF (`.3mf`) dosyaları.
`ThreeMfSaveOptions`	3MF çıktısı için kaydetme seçenekleri. 3MF, 3D baskı iş akışları için tercih edilen formattır.
`ThreeMfFormat`	3MF için format tanımlayıcısı. Şu şekilde erişilebilir: `FileFormat.MICROSOFT_3MF_FORMAT()`.

Example

Example	Example
`TextureMapping`	Bir dokunun geometriye nasıl eşlendiğini belirler: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, vb.
`BooleanOperation`	CSG Boole işlemi 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`	Yinelemeli koleksiyon `Property` birine eklenmiş nesneler `A3DObject`. İsimle aramayı ve tanımlı tüm özellikler üzerinde yinelemeyi destekler.
`CustomObject`	Hafif bir `A3DObject` yalnızca bir ad ve keyfi bir taşıyan alt sınıf `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ştirmesi için seçenekler. Arka plan rengini, görüntü boyutlarını ve kamera referansını depolar. Bu özellik desteklenen yapılandırmalarda mevcuttur.

Aspose.3D FOSS for Python

Temel Sahne Grafiği

Geometri ve Ağ

Dönüşüm ve Uzaysal

Malzemeler ve Gölgelendirme

Kamera ve Aydınlatma

Matematik Yardımcıları

Example

Biçim G/Ç

OBJ Biçimi

STL Biçimi

glTF Biçimi

FBX Biçimi

COLLADA Formatı

3MF Format

Example

Özellikler Sistemi

Görüntü ve Render

Ayrıca Bakınız