Tham chiếu API cho Aspose.3D 26.1.0 (.NET 10.0+, giấy phép MIT).
Tất cả các lớp nằm trong Aspose.ThreeD không gian tên gốc. Lệnh using gốc là:
Quy ước đặt tên C#: Tất cả các thuộc tính sử dụng cú pháp thuộc tính chuẩn của C#. Ví dụ, sử dụng scene.RootNode thay vì scene.getRootNode(), và transform.Translation = ... thay vì transform.setTranslation(...).
Cách đặt tên trường vector: Thư viện có hai bộ loại vector. Aspose.ThreeD.Utilities.Vector2/3/4 (được sử dụng bởi Mesh.ControlPoints, hình học, và hầu hết các phép toán toán học) là độ chính xác double với chữ thường các trường công khai (v.x, v.y, v.z, v.w). Đơn giản hơn Aspose.ThreeD.Vector2/3/4 cấu trúc (trong Vector.cs) là độ chính xác đơn (float) với chữ hoa các trường public (v.X, v.Y, v.Z). FVector2/3/4 và Quaternion và Matrix4 sử dụng truy cập trường viết hoa. Sử dụng Aspose.ThreeD.Utilities các kiểu cho công việc hình học.
Đồ thị Cảnh Cốt lõi
| Methods | Methods |
|---|
Scene | Bộ chứa cấp cao nhất cho tất cả dữ liệu cảnh 3D. Chứa nút gốc, siêu dữ liệu tài sản và các đoạn hoạt hình. Cung cấp Open() và Save() như các điểm vào/ra chính. |
Node | Một nút có tên trong cây phân cấp cảnh. Sở hữu một danh sách các nút con và một danh sách các đối tượng được gắn kèm Entity như lưới, máy ảnh và đèn. Mang một Transform. |
Entity | Lớp cơ sở trừu tượng cho tất cả các đối tượng có thể được gắn vào một Node. Cung cấp tên và định danh nhưng không có hình học riêng. |
SceneObject | Lớp cơ sở được chia sẻ bởi Node và Entity. Cung cấp giao diện bộ sưu tập thuộc tính được sử dụng cho siêu dữ liệu do người dùng định nghĩa. |
A3DObject | Lớp cơ sở gốc cho tất cả các đối tượng được quản lý Aspose.3D. Phơi bày Name thuộc tính và Properties bộ sưu tập. |
INamedObject | Giao diện đảm bảo một Name thuộc tính. Được triển khai bởi Node, Entity, và một số loại mô tả đặc thù cho định dạng. |
Hình học và Lưới
| Methods | Methods |
|---|
Mesh | Thực thể lưới đa giác. Lưu trữ các điểm điều khiển (vị trí đỉnh dưới dạng Vector4), danh sách mặt đa giác (danh sách các chỉ số điểm điều khiển), và các lớp phần tử đỉnh (normals, UVs, vertex colours). |
Geometry | Cơ sở trừu tượng cho các loại hình học dạng lưới. Định nghĩa mảng điểm điều khiển và tập hợp của VertexElement các lớp. Mesh kế thừa từ Geometry. |
VertexElement | Cơ sở trừu tượng cho một lớp dữ liệu gắn vào hình học (normals, UVs, colours, etc.). Mang MappingMode, ReferenceMode, và một danh sách dữ liệu. |
VertexElementNormal | Lưu trữ một vectơ pháp tuyến cho mỗi đỉnh hoặc mỗi góc đa giác, tùy thuộc vào chế độ ánh xạ. |
VertexElementUV | Lưu trữ các cặp tọa độ texture (Vector2) trên mỗi đỉnh hoặc góc đa giác. |
VertexElementVertexColor | Lưu trữ dữ liệu màu RGBA trên mỗi đỉnh hoặc mỗi góc dưới dạng Vector4. |
Các Hình Nguyên Tố Tích Hợp
| Methods | Methods |
|---|
Box | Hộp tham số căn trục với chiều rộng, chiều cao và độ sâu có thể cấu hình. Có thể được gắn vào một Node trực tiếp hoặc chuyển đổi thành Mesh thông qua ToMesh(). |
Sphere | Cầu tham số với bán kính có thể cấu hình. Hỗ trợ ToMesh() chuyển đổi. |
Cylinder | Hình trụ tham số với bán kính trên, bán kính dưới và chiều cao có thể cấu hình. Hỗ trợ ToMesh() chuyển đổi. |
Biến Đổi và Không Gian
| Methods | Methods |
|---|
Transform | Biến đổi cục bộ được gắn vào một Node. Cung cấp Translation (FVector3), Rotation (Quaternion), Scale (FVector3), và Matrix (Matrix4) các thuộc tính. |
GlobalTransform | Chế độ xem chỉ đọc của ma trận biến đổi không gian thế giới của một nút sau khi hợp thành tất cả các biến đổi của tổ tiên. Truy cập qua node.GlobalTransform. Tiết lộ một Matrix thuộc tính. |
AssetInfo | Khối siêu dữ liệu được đính kèm vào một Scene. Kế thừa từ A3DObject cung cấp Name và Properties. Không có thuộc tính bổ sung nào được định nghĩa trong phiên bản này. |
Vật liệu và Đổ bóng
| Methods | Methods |
|---|
Material | Lớp cơ sở trừu tượng cho tất cả các loại vật liệu. Cung cấp một tên và một bộ sưu tập thuộc tính. |
LambertMaterial | Vật liệu khuếch tán thuần cổ điển với Ambient, Diffuse, Emissive, Reflective, Transparency, và Texture các thuộc tính. Namespace: Aspose.ThreeD.Shading. |
PhongMaterial | Mở rộng Lambert với Specular, Shininess, và SpecularPower các thuộc tính. Namespace: Aspose.ThreeD.Shading. |
PbrMaterial | Vật liệu Physically Based Rendering với BaseColor, Metallic, Roughness, Occlusion, và các thuộc tính khe kết cấu. Namespace: Aspose.ThreeD.Shading. |
Methods
| Methods | Methods |
|---|
Camera | Thực thể Camera. Kế thừa từ Frustum. Được gắn vào một Node để xác định các biến đổi góc nhìn. Không có thuộc tính đặc thù cho định dạng nào được hiển thị trong phiên bản này. |
Tiện ích Toán học
| Methods | Methods |
|---|
Vector2 | Độ chính xác đôi 2-component vector (lowercase fields: x, y). Không gian tên: Aspose.ThreeD.Utilities. Được sử dụng cho tọa độ texture UV. |
Vector3 | Độ chính xác kép 3-component vector (lowercase fields: x, y, z). Không gian tên: Aspose.ThreeD.Utilities. Vector không gian đa mục đích cho hình học. |
Vector4 | Độ chính xác kép 4-component vector (lowercase fields: x, y, z, w). Không gian tên: Aspose.ThreeD.Utilities. Được sử dụng cho Mesh.ControlPoints và dữ liệu bình thường. |
FVector3 | Vector float 3 thành phần độ chính xác đơn (các trường viết hoa: X, Y, Z). Được sử dụng bởi Transform.Translation và Transform.Scale. |
FVector4 | Vector số thực 4 thành phần độ chính xác đơn (các trường viết hoa: X, Y, Z, W). |
Quaternion | Quaternion đơn vị để biểu diễn các phép quay (W, X, Y, Z). Được sử dụng bởi Transform.Rotation. |
Matrix4 | 4x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix. |
BoundingBox | Hộp bao trùm căn trục được định nghĩa bởi Minimum và Maximum FVector3 góc. |
Methods
| Methods | Methods |
|---|
AnimationClip | Bộ chứa có tên cho một phạm vi hoạt hình. A Scene có thể chứa nhiều clip. Mẫu khai báo — dữ liệu keyframe và phát lại chưa được triển khai. |
Đầu vào/Đầu ra Định dạng
| Methods | Methods |
|---|
Scene.Open(path) | Mở một tệp, phát hiện định dạng từ phần mở rộng và điền dữ liệu vào cảnh. |
Scene.Open(path, options) | Mở một tệp với định dạng cụ thể LoadOptions. |
Scene.Open(stream) | Mở từ một luồng, tự động phát hiện định dạng từ nội dung. |
Scene.Open(stream, options) | Mở từ một luồng với định dạng cụ thể LoadOptions. |
Scene.Save(path) | Lưu cảnh vào tệp; định dạng được suy ra từ phần mở rộng. |
Scene.Save(path, options) | Lưu với định dạng cụ thể SaveOptions. |
Scene.Save(stream, options) | Lưu vào luồng với định dạng cụ thể SaveOptions. |
FileFormat | Danh bạ các định dạng tệp được hỗ trợ. Sử dụng FileFormat.Formats (một IList<FileFormat>) để liệt kê tất cả các định dạng được hỗ trợ, hoặc FileFormat.Detect(fileName) để phát hiện định dạng dựa trên tên tệp. Các hằng số được đặt tên (ObjFormat, GltfFormat, FbxFormat, v.v.) là internal và không thể truy cập từ mã người dùng. |
IOService | Trừu tượng I/O nội bộ. Cung cấp DetectFormat() cho việc phát hiện định dạng dựa trên luồng. |
LoadOptions | Lớp cơ sở cho các tùy chọn tải đặc thù cho định dạng. |
SaveOptions | Lớp cơ sở cho các tùy chọn lưu đặc thù cho định dạng. |
Định dạng OBJ
Định dạng STL
Định dạng glTF
| Methods | Methods |
|---|
GltfLoadOptions | Tải các tùy chọn cho tệp glTF 2.0 và GLB. |
GltfSaveOptions | Lưu các tùy chọn cho đầu ra glTF 2.0 và GLB. Không có thuộc tính đặc thù cho định dạng nào được hiển thị trong phiên bản này; sử dụng .glb phần mở rộng cho đầu ra nhị phân. |
Định dạng FBX
| Methods | Methods |
|---|
FbxLoadOptions | Tải các tùy chọn cho tệp FBX. |
FbxSaveOptions | Lưu các tùy chọn cho đầu ra FBX. Xuất FBX luôn tạo ra đầu ra nhị phân; xuất FBX dạng ASCII không hoạt động trong phiên bản này. |
3MF Format
Methods
| Methods | Methods |
|---|
FileContentType | Bộ mô tả loại nội dung: ASCII, Binary. Có sẵn như một thuộc tính trên FileFormat. |
Axis | Xác định một trục tọa độ: XAxis, YAxis, ZAxis. |
CoordinateSystem | Xác định quy ước hướng tay: RightHand hoặc LeftHand. |
Hệ thống Thuộc tính
| Methods | Methods |
|---|
Property | Một thuộc tính có tên và kiểu duy nhất trên một A3DObject. |
PropertyCollection | Bộ sưu tập có thể lặp lại của Property đối tượng được gắn vào một A3DObject. |
Xem thêm
