The stream will typically be one of the following types: JPEG,
GIF, TIFF, BMP, PNG, PSD, PDB, EXIF, WMF, EMF, EPS, PS or SWF
The advantage of this method over SetStream, is that you can specify the ReadModule
you would like to use. This allows precise control over the way
that your graphics are imported.
In addition you can also control the way that transparency is
treated using the PreserveTransparency
For details of the formats supported and the way they are
imported, see the ReadModule
property and the the Doc.Read method.
The object takes the ownership of the XReadOptions, which is
disposed of when the object is disposed of. You can make the object
release the ownership without disposing of the XReadOptions using
the parameterized overloads of Dispose
and Clear. The XReadOptions must not be
modified as long as the object has the ownership.
If the returned XImage has the NeedsStream property set to true, you must
ensure that the specified stream will remain present and unmodified
until the XImage object is cleared, disposed of, or
garbage-collected. When this happens the XImage takes ownership of
the Stream, which is disposed of when the object is disposed of.
You can make the object release the ownership, without disposing of
the Stream using the parameterized overloads of Dispose and Clear.