Scalos Plugin

PLUGIN

• filename: title_clock.plugin
• author: David McMinn [dave@scalos.com]
• type: [OOP] Screen Titlebar

INSTALLATION

Run the supplied Install Script. -or- Copy the #?.plugin file to the Scalos:Plugins/OOP/ directory.
Start up the main Scalos Preference program and select the 'Plugins' page. Click the 'New' button and then use the file selector icon to the right-end of the string gadget to select you new plugin file from the Scalos:Plugins/OOP/ directory. Copy the title_clock.prefs executable to SCALOS:Prefs/Plugins/ folder.

DESCRIPTION

The Scalos desktop screen titlebar may be configured using the main Scalos Preference program. This plugin adds some additional placeholders:

• %ti, displays the current time in the default Locale format. e.g. "10:43:37"
• %da, displays the date in the default Locale format. e.g. "Saturday 14 July 2001"

Using the supplied prefs program for the plugin, or editing the ASCII file ENVARC:Scalos/title_clock.prefs you can use the following standard Amiga Locale values to change the standard formatting.

• %a - abbreviated weekday name
• %A - weekday name
• %b - abbreviated month name
• %B - month name
• %c - same as "%a %b %d %H:%M:%S %Y"
• %C - same as "%a %b %e %T %Z %Y"
• %d - day number with leading 0s
• %D - same as "%m/%d/%y"
• %e - day number with leading spaces
• %h - abbreviated month name
• %H - hour using 24-hour style with leading 0s
• %I - hour using 12-hour style with leading 0s
• %j - julian date
• %m - month number with leading 0s
• %M - the number of minutes with leading 0s
• %n - insert a linefeed
• %p - AM or PM strings
• %q - hour using 24-hour style
• %Q - hour using 12-hour style
• %r - same as "%I:%M:%S %p"
• %R - same as "%H:%M"
• %S - number of seconds with leadings 0s
• %t - insert a tab character
• %T - same as "%H:%M:%S"
• %U - week number, taking Sunday as first day of week
• %w - weekday number
• %W - week number, taking Monday as first day of week
• %x - same as "%m/%d/%y"
• %X - same as "%H:%M:%S"
• %y - year using two digits with leading 0s
• %Y - year using four digits with leading 0s

USAGE

In the Scalos Main Preference program select 'Titles' page. You can then use the above new placeholders in any of the title strings for Screen, RootWindow and Window.

NOTE: In order to allow the seconds display to count up in seconds you must set the title bar refresh time to every 1 second. The date/time will only display when the Scalos desktop is active, i.e. when one of the directory windows is currently the active window; this is a system limitation and not possible to get around with out a patch/hack sadly.