Aspose.3D FOSS for .NET

مرجع API برای Aspose.3D 26.1.0 (.NET 10.0+، MIT license).

تمام کلاس‌ها در Aspose.ThreeD فضای نام ریشه. دستور using ریشه به این صورت است:

using Aspose.ThreeD;

قواعد نام‌گذاری C#: تمام ویژگی‌ها از سینتکس استاندارد ویژگی‌های C# استفاده می‌کنند. به عنوان مثال، از scene.RootNode به جای scene.getRootNode(),، و transform.Translation = ... به جای transform.setTranslation(...).

قالب‌بندی فیلد برداری: این کتابخانه دو مجموعه از انواع بردار دارد. Aspose.ThreeD.Utilities.Vector2/3/4 (استفاده شده توسط Mesh.ControlPoints, هندسه، و بیشتر عملیات ریاضی) هستند دقت دوگانه با حروف کوچک فیلدهای عمومی (v.x, v.y, v.z, v.w). ساده‌تر Aspose.ThreeD.Vector2/3/4 ساختارها (در Vector.cs) هستند دقت تک‌نقطه (float) با حروف بزرگ فیلدهای عمومی (v.X, v.Y, v.Z). FVector2/3/4 و Quaternion و Matrix4 از دسترسی به فیلدهای بزرگ‌حرف استفاده کنید. Aspose.ThreeD.Utilities نوع‌ها برای کارهای هندسی.

گراف صحنه اصلی

MethodsMethods
Sceneمحفظه سطح بالایی برای تمام داده‌های صحنهٔ سه‌بعدی. گره ریشه، متادیتای دارایی و کلیپ‌های انیمیشن را نگه می‌دارد. در دسترس می‌گذارد. Open() و Save() به عنوان نقاط ورودی اصلی I/O.
Nodeیک گره نام‌گذاری‌شده در سلسله‌مراتب صحنه. فهرستی از گره‌های فرزند و فهرستی از پیوست‌شده‌ها را در اختیار دارد Entity اشیائی مانند مش‌ها، دوربین‌ها و نورها. یک محلی را حمل می‌کند Transform.
Entityکلاس پایهٔ انتزاعی برای تمام اشیائی که می‌توانند به یک Node. نام و هویت را فراهم می‌کند اما هیچ هندسه‌ای از خود ندارد.
SceneObjectکلاس پایه‌ای به اشتراک گذاشته شده توسط Node و Entity. رابط جمع‌آوری ویژگی‌ها را که برای فراداده‌های تعریف‌شده توسط کاربر استفاده می‌شود، فراهم می‌کند.
A3DObjectکلاس پایه ریشه برای تمام اشیای مدیریت‌شده Aspose.3D. نمایش می‌دهد Name ویژگی و Properties مجموعه.
INamedObjectرابطی که تضمین می‌کند یک Name ویژگی. پیاده‌سازی شده توسط Node, Entity, و چندین نوع توصیفگر مخصوص فرمت.

هندسه و مش

MethodsMethods
Meshموجودیت مش چندضلعی. نقاط کنترل (موقعیت‌های راس به عنوان Vector4), فهرست‌های سطح چندضلعی (فهرست‌های ایندکس نقاط کنترل)، و لایه‌های عنصر راس (نرمال‌ها، UVها، رنگ‌های راس).
Geometryپایهٔ انتزاعی برای انواع هندسه شبیه مش. آرایهٔ نقاط کنترل و مجموعهٔ VertexElement لایه‌ها. Mesh ارث می‌برد از Geometry.
VertexElementپایهٔ انتزاعی برای لایهٔ دادهٔ متصل به هندسه (نرمال‌ها، UVها، رنگ‌ها و غیره). حمل می‌کند MappingMode, ReferenceMode, و یک فهرست داده.
VertexElementNormalیک بردار نرمال برای هر راس یا هر گوشهٔ چندضلعی ذخیره می‌کند، بسته به حالت نگاشت.
VertexElementUVجفت‌های مختصات بافت را ذخیره می‌کند (Vector2) برای هر راس یا هر گوشهٔ چندضلعی.
VertexElementVertexColorداده‌های رنگ RGBA را به‌صورت per-vertex یا per-corner به عنوان Vector4.

اشیاء اولیه داخلی

MethodsMethods
Boxجعبه پارامتریک axis-aligned با عرض، ارتفاع و عمق قابل تنظیم. می‌تواند به یک Node به‌صورت مستقیم یا تبدیل به Mesh از طریق ToMesh().
Sphereکره پارامتریک با شعاع قابل تنظیم. پشتیبانی می‌کند ToMesh() تبدیل.
Cylinderاستوانه پارامتریک با شعاع بالایی، شعاع پایینی و ارتفاع قابل تنظیم. پشتیبانی می‌کند ToMesh() تبدیل.

Transform و Spatial

MethodsMethods
Transformتبدیل محلی متصل به یک Node. فراهم می‌کند Translation (FVector3)،, Rotation (Quaternion)،, Scale (FVector3)، و Matrix (Matrix4) ویژگی‌ها.
GlobalTransformنمایش فقط‑خواندنی از ماتریس تبدیل فضای جهانی یک گره پس از ترکیب تمام تبدیلات اجداد. دسترس‌پذیر از طریق node.GlobalTransform. یک مورد را افشا می‌کند Matrix ویژگی.
AssetInfoبلوک متادیتا پیوست به یک Scene. ارث‌بری از A3DObject فراهم‌کننده Name و Properties. هیچ ویژگی اضافی در این نسخه تعریف نشده است.

