ErgoTechWiki

com.ergotech.vib.graphics.Clock

The Clock graphic is a More Layout status and process graphic used to display an analog clock.

Clock displays time using an analog clock face with hour, minute, and second hands. It uses the timestamp from the incoming value to set the displayed time.

The Clock appearance can be configured with settings for the clock face, border circle, numbers, dots, hand colors, hand sizes, and time zone.

• Displaying an analog clock in an application
• Showing the time from an incoming value timestamp
• Adding a live time display to an operator screen
• Displaying time in a selected time zone
• Adding a decorative or status-style clock to a dashboard

Clock accepts input through valueInput.

The input can come from a data source or another logic component.

Clock uses the timestamp from the incoming value to set the displayed time.

Clock has no default output ports.

Clock is used as a display graphic.

Clock displays an analog clock face with configurable drawing options.

Clock-specific settings include:

• Name Sets the name of the Clock graphic.
• Bezel Sets the bezel style.
• Border Circle Color Sets the color of the outer border circle.
• Border Circle Distance Sets the radial distance of the outer border circle as a percentage of the bounds.
• Border Circle Thickness Sets the thickness of the outer border circle.
• Dots Color Sets the color of the clock tick dots.
• Dots Distance Sets the radial distance of the dots as a percentage of the bounds.
• Dots Thickness Sets the size of the dots.
• Border Circle Draw Controls whether the outer border circle is drawn.
• Dots Draw Controls whether the dots are drawn.
• Numbers Draw Controls whether the clock numbers are shown.
• Font Sets the font used for the clock numbers.
• Numbers Color Sets the color of the clock numbers.
• Clock Face Color Sets the fill color of the clock face.
• Hour Hand Color Sets the color of the hour hand.
• Hour Hand Size Sets the size of the hour hand.
• Hour Hand Thickness Sets the thickness of the hour hand.
• Inside Circle Color Sets the color of the inner center circle.
• Inside Circle Size Sets the size of the inner center circle.
• Numbers Major Only Controls whether only the major numbers are shown.
• Minute Hand Color Sets the color of the minute hand.
• Minute Hand Size Sets the size of the minute hand.
• Minute Hand Thickness Sets the thickness of the minute hand.
• Numbers Distance Sets the radial distance of the numbers as a percentage of the bounds.
• Round To Seconds Controls whether the display is rounded to seconds.
• Second Hand Color Sets the color of the second hand.
• Second Hand Size Sets the size of the second hand.
• Second Hand Thickness Sets the thickness of the second hand.
• Zone Time Sets the time zone used for the displayed time.
• Use Color Controls whether the incoming value color is used.
• Bad Qual. Indicator Controls the indicator used when bad quality data is received.
• Bezel Color Sets the outside bezel color.
• Bezel Inside Color Sets the inside bezel color.
• Bezel Thickness Sets the thickness of the bezel.
• Cursor Sets the cursor shown when the pointer is over the Clock.
• Rotation Sets the Clock rotation.
• Click Action Defines a click action.
• Click Count Sets the number of clicks used for the click action.
• Visible Controls whether the Clock is shown.
• Warning Qual. Indicator Controls the indicator used when warning or transitional quality data is received.

In the Logic Editor, Clock includes this default port:

• valueInput

The valueInput port updates the displayed clock time from the timestamp of the incoming value.

Use Clock when an application needs an analog time display.

Clock is a display graphic and does not function as a user input control.

For text-based date or time display, use a text or display graphic instead.

For general graphic behavior, see Active Graphic.

• MIStudio Design Editor
• More Layout
• Status, Motion, and Process Graphics
• Active Graphic