
##################################
A3DGlobalInsertGraphDottingPattern
##################################

.. c:function:: A3DStatus A3DGlobalInsertGraphDottingPattern(const A3DGraphDottingPatternData *pData, A3DUns32 *puiIndexDottingPattern)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DGlobalInsertGraphDottingPattern(*const* :c:struct:`~A3DGraphDottingPatternData`\ * **pData**\ , :c:type:`~A3DUns32`\ * **puiIndexDottingPattern**\ )
   
   Insert a new dotting pattern into the global state, returning its index. 
   
   
      2.0
   
   
   
   When given an ``A3DGraphDottingPatternData``\ , the function clones the picture data for internal storage and returns a new index to further retrieval with ``A3DGlobalGetGraphPictureData``\ . In case of failure ``*puiIndexDottingPattern`` is unchanged.
   
   
   ::
   
      A3DGraphDottingPatternDatapattern_data;
      A3D_INITIALIZE_DATA(A3DGraphDottingPatternData,pattern_data);
      //Configurepattern_data...
      A3DUns32idx=A3D_DEFAULT_PATTERN_INDEX;
      
      A3DStatusresult=A3DGlobalInsertGraphDottingPattern(&pattern_data,&idx);
      assert(result==A3D_SUCCESS);
      assert(idx!=A3D_DEFAULT_PATTERN_INDEX);
   
   **Parameters**
   
   
      **pData**\ : The pattern data to insert. 
   
      **puiIndexDottingPattern**\ : The resulting index for the inserted pattern data. 
   
   
   **Returns**
   
   
      A3D_SUCCESS or an error code.
   
   




