Node

Inheritance: java.lang.Object, com.aspose.threed.A3DObject, com.aspose.threed.SceneObject

public class Node extends SceneObject

يمثل عنصرًا في رسم المشهد. رسم المشهد هو شجرة من كائنات Node. خدمات إدارة الشجرة مدمجة في هذه الفئة. لاحظ أن Aspose.3D SDK لا يتحقق من صحة رسم المشهد المُنشأ. تقع مسؤولية المتصل في التأكد من عدم توليد رسومات بيانية دورية في تسلسل العقد. بالإضافة إلى إدارة الشجرة، تُعرّف هذه الفئة جميع الخصائص المطلوبة لوصف موضع الكائن في المشهد. تتضمن هذه المعلومات الخصائص الأساسية Translation و Rotation و Scaling والخيارات المتقدمة للمحاور، والحدود، وخصائص مفاصل IK مثل الصلابة والتخميد. عند إنشائها لأول مرة، يكون كائن Node "empty" (أي: هو كائن بدون أي تمثيل رسومي يحتوي فقط على معلومات الموضع). في هذه الحالة، يمكن استخدامه لتمثيل الأبواب في هيكل شجرة العقد ولكن ليس أكثر من ذلك. الاستخدام العادي لهذا النوع من الكائنات هو إضافة كيان يخصص العقدة (انظر "Entity"). الكيان هو كائن بحد ذاته ومربوط بـ Node. وهذا يعني أيضًا أن نفس الكيان يمكن مشاركته بين عدة عقد. الكاميرا، الضوء، الشبكة، إلخ… كلها كيانات وجميعها مشتقة من الفئة الأساسية Entity.

المنشئات

منشئ	الوصف
Node()	يُنشئ مثيلًا جديدًا من الفئة Node.
Node(String name, Entity entity)	يُنشئ مثيلًا جديدًا من الفئة Node.
Node(String name)	يُنشئ مثيلًا جديدًا من الفئة Node.

الطرق

طريقة	الوصف
accept(NodeVisitor visitor)	يتجول عبر جميع العقد التابعة (بما في ذلك العقدة الحالية) ويستدعي الزائر مع العقدة.
addChildNode(Node node)	أضف عقدة فرعية إلى هذه العقدة
addEntity(Entity entity)	أضف كيانًا إلى العقدة.
createChildNode()	ينشئ عقدة فرعية
createChildNode(Entity entity)	إنشاء عقدة فرعية جديدة مع الكيان المحدد مرفق
createChildNode(String nodeName)	إنشاء عقدة فرعية جديدة بالاسم المحدد للعقدة
createChildNode(String nodeName, Entity entity)	إنشاء عقدة فرعية جديدة بالاسم المحدد للعقدة
createChildNode(String nodeName, Entity entity, Material material)	إنشاء عقدة فرعية جديدة بالاسم المحدد للعقدة، وإرفاق الكيان المحدد ومادة
equals(Object arg0)
evaluateGlobalTransform(boolean withGeometricTransform)	تقييم التحويل العالمي، تضمين التحويل الهندسي أم لا.
findProperty(String propertyName)	يبحث عن الخاصية.
getAssetInfo()	معلومات الأصول لكل عقدة
getBoundingBox()	حساب الصندوق المحيط للعقدة
getChild(int index)	يحصل على العقدة الفرعية عند الفهرس المحدد.
getChild(String nodeName)	يحصل على العقدة الفرعية بالاسم المحدد
getChildNodes()	يحصل على العقد الفرعية.
getClass()
getEntities()	يحصل على جميع كيانات العقدة.
getEntity()	يحصل على أول كيان مرفق بهذه العقدة، إذا تم الضبط، سيتم مسح الكيانات الأخرى.
getExcluded()	يحصل على ما إذا كان يجب استبعاد هذه العقدة وجميع العقد/الكيانات الفرعية أثناء التصدير.
getGlobalTransform()	يحصل على التحويل العالمي.
getMaterial()	يحصل على أول مادة مرتبطة بهذه العقدة، إذا تم الضبط، سيتم مسح المواد الأخرى
getMaterials()	يحصل على المواد المرتبطة بهذه العقدة.
getMetaDatas()	يحصل على البيانات الوصفية المعرفة في هذه العقدة.
getName()	يحصل على الاسم.
getParentNode()	يحصل على العقدة الأصل.
getProperties()	يحصل على مجموعة جميع الخصائص.
getProperty(String property)	احصل على قيمة الخاصية المحددة
getScene()	يحصل على المشهد الذي ينتمي إليه هذا الكائن
getTransform()	يحصل على التحويل المحلي.
getVisible()	يحصل على إظهار العقدة
hashCode()
merge(Node node)	فصل كل شيء تحت العقدة وإرفاقه إلى العقدة الحالية.
notify()
notifyAll()
removeProperty(Property property)	يزيل خاصية ديناميكية.
removeProperty(String property)	إزالة الخاصية المحددة التي تم التعرف عليها بالاسم.
selectObjects(String path)	اختيار عدة كائنات تحت العقدة الحالية باستخدام صيغة استعلام شبيهة بـ XPath.
selectSingleObject(String path)	اختيار كائن واحد تحت العقدة الحالية باستخدام صيغة استعلام شبيهة بـ XPath.
setAssetInfo(AssetInfo value)	معلومات الأصول لكل عقدة
setEntity(Entity value)	يضبط أول كيان مرفق بهذه العقدة، إذا تم الضبط، سيتم مسح الكيانات الأخرى.
setExcluded(boolean value)	يضبط ما إذا كان يجب استبعاد هذه العقدة وجميع العقد/الكيانات الفرعية أثناء التصدير.
setMaterial(Material value)	يضبط المادة الأولى المرتبطة بهذه العقدة، إذا تم الضبط، سيُمسح باقي المواد
setName(String value)	يضبط الاسم.
setParentNode(Node value)	يضبط العقدة الأصلية.
setProperty(String property, Object value)	يضبط قيمة الخاصية المحددة
setVisible(boolean value)	يضبط لإظهار العقدة
toString()	يحصل على تمثيل النص لهذه العقدة.
wait()
wait(long arg0)
wait(long arg0, int arg1)

