Element: Image.

Icon: 

Text: An interactive image.

Description: An Image is a drawing element that displays a GIF or animated GIF image. The image is displayed at given coordinates with the size indicated in each direction (in 3D display modes, the largest of the sizes in X and Y is used for the horizontal dimension). The element can also be applied a rotation and a zoom factor.

Images respond to user interaction on their position coordinates (changing their position), invoking up to three different actions. The precise drawing position of the image with respect to the given coordinates can be chosen among several standard values.

Table of properties

Name Description Values accepted
Position and Size
X The X coordinate of the element. Any constant or variable of type double or int.
Y The Y coordinate of the element. Any constant or variable of type double or int.
Z The Z coordinate of the element. Any constant or variable of type double or int.
Size X The size of the element in the X direction. Any constant or variable of type double or int.
Size Y The size of the element in the Y direction. Any constant or variable of type double or int.
Size Z The size of the element in the Z direction. Any constant or variable of type double or int.
Scale X The zoom factor for the element in the X direction. Any constant or variable of type double or int.
Scale Y The zoom factor for the element in the Y direction. Any constant or variable of type double or int.
Scale Z The zoom factor for the element in the Z direction. Any constant or variable of type double or int.

Visibility and Interaction

Visible The visibility of the element. A boolean variable or one of the constants true or false.
Enabled Whether the element responds to user interaction. A boolean variable or one of the constants true or false.

Actions

On Press The action to invoke when the element is pressed. The Java code to invoke for the action. 
On Drag The action to invoke when the element is moved. The Java code to invoke for the action. 
On Release The action to invoke when the element is released. The Java code to invoke for the action. 
On Enter The action to invoke when the pointer enters the element. The Java code to invoke for the action. 
On Exit The action to invoke when the pointer leaves the element. The Java code to invoke for the action. 
Graphical Aspect
Image The image displayed by the element. Any constant or variable of type String, corresponding to a GIF or animated GIF image. The string indicates the path to the corresponding image file. The path can be relative to the working directory or an Internet URL.
Position The exact drawing position of the image relative to the element's coordinates. One of the following constants:
  • CENTERED. The shape is drawn with its center point on the element's coordinates. (Equivalent integer: 0).
  • NORTH. The shape is drawn with its top middle point on the element's coordinates. (Equivalent integer: 1).
  • SOUTH. The shape is drawn with its bottom middle point on the element's coordinates.  (Equivalent integer: 2).
  • EAST. The shape is drawn with its middle right point on the element's coordinates. (Equivalent integer: 3).
  • WEST. The shape is drawn with its middle left point on the element's coordinates.(Equivalent integer: 4).
  • NORTH_EAST. The shape is drawn with its top right point on the element's coordinates. (Equivalent integer: 5).
  • NORTH_WEST. The shape is drawn with its top left point on the element's coordinates. (Equivalent integer: 6).
  • SOUTH_EAST. The shape is drawn with its bottom right point on the element's coordinates. (Equivalent integer: 7).
  • SOUTH_WEST. The shape is drawn with its bottom left point on the element's coordinates. (Equivalent integer: 8).

Integer constants and variables are also accepted, using any of the values indicated in the parentheses above. This allows changing the position in run-time.

Rotate The (counter-clockwise) rotation angle to apply to the element. A constant or variable of type double for an angle in radians, or a constant or variable of type int for an angle in degrees.