Clock Object for Canvas

Note: For Canvas Series only.

Overview of Clock Object

Clock object displays the time that is read from a specific register, or if desired, is written to the register. Clock object can be either Analog clock format or Digital clock format. Clock object uses 3 consecutive 16 Bit Registers. The Clock object can be accessed through the Screens Project Toolbox > Live Graphic Data > Clock. User must be on a Screen and not in the Main work area in order to see the Objects Project Toolbox items.

Clock Data Properties

Controller Register

Starting reference of 3 consecutive registers - This object may be reference to %SR44 to access system time, or any 16-bit Registers that uses 48 consecutive bits for the format specified. Current register value is converted to specified time format every 150ms and displayed in the object. If editable, a new value may be entered which is written to the control register.

Time Format

register16 + 0: seconds
register16 + 1: minutes
register16 + 2: hours

Object Editor (editable checkbox enabled)

Click on the clock object
Time will be get displayed with option to change
Scroll Up or Down to change the time
Leave as it is for few seconds to set New time

Data Format

Justification - Specifies the location with-in the object’s rectangular bounds that the time will be displayed. NOTE: Justification option available only for Digital clock format.

Format - Specifies how the time will be displayed. Drop down displays a variety of combinations which can be displayed, the following defines the format codes.

HH = Hour (24-hour mode)
hh = Hour (12-hour mode)
mm = Minutes
ss = Seconds
xM = AM / PM indicator

Font - Specifies font used to display the time value.

Digital Clock - This checkbox allows the object to be displayed in digital clock format.

Uncheck the box to allow the object to be displayed as an analog clock.

Editable - This checkbox allows the object to be selected and the time value to be changed

Display Properties for Clock

Attributes >>>

Static

Visible

Non-touch units* - all objects are always visible, so as a result both the static and dynamic override fields will be grayed out.
Touch units** - the visibility attribute may be set as static or dynamic.
*Non-touch units include X2, XLE, and XLEe.

**Touch Units include all XL series, Prime Series, and Micro OCS series controllers.
When the attribute is statically set to ON, the object is always visible and always responds to touch signals.
When the attribute is statically set invisible (unchecked) the object is not drawn but if the object is the front most object it responds to touch signals. For example, placing a statically invisible screen jump object in front of a bitmap allows the bitmap to be drawn but touching the location of the invisible screen jump causes the screen jump action to be performed.
When this attribute is dynamically enabled the visibility of the object is controlled by the associated bit in the override register. When the bit is ON the object is drawn and operates normally. When the bit is OFF the object is not drawn and does respond to any touch signals.

Flash – When statically set, an object will ’Flash’ the data display continuously or the animation ICON when the associated control register is in the ON state. When dynamically overridden, a three-state display can be created: OFF, ON solid and ON flash, depending both on the state of the control register and the Override Register.

Border – This attribute, available only statically, provides a decorative border (rectangle) drawn around the inside of the objects bounding rectangle. This border is typically removed to allow either a more elaborate border to be drawn with the drawing primitives or no border at all.

Enable Input – This attribute, optionally available only as dynamically overridden, allows the object or the object editor to ignore keystrokes directed to that object. This allows run-time determination on whether to restrict input access to that object. This allows the user to create operator privilege or in-motion lockout of object modification. If this box is NOT checked, the associated object always accepts input.

Dynamic

Color – This attribute allows some objects to dynamically change colors. Up to four additional colors can be selected for an object. If none of the color attribute override bits are set the object defaults to the color chosen in the main object properties.

Override variable – This register / variable is used to control the dynamic properties like visible, Flash, Enable Input and Colors.

Enhanced - Selecting Enhanced button displays the following window:

This option is used for configuring the different display attribute of graphic objects mentioned below. The following options can be configured either using constant values or via register / variable.

Opacity – User can configure the display opacity of graphic object. Range is 0 to 100.
Rotation – User can configure at what degree the object should appear rotated. Range is -180 to 180.
X and Y axis – User can configure at what X and Y axis the object should be placed on the screen. Range depends on the model selected.

Width and Height – User can configure at what width and height the object should be displayed on the screen. Range depends on the model selected.

Legend>>>

Text – User can configure a descriptive text (legend) to be included with-in the objects bounding rectangle. Returns may be inserted for multiple lines.

Justification – This option is used to display the legend text in the configured position within a graphic object.

Font – User can select the available fonts / font size to be applied to legend text.

Insert Special Char >>> - Selecting this option displays the following window wherein user can select different fonts / special characters available to be added in legend:

Access>>>

User can select access level from 0 to 7 in the drop down as shown. User logged in with the configured Access level (of graphic object) only will have access to that particular graphic object.

Note: Default access level is 0 (Zero) for all the access level supported graphic objects.

Display Style>>>

Specify Analog clock color properties in this dialog:

Dial Color - Specify color for Dial, see Color Picker
Hand Color - Specify color for Hands in the clock, see Color Picker
Background Color/Image - Specify Background color for the clock object.
Dial Type - 2D /3D. Specify the Dial type.
Ticks Visible - Check this option to have ticks visible in the clock.

Specify Digital clock properties in this dialog:

Button Style – specify the style of button to be displayed for digital clock.

Background / Color Image>>>

Solid Color – Applies the selected color from color picker as solid background color for the graphic object. Selecting Background >>> displays the following Color Picker window.

Color Picker

Selecting More >>> displays the following window allowing user to select color apart from default colors available in the above displayed color picker window.

Gradient

Allows user to select start and end color to be configured which in turn displays the configured color as gradient to the background color of graphic objects.

Selecting Gradient Start Color >>> or Gradient End Color >>> displays the Color Picker.

Pattern

Selecting Select Pattern>>> option displays the following window, where user can select a pattern that will be applied as background for the graphic object.

User Image

Select Image>>> - Displays windows open dialog for user to select the image from local drive. Following image types are allowed - .bmp, .png, .jpg, .jpeg and .svg.

Scale to Fit – Resizes imported image to match bounds of object. If not selected, the object’s lower-right bounds are recalculated to match the bitmap’s dimensions. If the bitmap is larger than the screen, it is clipped appropriately.

Tile – Selecting this option applies the selected image to the graphic objects background in tile format.

Legend/Line Color>>>

Selecting Legend / Line Color >>> option displays the Color Picker dialog for user to select the color and this will be applied to the legend and line (boundary) of the graphic object.

Data Color>>>

Selecting Data Color >>> option displays the Color Picker dialog for user to select the color and this will be applied to the data color of the graphic object.

Day/Night Mode

When Day/Night mode option is checked, based on current controller time, dial color of the object changes to either black or white. Dial will be in White color when controller time is in between 7am to 7:59 PM. Dial will be in Black color when controller time is in between 8 PM to 6:59 AM.

Note: When Day/Night mode option is checked, Dial color and Hands color selection in Analog clock properties will be grayed out.

Return to the Top: Clock Object for Canvas