كيفية إنشاء 3D Mesh ببرمجة في TypeScript

الخطوة 1: تثبيت @aspose/3d

asposefoss/3d is not yet published — build from source until it ships. See the project README for build instructions.

لا تتطلب الإضافات الأصلية أو مكتبات النظام.يتضمن الحزمة تعريفات نوع TypeScript.

الحد الأدنى tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true
  }
}

الخطوة 2: إنشاء مشهد ونوود

أ أ Scene هو حاوية المستوى الأعلى.يجب أن تكون جميع الهندسة المرتبطة بـ Node داخل المشهد:

import { Scene } from '@aspose/3d';

const scene = new Scene();
const node = scene.rootNode.createChildNode('triangle');

createChildNode(name) يخلق عقدة تسمى ويصلها كطفل من عقد الحالي. Node الموضوع هو حيث سوف تصل إلى الماس في الخطوة 7.

الخطوة الثالثة: إنشاء كائن ميتش

Mesh يحتفظ بمواقف العمود الفقري وتحديدات البوليغون.تصميم واحد مع اسم اختياري:

import { Mesh } from '@aspose/3d/entities';

const mesh = new Mesh('triangle');

يبدأ الماس فارغًا: لا أعمدة ولا وجوه.أضفها في الخطوات التالية.

الخطوة 4: إضافة نقاط التحكم (المتقدمين)

نقاط التحكم هي المواقف الخلفية في الفضاء المحلي. Vector4 القيم داخل mesh.controlPoints.المكون الرابع (w) هو 1 بالنسبة للمواقف :

import { Vector4 } from '@aspose/3d/utilities';

mesh.controlPoints.push(new Vector4(0.0, 0.0, 0.0, 1.0)); // index 0
mesh.controlPoints.push(new Vector4(1.0, 0.0, 0.0, 1.0)); // index 1
mesh.controlPoints.push(new Vector4(0.5, 1.0, 0.0, 1.0)); // index 2

يمكنك الإشارة إلى هذه المواقف من خلال مؤشرها القائم على الصفر عند تحديد وجوه البوليغون.

الخطوة الخامسة: إنشاء وجوه البوليغون

createPolygon() يحدد وجهًا عن طريق إدراج المؤشرات العمودية في ترتيب.ثلاثة مؤشرات تجعل مثلثًّا:

mesh.createPolygon(0, 1, 2);

يمكنك أيضًا تعريف الربع (أربعة مؤشرات) أو المجموعات العشوائية للتنسيقات التي تدعمها.للمكتبة glTF ، ستتجول مكتبات n-gons و quads تلقائيًّا على الصادرات.

الخطوة 6: إضافة Vertex Normals

العادات تحسين جودة التصوير.استخدام mesh.createElement() لإنشاء A VertexElementNormal, جمع الفكتير العادي في صف ، ثم الاتصال setData() وَقَالَ الْمُحَرَّم: لِأَنَّهُ data يعود المضغوط نسخة دفاعية - الضغط عليه لا يؤثر. FVector3 (الضغط الوحيد) للبيانات العادية، لا Vector4.

import { VertexElementNormal } from '@aspose/3d/entities';
import { VertexElementType, MappingMode, ReferenceMode } from '@aspose/3d/entities';
import { FVector3 } from '@aspose/3d/utilities';

const normals = mesh.createElement(
    VertexElementType.NORMAL,
    MappingMode.CONTROL_POINT,
    ReferenceMode.DIRECT
) as VertexElementNormal;

// Build the normal array, then call setData() — do NOT push to normals.data
normals.setData([
    new FVector3(0, 0, 1), // normal for vertex 0 (pointing +Z)
    new FVector3(0, 0, 1), // normal for vertex 1
    new FVector3(0, 0, 1), // normal for vertex 2
]);

MappingMode.CONTROL_POINT 1 عادي لكل Vertex. ReferenceMode.DIRECT يعني أن مجموعة البيانات يتم فهرسةها مباشرة من قبل مؤشر البوليغون الوركس.

الخطوة 7: ضع الماسح الضوئي واحفظه إلى glTF

إعطاء الماس إلى العقد عبر node.entity,ثم حفظ المشهد:

import { GltfSaveOptions, GltfFormat } from '@aspose/3d/formats/gltf';

node.entity = mesh;

const saveOpts = new GltfSaveOptions();
scene.save('triangle.gltf', GltfFormat.getInstance(), saveOpts);
console.log('Triangle mesh saved to triangle.gltf');

إنتاج حاوية واحدة ذاتية .glb الملف بدلاً من ذلك، إعداد saveOpts.binaryMode = true وتغيير ملف النشر التمديد إلى .glb.