Class Node
חבילה: @aspose/3d (v24.12.0)
צומת מייצג אלמנט בעל שם במבנה גרף הסצנה. לכל צומת יש שינוי מקומי, הוא יכול להכיל צמתים ילדים, ונושא אפס או יותר Entity אובייקטים כגון רשתות, מצלמות או תאורות.
export class Node extends SceneObjectImageRenderOptions
A3DObject ← SceneObject ← Node
ImageRenderOptions
צור node הורה, חבר שני node ילדים אליו, ועבור על כל ההיררכיה לפי שם.
import { Scene, Node } from '@aspose/3d';
const scene = new Scene();
const root = scene.rootNode;
const vehicle = root.createChildNode('vehicle');
const body = vehicle.createChildNode('body');
const wheel = vehicle.createChildNode('wheel_front_left');
function traverse(node: Node, depth = 0): void {
console.log(' '.repeat(depth * 2) + node.name);
for (const child of node.childNodes) {
traverse(child, depth + 1);
}
}
traverse(root);
// Output:
// vehicle
// body
// wheel_front_left
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | string | שם הצומת הזה. משמש לזיהוי הצומת בתוך גרף הסצנה. |
parentNode | `Node | null` |
childNodes | Node[] | מערך של צמתים ילדים ישירים המחוברים לצומת זה. |
entities | Entity[] | רשימת הישויות (meshes, cameras, lights, וכו’) המחוברות לצומת זה. |
materials | Material[] | רשימת החומרים המשוייכים לצומת זה. |
transform | Transform | הטרנספורם המקומי של צומת זה, עם translation: Vector3, rotation: Quaternion, ו scaling: Vector3 רכיבים. |
globalTransform | GlobalTransform | קריאה בלבד. הטרנספורם במרחב העולם, מחושב על ידי כפל כל הטרנספורמים של האבות עד לשורש. |
visible | boolean | האם צומת זה ותת‑העץ שלו מוצגים. ברירת המחדל היא true. |
excluded | boolean | ImageRenderOptions true, הצומת ותת‑העץ שלו מוחרגים מהייצוא. ברירת המחדל היא false. |
entity | `Entity | undefined` |
ImageRenderOptions
addChildNode(node)
מוסיף קיים Node מופע כצאצא ישיר של הצומת הזה.
addChildNode(node: Node): voidImageRenderOptions
node Node
ה‑node לצירוף. ה‑node מועבר מההורה הנוכחי שלו ל‑node זה.
ImageRenderOptions
void
ImageRenderOptions
import { Scene, Node } from '@aspose/3d';
const scene = new Scene();
const parent = scene.rootNode.createChildNode('parent');
const child = new Node('child');
parent.addChildNode(child);
console.log(`Children of parent: ${parent.childNodes.length}`); // 1
createChildNode(name?, entity?, material?)
יוצר חדש Node, באופן אופציונלי עם שם, ישות, וחומר, ומוסיף אותו כצאצא של הצומת הזה.
createChildNode(name?: string, entity?: Entity, material?: Material): NodeImageRenderOptions
name string (אופציונלי)
השם עבור צומת הילד החדש.
entity Entity (אופציונלי)
ישות לצרף לצומת החדש, לדוגמה a Mesh מופע.
material Material (אופציונלי)
חומר לשייך לצומת החדש.
ImageRenderOptions
Node
צומת הילד שנוצר זה עתה.
ImageRenderOptions
import { Scene } from '@aspose/3d';
import { Mesh } from '@aspose/3d/entities';
const scene = new Scene();
const mesh = new Mesh();
// ... populate mesh ...
const meshNode = scene.rootNode.createChildNode('geometry', mesh);
console.log(`Node name: ${meshNode.name}`);
console.log(`Entities attached: ${meshNode.entities.length}`);evaluateGlobalTransform(withGeometricTransform)
מחשב ומחזיר את מטריצת ההמרה במרחב העולם עבור צומת זה. העבר true כדי לכלול את הסטיית ההמרה הגאומטרית השמורה בצומת (משמשת על ידי כמה מייצאי FBX).
evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4ImageRenderOptions
withGeometricTransform boolean
ImageRenderOptions true, כולל את הטרנספורמציה הגאומטרית בתוצאה.
ImageRenderOptions
Matrix4
מטריצת ההמרה במרחב העולם בגודל 4×4.
ImageRenderOptions
import { Scene } from '@aspose/3d';
const scene = new Scene();
scene.open('model.fbx');
const node = scene.rootNode.childNodes[0];
const matrix = node.evaluateGlobalTransform(false);
console.log('World transform matrix computed.');getBoundingBox()
מחשב את תיבת הגבול המיושרת לציר של צומת זה וכל הצאצאים שלו במרחב העולם.
getBoundingBox(): BoundingBoxImageRenderOptions
BoundingBox
תיבת הגבול המיושרת לציר המכילה את כל הגאומטריה תחת צומת זה.
ImageRenderOptions
import { Scene } from '@aspose/3d';
const scene = new Scene();
scene.open('model.obj');
const bbox = scene.rootNode.getBoundingBox();
console.log(`Min: ${JSON.stringify(bbox.minimum)}`);
console.log(`Max: ${JSON.stringify(bbox.maximum)}`);merge(node)
ממזג את תוכן של צומת אחר (היישויות, החומרים והילדים שלו) לתוך צומת זה ומסיר את צומת המקור מהסצנה.
merge(node: Node): voidImageRenderOptions
node Node
צומת המקור שהתוכן שלו משולב לתוך צומת זה.
ImageRenderOptions
void
ImageRenderOptions
import { Scene } from '@aspose/3d';
const scene = new Scene();
scene.open('multi_part.fbx');
const root = scene.rootNode;
if (root.childNodes.length >= 2) {
root.childNodes[0].merge(root.childNodes[1]);
console.log(`Children after merge: ${root.childNodes.length}`);
}