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

接口 MeshBuilder

public interface MeshBuilder

A utility class for creating 3D mesh resources from raw data.

You can pass a MeshBuilder object to ResourceManager to create a mesh resource.

从以下版本开始:

3

嵌套类概要

嵌套类

限定符和类型	接口	说明
static class	MeshBuilder.Primitive	Represents the primitive used to build a mesh.
static class	MeshBuilder.VertexData	Provides the vertex data for creating a mesh.

方法概要

限定符和类型	方法	说明
void	addPrimitive(MeshBuilder.Primitive primitive)	Adds a primitive and related information to the current mesh.
void	allocate()	Allocates memory for the current mesh.
int	getIndexCount()	Obtains the index count.
int	getVertexCount()	Obtains the vertex count.
void	release()	Releases the current mesh.
void	setAabb(int primitiveIndex, BoundingBox bounds)	Sets an axis-aligned bounding box (AABB) for a primitive.
void	setIndexData(int primitiveIndex, ByteBuffer indices)	Sets indices to triangles for a primitive.
void	setVertexData(int primitiveIndex, MeshBuilder.VertexData vertexData)	Sets geometry data for a given primitive.

方法详细资料

allocate

void allocate()

Allocates memory for the current mesh.

This method should be called after all primitives have been added to this mesh and before data is being fed to primitives.

release

void release()

Releases the current mesh.

addPrimitive

void addPrimitive(MeshBuilder.Primitive primitive)

Adds a primitive and related information to the current mesh.

参数:

primitive - Indicates the primitive to add and the related information that determines memory requirements.

setVertexData

void setVertexData(int primitiveIndex,
                   MeshBuilder.VertexData vertexData)

Sets geometry data for a given primitive.

参数:

primitiveIndex - Indicates the index of the primitive.

vertexData - Indicates the data buffers for creating a mesh.

setIndexData

void setIndexData(int primitiveIndex,
                  ByteBuffer indices)

Sets indices to triangles for a primitive.

参数:

primitiveIndex - Indicates the index of the primitive.

indices - Indicates index data as a byte array (the format of which is defined by the information related to the primitive).

setAabb

void setAabb(int primitiveIndex,
             BoundingBox bounds)

Sets an axis-aligned bounding box (AABB) for a primitive.

参数:

primitiveIndex - Indicates the index of the primitive.

bounds - Indicates the primitive bounds.

getVertexCount

int getVertexCount()

Obtains the vertex count.

This method should be called after allocate() has been called.

返回:

Returns the total vertex count in the current mesh.

getIndexCount

int getIndexCount()

Obtains the index count.

16-bit indices are packed (two per one 32-bit slot), and there might be paddings involved.

返回:

Returns the total index count in the current mesh.