Installation

Αυτός ο οδηγός καλύπτει όλα όσα χρειάζεστε για να εγκαταστήσετε το Aspose.3D FOSS για TypeScript και να επιβεβαιώσετε ότι λειτουργεί σωστά πριν γράψετε το πρώτο σας script επεξεργασίας 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

npm install @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

Expected output:

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

Το όνομα του ριζικού κόμβου είναι κενή συμβολοσειρά εξ ορισμού — scene.rootNode δημιουργείται χωρίς όρισμα ονόματος.

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

npx ts-node src/verify.ts

Βήμα 5: Γρήγορη Εκκίνηση: Φόρτωση Σκηνής και Εκτύπωση Πληροφοριών Κόμβου

Το παρακάτω script φορτώνει ένα 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 for TypeScript έχει ακριβώς μία εξάρτηση χρόνου εκτέλεσης:

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

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

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

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