程序包 ohos.agp.render.render3d.resources

接口 ResourceManager

public interface ResourceManager

Manages resources such as meshes, textures, and materials.

从以下版本开始:

3

嵌套类概要

嵌套类

限定符和类型	接口	说明
static interface	ResourceManager.ResourceInfo	Provides methods of obtaining the URI, name, and resource handle of a resource.

方法概要

限定符和类型	方法	说明
void	copyDataToImage(GpuResourceHandle destination, ByteBuffer data, int width, int height)	Copies CPU data into a GPU image.
int	createExternalTextureOes()	Creates an external OES texture.
ResourceHandle	createMaterial(String uri, String name)	Creates a material with a specified URI and name.
ResourceHandle	createMesh(String uri, String name, MeshBuilder meshBuilder)	Creates a mesh.
Optional<AnimationPlayback>	createPlayback(ResourceHandle animationHandle, SceneNode node)	Creates an animation playback object that can control the animation state.
RenderDataStorePod	createRenderDataStorePod(String name)	Creates a generic render data store for data of plain old data (POD) types.
GpuResourceHandle	createTexture(String name, int width, int height, ImageFormat format)	Creates a texture based on the image name, width, height, and format.
GpuResourceHandle	createTexture(String name, String imageUri)	Creates a texture based on the image name and URI.
GpuResourceHandle	createTextureViewOes(String name, int width, int height, int textureId)	Creates a texture view wrapping an external OpenGL ES (OES) texture.
GpuResourceHandle	createUniformRingBuffer(String name, int byteSize)	Creates a uniform GPU buffer.
void	deleteExternalTextureOes(int textureId)	Deletes a specified external OES texture.
List<ResourceManager.ResourceInfo>	getAnimations()	Obtains all animation resources.
GpuResourceHandle	getEmptyGpuResourceHandle()	Obtains an empty GPU resource handle.
ResourceHandle	getEmptyResourceHandle()	Obtains an empty resource handle.
List<ResourceManager.ResourceInfo>	getImages()	Obtains all image resources.
Optional<MaterialDesc>	getMaterialDesc(ResourceHandle resource)	Obtains a material descriptor using a specified handle.
List<ResourceManager.ResourceInfo>	getMaterials()	Obtains all material resources.
Optional<MeshDesc>	getMeshDesc(ResourceHandle resource)	Obtains a mesh descriptor using a specified handle.
List<ResourceManager.ResourceInfo>	getMeshes()	Obtains all mesh resources.
Optional<RenderDataStorePod>	getRenderDataStorePod(String name)	Obtains a generic render data store created for data of POD types using a specified data store name.
ResourceHandle	getResourceHandle(String uri)	Obtains a resource handle using a specified URI.
List<ResourceManager.ResourceInfo>	getResources()	Obtains all resources.
List<ResourceManager.ResourceInfo>	getSkins()	Obtains all skin resources.
void	setMaterialDesc(ResourceHandle resource, MaterialDesc materialDesc)	Sets a material descriptor using a specified handle.
void	updateBuffer(GpuResourceHandle buffer, ByteBuffer data)	Updates the contents of a specified dynamic GPU buffer.

方法详细资料

getResources

List<ResourceManager.ResourceInfo> getResources()

Obtains all resources.

返回:

Returns a list of ResourceInfo objects for all resources.

getMaterials

List<ResourceManager.ResourceInfo> getMaterials()

Obtains all material resources.

返回:

Returns a list of ResourceInfo objects for all materials.

getMeshes

List<ResourceManager.ResourceInfo> getMeshes()

Obtains all mesh resources.

返回:

Returns a list of ResourceInfo objects for all meshes.

getAnimations

List<ResourceManager.ResourceInfo> getAnimations()

Obtains all animation resources.

返回:

Returns a list of ResourceInfo objects for all animations.

getSkins

List<ResourceManager.ResourceInfo> getSkins()

Obtains all skin resources.

返回:

Returns a list of ResourceInfo objects for all skins.

getImages

List<ResourceManager.ResourceInfo> getImages()

Obtains all image resources.

返回:

Returns a list of ResourceInfo objects for all images.

getEmptyResourceHandle

ResourceHandle getEmptyResourceHandle()

Obtains an empty resource handle.

返回:

Returns an empty resource handle.

getResourceHandle

ResourceHandle getResourceHandle(String uri)

Obtains a resource handle using a specified URI.

参数:

uri - Indicates the unique identifier of a resource.

返回:

Returns the found resource handle if any; returns an invalid handle otherwise.

createMaterial

ResourceHandle createMaterial(String uri,
                              String name)

Creates a material with a specified URI and name.

参数:

uri - Indicates the unique identifier of the new material.

name - Indicates the material name to set.

返回:

Returns a handle to the new material if it is successfully created; returns an invalid handle otherwise.

getMaterialDesc