Node()

public Node()

يُنشئ مثيلًا جديدًا من الفئة Node.

Node(String name, Entity entity)

public Node(String name, Entity entity)

يُنشئ مثيلًا جديدًا من الفئة Node.

Parameters:

معامل	نوع	الوصف
الاسم	java.lang.String	الاسم.
entity	Entity	الكيان الافتراضي.

Node(String name)

public Node(String name)

يُنشئ مثيلًا جديدًا من الفئة Node.

Parameters:

معامل	نوع	الوصف
الاسم	java.lang.String	الاسم.

accept(NodeVisitor visitor)

public boolean accept(NodeVisitor visitor)

يتجول عبر جميع العقد التابعة (بما في ذلك العقدة الحالية) ويستدعي الزائر مع العقدة. يمكن للزائر إيقاف التجول بإرجاع false

Parameters:

معامل	نوع	الوصف
visitor	NodeVisitor	استدعاء رد النداء للزائر لزيارة العقدة

Returns: منطقي - true يعني أن الزائر قد كسر التجول. Example: الكود التالي يوضح كيفية الحصول على جميع الشبكات من مشهد

Scene scene = Scene.fromFile("input.fbx");
     List<Mesh> meshes = new ArrayList<Mesh>();
     scene.getRootNode().accept(new NodeVisitor() {
         @Override
         public boolean call(Node node) {
             if(node.Entity instanceof Mesh)
                 meshes.add(((Mesh)node).getEntity());
             //continue searching
             return true;
         }
     });

addChildNode(Node node)

public void addChildNode(Node node)

أضف عقدة فرعية إلى هذه العقدة

Parameters:

معامل	نوع	الوصف
	node	Node

Scene scene = Scene.fromFile("input.fbx");
     var newNode = new Node();
     //add a new node manually
     scene.getRootNode().addChildNode(newNode);
