.. _group__a3d__riset:

#######################
Set Representation Item
#######################

This entity is a logical grouping of other representation items.

No matrix for placement is attached to components, and an :c:type:`~A3DRiSet`\ entity can contain multiple child :c:type:`~A3DRiSet`\ sets.


   A representation item cannot belong to more than one set.



Sample code
===========


::

   A3DRiSet*pSet=A3D_NULL_HANDLE;
   /*ShouldcallsomethinghereinordertogetavalidA3DRiSet*/
   A3DInt32iErr=A3D_SUCCESS;
   A3DRiSetDatasData=A3D_MAKE_DATA(A3DRiSetData);
   iErr=A3DRiSetGet(pSet,&sData);
   if(iErr==A3D_SUCCESS)
   {
   for(A3DUns32ui=0;ui<sData.m_uiRepItemsSize;ui++)
   {
   /*InserthereyourowncodetoparsethroughmembersofSet:sData.m_ppRepItems[ui]*/
   }
   A3DRiSetGet(A3D_NULL_HANDLE,&sData);
   }


**Returns**


   ``A3D_SUCCESS``\ on success, or an error code on failure


.. rst-class:: kind-group kind-record

.. rubric:: Structures
   :class: kind-group-title


.. rst-class:: api-xref-list


* :c:struct:`~A3DRiSetData`

.. rst-class:: kind-group kind-function

.. rubric:: Functions
   :class: kind-group-title


.. rst-class:: api-xref-list


* :c:func:`~A3DRiSetGet`
* :c:func:`~A3DRiSetCreate`
* :c:func:`~A3DRiSetEdit`

.. toctree::
   :maxdepth: 1
   :hidden:

   ../structures/A3DRiSetData
   ../functions/A3DRiSetGet
   ../functions/A3DRiSetCreate
   ../functions/A3DRiSetEdit


