Entity Base

Creates and accesses a hierarchy of descriptive names and modeller data that can be applied to any PRC entity.

Entity type is:c:enumerator:~kA3DTypeRootBase

This module lets you create a hierarchy of descriptive names and modeller data (called*root-level attributes*) that can be applied to any PRC entity. These attributes are packaged as an:c:type:~A3DRootBaseentity that is referenced from the PRC entity they describe.

The following sample code shows how to create root-level attributes for any PRC entity. In this case, the attributes include modeller data. For restrictions on specifying modeller data, see:c:struct:~A3DMiscAttributeData.

A3DVoidsetAttributes(A3DEntity*p)
{
A3DMiscAttribute*pAttr[3];

A3DMiscSingleAttributeDataSingle=A3D_MAKE_DATA(A3DMiscSingleAttributeData);

Single.m_eType=kA3DModellerAttributeTypeString;
Single.m_pcTitle="Title";
Single.m_pcData="SimpleB-repbuildingdemonstration";

A3DMiscAttributeDatasAttribs=A3D_MAKE_DATA(A3DMiscAttributeData);

sAttribs.m_pcTitle=Single.m_pcTitle;
sAttribs.m_asSingleAttributesData=&Single;
sAttribs.m_uiSize=1;
A3DInt32iRet=A3DMiscAttributeCreate(&sAttribs,&pAttr[0]);

Single.m_pcTitle="Author";
Single.m_pcData="HOOPSExchange";
sAttribs.m_pcTitle=Single.m_pcTitle;
iRet=A3DMiscAttributeCreate(&sAttribs,&pAttr[1]);

Single.m_pcTitle="Company";
Single.m_pcData="TechSoft3D";
sAttribs.m_pcTitle=Single.m_pcTitle;
iRet=A3DMiscAttributeCreate(&sAttribs,&pAttr[2]);

A3DRootBaseDatasRootData=A3D_MAKE_DATA(A3DRootBaseData);

sRootData.m_pcName="Trimmedsurface";
sRootData.m_ppAttributes=pAttr;
sRootData.m_uiSize=3;
iRet=A3DRootBaseSet(p,&sRootData);

//cleaninguptheallocatedattributes
for(A3DUns32i=0;i<sRootData.m_uiSize;++i)
{
A3DEntityDelete(sRootData.m_ppAttributes[i]);
}
}

The following illustration shows the result of the sample code.

The sample code creates an:c:type:~A3DRootBaseentity that houses three:c:type:~A3DMiscAttributeentities, each of which reference an:c:struct:~A3DMiscSingleAttributeDatastructure. Each:c:struct:~A3DMiscSingleAttributeDatastructure provides modeller data of type:c:enumerator:~kA3DModellerAttributeTypeString.

Returns

A3D_SUCCESSon success, or an error code on failure

Topics

Structures

Functions