Sfairadora

  • Reference Guide

Image Label

This image label dispel allows you to insert a static image into a presentation. If you define the image by means of an Enki language function, the image can graphically reflect the document state. The image can also react to mouse events.
If you wish to display an image stored in the document data, the image editor should be used.

Display

Item
Description
Image
The image displayed. The image is entered using the image editor.
If you wish to define the image by means of an Enki language function, see the Bitmap and Icon Functions chapter.
Borders
The width of the margins around the image. Values for all four directions can be specified individually.
Image dimension
You can specify the image height and width in pixels. If no values are specified, the real dimensions of the image are used. However, if the image dimensions exceed the screen (application main window) size and the Do not downscale under image dimension option is not checked, the image is reduced so that all of it is visible.
The dimensions specify the optimal required image size when displayed. If the Do not downscale under image dimension/ Do not upscale above image dimension options are not checked, the user can change the displayed size by changing the window size.
Keep aspect ratio
If checked, the height and the width are modified simultaneously so that the aspect ratio is preserved. However, if both image dimensions are specified, the specified values are used.
Do not downscale under image dimension
If checked, the image size cannot be reduced under the image dimensions. The dispel retains the size of the image, and a scrollbar is displayed in the window containing the image.
Do not upscale above image dimension
If checked, the dispel size cannot exceed the image dimensions even if expansion was required by alignment or if the window size was expanded manually.
Scaling options
Determines the method used to resize the image:
halftone
an average of the color values of the original pixels of the image is used (This is the default setting. Older versions of Windows may not support this function – the delete line option is used instead.)
delete lines
superfluous lines are simply removed when downscaling and duplicated when upscaling.
merge black (AND)
for two-color images: when downsizing, and one of the original pixels is black, the resulting pixel will be black too. This option is suitable for line graphics with white background.
merge white (OR)
for two-color images: when downsizing, and one of the original pixels is white, the resulting pixel will be white too. This option is suitable for line graphics with black background.

Functionality

Item
Description
Mouse handling
This function allows the dispel to react to mouse events. Any mouse event (move of the mouse pointer, click …) on the image calls this function. A detailed description can be found in the Mouse Handling chapter.
Definition type: Image_label_def