Aspose.3D FOSS for TypeScript

مرجع API لـ: @aspose/3d النسخة 24.12.0. تثبيت عبر:

npm install @aspose/3d

وقت التشغيل: Node.js 18, 20, 22+ · اللغة: TypeScript 5.0+ / JavaScript (CommonJS) · ترخيص: MIT

الرسم البياني لمشهد الأساسي

المشهد

الحاوية الجذرية لمشهد ثلاثي الأبعاد. scene.open() أو scene.openFromBuffer() لتحميل ملف، و scene.save() للكتابة الناتج. scene.rootNode كنقطة دخول إلى هرم العقد.

العقدة

عقدة مسمّية في شجرة المشهد. تحتوي على Transform,، إختياري entity (ميش، كاميرا، ضوء أو غيرها) SceneObject), و صفر أو أكثر من العقدة التابعة يمكن الوصول إليها عبر childNodes.

الكيان

الطبقة الأساسية لجميع الكائنات التي يمكن ربطها بـ Node ككيان أساسي. Mesh, Camera, Light,وآخرين.

SceneObject

قاعدة مجردة للأجسام المسماة التي تنتمي إلى مشهد. توفر الموقع name تتبع الممتلكات والنشاط العضوي الذي تشاركته العقد، الكيانات، والأجسام على مستوى الأصول.

A3DOموضوع

طبقة الأساس الجذر لجميع كائنات Aspose.3D. يوفر نظام الخصائص (getProperty, setProperty) والمنظمة الوطنية للطاقة name المجال الذي ترثه كل طبقة عامة.

الهندسة والشبكة

شبكة

يمثل شبكة متعددة الأطراف. يحتوي على controlPoints مجموعة من Vector4 القمم و تعريفات متعددة الأطراف التي تم إنشاؤها عبر createPolygon().اتصل بي triangulate() لتحويل كل البوليغونات إلى مثلث قبل التصدير.

الهندسة

الطبقة الأساسية لجميع أنواع الهندسة. controlPoints ومجموعة من عناصر القمة (الطبيعية، الأشعة فوق البنفسجية والألوان) المرتبطة بالهندسة.

VertexElement

فئة أساسية لقنوات سمة per-vertex المرتبطة بـ a Geometry.الفئات الفرعية تحمل صفائح بيانات مُطبوعة و mappingMode / referenceMode البيانات الوصفية.

VertexElementNormal

(أ) VertexElement الفئة الفرعية التي تخزن طبيعيات السطح. يتم تخزين البيانات داخلياً كـ FVector4[] (مُورثة من VertexElementFVector) مطلوب من قبل معظم المرجعات للإضاءة الصحيحة.

VertexElementUV (المركز العلوي)

(أ) VertexElement الفئة الفرعية التي تخزن إحداثيات النسيج الثنائي الأبعاد. قد يكون لشبكة واحدة مجموعة متعددة من الأشعة فوق البنفسجية لتطبيق طبقات النسخ المختلفة.

VertexElementVertexColor

(أ) VertexElement الفئة الفرعية التي تخزن قيم اللون RGBA لكل عمق.

VertexElementType

إدراج أنواع قنوات السمات التي يستخدمها a VertexElement يمكن أن تمثل (مثال،., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).

MappingMode

إحصاء يسيطر على كيفية ترسم بيانات العنصر إلى الهندسة: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE,أو ، ALL_SAME.

ReferenceMode

إحصاء يسيطر على كيفية مؤشرات العنصر البيانات المرجعية: DIRECT (واحد على واحد) أو INDEX_TO_DIRECT (من خلال مصفوفة فهرسية).

TextureMapping

إدراج لغة قناة النسيج: DIFFUSE, SPECULAR, NORMAL, EMISSIVE, BUMP,و أكثر من ذلك.

التحول والمساحة

تحويل

يحتفظ بالموقف المحلي (translation), التناوب (rotation كما هو الحال Quaternion), والقياس (scaling) من Node.التغييرات هنا تؤثر على العقدة وجميع أطفاله.

GlobalTransform

عرض القراءة فقط لتحويل الفضاء العالمي للنود ، والحساب عن طريق تجميع جميع السلف Transform القيم الوصول عبر node.globalTransform.

