Navigation:  Menu Commands > Options Menu >

Insert Image command (Options menu)

JR   Viewer

Print this Topic Previous pageReturn to chapter overviewNext page

This command allows you to insert up to 4 images (BMP, EMF, GIF, JPG, PNG, or TIF) that will be drawn on the plot. Enhanced metafiles must have an extension of ".emf" to work properly with this command.To delete an existing image, delete the text in the Filename text box or click the Delete button.

These images are only applicable to 2D views of your data.

Location

Distance from top left corner

If selected, then the anchor point of the image is measured from the top left corner of the plot, positive Y values down. Default units are those set with the Default dimensions setting of the General command on the Options menu, but may be overridden with the appropriate suffix (" or in=inches, pt=points, mm=millimeters, cm=centimeters).
If using this option you should also select Specify plot size with the Extents/Intervals/Size command on the Options menu. Otherwise the image may change location as the plot is resized or rendered to a different device or file.

NOTE: Images placed outside the plot extents may be clipped on the display, depending on the plot size set with Extents/Intervals/Size. If an image is clipped and this is not desirable, decrease the size of the plot with Extents/Intervals/Size. Images copied to the clipboard (both metafile and bitmap versions) and bitmap images saved to disk will generally be expanded as necessary to include all images.

Data space

If selected, then the anchor point is in the X and Y units of your plot. In this case if X or Y are outside the plot extents, the image will not be drawn.

Lock aspect ratio at 1:1

If checked then the image will be drawn at the aspect ratio of the image's width and height. As you change either the width or height entries, the height or width will also be changed to maintain the same aspect ratio.

Draw in background

If checked then the image is drawn before any other items. If unchecked then the image is drawn after all other items.

Transparency

Global transparency value applied to entire image. Valid range is 0 (invisible) to 255 (opaque). Default value = 255 (opaque). This setting is not used for metafiles.

NOTE: The image is not saved to a DPlot file. Instead, the filename of the image is saved within the file. The absolute path to the image is saved unless 1) the image resides in the same folder as the DPlot file, or 2) the image resides in My Documents\DPlot\Images. This presents a problem if copying a saved DPlot file to another system: if the path to the image does not exist on the target machine then the image will not be found. For the best results on multiple systems, copy the image file to the same folder where you will subsequently save the DPlot file, or to My Documents\DPlot\Images, before you specify that image. If you do that, the image location within the DPlot file will not include a path and the file will be expected to reside in one of those two locations. When reading a DPlot file, images saved to the DPlot file's folder take precedence over images saved to My Documents\DPlot\Images.

NOTE: Images with an alpha channel (e.g. 32-bit PNG) generally do not work well with this feature due to resizing. Areas along boundaries between transparent and opaque regions will often have strange artifacts.

 

Related macro commands

InsertImage

DeleteImage

 

 


Page url: https://www.dplot.com/help/index.htm?insert_image_command.htm