Creates an XImage from a Stream.

[C#]
static XImage FromStream(Stream stream, XReadOptions options)

[Visual Basic]
Shared Function FromStream(stream As Stream, options As XReadOptions) As XImage


may throw Exception()

The stream will typically be one of the following types: JPEG, GIF, TIFF, BMP, PNG, PSD, PDB, EXIF, WMF, EMF, EPS, PS or SWF (Flash).

For details of additional formats which are supported and the way they are imported, see the ReadModule property and the the Doc.Read method.

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 property.

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.

None.