BoundingBox

مربع تحديد متوافق مع المحور يحدده a minimum و maximum (أوباما)Vector3 يستخدم لوصف المدى الفضائي لشبكة أو مشهد.

المواد

المادة LambertMaterial، PhongMaterial, PbrMaterial

المواد هي الفئة الأساسية المجردة لجميع أنواع المادة. وهناك ثلاثة تنفيذات ملموسة متاحة:

  • LambertMaterial لون موزع فقط مع قنوات الألوان المحيطة، المنتشرة والمنبعية. مناسبة للأسطح غير المرئية.
  • PhongMaterial تمتد LambertMaterial مع خصائص اللون المُنظّر واللمع لظلال فونج.
  • PbrMaterial مادة التصوير المستندة إلى الفيزيائية مع قنوات المعادن والحرجة والألوان الأساسية وخريطة العادية. خرائط مباشرة لنموذج مواد glTF 2.0 PBR.

الكاميرا والإضاءة

الكاميرا

كيان نقطة نظر مع نوع الإسقاط، مجال الرؤية، مسافة المقطع القريب/البعيد، وخصائص نسبة الجوانب.

الضوء

كيان عقدة مصدر ضوء. النوع يسيطر عليه LightType إحصاء.

LightType

إدراج أنواع الضوء المدعومة: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.

ProjectionType

إدراج أوضاع عرض الكاميرا: PERSPECTIVE و ORTHOGRAPHIC.

أدوات رياضيات

المتجه 3

متجه ثلاثي المكونات ذو نقطة عائمة مع x, y, z الحقول والطرق العادية في الحساب (dot, cross, normalize, minus, times) المصدر من @aspose/3d/utilities.

المتجه 4

متجه ذو نقطة عائمة من أربعة مكونات مع x, y, z, w المجال. تستخدم كنوع من الإدخالات في Mesh.controlPoints.

المتجه2

متجه دقيق مزدوج من مكونين مع x و y تستخدم لترتيبات النسيج فوق البنفسجي.

Fفيكتور3

متجهة عابرة دقيقة واحدة ذات ثلاثة مكونات مضغوطة تستخدم في مصفوفات بيانات العنصر القمة للطبيعيات والملمس.

المصفوفة 4

مصفوفة تحويل 4 × 4. تدعم الترابط والعكس والتحويل وتفكيكها إلى مكونات الترجمة والدوران والمقياس. تم تصديرها من @aspose/3d/utilities.

الكوترنيون

وحدة كواتيرنيون لتمثيل الدوران دون قفل المفصل. يوفر slerp() للاستمرار في التداخل والتحويل إلى زوايا أولر، و Matrix4. الصادرة من @aspose/3d/utilities.

الرسوم المتحركة

AnimationClip

مجموعة مسمّية، محدودة بالوقت من AnimationNode المسارات الحاوية الرئيسية لبيانات الرسوم المتحركة من ملف FBX أو COLLADA.

AnimationNode

مسار تحريك معين يستهدف طريق خاصية محددة على كائن مشهد. يتضمن واحد أو أكثر AnimationChannel الأشياء.

AnimationChannel

قناة واحدة متحركة في إطار AnimationNode. يحمل KeyframeSequence من أزواج الوقت/القيمة.

KeyFrame

عينة واحدة من الوقت/القيمة في KeyframeSequence.يحمل ختم الوقت (في الثواني) ، والقيمة، والمعلومات المماسة للانتقال.

KeyframeSequence

قائمة مرتبة من: KeyFrame عينات لقناة واحدة خاصية، جنبا إلى جنب مع Interpolation و Extrapolation الإعدادات التي تحكم التشغيل.

التداخل

قائمة بأوضاع التداخل في الإطار الرئيسي. الأعضاء المعروفون يشملون: LINEAR و CONSTANT.أعضاء إضافيين مثل: BEZIER قد تكون متاحة.

الاستثمارات

يحدد السلوك خارج نطاق إطار المفاتيح (قبل المفتاح الأول وبعد آخر مفتاح). يتم التحكم بها بواسطة: ExtrapolationType.

StepMode

إحصاء يسيطر على كيفية تطبيق التداخل المتدرج (المستمر) في الحدود.

