IPXC_Document::AddImageFromFile Method
From PDF XChange PDF SDK
m (Automatic page editing by robot) |
m (Automatic page editing by robot) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 8: | Line 8: | ||
== Syntax == | == Syntax == | ||
| − | <pre class="brush:cpp;gutter:false">HRESULT AddImageFromFile([in] LPWSTR | + | <pre class="brush:cpp;gutter:false">HRESULT AddImageFromFile([in] LPWSTR sFileName, |
| − | [in, defaultvalue(0)] ULONG | + | [in, defaultvalue(0)] ULONG nPage, |
| − | [in, defaultvalue(0)] ULONG | + | [in, defaultvalue(0)] ULONG nFlags, |
| − | [out, retval] IPXC_Image** | + | [out, retval] IPXC_Image** pImage);</pre> |
== Parameters == | == Parameters == | ||
| − | ; | + | ;sFileName |
:[in] Specifies a full file name of the image file. The file should be an image in one of supported format: <tt>BMP</tt>, <tt>PNG</tt>, <tt>GIF</tt>, <tt>ICO</tt>, <tt>PBM</tt>, <tt>PGM</tt>, <tt>PPM</tt>, <tt>JBIG</tt>, <tt>JBIG2</tt>, <tt>JPEG</tt>, <tt>JPEG2000</tt>, <tt>PXC</tt>, <tt>DCX</tt>, <tt>TGA</tt> or <tt>TIFF</tt>. | :[in] Specifies a full file name of the image file. The file should be an image in one of supported format: <tt>BMP</tt>, <tt>PNG</tt>, <tt>GIF</tt>, <tt>ICO</tt>, <tt>PBM</tt>, <tt>PGM</tt>, <tt>PPM</tt>, <tt>JBIG</tt>, <tt>JBIG2</tt>, <tt>JPEG</tt>, <tt>JPEG2000</tt>, <tt>PXC</tt>, <tt>DCX</tt>, <tt>TGA</tt> or <tt>TIFF</tt>. | ||
| − | ; | + | ;nPage |
:[in, defaultvalue(0)] Specifies the 0-based page number of multipaged image formats (like, <tt>TIFF</tt> or <tt>ICO</tt>) that should be taken. | :[in, defaultvalue(0)] Specifies the 0-based page number of multipaged image formats (like, <tt>TIFF</tt> or <tt>ICO</tt>) that should be taken. | ||
| − | ; | + | ;nFlags |
:[in, defaultvalue(0)] Specifies additional [[PXV:PXC_ImageToXObjectFlags|flags]] of image creation. | :[in, defaultvalue(0)] Specifies additional [[PXV:PXC_ImageToXObjectFlags|flags]] of image creation. | ||
| − | ; | + | ;pImage |
:[out, retval] Returns a [[PXV:IPXC_Image|IPXC_Image]] object if new image was successfully added. | :[out, retval] Returns a [[PXV:IPXC_Image|IPXC_Image]] object if new image was successfully added. | ||
| Line 27: | Line 27: | ||
== See Also == | == See Also == | ||
| − | [[PXV:IPXC_Document|IPXC_Document | + | [[PXV:IPXC_Document|IPXC_Document]] |
Latest revision as of 23:07, 30 November 2017
Adds new image to the document from specified image file. Image data compressed based on image type (monochrome, indexed, true color) and corresponding encoder array.
Syntax
HRESULT AddImageFromFile([in] LPWSTR sFileName,
[in, defaultvalue(0)] ULONG nPage,
[in, defaultvalue(0)] ULONG nFlags,
[out, retval] IPXC_Image** pImage);
Parameters
- sFileName
- [in] Specifies a full file name of the image file. The file should be an image in one of supported format: BMP, PNG, GIF, ICO, PBM, PGM, PPM, JBIG, JBIG2, JPEG, JPEG2000, PXC, DCX, TGA or TIFF.
- nPage
- [in, defaultvalue(0)] Specifies the 0-based page number of multipaged image formats (like, TIFF or ICO) that should be taken.
- nFlags
- [in, defaultvalue(0)] Specifies additional flags of image creation.
- pImage
- [out, retval] Returns a IPXC_Image object if new image was successfully added.
Return Value
Returns S_OK if operation was successful or error code in other cases.
