
##################################
A3DPDFRichMediaAnnotCreateFromFile
##################################

.. c:function:: A3DStatus A3DPDFRichMediaAnnotCreateFromFile(A3DPDFDocument *pDoc, const A3DPDFRichMediaAnnotData *pRichMediaAnnotData, const A3DUTF8Char *pcFileName, A3DPDFRichMediaAnnot **ppRichMediaAnnot)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DPDFRichMediaAnnotCreateFromFile(:c:type:`~A3DPDFDocument`\ * **pDoc**\ , *const* :c:struct:`~A3DPDFRichMediaAnnotData`\ * **pRichMediaAnnotData**\ , *const* :c:type:`~A3DUTF8Char`\ * **pcFileName**\ , :c:type:`~A3DPDFRichMediaAnnot`\ ** **ppRichMediaAnnot**\ )
   
   Function to create a RichMedia Annotation object. 
   
   The RichMedia Annotation object is primarily created with this function, and it should be inserted on the page with the functions :c:func:`~A3DPDFPageInsertRichMediaAnnot`\ .
   
   **Parameters**
   
   
      **pDoc**\ : The Document object to work with. 
   
      **pRichMediaAnnotData**\ : The RichMedia Annot parameters. 
   
      **pcFileName**\ : The file name of the rich media input file. The file format is deducted from file extension. Supported file formats for video are : QuickTime Movie (.mov) ; MPEG (.mp4, .m4v) ; 3GPP Movie (.3gp, .3g2). Supported file formats for audio are : mp3 
   
      **ppRichMediaAnnot**\ : The RichMedia Annot object created.
   
   
   **Returns**
   
   
      A3D_SUCCESS in case of success or an error code
   
   