WeightedMode

إحصاء لضغط وزن بيزير: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT,أو ، BOTH.

ExtrapolationType

قائمة السلوكيات خارج نطاق النفاذ: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE,، و OSCILLATE.

صيغة إدخال/إخراج

FileFormat

الموصف الأساسي لتنسيق ملف ثلاثي الأبعاد. كل تنسق مدعوم يوفر نموذج واحد ملموس عبر getInstance().

المستورد

الطبقة الأساسية لتنفيذات الاستيراد الخاصة بالنسخة. غير مثيل مباشرة؛ يتم استدعائها داخلياً بواسطة: scene.open().

المصدر

الطبقة الأساسية لتنفيذات التصدير الخاصة بالنسخة. غير مثيل مباشرة؛ يتم استدعائها داخلياً بواسطة: scene.save().

LoadOptions

طبقة أساسية لأشياء خيار تحميل محددة للشكل. تمرّد حالة من الفئة الفرعية إلى scene.open() أو scene.openFromBuffer().

SaveOptions

فئة أساسية لأشياء خيار حفظ محددة للشكل. تمرّد حالة الفصل الفرعي إلى scene.save().

ImageRenderOptions (مُحملة مكان)

واجهة خدمة داخلية تمثل نظام ملفات ومخزن إدخالات/إخراجات للمستوردين والمصدرين.

صيغة OBJ

يدعم OBJ كل من الاستيراد والتصدير. عند حفظ كـ OB J ، يتم استخدام مكتبة المواد (.mtl) يتم كتابته تلقائياً إلى جانب المادة التالية: .obj الملف.

ObjImporter

المستورد الداخلي الذي يقرأ ملفات Wavefront OBJ، يحل .mtl المواد، وتقوم بتجميع مجموعة من المكتبات. Scene.يتم استدعائه تلقائيًا عندما ObjLoadOptions تم نقلها إلى scene.open().

ObjExporter

مصدراً داخلياً يكتب الملفات على Wavefront OBJ. .mtl مكتبة المواد تكتب تلقائياً. scene.save() الأهداف والنوايا .obj الطريق.

ObjLoadOptions

خيارات التحميل لملفات OBJ. خصائص رئيسية: enableMaterials (بوليان، افتراضية) true), flipCoordinateSystem (بولية) ،, normalizeNormal (بوليان، افتراضية) true), scale (عدد) انظر خيارات تحميل وتحفظ الصيغة لمزيد من التفاصيل.

ObjSaveOptions

حفظ خيارات تصدير OBJ. تمرير إلى scene.save() لتحكم سلوك خروج OBJ. انظر خيارات تحميل وتحفظ الصيغة لمزيد من التفاصيل.

ObjFormat

صيغة الموصف الأحادية لـ OBJ. كلاهما canImport و canExport هي true.

صيغة glTF

GltfImporter

يقرأ glTF 2.0 JSON (.gltf) والثنائي GLB (.glb) الملفات. يتعامل مع مراجع العازل الداخلية والخارجية، ومواد PBR ، وجلود الرسوم التجريبية.

GltfExporter

يكتب خروجاً للـ glTF 2.0 عندما GltfSaveOptions.binaryMode هو true,، ينتج GLB متكاملة ذاتياً ؛ وإلا يكتب JSON .gltf مع رفيقة . .bin عازل.

GltfLoadOptions

خيارات التحميل لملفات glTF/GLB. تسيطر على حل الوعاء و سلوك تحميل النسج .

GltfSaveOptions

خيارات الاحتفاظ للاستيراد glTF/GLB. خصائص ملحوظة: binaryMode (بولية،, true → GLB، افتراضية false), flipTexCoordV (البويلين، يقلع المحور العمودي للأشعة فوق البنفسجية، الافتراضي) true) انظر: خيارات تحميل وتحفظ الصيغة لمزيد من التفاصيل.

GltfFormat

صيغة وصفية واحد. الحصول على من خلال GltfFormat.getInstance() و تمر إلى scene.save() كحجة ثانية.

صيغة STL

StlImporter

يقرأ كل من ASCII و STL الملفات الثنائية في a Scene تحتوي على قطعة واحدة Mesh الكيان.

StlExporter

