A3DRootBaseSet

A3DStatus A3DRootBaseSet(A3DRootBase *pRootBase, const A3DRootBaseData *pData)
A3DStatus A3DRootBaseSet(A3DRootBase* pRootBase, const A3DRootBaseData* pData)

Adds an:c:struct:~A3DRootBaseDatastructure to an existing PRC entity.

According to what is defined in the parameter pData, the:c:type:~A3DEntitywill be updated.

  • If:c:member:A3DRootBaseData::m_pcName <A3DRootBaseData.m_pcName>is initialized, the entity will be renamed.
  • Persistent and non-persistent id’s are systematically replaced.
  • The array:c:member:A3DRootBaseData::m_ppAttributes <A3DRootBaseData.m_ppAttributes>will be appended to the current attribute array of the Entity. To manipulate just the Entity attributes, please use the following functions:A3DRootBaseAttributeRemoveAll(),:c:func:~A3DRootBaseAttributeRemove,:c:func:~A3DRootBaseAttributeRemoveAt,:c:func:~A3DRootBaseAttributeAppend,:c:func:~A3DRootBaseAttributeAdd.

Returns

A3D_SUCCESSon success, or an error code on failure