כיצד להתחיל עם Aspose.3D FOSS עבור TypeScript
@aspose/3d עבור TypeScript הוא חבילה חינם, מורשה על ידי MIT להעלאת, ניתוח, ו שמור קבצים 3D ב Node.js – אין בינאריות מקומיות נדרשות, ניתן להתקין מ npm.
מדריך שלב‑אחר‑שלב
שלב 1: התקנת החבילה
התקנה מ npm (Node.js 18 או מאוחר יותר נדרש):
npm install @aspose/3d@24.12.0בדוק את ההתקנה הנכונה:
import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");שלב 2: ייבוא שיעורים נדרשים
ייבא את המחלקות שאתה צריך:
import { Scene, Node } from "@aspose/3d";שלב 3: הורד קובץ 3D
שימוש scene.open() כדי להעלות כל פורמט תומך.הספרייה מזהה את הפורמט באופן אוטומטי מתוך הרחבה של הקובץ:
import { Scene } from "@aspose/3d";
const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);או להשתמש בשיטה סטטית מפעל:
const scene = Scene.fromFile("model.glb");שלב 4: חוצה את הקריקטורה
עץ שורש הוא עצי Node אובייקטים שורשים ב scene.rootNode:
import { Scene, Node } from "@aspose/3d";
function walk(node: Node, depth: number = 0): void {
const indent = " ".repeat(depth * 2);
console.log(`${indent}Node: ${node.name}`);
for (const child of node.childNodes) {
walk(child, depth + 1);
}
}
const scene = Scene.fromFile("model.obj");
walk(scene.rootNode);שלב 3: שמור לפורמט היעד
שימוש scene.save() כל תפריט ייצוא נתמך.הספרייה מזהה את התפריטים פורמט היציאה מתוך הרחבת הקובץ:
import { Scene } from "@aspose/3d";
const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");בעיות נפוצות ותיקונים
Error: ENOENT כאשר קוראים scene.open() הדרך שעברתם אינה קיימת, השתמשו בדרכים מוחלטות או path.resolve() כדי להבטיח מסלול הקובץ הוא נכון.
שגיאה פורמט לא ידוע להבטיח שהרחבה של הקובץ תואמת את התבנית האמיתית.הספרייה מזהה את הפורמט על ידי הרחבה עבור open() ו fromFile().קבעו פרמטרים של פורמט ברור כדי להעלות.
סצנה ריקה לאחר ההעלאה כמה פורמטים בינאריים עשויים לדרוש אפשרויות משאבה ספציפיות. עם אפשרויות ספציפיות לתבנית אם העומס הנדרש מייצר סצנה ריקה.
שגיאות ייבוא TypeScript הגדרות סוג מחוברות עם החבילה. "moduleResolution": "bundler" או "node16" הוא מונח בך tsconfig.json.
שאלות נפוצות
האם @aspose/3d דורש כל בינארי מקומי?
החבילה היא JavaScript טהור / TypeScript ללא תלויות מקומיות.זה פועל על כל פלטפורמה תומכת Node.js 18 או מאוחר יותר.
אילו גרסאות של Node.js תומכות?
Node.js 18 או מאוחר יותר.החבילה פועלת ב- Windows, macOS ו- Linux.
האם הספרייה חופשית לשימוש מסחרי?
כן, הוא שוחרר תחת רישיון MIT. אתה יכול להשתמש בו, לשנות אותו ולהפיץ מחדש לכל מטרה, כולל יישומים מסחריים.
אילו פורמטים 3D אני יכול לקרוא ולכתוב?
החבילה תומכת ב-OBJ, STL, GLTF 2.0 / GLB, FBX, COLLADA ו-PLY עבור שני קריאה. שימוש ב- Extension Based scene.save() להוציא לכל פורמט תומך.
האם אני יכול ליצור סצנה 3D מתוך סקרטש?
תגית: יצירת A Scene ללא תובנות, הוסף נוזלים לילדים scene.rootNode, ו להשאיר את זה בפורמט הרצוי.