Helpers

Types

	A3DRiComputeMeshDataParameters
	A3DMeshData

Functions

A3DStatus

A3DRiComputeMesh

Detailed Description

group a3d_rihelpers: High-level functions for Representation Items module.

Function Documentation

A3DStatus A3DRiComputeMesh(const A3DRiRepresentationItem *pRi, const A3DMiscCascadedAttributes *pParentAttributes, A3DMeshData *pMesh, const A3DRiComputeMeshDataParameters *psMeshOptionsData)

Populate an A3DMeshData structure with mesh information extracted from the provided A3DRiRepresentationItem entity.

This function computes the underlying mesh structure contained within the given representation item and fills in an instance of A3DMeshData. If normals are missing from the representation item, they are computed using A3DRiComputeMesh.

Version: 24.0

Memory Management:

If successful, the pMesh structure contains heap-allocated memory for which you are responsible. To free the memory in pMesh, call A3DRiComputeMesh with pRi set to 0:

A3DRiComputeMesh(0, 0, &pMesh, 0);

Limitations:

A3DRiComputeMesh computes the mesh for kA3DTypeRiBrepModel and kA3DTypeRiPolyBrepModel representation items only.

Example:

Before calling the function, ensure that the representation item contains tessellation. Use A3DRiRepresentationItemComputeTessellation to generate tessellation data if needed:

A3DMeshData meshData;
A3D_INITIALIZE_DATA(A3DMeshData, meshData);

A3DStatus status = A3DRiComputeMesh(pRi, parentGraphicalContext, &meshData, 0);

if (status != A3D_SUCCESS)
{
    A3DRWParamsTessellationData tess_params;
    A3D_INITIALIZE_DATA(A3DRWParamsTessellationData, tess_params);
    tess_params.m_eTessellationLevelOfDetail = kA3DTessLODMedium;
    A3DRiRepresentationItemComputeTessellation(pRi, &tess_params);

    status = A3DRiComputeMesh(pRi, parentGraphicalContext, &meshData, 0);
    assert(status == A3D_SUCCESS);
}