AminetAminet
Search:
83665 packages online
About
Recent
Browse
Search
Upload
Setup
Services

util/time/ScreenTime.lha

Mirror:Random
Showing:m68k-amigaosppc-amigaosppc-morphosi386-arosi386-amithlonppc-warpupppc-powerupgeneric
No screenshot available
Short:Screen clock, configurable with locale
Author:Kim Fastrup Larsen
Uploader:kimflarsen hotmail com (Kim Fastrup Larsen)
Type:util/time
Version:1.3
Architecture:m68k-amigaos >= 2.0
Date:2021-02-01
Download:http://aminet.net/util/time/ScreenTime.lha - View contents
Readme:http://aminet.net/util/time/ScreenTime.readme
Downloads:1376

New in version 1.3:

- The placement of the calendar can now be specified with
  tool types or Shell arguments.
- The calendar can now be dismissed by pressing the Esc key.
- Added abbreviations for several of the Shell arguments.
- Added the DONOTWAIT tool type to the program icon.


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 or press Esc 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.

Note that if you change your system time, it can happen that
the clock stops updating due to the manner in which it waits
for the system time to change. The program is still running
just fine, but it might be waiting for a moment in time that
is now far in the future. You will just have to restart the
program or use Commodities Exchange to deactivate and reac-
tivate it.

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 commands available are defined by the locale. They 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.

You can also specify the position of the calendar using
CALENDAR_X and CALENDAR_Y. If you specify a position that is
outside the bounds of the screen, it will be adjusted to
place the calendar along the edge. Using -1 will place the
calendar just below the screen bar and on the right edge of
the screen, respectively. This is also 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.3 (Feb 1, 2021)

- The placement of the calendar can now be specified with
  tool types or Shell arguments.
- The calendar can now be dismissed by pressing the Esc key.
- Added abbreviations for several of the Shell arguments.
- Added the DONOTWAIT tool type to the program icon.

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.


Contents of util/time/ScreenTime.lha
PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                  252     628  40.1% -lh5- 2c51 Feb  1 13:57 ScreenTime.info
[unknown]                  154     200  77.0% -lh5- 2532 Feb  1 13:57 ScreenTime/Catalogs/dansk/screentime.catalog
[unknown]                  160     214  74.8% -lh5- 3ba4 Feb  1 13:57 ScreenTime/Catalogs/deutsch/screentime.catalog
[unknown]                  215     290  74.1% -lh5- e397 Feb  1 13:57 ScreenTime/Catalogs/italiano/screentime.catalog
[unknown]                12641   35147  36.0% -lh5- 7994 Feb  1 13:57 ScreenTime/gpl-3.0.txt
[unknown]                  249     477  52.2% -lh5- 4273 Feb  1 13:57 ScreenTime/gpl-3.0.txt.info
[unknown]                 3102    7506  41.3% -lh5- 28de Feb  1 13:57 ScreenTime/Readme
[unknown]                  246     477  51.6% -lh5- 7f30 Feb  1 13:57 ScreenTime/ReadMe.info
[unknown]                 7312   11120  65.8% -lh5- cc6e Feb  1 13:57 ScreenTime/ScreenTime
[unknown]                  394     787  50.1% -lh5- 0cfb Feb  1 13:57 ScreenTime/ScreenTime.info
[unknown]                 1321    1321 100.0% -lh0- 598e Feb  1 13:57 ScreenTime/ScreenTime_ITA.lha
[unknown]                 1655    4778  34.6% -lh5- f7e9 Feb  1 13:57 ScreenTime/Source/args.c
[unknown]                  666    1102  60.4% -lh5- ce66 Feb  1 13:57 ScreenTime/Source/args.h
[unknown]                 1343    3026  44.4% -lh5- 805f Feb  1 13:57 ScreenTime/Source/broker.c
[unknown]                  568     961  59.1% -lh5- a043 Feb  1 13:57 ScreenTime/Source/broker.h
[unknown]                  850    1596  53.3% -lh5- ad0a Feb  1 13:57 ScreenTime/Source/catalog.c
[unknown]                  572     935  61.2% -lh5- 3b41 Feb  1 13:57 ScreenTime/Source/catalog.h
[unknown]                  647    1085  59.6% -lh5- a774 Feb  1 13:57 ScreenTime/Source/common.c
[unknown]                  650    1100  59.1% -lh5- 941f Feb  1 13:57 ScreenTime/Source/common.h
[unknown]                  562     921  61.0% -lh5- 6dfe Feb  1 13:57 ScreenTime/Source/compiler.h
[unknown]                  685    1327  51.6% -lh5- ed42 Feb  1 13:57 ScreenTime/Source/cx.c
[unknown]                  528     875  60.3% -lh5- d294 Feb  1 13:57 ScreenTime/Source/cx.h
[unknown]                  209     252  82.9% -lh5- e1a4 Feb  1 13:57 ScreenTime/Source/dansk.ct
[unknown]                 1830    4651  39.3% -lh5- c268 Feb  1 13:57 ScreenTime/Source/datetime.c
[unknown]                  834    1535  54.3% -lh5- a550 Feb  1 13:57 ScreenTime/Source/datetime.h
[unknown]                  212     263  80.6% -lh5- d88a Feb  1 13:57 ScreenTime/Source/deutsch.ct
[unknown]                 3971   12878  30.8% -lh5- f928 Feb  1 13:57 ScreenTime/Source/display.c
[unknown]                  587    1005  58.4% -lh5- ed89 Feb  1 13:57 ScreenTime/Source/display.h
[unknown]                  926    1823  50.8% -lh5- a620 Feb  1 13:57 ScreenTime/Source/error.c
[unknown]                  710    1190  59.7% -lh5- a368 Feb  1 13:57 ScreenTime/Source/error.h
[unknown]                 1412    3613  39.1% -lh5- a25b Feb  1 13:57 ScreenTime/Source/main.c
[unknown]                  215     290  74.1% -lh5- e397 Feb  1 13:57 ScreenTime/Source/Resources/Catalogs/italiano/ScreenTime.catalog
[unknown]                  395     787  50.2% -lh5- 0d46 Feb  1 13:57 ScreenTime/Source/Resources/ScreenTime.info
[unknown]                  106     141  75.2% -lh5- 76a7 Feb  1 13:57 ScreenTime/Source/SCOPTIONS
[unknown]                  564     928  60.8% -lh5- a207 Feb  1 13:57 ScreenTime/Source/screentime.cd
[unknown]                  751    2085  36.0% -lh5- b7ed Feb  1 13:57 ScreenTime/Source/smakefile
[unknown]                  890    1680  53.0% -lh5- 56d2 Feb  1 13:57 ScreenTime/Source/snprintf.c
[unknown]                  845    1492  56.6% -lh5- d48d Feb  1 13:57 ScreenTime/Source/snprintf.h
[unknown]                 1209    2713  44.6% -lh5- 8fd7 Feb  1 13:57 ScreenTime/Source/timer.c
[unknown]                  582     994  58.6% -lh5- 2e08 Feb  1 13:57 ScreenTime/Source/timer.h
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        40 files   51020  114193  44.7%            Feb  1 20:11

Aminet © 1992-2021 Urban Müller and the Aminet team. Aminet contact address: <aminetaminet net>