程序包 ohos.agp.render.render3d

接口 Scene

public interface Scene

Represents scenes that contain entities, such as a scene of 3D objects.

从以下版本开始:

3

方法概要

限定符和类型	方法	说明
SceneNode	cloneNode(SceneNode node, boolean recursive)	Creates a clone node that copies all components of the original node according to handle values.
Entity	createEntity()	Creates an empty entity.
SceneNode	createNode()	Creates a node in a scene.
void	destroyEntity(Entity entity)	Destroys an entity.
void	destroyNode(SceneNode node)	Destroys a node and all its child nodes.
Engine	getEngine()	Obtains the engine used by the current scene.
MorphingSystem	getMorphingSystem()	Obtains a MorphingSystem instance.
Optional<SceneNode>	getNode(Entity entity)	Obtains the scene node of an entity.
SceneNode	getRootNode()	Obtains the root node of a scene, which is a container for other nodes and does not point to any entity.
SceneUtil	getSceneUtil()	Obtains a SceneUtil instance.

方法详细资料

getEngine

Engine getEngine()

Obtains the engine used by the current scene.

返回:

Returns the engine used by the current scene.

getSceneUtil

SceneUtil getSceneUtil()

Obtains a SceneUtil instance.

返回:

Returns the SceneUtil instance.

createEntity

Entity createEntity()

Creates an empty entity.

返回:

Returns the created entity.

destroyEntity

void destroyEntity(Entity entity)

Destroys an entity.

参数:

entity - Indicates the entity to destroy.

getRootNode

SceneNode getRootNode()

Obtains the root node of a scene, which is a container for other nodes and does not point to any entity.

返回:

Returns the root node of the scene.

getNode

Optional<SceneNode> getNode(Entity entity)

Obtains the scene node of an entity.

参数:

entity - Indicates the scene node to request.

返回:

Returns the root node of the entity. Returns an empty optional if the entity does not have a node, that is,a NodeComponent object.

createNode

SceneNode createNode()

Creates a node in a scene. This method creates an entity that consists of the Transform object, node, and requisite matrix. By default, the created node is a child node of the root node.

返回:

Returns the created node.

cloneNode

SceneNode cloneNode(SceneNode node,
                    boolean recursive)

Creates a clone node that copies all components of the original node according to handle values. If the handle references resources such as meshes and materials, the clone node copies the handle values to point to the same resources of the original node.

参数:

node - Indicates the original node to clone.

recursive - Indicates whether the child nodes are recursively cloned. true indicates that all child nodes are recursively cloned.

返回:

Returns the clone node of the original node.

destroyNode

void destroyNode(SceneNode node)

Destroys a node and all its child nodes. The resources used by the node will not be destroyed.

参数:

node - Indicates the node to destroy.

getMorphingSystem

MorphingSystem getMorphingSystem()

Obtains a MorphingSystem instance.

返回:

Returns the MorphingSystem instance.