Skip to main content
This method opens an image file from the input stream implemented by the user, and adds the pages corresponding to the opened file to the document. In Windows, this method differs from the AddImageFileFromMemory method in that it can be used when the Engine object is created using the OutprocLoader object.

​
Syntax

​
C++

HRESULT AddImageFileFromStream(
  IReadStream*            Stream,
  IImagePasswordCallback* Callback,
  IPrepareImageMode*      PrepareMode,
  IIntsCollection*        PageIndices,
  BSTR                    FileName
);

​
C#

void AddImageFileFromStream(
  IReadStream             Stream,
  IImagePasswordCallback  Callback,
  IPrepareImageMode       PrepareMode,
  IIntsCollection         PageIndices,
  string                  FileName
);

​
Visual Basic .NET

Sub AddImageFileFromStream( _
  Stream As IReadStream, _
  Callback As IImagePasswordCallback, _
  [PrepareMode As IPrepareImageMode = Nothing], _
  [PageIndices As IIntsCollection = Nothing], _
  [FileName As String = "0"] _
)

​
Parameters

Stream [in] Refers to the interface of the user-implemented object of the type IReadStream which contains the image file to be added to the document. Callback [in] This variable refers to the interface of the user-implemented object of the type ImagePasswordCallback which is used to handle possible password requests for accessing images in PDF format. This parameter is optional and may be 0, in which case password-protected files cannot be processed. PrepareMode [in] Refers to the PrepareImageMode object which specifies how an image will be preprocessed during opening. This parameter is optional and may be 0, in which case either the default parameters are used, or, if a profile has been loaded, the parameters set by this profile are used. PageIndices [in] This parameter refers to the IntsCollection object which specifies the indices of the pages which have to be added to the document. Note that repeated indices are not allowed. To add the same page several times, please call this method several times.
This parameter is optional and may be 0, in which case all the pages of the opened file will be added to the document. FileName [in] Specifies the name of the image file. This information is used to define the format of the file, if not explicitly specified, and in error messages. This parameter is optional and may be 0. In Windows and Linux: For opening the office formats, pass the name of the document with its extension.

​
Return values

This method has no specific return values. It returns the standard return values of ABBYY FineReader Engine functions.

​
Remarks

  • Files in SVG format cannot be opened from stream.
  • When opening a PDF Portfolio file using this method, its cover is always included in the output file.
  • This method may report events to the listeners attached to the IConnectionPointContainer interface of the FRDocument object.
  • For Linux and Windows:
  • For Linux: This method does not work if the Engine object is loaded as an out-of-process server.
  • For Windows: This method does not support WIC-compatible files opening.

​
See also

FRDocument