
###############################
A3DGlobalInsertGraphLinePattern
###############################

.. c:function:: A3DStatus A3DGlobalInsertGraphLinePattern(const A3DGraphLinePatternData *pData, A3DUns32 *puiIndexLinePattern)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DGlobalInsertGraphLinePattern(*const* :c:struct:`~A3DGraphLinePatternData`\ \* **pData**\ , :c:type:`~A3DUns32`\ \* **puiIndexLinePattern**\ )
   
   Creates a line pattern, returning its index.
   
   
      2.0
   
   
   When given an ``A3DGraphLinePatternData``\ , the function searches for an already existing descriptor of the same value and returns its index. If the descriptor does not exist, it is created and a new index is returned. In case of failure ``*puiIndexRgbColor``\ is unchanged.
   
   
   ::
   
      A3DDouble[]aLengths={1.0,3.0};
      A3DGraphLinePatternDatadescriptor=A3D_MAKE_DATA(A3DGraphLinePatternData);
      descriptor.m_uiNumberOfLengths=2;
      descriptor.m_pdLengths=aLengths;
      descriptor.m_dPhase=0.0;
      descriptor.m_bRealLength=A3D_TRUE;
      
      A3DUns32idx_0=A3D_DEFAULT_LINEPATTERN_INDEX;
      
      A3DStatusresult=A3DGlobalInsertGraphLinePattern(&descriptor,&idx_0);
      assert(result==A3D_SUCCESS);
      
      Secondinsertionwiththesamedata,expectindextobethesame.
      A3DUns32idx_1=A3D_DEFAULT_LINEPATTERN_INDEX;
      result=A3DGlobalInsertGraphLinePattern(&descriptor,&idx_1);
      assert(result==A3D_SUCCESS);
      assert(idx_0==idx_1);
   
   **Parameters**
   
   
      **pData**\ : The line pattern descriptor to insert.
   
      **puiIndexLinePattern**\ : The resulting index for the line pattern.
   
   
   **Returns**
   
   
      A3D_SUCCESS or an error code.
   
   




