
###################################
A3DGlobalInsertGraphVPicturePattern
###################################

.. c:function:: A3DStatus A3DGlobalInsertGraphVPicturePattern(const A3DGraphVPicturePatternData *pData, A3DUns32 *puiIndexVPicturePattern)

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




