| Readme: | Short: Screen clock, configurable with locale
Author: Kim Fastrup Larsen
Uploader: kimflarsen hotmail com (Kim Fastrup Larsen)
Type: util/time
Version: 1.2.2
Architecture: m68k-amigaos >= 2.0
New in version 1.2.2:
- Fixed a bug in the calendar where, if you were on the last
day of the month, the next and previous month would be
incorrectly rendered.
ScreenTime is a commodity that will display the current time
on any public screen. If no particular screen is specified,
it will open on the default public screen (usually the Work-
bench). By default, ScreenTime will open a small borderless
window on top of the screen bar, adopting the font and col-
ors of the screen to make it look like it's part of it, but
if you want, you can override the position, font or colors
using tool types or Shell arguments.
Clicking the clock will bring up a calendar for the current
month. A pair of buttons allow you to browse through other
months. Alternatively, you can use the left and right arrow
keys on your keyboard for the same purpose. Click the clock
again to dismiss the calendar.
You can run multiple instances of ScreenTime at the same
time if you want the time displayed on several screens at
once, but only one for each screen. Each instance will be
given a different commodity name that includes the screen
name so that they can be told apart in Commodities Exchange.
To remove an instance of ScreenTime, run it again (using the
same screen specification), or use Commodities Exchange.
When running on Workbench 2, ScreenTime will use a simple
hh:mm:ss format. On Workbench 2.1 or later, you can choose
between a number of formats defined by your locale that show
different combinations of time and date, or you can create
your own custom format that can also include things like day
of the week and week number.
You specify the desired format using the FORMAT tool type or
Shell argument. There are six different locale-defined for-
mats to choose from:
TIME
DATE
DATETIME
SHORTTIME
SHORTDATE
SHORTDATETIME
What you get in each case depends on your locale. Some of
them may give the same result in some locales. By default,
ScreenTime will use the TIME format, equivalent to using
FORMAT=TIME
You can also create your own custom format. For example,
FORMAT=%a %q:%M
will show the abbreviated week day, followed by a space,
followed by the hour (in 24-hour format), followed by a
colon, followed by the minutes.
You can include any characters in the string, but every ap-
pearance of a % character followed by a single letter is
taken as a command to insert a particular element of the
current time into the string at that position - to display
an actual % character, use %%.
The possible commands are:
%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
%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 - 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
You specify which public screen you want the time displayed
on by using the PUBSCREEN tool type or Shell argument.
Use MARGIN_TOP and MARGIN_RIGHT to specify the position of
ScreenMenu's window. The default values are 1 and 30, re-
spectively.
Use FONT_NAME and FONT_SIZE to specify the font. The font
name must include the .font suffix, as in
FONT_NAME=topaz.font
FONT_SIZE=8
If no font is specified, ScreenMenu will use the same font
as the screen bar.
Finally, you can specify the colors to be used with
TEXT_COLOR and BACKGROUND_COLOR. The value in each case must
be a number from 0 and up, or -1 to tell ScreenMenu to imi-
tate the screen bar, the latter being the default behavior.
ScreenTime requires Kickstart 2 or later. Full source code
is included.
Thank you to the people who give me feedback and help me im-
prove ScreenTime, to Stefan Haubenthal for the German trans-
lation, and to Samir Hawamdeh for the Italian translation!
History:
1.2.2 (Mar 31, 2020):
- Fixed a bug in the calendar where, if you were on the last
day of the month, the next and previous month would be
incorrectly rendered.
1.2.1 (Jan 24, 2020):
- Tried to make the calendar layout routines more compatible
with certain patches or versions of the AmigaOS that mess
with window title bars and cause problems when precalcu-
lating the size of windows that do not have titles.
- Removed the spacing added in 1.2 since it might not be de-
sirable when using alternative colors, and since it can be
added manually using the format string anyway.
- Now includes Italian translation by Samir Hawamdeh.
1.2 (Jan 16, 2020)
- Clicking the clock now pops up a calendar for the current
month. Months can be browsed using buttons or the arrow
keys. Click the clock again to close the calendar.
- Added a bit of spacing at the left edge of the clock to
cover very long screen titles.
- Now includes German translation by Stefan Haubenthal.
1.1 (Dec 17, 2019)
- Added options to specify position, font and colors.
1.0 (Dec 8, 2019)
- Initial release.
|
060 (2)
ScreenTime_1.2.2.lha