อ้างอิง API สำหรับ Aspose.3D 26.1.0 (.NET 10.0+, MIT license).
คลาสทั้งหมดอยู่ใน Aspose.ThreeD เนมสเปซราก. คำสั่ง using รากคือ:
แนวปฏิบัติการตั้งชื่อ C#: คุณสมบัติทั้งหมดใช้ไวยากรณ์ property ของ C# มาตรฐาน ตัวอย่างเช่น ใช้ scene.RootNode แทนที่จะเป็น scene.getRootNode(), และ transform.Translation = ... แทนที่จะเป็น transform.setTranslation(...).
การตั้งชื่อฟิลด์เวกเตอร์: ไลบรารีมีชุดประเภทเวกเตอร์สองชุด. Aspose.ThreeD.Utilities.Vector2/3/4 (ใช้โดย Mesh.ControlPoints, เรขาคณิต, และการดำเนินการคณิตศาสตร์ส่วนใหญ่) เป็น double-precision กับ ตัวพิมพ์เล็ก ฟิลด์สาธารณะ (v.x, v.y, v.z, v.w). ที่ง่ายกว่า Aspose.ThreeD.Vector2/3/4 structs (ใน Vector.cs) คือ ความแม่นยำเดี่ยว (float) กับ ตัวพิมพ์ใหญ่ ฟิลด์สาธารณะ (v.X, v.Y, v.Z). FVector2/3/4 และ Quaternion และ Matrix4 ใช้การเข้าถึงฟิลด์แบบตัวพิมพ์ใหญ่. ใช้ Aspose.ThreeD.Utilities ประเภทสำหรับงานเรขาคณิต.
กราฟฉากหลัก
| Methods | Methods |
|---|
Scene | คอนเทนเนอร์ระดับบนสุดสำหรับข้อมูลฉาก 3D ทั้งหมด. เก็บโหนดราก, เมตาดาต้าแอสเซ็ต, และคลิปแอนิเมชัน. เปิดเผย Open() และ Save() เป็นจุดเข้าหลักของ I/O. |
Node | โหนดที่มีชื่อในลำดับชั้นของฉาก มีรายการโหนดลูกและรายการที่แนบ Entity วัตถุต่าง ๆ เช่น meshes, cameras, และ lights. มีการพกพา local Transform. |
Entity | คลาสฐานเชิงนามธรรมสำหรับวัตถุทั้งหมดที่สามารถแนบไปยัง Node. ให้ชื่อและเอกลักษณ์แต่ไม่มีรูปทรงของตนเอง. |
SceneObject | คลาสฐานที่ใช้ร่วมโดย Node และ Entity. ให้ส่วนต่อประสานการรวบรวมคุณสมบัติที่ใช้สำหรับเมตาดาต้ากำหนดโดยผู้ใช้. |
A3DObject | คลาสฐานรากสำหรับอ็อบเจ็กต์ที่จัดการ Aspose.3D ทั้งหมด. เปิดเผย Name คุณสมบัติและ Properties คอลเลกชัน. |
INamedObject | อินเทอร์เฟซที่รับประกัน a Name คุณสมบัติ. ถูกนำไปใช้โดย Node, Entity, และหลายประเภทของ descriptor ที่เฉพาะเจาะจงต่อฟอร์แมต. |
เรขาคณิตและเมช
| Methods | Methods |
|---|
Mesh | Polygon mesh entity. เก็บจุดควบคุม (ตำแหน่งเวอร์เท็กซ์เป็น Vector4), รายการหน้าพอลิกอน (รายการของดัชนีจุดควบคุม), และชั้นขององค์ประกอบเวอร์เท็กซ์ (normals, UVs, vertex colours). |
Geometry | ฐานเชิงนามธรรมสำหรับประเภทเรขาคณิตแบบเมช. กำหนดอาร์เรย์ของจุดควบคุมและคอลเลกชันของ VertexElement ชั้น. Mesh สืบทอดจาก Geometry. |
VertexElement | ฐานเชิงนามธรรมสำหรับชั้นข้อมูลที่แนบกับเรขาคณิต (normals, UVs, colours, ฯลฯ) บรรจุ MappingMode, ReferenceMode, และรายการข้อมูล. |
VertexElementNormal | จัดเก็บเวกเตอร์ปกติหนึ่งตัวต่อเวอร์เท็กซ์หรือต่อมุมของโพลิกอน ขึ้นอยู่กับโหมดการแมป. |
VertexElementUV | จัดเก็บคู่พิกัดเทกซ์เจอร์ (Vector2) ต่อจุดยอดหรือมุมของโพลิกอน. |
VertexElementVertexColor | จัดเก็บข้อมูลสี RGBA ต่อจุดยอดหรือต่อมุมเป็น Vector4. |
รูปทรงพื้นฐานในตัว
| Methods | Methods |
|---|
Box | กล่องพารามิเตอร์ที่จัดแนวแกน (axis-aligned) มีความกว้าง, ความสูง, และความลึกที่กำหนดค่าได้. สามารถแนบไปยัง Node โดยตรงหรือแปลงเป็น Mesh ผ่าน ToMesh(). |
Sphere | ทรงกลมพารามิเตอร์ที่มีรัศมีที่ปรับได้. รองรับ ToMesh() การแปลง. |
Cylinder | ทรงกระบอกพารามิเตอร์ที่มีรัศมีด้านบน, รัศมีด้านล่าง, และความสูงที่กำหนดได้. รองรับ ToMesh() การแปลง. |
การแปลงและตำแหน่งเชิงพื้นที่
| Methods | Methods |
|---|
Transform | การแปลงเชิงท้องถิ่นที่แนบกับ Node. ให้บริการ Translation (FVector3), Rotation (Quaternion), Scale (FVector3), และ Matrix (Matrix4) คุณสมบัติ. |
GlobalTransform | มุมมองแบบอ่านอย่างเดียวของเมทริกซ์การแปลงในพื้นที่โลกของโหนดหลังจากรวมการแปลงของบรรพบุรุษทั้งหมด. เข้าถึงได้ผ่าน node.GlobalTransform. เปิดเผยเพียงหนึ่ง Matrix คุณสมบัติ. |
AssetInfo | บล็อกเมตาดาต้าที่แนบกับ a Scene. สืบทอดจาก A3DObject ให้ Name และ Properties. ไม่มีคุณสมบัติเพิ่มเติมที่กำหนดไว้ในฉบับนี้. |
วัสดุและการเชดดิ้ง
| Methods | Methods |
|---|
Material | คลาสฐานเชิงนามธรรมสำหรับทุกประเภทของวัสดุ. ให้ชื่อและคอลเลกชันของคุณสมบัติ. |
LambertMaterial | วัสดุแบบกระจายแสงอย่างเดียวแบบคลาสสิกที่มี Ambient, Diffuse, Emissive, Reflective, Transparency, และ Texture คุณสมบัติ. Namespace: Aspose.ThreeD.Shading. |
PhongMaterial | ขยาย Lambert ด้วย Specular, Shininess, และ SpecularPower คุณสมบัติ. Namespace: Aspose.ThreeD.Shading. |
PbrMaterial | วัสดุ Physically Based Rendering กับ BaseColor, Metallic, Roughness, Occlusion, และคุณสมบัติของ texture slot. Namespace: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | เอนทิตี Camera. สืบทอดจาก Frustum. แนบกับ a Node เพื่อกำหนดการแปลงมุมมอง คุณสมบัติที่เฉพาะเจาะจงของรูปแบบไม่ได้เปิดเผยในฉบับนี้. |
ยูทิลิตี้คณิตศาสตร์
| Methods | Methods |
|---|
Vector2 | ความแม่นยำคู่ 2-component vector (lowercase fields: x, y). Namespace: Aspose.ThreeD.Utilities. ใช้สำหรับพิกัดเทกเจอร์ UV. |
Vector3 | ความแม่นยำแบบคู่ 3-component vector (lowercase fields: x, y, z). เนมสเปซ: Aspose.ThreeD.Utilities. เวกเตอร์เชิงพื้นที่ทั่วไปสำหรับเรขาคณิต. |
Vector4 | ความแม่นยำคู่ 4-component vector (lowercase fields: x, y, z, w). Namespace: Aspose.ThreeD.Utilities. ใช้สำหรับ Mesh.ControlPoints และข้อมูลปกติ. |
FVector3 | Single-precision 3-component float vector (ฟิลด์ตัวพิมพ์ใหญ่: X, Y, Z). ใช้โดย Transform.Translation และ Transform.Scale. |
FVector4 | เวกเตอร์ float แบบความแม่นยำเดี่ยว 4 ส่วนประกอบ (ฟิลด์ตัวพิมพ์ใหญ่: X, Y, Z, W). |
Quaternion | ควอเทอร์เนียนหน่วยสำหรับแสดงการหมุน (W, X, Y, Z). ใช้โดย Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | กล่องขอบเขตที่จัดแนวตามแกนที่กำหนดโดย Minimum และ Maximum FVector3 มุม. |
Methods
| Methods | Methods |
|---|
AnimationClip | คอนเทนเนอร์ที่ตั้งชื่อสำหรับช่วงแอนิเมชัน. A Scene อาจบรรจุหลายคลิป. ส่วนประกาศสเตบ — ข้อมูลคีย์เฟรมและการเล่นยังไม่ได้ทำการใช้งาน. |
การอ่าน/เขียนรูปแบบ
| Methods | Methods |
|---|
Scene.Open(path) | เปิดไฟล์ ตรวจจับรูปแบบจากส่วนขยาย และเติมข้อมูลลงในซีน. |
Scene.Open(path, options) | เปิดไฟล์โดยใช้รูปแบบที่ระบุเฉพาะ LoadOptions. |
Scene.Open(stream) | เปิดจากสตรีมโดยตรวจจับรูปแบบอัตโนมัติจากเนื้อหา. |
Scene.Open(stream, options) | เปิดจากสตรีมด้วยรูปแบบที่ระบุเฉพาะ LoadOptions. |
Scene.Save(path) | บันทึกฉากลงไฟล์; รูปแบบสรุปจากนามสกุลไฟล์. |
Scene.Save(path, options) | บันทึกด้วยรูปแบบที่ระบุเฉพาะ SaveOptions. |
Scene.Save(stream, options) | บันทึกลงสตรีมด้วยรูปแบบที่ระบุเฉพาะ SaveOptions. |
FileFormat | ทะเบียนของรูปแบบไฟล์ที่รองรับ ใช้ FileFormat.Formats (an IList<FileFormat>) เพื่อแสดงรายการรูปแบบที่รองรับทั้งหมด, หรือ FileFormat.Detect(fileName) เพื่อค้นหารูปแบบโดยใช้ชื่อไฟล์. ค่าคงที่ที่ตั้งชื่อ (ObjFormat, GltfFormat, FbxFormat, ฯลฯ) เป็น internal และไม่สามารถเข้าถึงได้จากโค้ดของผู้ใช้. |
IOService | การแยกนามธรรม I/O ภายใน. ให้ DetectFormat() สำหรับการตรวจจับรูปแบบแบบสตรีม. |
LoadOptions | คลาสพื้นฐานสำหรับตัวเลือกการโหลดที่กำหนดรูปแบบ. |
SaveOptions | คลาสพื้นฐานสำหรับตัวเลือกการบันทึกที่กำหนดรูปแบบ. |
รูปแบบ OBJ
รูปแบบ STL
รูปแบบ glTF
| Methods | Methods |
|---|
GltfLoadOptions | โหลดตัวเลือกสำหรับไฟล์ glTF 2.0 และ GLB. |
GltfSaveOptions | บันทึกตัวเลือกสำหรับผลลัพธ์ glTF 2.0 และ GLB. ไม่มีคุณสมบัติเฉพาะรูปแบบที่เปิดเผยในรุ่นนี้; ใช้ .glb ส่วนขยายสำหรับผลลัพธ์ไบนารี. |
รูปแบบ FBX
| Methods | Methods |
|---|
FbxLoadOptions | โหลดตัวเลือกสำหรับไฟล์ FBX. |
FbxSaveOptions | บันทึกตัวเลือกสำหรับการส่งออก FBX. การส่งออก FBX จะสร้างผลลัพธ์เป็นไบนารีเสมอ; การส่งออก FBX แบบ ASCII ไม่ได้เปิดใช้งานในเวอร์ชันนี้. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | ตัวบรรยายประเภทเนื้อหา: ASCII, Binary. มีให้เป็นคุณสมบัติบน FileFormat. |
Axis | ระบุแกนพิกัด: XAxis, YAxis, ZAxis. |
CoordinateSystem | ระบุแนวทางการกำหนดมือ: RightHand หรือ LeftHand. |
ระบบคุณสมบัติ
| Methods | Methods |
|---|
Property | คุณสมบัติที่มีชื่อและกำหนดประเภทบน A3DObject. |
PropertyCollection | คอลเลกชัน Iterable ของ Property objects ที่แนบกับ an A3DObject. |
ดูเพิ่มเติม
