If the XImage has been
created with an XReadOptions with ReadModule
that uses an Operation, the
operation will be invoked and the result depends on the operation.
Otherwise, this method gets an image from the Image object and adds
it to the current page returning the ID of the newly added
Adds the Selection of the
returning the ID of the newly added object.
Images embedded using this method are always inserted using
Indirect mode is not as fast as pass-through mode. However
it allows greater flexibility and the use of many different image
If the Transparent parameter is set to true then any
transparency information will be preserved. This allows you to add
formats such as transparent GIF, PNG with alpha channel, or images
with masks set using the Image.SetMask method.
The image is scaled to fill the current Rect. It is transformed using the
If the width or height of the current rectangle is zero the
image is auto-sized. If you are working in TopDown mode the image is
positioned with its top left pinned at the location indicated by
the rectangle. If you are not in TopDown mode the bottom left of
the image is pinned at the location indicated by the rectangle. In
both cases the natural dimensions of the supplied image are used to
determine the displayed width and height resulting in a 72 dpi