مواد و سایه‌زنی

MethodsMethods
Materialکلاس پایهٔ انتزاعی برای تمام انواع مواد. یک نام و یک مجموعهٔ ویژگی‌ها را فراهم می‌کند.
LambertMaterialجنس کلاسیک فقط پخش‌کننده با Ambient, Diffuse, Emissive, Reflective, Transparency, و Texture ویژگی‌ها. فضای‌نام: Aspose.ThreeD.Shading.
PhongMaterialLambert را گسترش می‌دهد Specular, Shininess, و SpecularPower ویژگی‌ها. فضای‌نام: Aspose.ThreeD.Shading.
PbrMaterialجنس رندرینگ مبتنی بر فیزیک با BaseColor, Metallic, Roughness, Occlusion, و ویژگی‌های اسلات بافت. فضای نام: Aspose.ThreeD.Shading.

Methods

MethodsMethods
Cameraموجودیت دوربین. ارث‌بری از Frustum. متصل به یک Node برای تعریف تبدیل‌های نقطه‌نظر. هیچ ویژگی خاص فرمت در این نسخه نمایش داده نمی‌شود.

ابزارهای ریاضی

MethodsMethods
Vector2دقت دوگانه 2-component vector (lowercase fields: x, y). فضای نام: 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). فضای‌نام: Aspose.ThreeD.Utilities. برای Mesh.ControlPoints و داده‌های عادی.
FVector3بردار شناور 3 مؤلفه‌ای با دقت تک (فیلدهای بزرگ‌حرف: X, Y, Z). استفاده شده توسط Transform.Translation و Transform.Scale.
FVector4بردار شناور تک‌دقت ۴ مؤلفه‌ای (فیلدهای بزرگ: X, Y, Z, W).
Quaternionکواترنیون واحد برای نمایش چرخش‌ها (W, X, Y, Z). استفاده شده توسط Transform.Rotation.
Matrix44x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix.
BoundingBoxجعبه محدود‌کنندهٔ محور‌محور تعریف‌شده توسط Minimum و Maximum FVector3 گوشه‌ها.

Methods

MethodsMethods
AnimationClipمحفظه‌ای نام‌گذاری‌شده برای یک بازهٔ انیمیشن. A Scene ممکن است چندین کلیپ را در خود داشته باشد. قالب اعلان — داده‌های فریم کلیدی و پخش هنوز پیاده‌سازی نشده‌اند.

ورودی/خروجی فرمت

MethodsMethods
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 (یک IList<FileFormat>) برای فهرست کردن تمام فرمت‌های پشتیبانی‌شده، یا FileFormat.Detect(fileName) برای شناسایی یک فرمت بر اساس نام فایل. ثابت‌های نام‌گذاری‌شده (ObjFormat, GltfFormat, FbxFormat,، غیره) هستند internal و برای کد کاربر قابل دسترسی نیست.
IOServiceانتزاع داخلی I/O. ارائه می‌دهد DetectFormat() برای تشخیص قالب مبتنی بر جریان.
LoadOptionsکلاس پایه برای گزینه‌های بارگیری مخصوص قالب.
SaveOptionsکلاس پایه برای گزینه‌های ذخیره‌سازی مخصوص قالب.

فرمت OBJ

MethodsMethods
ObjLoadOptionsگزینه‌های بارگذاری برای فایل‌های Wavefront OBJ.
ObjSaveOptionsگزینه‌های ذخیره‌سازی برای خروجی Wavefront OBJ.

فرمت STL

MethodsMethods
StlLoadOptionsگزینه‌های بارگذاری برای فایل‌های STL.
StlSaveOptionsگزینه‌های ذخیره‌سازی برای خروجی STL.

فرمت glTF

MethodsMethods
GltfLoadOptionsگزینه‌های بارگذاری برای فایل‌های glTF 2.0 و GLB.
GltfSaveOptionsگزینه‌های ذخیره‌سازی برای خروجی glTF 2.0 و GLB. هیچ ویژگی خاص فرمت در این نسخه نمایش داده نمی‌شود؛ از .glb افزونه برای خروجی باینری.

فرمت FBX

MethodsMethods
FbxLoadOptionsگزینه‌های بارگذاری برای فایل‌های FBX.
FbxSaveOptionsگزینه‌های ذخیره‌سازی برای خروجی FBX. خروجی FBX همیشه خروجی باینری تولید می‌کند؛ خروجی ASCII FBX در این نسخه فعال نیست.

3MF Format

MethodsMethods
TmfLoadOptionsگزینه‌های بارگذاری برای فایل‌های 3MF.
TmfSaveOptionsگزینه‌های ذخیره برای خروجی 3MF.

Methods

MethodsMethods
FileContentTypeتوصیف‌کننده نوع محتوا: ASCII, Binary. در دسترس به عنوان یک ویژگی در FileFormat.
Axisمحور مختصات را شناسایی می‌کند: XAxis, YAxis, ZAxis.
CoordinateSystemقواعد جهت‌گیری را مشخص می‌کند: RightHand یا LeftHand.

سیستم ویژگی‌ها

MethodsMethods
Propertyیک ویژگی تک‌نام‌دار با نوع بر روی یک A3DObject.
PropertyCollectionمجموعه قابل تکرار از Property اشیائی که به یک A3DObject.

موارد مرتبط

 فارسی