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
| Example | Example | Example | Example | Example |
|---|---|---|---|---|
name | String | getName() | setName(String) | Читаемое человеком имя объекта. По умолчанию — пустая строка. |
properties | PropertyCollection | getProperties() | – | Динамическая коллекция свойств, прикреплённая к этому объекту. Перебирайте её или используйте findProperty() для именованных поисков. |
Example
findProperty(String propertyName)
Ищите именованное свойство в объекте PropertyCollection и возвращайте Property экземпляр, либо null если не найдено.
| Example | Example | Example |
|---|---|---|
propertyName | String | Имя для поиска. |
Возвращает: 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 если свойство не существует.
| Example | Example | Example |
|---|---|---|
property | String | Имя свойства. |
Возвращает: Object
Object val = node.getProperty("name");
System.out.println(val); // "origin"setProperty(String property, Object value)
Устанавливает значение именованного свойства. Создаёт свойство, если оно ещё не существует.
| Example | Example | Example |
|---|---|---|
property | String | Имя свойства. |
value | Object | Новое значение. |
Возвращает: void
node.setProperty("layer", 3);
System.out.println(node.getProperty("layer")); // 3removeProperty(String property)
Удалить именованное свойство из коллекции.
| Example | Example | Example |
|---|---|---|
property | String или Property | Имя свойства или Property экземпляр для удаления. |
Возвращает: boolean – true если свойство было найдено и удалено.
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
Дополнительное свойство
| Example | Example | Example | Example | Example |
|---|---|---|---|---|
scene | Scene | getScene() | 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); // trueCustomObject
Лёгкий конкретный подкласс 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