Node — Aspose.3D FOSS for Java
Methods
Methods Node מחלקה מייצגת אלמנט בעל שם בגרף הסצנה של Aspose.3D. כל צומת יכול להכיל אחד Entity (כגון Mesh או Camera), שומר על יחסי הורה‑צאצא עם צמתים אחרים, ונושא שינוי מקומי. צמתים הם הדרך העיקרית לארגן אובייקטים תלת‑ממדיים במבנה סצנה.
import com.aspose.threed.Scene;
import com.aspose.threed.Node;
Scene scene = new Scene();
// Access the root node via getter
Node root = scene.getRootNode();
// Create a child node
Node child = root.createChildNode("my_node");
// Iterate child nodes via getter
for (Node node : root.getChildNodes()) {
System.out.println(node.getName());
}Methods
Methods Node constructor מאתחל צומת עם שם אופציונלי.
| Methods | Methods | Methods |
|---|---|---|
name | String | שם אופציונלי לצומת |
Methods
כל תכונות ה‑node נגישות דרך שיטות getter/setter.
| Methods | Methods | Methods | Methods | Methods |
|---|---|---|---|---|
name | String | getName() | setName(String) | מזהה קריא לבני אדם עבור הצומת |
entity | Entity | getEntity() | setEntity(Entity) | הישות הראשית המחוברת לצומת זה (למשל,., Mesh, Camera). קיצור ל‑האלמנט הראשון של getEntities(). |
entities | List<Entity> | getEntities() | – | כל הישויות המחוברות לצומת זה (קריאה בלבד) |
material | Material | getMaterial() | setMaterial(Material) | החומר הראשי שהוקצה לצומת זה |
materials | List<Material> | getMaterials() | – | כל החומרים שהוקצו לצומת זה (קריאה בלבד) |
childNodes | List<Node> | getChildNodes() | – | רשימת צמתים ילדים |
parentNode | Node | getParentNode() | setParentNode(Node) | הצומת ההורה המיידי במבנה הסצנה (getParentNodes() אינו זמין ב Node) |
visible | boolean | getVisible() | setVisible(boolean) | Methods false, הצומת ותת‑העץ שלה מוסתרים |
excluded | boolean | getExcluded() | setExcluded(boolean) | Methods true, צומת זה אינו נכלל ברינדור |
transform | Transform | getTransform() | – | טרנספורמציה מקומית (תרגום, סיבוב, קנה מידה) |
globalTransform | GlobalTransform | getGlobalTransform() | – | מטריצת טרנספורמציה במרחב העולם |
assetInfo | AssetInfo | getAssetInfo() | setAssetInfo(AssetInfo) | מטא-נתוני נכס מצורפים לצומת זה, אם קיימים |
properties | PropertyCollection | getProperties() | – | מאפיינים מותאמים אישית המחוברים לצומת זה |
Methods
| Methods | סוג החזרה | Methods |
|---|---|---|
createChildNode(String name) | Node | יוצר ומצמיד צומת בן חדש עם השם הנתון |
createChildNode(String name, Entity entity) | Node | יוצר צומת בן ומקצה לו ישות |
addChildNode(Node node) | void | מוסיף צומת קיים כבן של צומת זה |
getChild(String name) | Node | מחפש צומת בן ישיר לפי שם |
addEntity(Entity entity) | void | מצמיד ישות נוספת לצומת זה |
merge(Node node) | void | ממזג את הילדים והיישויות של צומת אחר לתוך צומת זה |
evaluateGlobalTransform(boolean withGeometricTransform) | Matrix4 | מחזיר את מטריצת ההמרה במרחב העולם; העבר true כדי לכלול הסטות גאומטריות |
getBoundingBox() | BoundingBox | קוד מדומה בגרסה זו — תמיד מחזיר ערך שמירה BoundingBox (min = Double.MAX_VALUE, max = Double.MIN_VALUE). לא מתבצע חישוב גאומטרי. |
getProperty(String name) | Object | מקבל ערך מאפיין לפי שם |
findProperty(String name) | Property | מחפש מאפיין לפי שם |
Methods
צור סצנה, חבר mesh ל‑node, ועבור על גרף הסצנה:
import com.aspose.threed.Scene;
import com.aspose.threed.Node;
import com.aspose.threed.*;
Scene scene = new Scene();
Mesh mesh = new Mesh();
mesh.getControlPoints().add(new Vector4(0, 0, 0, 1));
mesh.getControlPoints().add(new Vector4(1, 0, 0, 1));
mesh.getControlPoints().add(new Vector4(0.5, 1, 0, 1));
mesh.createPolygon(0, 1, 2);
// Attach mesh to a child node
Node node = scene.getRootNode().createChildNode("triangle", mesh);
// Traverse child nodes using getter
for (Node child : scene.getRootNode().getChildNodes()) {
Entity entity = child.getEntity();
if (entity != null) {
System.out.println("Node '" + child.getName() + "': " + entity.getClass().getSimpleName());
System.out.println(" Excluded: " + child.getExcluded());
}
}