Class Scene

חבילה: @aspose/3d (v24.12.0)

Scene הוא מכולת השורש עבור גרף סצנה תלת‑ממדית ב @aspose/3d. הוא מחזיק במבנה ההיררכי של הצמתים, במטא‑דאטה ובקלאפים של אנימציה, ומספק את ממשק הקלט/פלט הראשי לטעינה ושמירה של קבצי 3D.

export class Scene extends SceneObject

ColladaSaveOptions

A3DObject ← SceneObject ← Scene

ColladaSaveOptions

טען קובץ OBJ והדפס את מספר צמתים צאצאים בשורש של גרף הסצנה.

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

const scene = new Scene();
scene.open('model.obj');

function countNodes(node: any): number {
  let total = 1;
  for (const child of node.childNodes) {
    total += countNodes(child);
  }
  return total;
}

const nodeCount = countNodes(scene.rootNode);
console.log(`Total nodes in scene: ${nodeCount}`);

ColladaSaveOptions

ColladaSaveOptions

open(fileOrStream, options?)

טוען קובץ 3D ממסלול קובץ או מ- Buffer אל הסצנה, מחליף כל תוכן קיים.

open(fileOrStream: string | Buffer, options?: LoadOptions): void

ColladaSaveOptions

fileOrStream string | Buffer

הנתיב לקובץ המקור, או מ- Buffer שמכיל את נתוני הקובץ הגולמיים.

options LoadOptions (אופציונלי)

אפשרויות טעינה ספציפיות לפורמט. העבר undefined להשתמש בברירות מחדל.

ColladaSaveOptions

void

ColladaSaveOptions

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

const scene = new Scene();
scene.open('input.fbx');
console.log(`Loaded scene with root node: ${scene.rootNode.name}`);

openFromBuffer(buffer, options?)

טוען קובץ תלת‑ממדי מזיכרון Buffer. זה העומס המועדף כאשר נתוני הקובץ כבר נקראו לזיכרון.

openFromBuffer(buffer: Buffer, options?: LoadOptions): void

ColladaSaveOptions

buffer Buffer

אובייקט Node.js Buffer שמכיל את תוכן הקובץ המלא.

options LoadOptions (אופציונלי)

אפשרויות טעינה ספציפיות לפורמט.

ColladaSaveOptions

void

ColladaSaveOptions

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

const data = readFileSync('model.glb');
const scene = new Scene();
scene.openFromBuffer(data);
console.log(`Animation clips: ${scene.animationClips.length}`);

save(fileOrStream, formatOrOptions?, options?)

שומר את הסצנה לקובץ. הפורמט נגזר מהרחבת הקובץ, או שניתן להעביר אובייקט ספציפי לפורמט SaveOptions מופע (או FileFormat singleton) כארגומנט שני.

save(fileOrStream: string, formatOrOptions?: FileFormat | SaveOptions, options?: SaveOptions): void

ColladaSaveOptions

fileOrStream string

נתיב קובץ היעד. ההרחבה קובעת את פורמט הפלט (לדוגמה,., .glb → GLB, .gltf → glTF JSON, .stl → STL).

formatOrOptions FileFormat | SaveOptions (אופציונלי)

או singleton של פורמט (לדוגמה,., GltfFormat.getInstance()) SaveOptions מחלקה נגזרת.

options SaveOptions (אופציונלי)

אפשרויות שמירה ספציפיות לפורמט כאשר a FileFormat נמסרת כארגומנט השני.

ColladaSaveOptions

void

ColladaSaveOptions

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

const scene = new Scene();
scene.open('input.obj');

// Format inferred from extension
scene.save('output.glb');
console.log('Scene saved as GLB.');

createAnimationClip(name)

יוצר קטע אנימציה חדש בעל שם ומוסיף אותו ל‑ animationClips אוסף.

createAnimationClip(name: string): AnimationClip

ColladaSaveOptions

name string

שם תיאורי לקטע האנימציה החדש.

ColladaSaveOptions

AnimationClip

הנוצר החדש AnimationClip מופע.

ColladaSaveOptions

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

const scene = new Scene();
const clip = scene.createAnimationClip('WalkCycle');
console.log(`Created clip: ${clip.name}`);
console.log(`Total clips: ${scene.animationClips.length}`);