A3DObject / SceneObject / CustomObject

A3DObject, SceneObject, CustomObject — Aspose.3D FOSS for Java

Пакет: com.aspose.threed (aspose-3d-foss 26.1.0)

Эти три класса образуют основу иерархии классов Aspose.3D. Каждый публичный объект в библиотеке наследуется от A3DObject, который предоставляет имя и динамическую коллекцию свойств. SceneObject расширяет A3DObject с отслеживанием членства в сцене. CustomObject является лёгким конкретным подклассом для хранения произвольных пользовательских метаданных.


A3DObject

Корневой базовый класс для всех управляемых объектов Aspose.3D. Каждый именованный объект в библиотеке — Node, Mesh, AnimationClip, Material, и так далее – наследуется от A3DObject.

import com.aspose.threed.A3DObject;

Example

ExampleExampleExampleExampleExample
nameStringgetName()setName(String)Читаемое человеком имя объекта. По умолчанию — пустая строка.
propertiesPropertyCollectiongetProperties()Динамическая коллекция свойств, прикреплённая к этому объекту. Перебирайте её или используйте findProperty() для именованных поисков.

Example

findProperty(String propertyName)

Ищите именованное свойство в объекте PropertyCollection и возвращайте Property экземпляр, либо null если не найдено.

ExampleExampleExample
propertyNameStringИмя для поиска.

Возвращает: Property или null

import com.aspose.threed.Scene;

Scene scene = new Scene();
Node node = scene.getRootNode().createChildNode("origin");
Property prop = node.findProperty("name");
if (prop != null) {
    System.out.println(prop.getValue());   // "origin"
}

getProperty(String property)

Возвратить текущее значение именованного свойства, или null если свойство не существует.

ExampleExampleExample
propertyStringИмя свойства.

Возвращает: Object

Object val = node.getProperty("name");
System.out.println(val);   // "origin"

setProperty(String property, Object value)

Устанавливает значение именованного свойства. Создаёт свойство, если оно ещё не существует.

ExampleExampleExample
propertyStringИмя свойства.
valueObjectНовое значение.

Возвращает: void

node.setProperty("layer", 3);
System.out.println(node.getProperty("layer"));   // 3

removeProperty(String property)

Удалить именованное свойство из коллекции.

ExampleExampleExample
propertyString или PropertyИмя свойства или Property экземпляр для удаления.

Возвращает: booleantrue если свойство было найдено и удалено.


Example

import com.aspose.threed.Scene;
import com.aspose.threed.Node;
import com.aspose.threed.Property;

Scene scene = new Scene();
Node node = scene.getRootNode().createChildNode("my_node");

// Set and retrieve a custom property
node.setProperty("export_lod", 2);
System.out.println(node.getProperty("export_lod"));   // 2

// Enumerate all properties
for (Property prop : node.getProperties()) {
    System.out.println("  " + prop.getName() + " = " + prop.getValue());
}

// Find and inspect a specific property
Property p = node.findProperty("name");
if (p != null) {
    System.out.println(p.getValueType());   // java.lang.String
}

SceneObject

Example A3DObject со ссылкой на владеющий Scene. Node, Entity, и связанные классы наследуются от SceneObject.

import com.aspose.threed.SceneObject;

Example

A3DObject -> SceneObject

Дополнительное свойство

ExampleExampleExampleExampleExample
sceneScenegetScene()setScene(Scene)Example Scene к которому принадлежит этот объект, или null если ещё не присоединён.
import com.aspose.threed.Scene;

Scene scene = new Scene();
Node node = scene.getRootNode().createChildNode("child");
System.out.println(node.getScene() == scene);   // true

CustomObject

Лёгкий конкретный подкласс of A3DObject который содержит только имя и произвольный PropertyCollection. Используйте его, чтобы прикреплять свободно-форматированные метаданные к сцене без создания подкласса какого-либо типа сущности.

import com.aspose.threed.CustomObject;

Example

A3DObject -> CustomObject

Example

CustomObject()
CustomObject(String name)

Example

import com.aspose.threed.CustomObject;
import com.aspose.threed.Scene;

// Attach pipeline metadata to a scene as a custom object
CustomObject meta = new CustomObject("render_settings");
meta.setProperty("max_bounces", 8);
meta.setProperty("use_denoiser", true);

Scene scene = new Scene();
scene.getRootNode().setProperty("render_meta", meta.getName());
System.out.println(meta.getProperty("max_bounces"));   // 8

См. также

 Русский