A3DObject, SceneObject, CustomObject — Aspose.3D FOSS for Java
Package : com.aspose.threed (aspose-3d-foss 26.1.0)
Ces trois classes constituent la base de la hiérarchie de classes Aspose.3D. Chaque objet public de la bibliothèque hérite de A3DObject, qui fournit un nom et une collection de propriétés dynamiques. SceneObject étend A3DObject avec le suivi d’appartenance à la scène. CustomObject est une sous‑classe concrète légère pour stocker des métadonnées utilisateur arbitraires.
A3DObject
La classe de base racine pour tous les objets gérés Aspose.3D. Chaque objet nommé dans la bibliothèque — Node, Mesh, AnimationClip, Material, et ainsi de suite – hérite de A3DObject.
import com.aspose.threed.A3DObject;Example
| Example | Example | Example | Example | Example |
|---|---|---|---|---|
name | String | getName() | setName(String) | Nom lisible par l’homme de l’objet. Par défaut, une chaîne vide. |
properties | PropertyCollection | getProperties() | – | La collection de propriétés dynamiques attachée à cet objet. Parcourez‑la ou utilisez findProperty() pour les recherches nommées. |
Example
findProperty(String propertyName)
Rechercher une propriété nommée dans cet objet PropertyCollection et renvoyer le Property instance, ou null si non trouvé.
| Example | Example | Example |
|---|---|---|
propertyName | String | Le nom à rechercher. |
Renvoie : Property ou 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)
Retourne la valeur actuelle d’une propriété nommée, ou null si la propriété n’existe pas.
| Example | Example | Example |
|---|---|---|
property | String | Nom de la propriété. |
Renvoie : Object
Object val = node.getProperty("name");
System.out.println(val); // "origin"setProperty(String property, Object value)
Définit la valeur d’une propriété nommée. Crée la propriété si elle n’existe pas déjà.
| Example | Example | Example |
|---|---|---|
property | String | Nom de la propriété. |
value | Object | Nouvelle valeur. |
Renvoie : void
node.setProperty("layer", 3);
System.out.println(node.getProperty("layer")); // 3removeProperty(String property)
Supprime une propriété nommée de la collection.
| Example | Example | Example |
|---|---|---|
property | String ou Property | Nom de la propriété ou Property instance à supprimer. |
Retours : boolean – true si la propriété a été trouvée et supprimée.
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 avec une référence à l’entité propriétaire Scene. Node, Entity, et les classes associées héritent de SceneObject.
import com.aspose.threed.SceneObject;Example
A3DObject -> SceneObject
Propriété supplémentaire
| Example | Example | Example | Example | Example |
|---|---|---|---|---|
scene | Scene | getScene() | setScene(Scene) | Example Scene à laquelle cet objet appartient, ou null si elle n’est pas encore attachée. |
import com.aspose.threed.Scene;
Scene scene = new Scene();
Node node = scene.getRootNode().createChildNode("child");
System.out.println(node.getScene() == scene); // trueCustomObject
Une sous‑classe concrète légère de A3DObject qui ne porte qu’un nom et un(e) PropertyCollection. Utilisez‑le pour attacher des métadonnées libres à une scène sans sous‑classer aucun type d’entité.
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