
#########################
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
   
   




