
###################################
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_MAKE_DATA(A3DGraphVPicturePatternData);
      //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.
   
   




