Πώς να δημιουργήσετε ένα 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.

Βήμα 3: Δημιουργία αντικειμένου Mesh

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

Αναφέρετε αυτές τις θέσεις με τον δείκτη τους που βασίζεται στο μηδέν κατά τον καθορισμό των προσώπων πολυγώνου.

Βήμα 5: Δημιουργία πολυγώνων προσώπων

createPolygon() Ορισμός ενός προσώπου με την κατάταξη των δεικτών σε σειρά.Τρία δείκτες κάνουν ένα τρίγωνο:

mesh.createPolygon(0, 1, 2);

Μπορείτε επίσης να ορίσετε quads (τέσσερις δείκτες) ή αυθαίρετα πολυγόνες για μορφές που τις υποστηρίζουν. για glTF, η βιβλιοθήκη θα τριγωνίσει αυτόματα quades και n-gons στην εξαγωγή.

Βήμα 6: Προσθήκη Vertex κανονικά

Η ποιότητα των προϊόντων βελτιώνεται. χρησιμοποιήστε mesh.createElement() Για να δημιουργήσουμε ένα VertexElementNormal, συλλέγουν τα κανονικά vectors σε μια σειρά, στη συνέχεια καλούν 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 Το κανονικό είναι ένα ανά στίχο. ReferenceMode.DIRECT Το σύνολο των δεδομένων είναι εντελώς indexed από τον δείκτη vertex polygon.

Βήμα 7: Προσθέστε το Mesh και Σώστε στο 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.