A3DRootBaseWithGraphicsSet
-
A3DStatus
A3DRootBaseWithGraphicsSet(A3DRootBaseWithGraphics *pRoot, const A3DRootBaseWithGraphicsData *pData) A3DStatusA3DRootBaseWithGraphicsSet(A3DRootBaseWithGraphics* pRoot, constA3DRootBaseWithGraphicsData* pData)Adds an
A3DRootBaseWithGraphicsDatastructure to an existingA3DRootBaseWithGraphicsentity.11.1Return Values
A3D_INVALID_DATA_STRUCT_SIZE:
A3D_INVALID_DATA_STRUCT_NULL:
A3D_SUCCESS:
The
A3DRootBaseWithGraphicsentity type is an abstract class and cannot be directly created; however, any graphic entity created with a function of the formA3DGraphics_entity_nameCreateresults in the creation of a PRC entity of typeA3DRootBaseWithGraphicsand of typeA3DEntity_name. That is, a function of the formA3DGraphics_entity_nameCreateadds specific data to the base class, for exampleA3DRootBaseWithGraphicsData::m_pGraphics.When A3DRootBaseWithGraphicsSet is used to set a new A3DGraphics, its data is copied in the
A3DRootBaseWithGraphicsbut the pointer is not kept nor freed later when theA3DRootBaseWithGraphicsis deleted. It must be deleted usingA3DEntityDelete()A3DGraphicsData sGraphicsData = A3D_MAKE_DATA(A3DGraphicsData); // fill in sGraphicsData A3DGraphics* pGraphics = A3D_NULL_HANDLE; A3DStatus eStatus = A3DGraphicsCreate(&sGraphicsData, &graphics); A3DRootBaseWithGraphicsData sRootBaseWithGraphicsData = A3D_MAKE_DATA(A3DRootBaseWithGraphicsData); sRootBaseWithGraphicsData.m_pGraphics = pGraphics; // copy pGraphics'content to pEntity eStatus = A3DRootBaseWithGraphicsSet(pEntity, &sRootBaseWithGraphicsData); // free pGraphics eStatus = A3DEntityDelete(pGraphics); Never call :c:func:`~A3DEntityDelete` on an :c:type:`~A3DGraphics` obtained with :c:func:`~A3DRootBaseWithGraphicsGet`\ .
Returns
A3D_SUCCESSon success, or an error code on failure