``` |

### addEntity(Entity entity) {#addEntity-com.aspose.threed.Entity-}

public void addEntity(Entity entity)

أضف كيانًا إلى العقدة.

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| entity | [Entity](../../com.aspose.threed/entity) | الكيان الذي سيتم إرفاقه بالعقدة |

### createChildNode() {#createChildNode--}

public Node createChildNode()

ينشئ عقدة فرعية

**Returns:**
[Node](../../com.aspose.threed/node) - The new child node. **Example:** The following code shows how to create a new child node under root node

Scene scene = new Scene(); Node node = scene.getRootNode().createChildNode(); node.setEntity(new Box()); scene.save(“output.fbx”);

### createChildNode(Entity entity) {#createChildNode-com.aspose.threed.Entity-}

public Node createChildNode(Entity entity)

إنشاء عقدة فرعية جديدة مع الكيان المحدد مرفق

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| entity | [Entity](../../com.aspose.threed/entity) | الكيان الافتراضي المرفق بالعقدة |

**Returns:**
[Node](../../com.aspose.threed/node) - The new child node. **Example:** The following code shows how to create a new child node under root node

Scene scene = new Scene(); Node node = scene.getRootNode().createChildNode(new Box()); scene.save(“output.fbx”);

### createChildNode(String nodeName) {#createChildNode-java.lang.String-}

public Node createChildNode(String nodeName)

إنشاء عقدة فرعية جديدة بالاسم المحدد للعقدة

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| nodeName | java.lang.String | اسم العقدة الفرعية الجديدة |

**Returns:**
[Node](../../com.aspose.threed/node) - The new child node. **Example:** The following code shows how to create a new child node under root node

Scene scene = new Scene(); Node node = scene.getRootNode().createChildNode(“new node”); node.setEntity(new Box()); scene.save(“output.fbx”);

### createChildNode(String nodeName, Entity entity) {#createChildNode-java.lang.String-com.aspose.threed.Entity-}

public Node createChildNode(String nodeName, Entity entity)

إنشاء عقدة فرعية جديدة بالاسم المحدد للعقدة

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| nodeName | java.lang.String | اسم العقدة الفرعية الجديدة |
| entity | [Entity](../../com.aspose.threed/entity) | الكيان الافتراضي المرفق بالعقدة |

**Returns:**
[Node](../../com.aspose.threed/node) - The new child node.
### createChildNode(String nodeName, Entity entity, Material material) {#createChildNode-java.lang.String-com.aspose.threed.Entity-com.aspose.threed.Material-}

public Node createChildNode(String nodeName, Entity entity, Material material)

إنشاء عقدة فرعية جديدة بالاسم المحدد للعقدة، وإرفاق الكيان المحدد ومادة

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| nodeName | java.lang.String | اسم العقدة الفرعية الجديدة |
| entity | [Entity](../../com.aspose.threed/entity) | الكيان الافتراضي المرفق بالعقدة |
| material | [Material](../../com.aspose.threed/material) | المادة المرفقة بالعقدة |

**Returns:**
[Node](../../com.aspose.threed/node) - The new child node.
### equals(Object arg0) {#equals-java.lang.Object-}

public boolean equals(Object arg0)

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| arg0 | java.lang.Object |  |

**Returns:**
boolean
### evaluateGlobalTransform(boolean withGeometricTransform) {#evaluateGlobalTransform-boolean-}

public Matrix4 evaluateGlobalTransform(boolean withGeometricTransform)

تقييم التحويل العالمي، تضمين التحويل الهندسي أم لا.

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| withGeometricTransform | boolean | ما إذا كان التحويل الهندسي مطلوبًا. |

**Returns:**
[Matrix4](../../com.aspose.threed/matrix4) - The global transform matrix. **Example:** The following code shows how to read the node's global transform matrix.

Scene scene = new Scene(); var boxNode = scene.getRootNode().createChildNode(new Box()); //place the box at (10, 0, 0) boxNode.getTransform().setTranslation(new Vector3(10, 0, 0)); Matrix4 mat = boxNode.evaluateGlobalTransform(true); System.out.printf(“The box’s global transform matrix is %s”, mat);

### findProperty(String propertyName) {#findProperty-java.lang.String-}

public Property findProperty(String propertyName)

يبحث عن الخاصية. يمكن أن تكون خاصية ديناميكية (Created by CreateDynamicProperty/SetProperty) أو خاصية أصلية (Identified by its name)

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| propertyName | java.lang.String | اسم الخاصية. |

**Returns:**
[Property](../../com.aspose.threed/property) - The property.
### getAssetInfo() {#getAssetInfo--}

public AssetInfo getAssetInfo()

معلومات الأصول لكل عقدة

**Returns:**
[AssetInfo](../../com.aspose.threed/assetinfo) - Per-node asset info
### getBoundingBox() {#getBoundingBox--}

public BoundingBox getBoundingBox()

حساب الصندوق المحيط للعقدة

**Returns:**
[BoundingBox](../../com.aspose.threed/boundingbox) - The bounding box of current node
### getChild(int index) {#getChild-int-}

public Node getChild(int index)

يحصل على العقدة الفرعية عند الفهرس المحدد.

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| الفهرس | int | الفهرس. |

**Returns:**
[Node](../../com.aspose.threed/node) - The child. **Example:** The following code shows how to get a child node at specified index.

Scene scene = Scene.fromFile(“input.fbx”); var node = scene.getRootNode().getChild(0); System.out.printf(“The first node of the file is %s”, node.getName());

### getChild(String nodeName) {#getChild-java.lang.String-}

public Node getChild(String nodeName)

يحصل على العقدة الفرعية بالاسم المحدد

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| nodeName | java.lang.String | اسم العقدة الفرعية للبحث عنه. |

**Returns:**
[Node](../../com.aspose.threed/node) - The child. **Example:** The following code shows how to get a child node with specified name

Scene scene = Scene.fromFile(“input.fbx”); var node = scene.getRootNode().getChild(“box”); System.out.printf(“The box node’s translation is %s”, node.getTransform().getTranslation());

### getChildNodes() {#getChildNodes--}

public List getChildNodes()

يحصل على العقد الفرعية.

**Returns:**
java.util.List<com.aspose.threed.Node> - العقد الفرعية. **Example:** الكود التالي يوضح كيفية تعداد العقدة الفرعية للجذر

Scene scene = Scene.fromFile(“test.fbx”); for(var child : scene.getRootNode().getChildNodes()) { //do your business }

### getClass() {#getClass--}

public final native Class getClass()

**Returns:**
java.lang.Class<?>
### getEntities() {#getEntities--}

public List getEntities()

يحصل على جميع كيانات العقدة.

**Returns:**
java.util.List<com.aspose.threed.Entity> - جميع كيانات العقدة.
### getEntity() {#getEntity--}

public Entity getEntity()

يحصل على أول كيان مرفق بهذه العقدة، إذا تم الضبط، سيتم مسح الكيانات الأخرى.

**Returns:**
[Entity](../../com.aspose.threed/entity) - the first entity attached to this node, if sets, will clear other entities. **Example:** The following code shows how to create a new child node under root node

Scene scene = new Scene(); Node node = scene.getRootNode().createChildNode(“new node”); node.setEntity(new Box()); scene.save(“output.fbx”);

### getExcluded() {#getExcluded--}

public boolean getExcluded()

يحصل على ما إذا كان يجب استبعاد هذه العقدة وجميع العقد/الكيانات الفرعية أثناء التصدير.

**Returns:**
منطقي - ما إذا كان يجب استبعاد هذه العقدة وجميع العقد/الكيانات الفرعية أثناء التصدير. **Example:** الكود التالي يوضح كيفية استبعاد العقدة المحددة من التصدير

Scene scene = new Scene(); scene.getRootNode().createChildNode(“excluded”, new Box()).setExcluded(true); scene.getRootNode().createChildNode(“not excluded”, new Box()); scene.save(“output.usdz”);

### getGlobalTransform() {#getGlobalTransform--}

public GlobalTransform getGlobalTransform()

يحصل على التحويل العالمي.

**Returns:**
[GlobalTransform](../../com.aspose.threed/globaltransform) - the global transform. **Example:** The following code shows how to read node's global transform

Scene scene = new Scene(); var boxNode = scene.getRootNode().createChildNode(new Box()); //place the box at (10, 0, 0) boxNode.getTransform().setTranslation(new Vector3(10, 0, 0)); var global = boxNode.getGlobalTransform(); System.out.printf(“The box’s position in world coordinate is %s”, global.getTranslation());

### getMaterial() {#getMaterial--}

public Material getMaterial()

يحصل على أول مادة مرتبطة بهذه العقدة، إذا تم الضبط، سيتم مسح المواد الأخرى

**Returns:**
[Material](../../com.aspose.threed/material) - the first material associated with this node, if sets, will clear other materials **Example:**

Scene scene = new Scene(); var node = scene.getRootNode().createChildNode(new Box()); node.setMaterial(new LambertMaterial());

### getMaterials() {#getMaterials--}

public List getMaterials()

يحصل على المواد المرتبطة بهذه العقدة.

**Returns:**
java.util.List<com.aspose.threed.Material> - المواد المرتبطة بهذه العقدة.
### getMetaDatas() {#getMetaDatas--}

public List getMetaDatas()

يحصل على البيانات الوصفية المعرفة في هذه العقدة.

**Returns:**
java.util.List<com.aspose.threed.CustomObject> - البيانات الوصفية المعرفة في هذه العقدة.
### getName() {#getName--}

public String getName()

يحصل على الاسم.

**Returns:**
java.lang.String - الاسم.
### getParentNode() {#getParentNode--}

public Node getParentNode()

يحصل على العقدة الأصل.

**Returns:**
[Node](../../com.aspose.threed/node) - the parent node.
### getProperties() {#getProperties--}

public PropertyCollection getProperties()

يحصل على مجموعة جميع الخصائص.

**Returns:**
[PropertyCollection](../../com.aspose.threed/propertycollection) - the collection of all properties.
### getProperty(String property) {#getProperty-java.lang.String-}

public Object getProperty(String property)

احصل على قيمة الخاصية المحددة

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| خاصية | java.lang.String | اسم الخاصية |

**Returns:**
java.lang.Object - قيمة الخاصية التي تم العثور عليها
### getScene() {#getScene--}

public Scene getScene()

يحصل على المشهد الذي ينتمي إليه هذا الكائن

**Returns:**
[Scene](../../com.aspose.threed/scene) - the scene that this object belongs to
### getTransform() {#getTransform--}

public Transform getTransform()

يحصل على التحويل المحلي.

**Returns:**
[Transform](../../com.aspose.threed/transform) - the local transform. **Example:** The following code shows how to change the transform of the node:

Scene scene = new Scene(); var boxNode = scene.getRootNode().createChildNode(new Box()); //place the box at (10, 0, 0) boxNode.getTransform().setTranslation(new Vector3(10, 0, 0));

### getVisible() {#getVisible--}

public boolean getVisible()

يحصل على إظهار العقدة

**Returns:**
منطقي - لإظهار العقدة **Example:** الكود التالي يوضح كيفية إنشاء عقدة غير مرئية

Scene scene = new Scene(); Node node = scene.getRootNode().createChildNode(“test-node”, new Box()); node.setVisible(false); scene.save(“output.fbx”);

### hashCode() {#hashCode--}

public native int hashCode()

**Returns:**
int
### merge(Node node) {#merge-com.aspose.threed.Node-}

public void merge(Node node)

افصل كل شيء تحت العقدة وأرفقه بالعقدة الحالية. **Example:** الكود التالي يوضح كيفية دمج ملفين ثلاثيين الأبعاد في ملف واحد

Scene scene1 = Scene.fromFile(“scene1.fbx”); Scene scene2 = Scene.fromFile(“scene2.fbx”); scene1.getRootNode().merge(scene2.getRootNode()); scene1.save(“merged.fbx”);

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| node | [Node](../../com.aspose.threed/node) |  |

### notify() {#notify--}

public final native void notify()

### notifyAll() {#notifyAll--}

public final native void notifyAll()

### removeProperty(Property property) {#removeProperty-com.aspose.threed.Property-}

public boolean removeProperty(Property property)

يزيل خاصية ديناميكية.

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| property | [Property](../../com.aspose.threed/property) | أي خاصية تريد إزالتها |

**Returns:**
boolean - true إذا تم إزالة الخاصية بنجاح
### removeProperty(String property) {#removeProperty-java.lang.String-}

public boolean removeProperty(String property)

إزالة الخاصية المحددة التي تم التعرف عليها بالاسم.

**Parameters:**
| معامل | نوع | الوصف |
| --- | --- | --- |
| خاصية | java.lang.String | أي خاصية تريد إزالتها |

**Returns:**
boolean - true إذا تم إزالة الخاصية بنجاح
### selectObjects(String path) {#selectObjects-java.lang.String-}

public ArrayList