Εγκατάσταση

Αυτό το εγχειρίδιο καλύπτει όλα όσα χρειάζεστε για να εγκαταστήσετε το Aspose.3D FOSS για TypeScript και επιβεβαιώνει ότι λειτουργεί σωστά πριν γράψετε το πρώτο σας 3D επεξεργαστικό σενάριο.

Προϋποθέσεις

Βεβαιωθείτε ότι τα παρακάτω είναι εγκατεστημένα και στο δικό σας PATH Πριν από την διαδικασία:

Για να ελέγξετε τις εκδόσεις σας:

node --version   # v18.x.x or later
npm --version    # 7.x or later
npx tsc --version  # Version 5.x.x

Βήμα 1: Δημιουργία ενός έργου (εάν είναι απαραίτητο)

Εάν προσθέτετε το Aspose.3D σε ένα υπάρχον έργο TypeScript, ξεχάστε αυτό το βήμα και μεταβείτε απευθείας στο Βήμα 2.

Για ένα νέο πρόγραμμα:

mkdir my-3d-project && cd my-3d-project
npm init -y
npm install -D typescript ts-node @types/node

Βήμα 2: Εγκατάσταση @aspose/3d

Αυτό εγκαθιστά το πακέτο και την ενιαία μεταβατική εξάρτησή του, xmldom,Δεν απαιτούνται πρόσθετα πακέτα συστήματος, εγχώριες προσθήκες ή συντάκτες.Η εγκατάσταση ολοκληρώνεται όταν @aspose/3d εμφανίζεται στο δικό σας package.json κάτω από dependencies.

Ελέγξτε την εγκατάσταση:

ls node_modules/@aspose/3d

Θα πρέπει να δείτε το αρχείο συσκευασίας με package.json,Η αναφορά του αρχείου (.d.tsκαι να συντάξει JavaScript.

Βήμα 3: Εισαγωγή TypeScript

Προσθήκη ή ενημέρωση tsconfig.json Αυτές είναι απαραίτητες για πλήρη συμβατότητα με τους ορισμούς τύπου της βιβλιοθήκης και την έκδοση CommonJS:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true,
    "outDir": "dist",
    "rootDir": "src"
  },
  "include": ["src/**/*.ts"],
  "exclude": ["node_modules", "dist"]
}

Οι βασικές ρυθμίσεις και γιατί είναι σημαντικές:

Βήμα 4: Ελέγξτε την εγκατάσταση

Δημιουργία src/verify.ts Με την παρακάτω ελάχιστη δοκιμή εισαγωγής:

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

const scene = new Scene();
console.log('Aspose.3D FOSS for TypeScript is installed correctly.');
console.log('rootNode name:', scene.rootNode.name);

Συγκεντρώστε και τρέξτε:

npx tsc
node dist/verify.js

Αναμενόμενη παραγωγή:

Aspose.3D FOSS for TypeScript is installed correctly.
rootNode name:

Το όνομα ρίζας είναι μια κενή γραμμή κατά προεπιλογή - scene.rootNode Δημιουργήθηκε χωρίς όνομα.

Αν προτιμάτε να ξεφύγετε από το βήμα της συλλογής κατά τη διάρκεια της ανάπτυξης, τρέξτε απευθείας με ts-node:

npx ts-node src/verify.ts

Βήμα 5: Γρήγορη έναρξη: Κατεβάστε μια σκηνή και εκτυπώστε πληροφορίες κόμβων

Το παρακάτω σενάριο φορτώνει ένα αρχείο 3D και εκτυπώνει το όνομα και τον τύπο οντότητας κάθε κόμβου στη σκηνή. Λειτουργεί με οποιαδήποτε υποστηριζόμενη μορφή: OBJ, glTF, GLB, STL, 3MF , FBX ή COLLADA.

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

function printNode(node: Node, depth: number = 0): void {
  const indent = '  '.repeat(depth);
  const entityType = node.entity ? node.entity.constructor.name : '(no entity)';
  console.log(`${indent}${node.name} [${entityType}]`);
  for (const child of node.childNodes) {
    printNode(child, depth + 1);
  }
}

const scene = new Scene();

// Replace 'model.obj' with any supported 3D file path.
// Format is detected automatically from binary magic numbers.
scene.open('model.obj');

console.log('Scene loaded. Node hierarchy:');
printNode(scene.rootNode);

Σώστε το ως src/quickstart.ts Και τρέξτε το:

npx ts-node src/quickstart.ts

Για ένα αρχείο OBJ με ένα μασχ που ονομάζεται Cube,Η παραγωγή θα μοιάζει με:

Scene loaded. Node hierarchy:
 [(no entity)]
  Cube [Mesh]

Το κόμβο ρίζας έχει ένα κενό όνομα (τυπώθηκε ως άσπρο προφίλ). Παιδικά κόμπες κληρονόμησαν τα ονόματά τους από το φορτωμένο αρχείο.

Εξάρτηση σημειώσεις

Το Aspose.3D FOSS για το TypeScript έχει ακριβώς μία εξάρτηση του χρόνου εκτέλεσης:

Δεν χρειάζεται να εγκαταστήσετε xmldom Ετικέτες: Θα εμφανιστεί στο δικό σας node_modules Η πρώτη είναι η συσκευή που δεν έχει καμία εγκατάσταση (.node αρχεία) και δεν απαιτούνται βιβλιοθήκες συστήματος.

Επόμενο Βήματα

Τώρα που η βιβλιοθήκη είναι εγκατεστημένη και επαληθεύεται:

• Διαβάστε το Οδηγός Ανάπτυξης Για μια πλήρη βόλτα σε όλες τις περιοχές.
• Βλέπετε Χαρακτηριστικά και λειτουργίες για τις λεπτομέρειες υποστήριξης μορφής, τα πρότυπα σκηνικού-γραφογραφίας, το υλικό και την κινούμενη API, καθώς και πλήρη παραδείγματα κωδικού TypeScript.