Labels objects that feature the image property can be customized to display your image (.gif, .jpg or .png) file.

The webLabelFlag property allows select Labels objects to be rendered as HTML elements in a thin client deployment.

Types of Labels Objects

Value Labels The value and label properties are used, respectively, to display numeric and text data, either from a data attachment or static values. Value Labels that feature Alert properties can be designed to change color according to numeric values from your data attachment.
Vu Labels Similar to Value Labels, Vu Labels contain the value and label properties as well as featuring vu meters to display numeric values from your data attachment.
ValueString Labels The valueString and label properties are both used to display text data, either from a data attachment or static values.
Text Only / ValueString Only Labels The Text Only Label can be rotated at any angle and is limited to a static value. The ValueString Only Label can display text data, either from a data attachment or a static value.

image Property

Labels objects that feature the image property can be customized to display your image (.gif, .jpg or .png) file. Click in the image Property Value field and type the name of the image. Or, select the  button to open the Select Image dialog containing up to three directories:

• Current Directory - Contains images in the current directory and one level of subdirectories.
• Custom Image Library - If you have specified a custom image library, this directory contains those images. See Creating a Custom Image Library for details.
• Symbol Library - Contains symbolic images (for example, symbols for various types of hardware, shapes, lights, arrows, etc.).

Navigate to the image you want to use and select it. A preview of the image appears in the pane to the right. Click OK or Apply to set the image on your object. If an image is not listed, enter the name of the file, including the relative path.

To scale your image to the size of the object, check the imageScaleFlag. The visFlag property controls the visibility of the object. The transparencyPercent property controls the transparency of the object.

NOTE: The sample display file general_objects.rtv (located in demos/tutorials) features information on working with objects from the General tab.

Creating a Custom Image Library
The custom image library enables you to make your own images available in the Select Image dialog. To add your own image library, perform the following steps.

1.  Place your images .jar file and add it to the RTV_USERPATH environment variable. The images must be in a directory (not in the top level of the jar). They can be organized into subdirectories of one top level directory.

2.  In the Display Builder, select Tools/Builder Options and, in the Custom Image Library Path field, set the path to the directory containing your images .jar file. 

For example, if you have a jar with this directory structure:

com/mycompany/Images
com/mycompany/Images/Blue Images
com/mycompany/Images/Red Images
com/mycompany/Images/Green Images

you would enter com/mycompany/Images. This adds a directory named Images to the tree in the Select Image dialog. The Images directory will have three subdirectories: Blue Images, Red Images and Green Images. Only directories containing images are added to the Select Image dialog.

To access the images, you can edit any property that allows you to set an image on an object (for example, the image, barImage and filterProperties properties), or edit the File>Background Properties>Image Name field.

webLabelFlag

In a Display Server deployment when the webLabelFlag property is selected, the object will be rendered as an HTML element in the thin client rather than rendered in the image by the Display Server. This allows the Display Server to update the individual object (if necessary) when the display is refreshed, instead of regenerating the entire display image. In some cases, this can improve the performance of the  Display Server and thin client.

The webLabelFlag property also enables you to select an object's text and copy it to the clipboard.

Labels objects that support webLabelFlag are:

obj_label05
obj_label05s
obj_label11
obj_label11s
obj_text01
obj_rect_il
obj_rect_ilv
obj_rect_ilvs

Use the following entry to set webLabelFlag in an rtview stylesheet (.rts) file:

rtv-all {
webLabelFlag: 1;
}

Limitations
In the following situations, an object with webLabelFlag selected will still be rendered in the image by the Display Server:

• Display is opened in Internet Explorer 8 or older.
• Display Server is run with the -nohtml5 option set on the command line.
• bgStyle property is set to "Round Rectangle" (obj_label*)
• rotationAngle property with nonzero value (obj_text01 with rotated text)
• labelTextPosY is set to "Tab Top" (obj_rect*)
• labelTextPosY is set to "Title Top" and bgBorderFlag is set to "true" (obj_rect*) 
• obj_rect* with non-html object above it in Z-order which overlaps (e.g. obj_rect* used as a background behind several meter objects)
• Object is inside an object grid, and is not inside a composite object in that grid.

In other cases, an object may have a slightly different appearance in the thin client when it is rendered as HTML:

• bgGradientMode property set to "Diagonal Edge" or "Diagonal Center" is treated as "Vertical Edge" (Only vertical and horizontal gradients are supported on HTML objects in the thin client.)
• bgShadowFlag property is ignored