
#########################
A3DPDFImageCreateFromFile
#########################

.. c:function:: A3DStatus A3DPDFImageCreateFromFile(A3DPDFDocument *pDoc, const A3DUTF8Char *pcFileName, const A3DPDFEImageFormat eFormat, A3DPDFImage **ppImage)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DPDFImageCreateFromFile(:c:type:`~A3DPDFDocument`\ * **pDoc**\ , *const* :c:type:`~A3DUTF8Char`\ * **pcFileName**\ , *const* :c:enum:`~A3DPDFEImageFormat` **eFormat**\ , :c:type:`~A3DPDFImage`\ ** **ppImage**\ )
   
   Function to create an image object from a file. 
   
   The image object is primarily created with this function, and it should be positioned on the page with the function :c:func:`~A3DPDFPageInsertImage2`\ .
   
   **Parameters**
   
   
      **pDoc**\ : The Document object to work with. 
   
      **pcFileName**\ : File name of the image file. 
   
      **eFormat**\ : Format of the image. If kA3DPDFImageFormatUnknown, the format is deducted from file extension. 
   
      **ppImage**\ : The Image object created.
   
   
   **Returns**
   
   
      A3D_SUCCESS in case of success or an error code
   
   