يكتب STL الثنائي. الناتج يتضمن الشبكة المثلاثة من المنظر؛ يتم مثلث متعددين غير المثلثين تلقائياً.

StlLoadOptions

خيارات الحمل لـ STL. يتحكم في ما إذا كان المستورد يقلع العادي أثناء الاستيراد.

StlSaveOptions

خيارات حفظ لتصدير STL. خاصية رئيسية: binaryMode (بوليان، افتراضية) false) يتحكم في ما إذا كان الخروج ASCII أو STL الثنائي. انظر خيارات تحميل وتحفظ الصيغة لمزيد من التفاصيل.

StlFormat

صيغة وصفية واحد. الحصول على من خلال StlFormat.getInstance().

3MF Format

ThreeMfImporter

يقرأ مؤتمر التعبئة المفتوحة 3MF ويحمل ملفات Scene مع الأشياء المربعة بالألوان و خصائص المواد.

ThreeMfExporter

يكتب أرشيف 3MF صالح من المشهد الحالي. مناسبة لتدفقات عمل الطباعة ثلاثية الأبعاد.

ThreeMfLoadOptions

خيارات التحميل لملفات 3MF.

ThreeMfSaveOptions

احتفظ بالخيارات للتصدير 3MF.

ThreeMfFormat

صيغة وصفية واحد. الحصول على من خلال ThreeMfFormat.getInstance().

صيغة FBX

FbxImporter

يقرأ ملفات ASCII FBX بما في ذلك الهندسة والمواد ومقاطع الرسوم المتحركة. فقط AS CII fbx ؛ لم يتم تنفيذ FBx الثنائي بعد. لا يتم أيضًا تنفيس استيراد الهيكل العظمي وشكل الخليط في الإصدار الحالي.

FbxExporter

يكتب خروج ASCII FBX فقط من المشهد الحالي. النقل الثنائي لـ FBx غير متوفر في الإصدار الحالى.

FbxLoadOptions

خيارات التحميل لـ FBX. في النسخة الحالية ، لا يمكن تكوين أي خرائط تحميل محددة للشكل (لا يتم تنفيذ استيراد الشكل الجلدي والمزيج).

FbxSaveOptions

خيارات حفظ لترقية FBX خاصية المفتاح: embedTextures (بوليان، افتراضية) false) انظر: خيارات تحميل وتحفظ الصيغة لمزيد من التفاصيل.

FbxFormat

صيغة وصفية واحد. الحصول على من خلال FbxFormat.getInstance().

COLLADA شكل

كولادا استيراد و تصدير يتطلبون xmldom التبعية بين الأقران، التي يتم تثبيتها تلقائياً مع @aspose/3d.

ColladaImporter

(تقرأ: كولادا).dae) ملفات XML باستخدام xmldom.يتعامل مع الهندسة والمواد، الكاميرات والأضواء، والرسوم المتحركة.

ColladaExporter

يكتب COLLADA XML من المشهد الحالي. مناسب للتبادل مع أدوات DCC (Blender ، Maya ، إلخ).

ColladaFormat

صيغة وصفية واحد. الحصول على من خلال ColladaFormat.getInstance().

نظام الخصائص

الممتلكات

زوج اسم/قيمة مكتوب يمكن ربطه بأي A3DObject.يدعم أنواع القيمة الستكالرية والمتجهة.

PropertyCollection

حاوية مُطلبة من Property يمكن الوصول إليها على أي جهاز. A3DObject عبر الموقع الإلكتروني properties المرفق.

CustomObject

كيس ملكية حرة الشكل تمتد إلى A3DObject.يستخدم لتخزين البيانات الوصفية التعسفيّة التي لا تربطها بالصف القياسي.

معلومات الأصول

AssetInfo

يحمل البيانات المتحركة على مستوى المنظر المحتوى من ملف المصدر: المؤلف، اسم التطبيق، تاريخ الإنشاء، مقياس الوحدة، ومعلومات محور الاتحاد.

ImageRenderOptions

خيارات التحكم في كيفية حل النسيج والصور وتشفيرها عند حفظها إلى تنسيقات تضم بيانات الصورة (على سبيل المثال ، GLB مع binaryMode: true).

انظر أيضاً

 العربية