This animation enable an object to display historical trends.
All the tag used by this kind of animation (except the tags whose value history is displayed by the trend) should belong to the User Domain (to make the application to support multi users).
Many tag / expression can be given to set/get various parameters:
- End trend time: long tag that set/get the end trend time of the displayed trend. It defines, with the Trend time length tag, the time interval displayed by the trend. The format used is the same of System.currentTimeMillis()
of Java API function.
- Trend time length: int/long tag that set/get the time length displayed by the trend (in milliseconds). In the standard JSup Trend window, the Trend length field uses a Custom input animation to display/set the length of the trend in a human being format.
- Historical mode: a boolean expression that when true turn the trend into historical mode, where the user can pan the variable history; when false the trend is in realtime mode, where the End trend time always match the current time and only the last Trend time length milliseconds of history can be vied.
- Grid show: a boolean expression that shows (when true) the grid over the trend area.
- Pointed time: a long tag that will receive the time the user is pointing (with the mouse) on the trend.
Grid definition
The number inserted in the major division (for time/vertical grid) are to be considered suggestions: JSup will choose a human being understandable division (for example 5', 1h, etc... and not 67s) to have the number of major divisions as near as possible to the entered number.
The optional Grid info to tag is an Object tag (Vector typed) that will receive the information about the time axis grid as Trend.GridVLineInfo. See how the time tick/labels are painted in the standard JSup Trend window for an example of how this information can be used.
Trend pens
For a fixed pen trend you can directly define the pens that will be drawn by the trend.
For a dynamic pen configuration (like in the standard JSup Trend window) you can leave the pen list blank and check Persistent pen configuration that makes the trend to remember the last pen configuration (Windows user based).
(logged tags)
