IconCalendar 1.0 Copyright © 1994 Mika Kuulusa Written by Mika Kuulusa Released: 22-Jun-94 DISTRIBUTION IconCalendar is CardWare. That means it is freely distributable, but if you really like it, ought to send me a POSTCARD! My address is in the end of this document. DESCRIPTION This user-friendly utility gives your Workbench a nice touch: it displays the number of the day in month as a nice AppIcon, and the icon has the name of the month. The user may translate month names as he/she wishes, by writing the translations as arguments in CLI or as tooltypes in Workbench (e.g. month January could be translated to "Janvier" (French) or "Januari" (Swedish)). REQUIREMENTS OS2.x or higher required. In order to use the program, Workbench must be running, because IconCalendar uses an AppIcon. The program takes only about 12k bytes of memory when running. INTRODUCTION As I use cm (calendar manager) in Sun Sparc workstations, it occurred to me that there was no such utility for Amiga that shows the date so nicely, on the background. Actually cm is much more than just an icon on the background, it is a scheduler, too. After some careful planning I decided to program it, just for fun! I cold bloodedly used xv to grab the icon from the Sparc. Then I modified it a bit and also made those number fonts used in it. Then I made some test with timer.device and other resources I needed, tested it and gave it some finishing touches. I have still one remark to make: if you get the same good feeling about this nifty utility like I do, use it, and really like it... DO SEND ME A POSTCARD! That way I know that people really use it and maybe, just maybe, I could make an update some day... ;-) My address is in the end of this document. INSTALLATION From Workbench: Just drag IconCalendar icon to the place where you want to use it from. If you drag it to the WBStartup drawer, it will be executed every time you boot your system. From CLI: Copy "IconCalendar" file to a directory that is in your command path (e.g. C:). I suggest you use IconCalendar with its icon from Workbench. By using it this way, modifying the translations is *much* easier with tooltypes than it is with command-line arguments. USAGE From Workbench: Doubleclick the icon, and the AppIcon appears. You may modify the tooltypes by selecting the IconCalendar icon and using "Information..." from the Workbench menu. From CLI: Simply execute the program by writing "IconCalendar". Arguments are written after the commandname. Tooltypes (Workbench) and command-line arguments (CLI): XPOS/N X position where topleft corner of AppIcon should apperar (e.g. 590 for right hand corner of the Workbench). Default: NO_ICON_POSITION YPOS/N Y position where topleft corner of Appicon should appear (e.g. 210 for bottom edge of PAL:High Res screen). Default: NO_ICON_POSITION UPDATE/N Time in seconds after which IconCalendar checks if it should update the AppIcon (e.g. if 3 is set, the program checks every 3 seconds if the date has changed). Default: 60, minimum: 1 JANUARY/K MARCH/K MAY/K JULY/K OCTOBER/K NOVEMBER/K FEBRUARY/K APRIL/K JUNE/K AUGUST/K SEPTEMBER/K DECEMBER/K Month name translations (e.g. set JANUARY=Janvier if you want January to be translated in french). All month names are translated in the same manner. Defaults to: English Examples: > IconCalendar (appears some free position, names in English, check every 60 seconds for the date) > IconCalendar 550 30 15 (appears in position (550,30), names in English, check every 15 seconds for the date) > IconCalendar 10 200 january=Janvier february=Février (appears in position (10,200), translate January and February to french (more tranlations should be added), check every 60 for the date) The same arguments could be given in tooltypes of Workbench. BUGS When the AppIcon is refreshed (i.e. the date changes) and you have dragged the icon to some other place in the Workbench, the AppIcon jumps back to its original place. Reason: I can't read the current position of the AppIcon (an OS bug?). Hints how to do it, anyone? AUTHOR Any suggestions, comments, etc. are welcome! :) My address is: Mika Kuulusa Yliopistonkatu 46 B 49 33100 Tampere FINLAND Europe Internet: sunshine@cs.tut.fi IRC: MKsa Sie können auch auf deutsch schreiben! Ni kan skriva på svenska också! Thanks to my betatester crew: Stefan Gybas, Patrik Lundquist, Hans Ander Christiansen and Scott Pinard. Greetings to the nice ppl in Internet Relay Chat (IRC) in channels #amiga, #amiga! and #amigager. Special hi5s to: SpaceC, lundman, NeilM, PatrikL, Xed and Dense. HISTORY v1.0 26/06/94 Initial release.