Optional<MaterialDesc> getMaterialDesc(ResourceHandle resource)

Obtains a material descriptor using a specified handle.

参数:

resource - Indicates the resource handle to the material.

返回:

Returns the found material descriptor if any; returns an empty Optional object otherwise.

setMaterialDesc

void setMaterialDesc(ResourceHandle resource,
                     MaterialDesc materialDesc)

Sets a material descriptor using a specified handle.

参数:

resource - Indicates the resource handle to the material.

materialDesc - Indicates the material descriptor to set.

createMesh

ResourceHandle createMesh(String uri,
                          String name,
                          MeshBuilder meshBuilder)

Creates a mesh.

参数:

uri - Indicates the unique identifier of the new mesh.

name - Indicates the mesh name to set.

meshBuilder - Indicates the data of the new mesh.

返回:

Returns a handle to the new mesh if it is successfully created; returns an invalid handle otherwise.

getMeshDesc

Optional<MeshDesc> getMeshDesc(ResourceHandle resource)

Obtains a mesh descriptor using a specified handle.

参数:

resource - Indicates the resource handle to the mesh.

返回:

Returns the found mesh descriptor if any; returns an empty Optional object otherwise.

getEmptyGpuResourceHandle

GpuResourceHandle getEmptyGpuResourceHandle()

Obtains an empty GPU resource handle.

返回:

Returns an empty GPU resource handle.

createTexture

GpuResourceHandle createTexture(String name,
                                String imageUri)

Creates a texture based on the image name and URI.

参数:

name - Indicates the image name to set.

imageUri - Indicates the URI of the image.

返回:

Returns a handle to the new texture if it is successfully created; returns an invalid handle otherwise.

createTexture

GpuResourceHandle createTexture(String name,
                                int width,
                                int height,
                                ImageFormat format)

Creates a texture based on the image name, width, height, and format.

参数:

name - Indicates the image name to set.

width - Indicates the width of the texture.

height - Indicates the height of the texture.

format - Indicates the format of the texture.

返回:

Returns a handle to the new texture if it is successfully created; returns an invalid handle otherwise.

copyDataToImage

void copyDataToImage(GpuResourceHandle destination,
                     ByteBuffer data,
                     int width,
                     int height)

Copies CPU data into a GPU image.

参数:

destination - Indicates the GPU resource handle to the destination image.

data - Indicates the data to copy.

width - Indicates the width of the image.

height - Indicates the height of the image.

createTextureViewOes

GpuResourceHandle createTextureViewOes(String name,
                                       int width,
                                       int height,
                                       int textureId)

Creates a texture view wrapping an external OpenGL ES (OES) texture.

参数:

name - Indicates the name of the texture.

width - Indicates the width of the texture.

height - Indicates the height of the texture.

textureId - Indicates the OES texture ID.

返回:

Returns a handle to the new texture view if it is successfully created; returns an invalid handle otherwise.

createUniformRingBuffer

GpuResourceHandle createUniformRingBuffer(String name,
                                          int byteSize)

Creates a uniform GPU buffer. You can call updateBuffer(ohos.agp.render.render3d.resources.GpuResourceHandle,java.nio.ByteBuffer) to update contents in the buffer.

参数:

name - Indicates the name of the buffer to create.

byteSize - Indicates the size of the buffer, in bytes.

返回:

Returns a handle to the new buffer if it is successfully created; returns an invalid handle otherwise.

updateBuffer

void updateBuffer(GpuResourceHandle buffer,
                  ByteBuffer data)

Updates the contents of a specified dynamic GPU buffer.

参数:

buffer - Indicates the handle to the GPU buffer whose contents are to be updated.

data - Indicates the data to update.

createExternalTextureOes

int createExternalTextureOes()

Creates an external OES texture.

返回:

Returns the ID of the created external OES texture.

deleteExternalTextureOes

void deleteExternalTextureOes(int textureId)

Deletes a specified external OES texture.

参数:

textureId - Indicates the external OES texture ID.

createRenderDataStorePod

RenderDataStorePod createRenderDataStorePod(String name)

Creates a generic render data store for data of plain old data (POD) types.

参数:

name - Indicates the name of the data store to create.

返回:

Returns the created RenderDataStorePod object.

getRenderDataStorePod

Optional<RenderDataStorePod> getRenderDataStorePod(String name)

Obtains a generic render data store created for data of POD types using a specified data store name.

参数:

name - Indicates the name of the data store.

返回:

Returns the found data store if any; returns an empty Optional object otherwise.

createPlayback

Optional<AnimationPlayback> createPlayback(ResourceHandle animationHandle,
                                           SceneNode node)

Creates an animation playback object that can control the animation state.

参数:

animationHandle - Indicates the handle to the animation resource.

node - Indicates the node where the animation is to be added.

返回:

Returns the found AnimationPlayback object if any; returns an empty Optional object otherwise.