IIXC_Image::Load Method

From Tracker Software PDF SDK
Jump to: navigation, search
m
(See Also)
Line 24: Line 24:
 
:[[PXV:IIXC_Image|IIXC_Image]]
 
:[[PXV:IIXC_Image|IIXC_Image]]
 
:[[PXV:IXC_ImageLoadFlags|IXC_ImageLoadFlags]]
 
:[[PXV:IXC_ImageLoadFlags|IXC_ImageLoadFlags]]
 +
:[[PXV:IIXC_Inst_CreateEmptyImage|IIXC_Inst::CreateEmptyImage]]
 +
:[[PXV:IIXC_Image_LoadFromIStream|IIXC_Image::LoadFromIStream]]
 +
:[[PXV:IIXC_Image_LoadFromMemory|IIXC_Image::LoadFromMemory]]
 +
:[[PXV:IIXC_Image_Save|IIXC_Image::Save]]

Revision as of 04:07, 18 May 2015

This method loads an image from the selected file.

Syntax

HRESULT Load([in]                   LPWSTR  pImagePath,
             [in, defaultvalue(0)]  ULONG   nFlags);

Parameters

pImagePath
[in] Value of LPWSTR is the null-terminated file name string.
nFlags
[in, defaultvalue(0)] The following flag can be used to specify how the image will be loaded.

Return Value

Returns S_OK if operation was successful, or an error code if not.

Remarks

By default Load opens the image file, acquires information about all pages, decodes all of them, and closes the file. This is a good approach for single page files, but when dealing with large multi-paged files, this may cause unnecessary memory usage and performance degradation. To avoid this situation, Load should be called with the ImageLoad_Deferred flag. In this case, the image file will be analyzed, information about its pages will be acquired, but actual page data will not be decoded immediately.

See Also

IIXC_Image
IXC_ImageLoadFlags
IIXC_Inst::CreateEmptyImage
IIXC_Image::LoadFromIStream
IIXC_Image::LoadFromMemory
IIXC_Image::Save