Set Representation Item

Types

Functions

`A3DStatus`	`A3DRiSetGet`
`A3DStatus`	`A3DRiSetCreate`
`A3DStatus`	`A3DRiSetEdit`

Detailed Description

group a3d_riset

This entity is a logical grouping of other representation items. No matrix for placement is attached to components, and an A3DRiSet entity can contain multiple child A3DRiSet sets.

Sample code

A3DRiSet pSet;
/* Should call something here in order to get a valid A3DRiSet */
A3DInt32 iErr = A3D_SUCCESS;
A3DRiSetData sData;
A3D_INITIALIZE_DATA(sData);
iErr = A3DRiSetGet(pSet, &sData);
if (iErr == A3D_SUCCESS)
{
    for(A3DUns32 ui=0; ui<sData.m_uiRepItemsSize;ui++)
    {
        /* Insert here your own code to parse through members of Set: sData.m_ppRepItems[ui] */
    }
    A3DRiSetGet( NULL,&sData );
}

Warning

A representation item cannot belong to more than one set.

Function Documentation

A3DStatus A3DRiSetGet(const A3DRiSet *pSet, A3DRiSetData *pData)

Populates the A3DRiSetData structure.

Version: 2.0

Return values:	A3D_INITIALIZE_NOT_CALLED – A3D_INVALID_DATA_STRUCT_SIZE – A3D_INVALID_DATA_STRUCT_NULL – A3D_INVALID_ENTITY_NULL – A3D_INVALID_ENTITY_TYPE – A3D_SUCCESS –
Returns:	`A3D_SUCCESS` on success, or an error code on failure

A3DStatus A3DRiSetCreate(const A3DRiSetData *pData, A3DRiSet **ppSet)

Creates an A3DRiSet from A3DRiSetData structure.

Version: 2.0

Return values:	A3D_INVALID_DATA_STRUCT_SIZE – A3D_INVALID_DATA_STRUCT_NULL – A3D_SET_INCONSISTENT_EMPTY – A3D_SUCCESS –
Returns:	`A3D_SUCCESS` on success, or an error code on failure

A3DStatus A3DRiSetEdit(const A3DRiSetData *pData, A3DRiSet *pSet)

Replaces the old data of an A3DRiSet with the new A3DRiSetData structure.

Version: 10.0

Return values:	A3D_INVALID_DATA_STRUCT_SIZE – A3D_INVALID_DATA_STRUCT_NULL – A3D_SET_INCONSISTENT_EMPTY – A3D_INVALID_ENTITY_NULL – A3D_SUCCESS –
Returns:	`A3D_SUCCESS` on success, or an error code on failure