Image Display Registry entry
Specify an image (and sound and hint if required) to display along with Summary Data in a module window.
Note: Details about Image Displays can be found here.
Usage
This Registry entry can be assigned to users and groups:
Key | User | User | Group | Group | Group | Group |
---|---|---|---|---|---|---|
Key 1 | User
|
User
|
Group
|
Group
|
Group
|
Group
|
Key 2 | user | user | group | group | Default
|
Default
|
Key 3 | Table
|
Table
|
Table
|
Table
|
Table
|
Table
|
Key 4 | table | Default
|
table | Default
|
table | Default
|
Key 5 | Image Display
|
|||||
Key 6 | column | |||||
Key 7 | value | |||||
Value | image[;sound[;hint]] |
User
|
user | Table
|
table | Image Display
|
column | value | image[;sound[;hint]] |
User
|
user | Table
|
Default
|
Image Display
|
column | value | image[;sound[;hint]] |
Group
|
group | Table
|
table | Image Display
|
column | value | image[;sound[;hint]] |
Group
|
group | Table
|
Default
|
Image Display
|
column | value | image[;sound[;hint]] |
Group
|
Default
|
Table
|
table | Image Display
|
column | value | image[;sound[;hint]] |
Group
|
Default
|
Table
|
Default
|
Image Display
|
column | value | image[;sound[;hint]] |
It is also possible to test for the existence of data in a field rather than for an exact value using the following variations:
Group
|
Default
|
Table
|
table | Image Display
|
column | value | image[;sound[;hint]] |
Group
|
Default
|
Table
|
Default
|
Image Display
|
column | value | image[;sound[;hint]] |
where:
column |
|
||||||||
value |
is the value to search for in column. If value is found in column (or is one of the values in a table), the rest of the Registry entry is evaluated. To be matched, value must be found in column exactly as specified and on its own line / in its own row. For example, if value = warning and the data in column is:
The same holds for rows in a column:
|
||||||||
image |
is the name of the image file to display. The file must be located on the EMu server in the Which resolution of an image is pulled back from the server
When retrieving an image file from the server, EMu will first try to retrieve a resolution specific image (21x21 or 42x42). If this image is not found, the specified image file is retrieved. The resolution specific image makes it possible to have two images per image display entry, one shown with Thumbnails disabled and the other shown with Thumbnails enabled. If Thumbnails (View>Thumbnails) is disabled, the file image21x21.ext is first tried, then image.ext. For example, the Registry entry:
will result in EMu first trying to retrieve toxic21x21.jpg; if this file is not found in ~emu/client/etc/images, then toxic.jpg would be fetched. If Thumbnails is enabled and the above Registry entry used, EMu would first try to retrieve toxic42x42.jpg; if this file is not found in ~emu/client/etc/images, then toxic.jpg would be shown. |
||||||||
sound |
is optional. The sound will be played after the image is displayed. The sound file must be located on the EMu server in the |
||||||||
hint |
is optional. The hint is shown when the mouse cursor hovers over the displayed image. The hint message is multilingual, with the text for the prompt language being used. |
||||||||
|
will match an empty column. |
||||||||
|
will match a column with data. |
Note: It is possible to display multiple images. If the same image would be displayed more than once, only the first instance is shown. Hence it is possible to display just one image display where multiple values are matched. Also the same named sound file will only be played once. See last example below for details.
Example 1
In this example, to identify that an object contains hazardous materials, the field HazHazardous_tab contains the term toxic
. In order for a warning image to display and sound to play when the record is accessed, the following Registry entry may be used:
Key | Setting | Description |
---|---|---|
Key 1 | Group
|
|
Key 2 | Default
|
|
Key 3 | Table
|
|
Key 4 | ecatalogue
|
|
Key 5 | Image Display
|
|
Key 6 | HazHazardous_tab
|
The HazHazardous_tab field is searched for the value (toxic ) and if found, the image will be displayed and the sound played. |
Key 7 | toxic | |
Value |
toxic.jpg;toxic.wav
|
These files must be stored on the EMu server in the ~emu/client/etc/images directory. |
Example 2
In this example a warning image is displayed and a sound played when a record is accessed where there is any value in the HazHazardous_tab field:
Key | Setting |
---|---|
Key 1 | Group
|
Key 2 | Default
|
Key 3 | Table
|
Key 4 | ecatalogue
|
Key 5 | Image Display
|
Key 6 | HazHazardous_tab
|
Key 7 | NOT NULL
|
Value |
toxic.jpg;toxic.wav
|
Example 3
In this example images are displayed if a record contains certain chemicals. A hint is given for each chemical:
Column |
Value |
Image |
Sound |
Hint |
---|---|---|---|---|
MatMaterials_tab
|
Sulphur
|
sulphur.gif
|
-
|
Sulpher
|
Magnesium
|
magnesium.gif
|
-
|
Magnesium
|
|
Uranium
|
uranium.gif
|
warning.wav
|
Uranium
|
|
Plutonium
|
plutonium.gif
|
warning.wav
|
Plutonium
|
The following Registry entries may be used:
Key | Setting | Description |
---|---|---|
Key 1 | Group
|
|
Key 2 | Default
|
|
Key 3 | Table
|
|
Key 4 | ecatalogue
|
|
Key 5 | Image Display
|
|
Key 6 | MatMaterial_tab
|
MatMaterial_tab is searched for the word sulphur; if found, the sulphur.gif image displays; no sound is played, but there is a hint that states sulphur. |
Key 7 | sulphur
|
|
Value | sulphur.gif;;Sulphur
|
Key | Setting |
---|---|
Key 1 | Group
|
Key 2 | Default
|
Key 3 | Table
|
Key 4 | ecatalogue
|
Key 5 | Image Display
|
Key 6 | MatMaterial_tab
|
Key 7 | magnesium
|
Value | magnesium.gif;;Magnesium
|
Key | Setting |
---|---|
Key 1 | Group
|
Key 2 | Default
|
Key 3 | Table
|
Key 4 | ecatalogue
|
Key 5 | Image Display
|
Key 6 | MatMaterial_tab
|
Key 7 | uranium
|
Value | uranium.gif;warning.wav;Uranium
|
Key | Setting |
---|---|
Key 1 | Group
|
Key 2 | Default
|
Key 3 | Table
|
Key 4 | ecatalogue
|
Key 5 | Image Display
|
Key 6 | MatMaterial_tab
|
Key 7 | plutonium
|
Value | plutonium.gif;warning.wav;Plutonium
|
If a record contains more than one of the materials listed above, an image will display for each material.
Example 4: Bi-lingual hint
If the column MatMaterials_tab contains the word toxic
, the image is shown with a hint. The following Registry entry may be used:
Key | Setting | Description |
---|---|---|
Key 1 | Group
|
|
Key 2 | Default
|
|
Key 3 | Table
|
|
Key 4 | ecatalogue
|
|
Key 5 | Image Display
|
|
Key 6 | MatMaterial_tab
|
|
Key 7 | toxic
|
|
Value | toxic.gif;;Toxic;:;toxique
|
The correct hint, toxic (English) or toxique (French) will be displayed depending on the prompt language selected by the user. |
Example 5
If, for example, the same image display is specified for a list of chemicals, only one image will display if a record contains more than one of the chemicals.
If the following Registry entries existed and a record contained cyanide and sulphur, hazardous.gif would only display once:
Key | Setting 1 | Setting 2 |
---|---|---|
Key 1 | Group
|
Group
|
Key 2 | Default
|
Default
|
Key 3 | Table
|
Table
|
Key 4 | ecatalogue
|
ecatalogue
|
Key 5 | Image Display
|
Image Display
|
Key 6 | MatMaterial_tab
|
MatMaterial_tab
|
Key 7 | sulphur
|
cyanide
|
Value | hazardous.gif;warning.wav;Hazardous
|
hazardous.gif;warning.wav;Hazardous
|
Key | Setting 3 | Setting 4 |
Key 1 | Group
|
Group
|
Key 2 | Default
|
Default
|
Key 3 | Table
|
Table
|
Key 4 | ecatalogue
|
ecatalogue
|
Key 5 | Image Display
|
Image Display
|
Key 6 | MatMaterial_tab
|
MatMaterial_tab
|
Key 7 | uranium
|
plutonium
|
Value | hazardous.gif;warning.wav;Hazardous
|
hazardous.gif;warning.wav;Hazardous
|