
###################################
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.
   
   .. code-block:: c
   
      A3DGraphVPicturePatternData pattern_data = A3D_MAKE_DATA(A3DGraphVPicturePatternData);
      // Configure pattern_data...
      A3DUns32 idx = A3D_DEFAULT_PATTERN_INDEX;
      
      A3DStatus result = A3DGlobalInsertGraphVPicturePattern(&pattern_data, &idx);
      assert(result == A3D_SUCCESS);
      assert(idx != A3D_DEFAULT_PATTERN_INDEX);
   
   **Return Values**
   
   
      **A3D_SUCCESS**\ : in case of success.
   
      **A3D_INITIALIZE_NOT_CALLED**\ : if the library is not initialized.
   
      **A3D_INVALID_DATA_STRUCT_SIZE**\ : if ``pData`` is incorrectly initialized
   
      **A3D_INVALID_DATA_STRUCT_NULL**\ : if ``pData`` is null.
   
      **A3D_ERROR**\ : when an internal error is encountered while storing the pattern data.
   
   
   
      :c:struct:`~A3DGraphVPicturePatternData`
   
   
   
      :c:func:`~A3DGlobalGetGraphVPicturePatternData`
   
   
   
      :c:func:`~A3DTessBaseSet`
   
   
   
      :c:func:`~A3DTessMarkupCreate`
   
   
   
      :c:struct:`~A3DTessBaseData`
   
   
   
      :c:struct:`~A3DTessMarkupData`
   
   
   
      :c:struct:`~A3DGraphDottingPatternData`
   
   
   
      :c:struct:`~A3DGraphSolidPatternData`
   
   
   
      :c:struct:`~A3DGraphVPicturePatternData`
   
   
   **Parameters**
   
   
      **pData**\ : The pattern data to insert.
   
      **puiIndexVPicturePattern**\ : The resulting index for the inserted pattern data.
   
   
   **Returns**
   
   
      A3D_SUCCESS or an error code.
   
   




