
####################
A3DMiscAttributeData
####################

.. c:struct:: A3DMiscAttributeData

   A structure that specifies descriptive names and modeller data.
   
   
      2.0
   
   
   The ``A3DMiscAttributeData`` structure specifies a descriptive name as a character string or integer. It can also reference an array of ``A3DMiscSingleAttributeData`` structure, which specifies modeler data.
   
   If ``m_bTitleIsInt`` is ``A3DTrue``\ , ``m_pcTitle`` will be parsed as an ``A3DUns32``\ .
   
   .. code-block:: c
   
      A3DVoid setAttributesSample(A3DEntity* pEntity)
      {
          A3DMiscAttribute* pAttributes[2];
      
          // ----------------------------------------------------------------
          // creation of the first A3DMiscAttributeData
      
          A3DMiscSingleAttributeData pSingleAttributes[2];
          // creation of the first A3DMiscSingleAttribute
          A3DMiscSingleAttributeData sSingleAttributeData1 = A3D_MAKE_DATA(A3DMiscSingleAttributeData);
          sSingleAttributeData1.m_eType = kA3DModellerAttributeTypeString;
          sSingleAttributeData1.m_pcTitle = (char*) "First single attribute";
          sSingleAttributeData1.m_pcData = (char*) "Simple attribute 1 demonstration";
          pSingleAttributes[0] = sSingleAttributeData1;
          // creation of the second A3DMiscSingleAttribute
          A3DMiscSingleAttributeData sSingleAttributeData2 = A3D_MAKE_DATA(A3DMiscSingleAttributeData);
          sSingleAttributeData2.m_eType = kA3DModellerAttributeTypeString;
          sSingleAttributeData2.m_pcTitle = (char*) "Second single attribute";
          sSingleAttributeData2.m_pcData = (char*) "Simple attribute 2 demonstration";
          pSingleAttributes[1] = sSingleAttributeData2;
      
          // creation of the first A3DMiscAttribute
          A3DMiscAttributeData sAttributeData1 = A3D_MAKE_DATA(A3DMiscAttributeData);
          sAttributeData1.m_pcTitle = "First attribute";
          sAttributeData1.m_bTitleIsInt = false;
          sAttributeData1.m_pSingleAttributesData = pSingleAttributes;
          sAttributeData1.m_uiSize = 2;
          A3DMiscAttributeCreate(&sAttributeData1, &pAttributes[0]);
      
          // ----------------------------------------------------------------
          // creation of the second A3DMiscAttribute
          A3DMiscAttributeData sAttributeData2 = A3D_MAKE_DATA(A3DMiscAttributeData);
          A3DUns32 uiTitleAsInt = 12345;
          sAttributeData2.m_pcTitle = (A3DUTF8Char*)(&uiTitleAsInt);
          sAttributeData2.m_bTitleIsInt = true;
          sAttributeData2.m_uiSize = 0;
          A3DMiscAttributeCreate(&sAttributeData2, &pAttributes[1]);
      
      
          // ----------------------------------------------------------------
          // creation of the A3DRootBase
          A3DRootBaseData sRootData = A3D_MAKE_DATA(A3DRootBaseData);
          sRootData.m_pcName = (char*) "Root base information";
          sRootData.m_ppAttributes = pAttributes;
          sRootData.m_uiSize = 2;
          A3DRootBaseSet(pEntity, &sRootData);
      
          for(A3DUns32 i = 0; i < sRootData.m_uiSize; ++i)
          {
              A3DEntityDelete(sRootData.m_ppAttributes[i]);
          }
      }
   
   
   Index
   =====
   
   .. rubric:: Variables
   
   
   .. rst-class:: api-xref-list
   
   
   * :c:member:`~A3DMiscAttributeData.m_asSingleAttributesData`
   * :c:member:`~A3DMiscAttributeData.m_bTitleIsInt`
   * :c:member:`~A3DMiscAttributeData.m_pcTitle`
   * :c:member:`~A3DMiscAttributeData.m_uiSize`
   
   



.. rst-class:: kind-group kind-variable

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


.. c:member:: A3DBool A3DMiscAttributeData.m_bTitleIsInt

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      A value of ``A3DTrue`` indicates that ``m_pcTitle`` member represents an integer.
      



.. c:member:: A3DUTF8Char* A3DMiscAttributeData.m_pcTitle

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DUTF8Char`\ \*
      
      Title as string.
      



.. c:member:: A3DUns32 A3DMiscAttributeData.m_uiSize

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DUns32`
      
      Size of m_asSingleAttributesData.
      



.. c:member:: A3DMiscSingleAttributeData* A3DMiscAttributeData.m_asSingleAttributesData

      .. rst-class:: sig-pretty-signature
      
         | :c:struct:`~A3DMiscSingleAttributeData`\ \*
      
      Pointer to an array of single attribute structures.
      




