@DATABASE ScreenClock.guide @MASTER "HELP:english/ScreenClock.guide" @$VER: ScreenClock_english.guide 38.33 (08.03.99) by Thomas Igracki @AUTHOR Thomas Igracki @(c) by Thomas Igracki @WIDTH 78 @NODE Main "ScreenClock Documentation" @{b}/@{ub} @{b}ScreenClock v2.2 /@{ub} by Thomas Igracki ____________________@{b}/@{ub} @{" AFD - C O P Y R I G H T " link AFD-COPYRIGHT/Main} @{" What should be in the archive? " link Archiv } @{" The history of the program " link History} @{" What is it for? " link WhatItIs } @{" How to contact me? " link Me } @{" How to start? " link HowToStart} @{" Possible error messages " link Errors } @{" How to register? " link Register } @{" How to get Updates? " link Updates} --------------------- This software is subject to the "Standard Amiga FD-Software Copyright Note" It is @{"SHAREWARE" link AFD-COPYRIGHT/Main 99} as defined in paragraph 4s. [...] For more information please read "AFD-COPYRIGHT" (Version 1 or higher). @ENDNODE @NODE Archiv "ScreenClock/What should be in the archive?" The following files should be in the archiv: @{LINDENT 3} @{b}env/ScreenClock@{ub} --> example environment variable @{b}env/mui/SCREENCLOCKPREFS.(cfg|prefs)@{ub} --> my MUI-Config/Prefs for ScreenClockPrefs @{b}libs/sysinfo.libray@{ub} --> @{"SysInfo.library" link SysInfo} by Petri Nordlund @{b}help/deutsch/ScreenClock.guide@{ub} --> german documentation, AmigaGuide-Format @{b}help/deutsch/AFD-COPYRIGHT.de@{ub} --> german COPYRIGHT-Note @{b}help/english/ScreenClock.guide@{ub} --> english documentation, AmigaGuide-Format @{b}help/english/AFD-COPYRIGHT@{ub} --> english COPYRIGHT-Note @{b}prefs/ScreenClock@{ub} --> prefs-program (MUI) for @{b}ScreenClock@{ub} @{b}catalogs/deutsch/ScreenClockPrefs.catalog@{ub} --> german catalog for @{b}ScreenClockPrefs@{ub} @{b}catalogs/ScreenClockPrefs_D.ct@{ub} --> german catalog-translation for @{b}ScreenClockPrefs@{ub} @{b}catalogs/ScreenClockPrefs_blank.ct@{ub} --> blank catalog-translation for @{b}ScreenClockPrefs@{ub} @{b}Registration.txt@{ub} --> english registration formular @{b}Registrierung.txt@{ub} --> german registration formular @{b}Product-Info@{ub} --> product info @{b}ScreenClock.readme@{ub} --> short english doc, ASCII @{b}ScreenClock.liesmich@{ub} --> short german doc, ASCII @{b}ScreenClock.info@{ub} --> the wb-icon for ScreenClock @{b}ScreenClock@{ub} --> the program @ENDNODE @NODE WhatItIs "ScreenClock/What is this program for?" @{LINDENT 3} This program displays the date, time and optional the free memory in your current screen's titlebar (left to the depth-gadget) in the actual language. Additionaly the current or recent cpu usage can be displayed too! And the online-time! @{fg shine}@{b}The features are:@{ub}@{fg text} @{LINDENT 6} - configurable @{"date and time format" link Arg_DateFormat} - optional showing of the @{"free memory" link Arg_MemoryFormat} - @{"in-/excluding screens" link Arg_Screens} to be used or not used - adjustable @{"update-rate" link Arg_Delay} in which the display should be updated - using a notified environment variable, named @{b}SCREENCLOCK@{ub}, which will be read at startup and on changing - observing @{b}ENV:SYS/locale.prefs@{ub} to get informed, if the language changed - optional working only on public-screens, see @{"OPS=OnlyPubScreens/T" link Arg_OPS} - adjustable task priority, see @{"Pri=TaskPriority/K/N" link Arg_Pri} - supporting autoscroll screen, see @{"AV=AlwaysVisible/T" link Arg_AV} - displaying 1/50ths of a second on demand, see @{"ST=ShowTicks/T" link Arg_ShowTicks} - double the 1/50ths of a second on demand to have pseudo 1/100, see @{"DT=DoubleTicks/T" link Arg_DoubleTicks} - displaying the current or recent cpu usage optionaly, see @{"CPU=CpuUsage/T" link Arg_CpuUsage} - it is a commodity - CX_SHOW opens/starts the @{"PrefsProgramm" link Arg_PrefsCommand} - CX_HIDE closes/hides the @{"PrefsProgramms'" link Arg_PrefsCommand} window - CX_KILL quits ScreenClock - CX_ACTIVATE/DEACTIVATE doesn't have a function - a nice external @{"prefs-program" link Arg_PrefsCommand} (MUI) - the online-time is displayed while you're online, it vanishes 5 secs after going offline. It starts when by setting ENV:ONLINE to 1 and stops by setting it to 0. You can configure Miami to do that! And if you're not online anymore the time you were online will be saved to ENV:OnlineTime. @{LINDENT 3} To remove @{b}ScreenClock@{ub} simple start it again or break it with CtrlC. @ENDNODE @NODE HowToStart "ScreenClock/How to start" @{LINDENT 3} @{b}Start from a shell:@{ub} [Run] @{b}ScreenClock@{ub} @{"DF=DateFormat/K " link Arg_DateFormat },@{"MF=MemoryFormat/K " link Arg_MemoryFormat}, @{"Screens/K " link Arg_Screens },@{"D=Delay/K/N " link Arg_Delay },@{"Mem=Memory/T " link Arg_Memory}, @{"OPS=OnlyPubScreens/T" link Arg_OPS },@{"Pri=TaskPriority/K/N " link Arg_Pri }, @{"AV=AlwaysVisible/T " link Arg_AV },@{"ST=ShowTicks/T " link Arg_ShowTicks},@{"DT=DoubleTicks/T" link Arg_DoubleTicks} @{"CPU=CpuUsage/T " link Arg_CpuUsage },@{"CF=CpuFormat/K " link Arg_CpuFormat},@{"RecentCPU/T " link Arg_RecentCPU} @{"NLS=NoLockScreen/T " link Arg_NoLockScreen}, @{"PCMD=PrefsCommand/K " link Arg_PrefsCommand},@{"OAS=OnlyActiveScreen/T" link Arg_OnlyActiveScreen}, @{"CX_POPKEY/K " link Arg_CxPopkey} You can save all these options to the env-var @{b}ScreenClock@{ub}! @{b}Start from Workbench:@{ub} Just double-click the icon. There is no tooltype-support, use the env-var instead! This may change in future. @ENDNODE @NODE Arg_DateFormat "ScreenClock/Argument" @{LINDENT 3} @{b}DF=DateFormat/K@{ub} This option specifies the format in which the date & time should be displayed. The available parameters are (see @{"Locale.FormatDate()" link Locale/FormatDate}): %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 Default: @{b}"%A %d-%h-%y %T"@{ub}. The result is: @{b}Monday 09-Jan-95 18:22:57@{ub}. If you set this option to @{b}""@{ub} while @{b}ScreenClock@{ub} is running, the default setting will be used again! @ENDNODE @NODE Arg_MemoryFormat "ScreenClock/Argument" @{LINDENT 3} @{b}MF=MemoryFormat/K@{ub} This option specifies the format of the memory display. There are 3 parameters (@{b}%ld@{ub} or @{b}%lD@{ub}) supported: - the 1. is for the free chip-memory in KB, - the 2. is for the free fast-memory in KB and - the 3. is for the total free memory in KB. Default: @{b}" - C:%5lD F:%5lD"@{ub}. The result is: @{b}" - C:1.737 F:3.538"@{ub}. If you set this option to @{b}""@{ub} while @{b}ScreenClock@{ub} is running, the default setting will be used again! You should use a space as the first character, because the created string is appended to the created date/time string! You could also append a space to the date/time string;-) Tip: If you like to change the order of the memory type, you have to place a @{b}$@{ub} command between the @{b}%@{ub} and the @{b}ld@{ub} or @{b}lD@{ub} chars! @{b}@{ub} is the number of the memory type, see above. Example: MF = " Total: %3$lD (FAST = %2$lD, CHIP = %1$lD)" And If you only want to display the total free memory you have to do this: MF = "%0.0ld%0.0ld Total: %lD"! See also @{"Locale/FormatString()" link "Locale/FormatString"}. The difference between @{b}%ld@{ub} and @{b}%lD@{ub}, is that the second uses locale format. @ENDNODE @NODE Arg_Screens "ScreenClock/Argument" @{LINDENT 3} @{b}Screens/K@{ub} This option specifies the screens on which @{b}ScreenClock@{ub} should appear or should NOT appear by an AmigaDOS pattern! Because @{b}ScreenClock@{ub} compares with the screen's defaulttitle, it displays the date/time/mem even if a program changed the used screen title! If this option is not used @{b}ScreenClock@{ub} uses all screens which have a titlebar. If you set this option to @{b}""@{ub} while @{b}ScreenClock@{ub} is running, the default setting (no matching) will be used again! Tip2: You should use a @{b}#?@{ub} instead of a @{b}*@{ub}, because the wild star has also some other meaning under DOS (i.e. @{b}*"@{ub})! Tip2: If you want that some screens aren't used, than try this pattern: @{b}~(|)@{ub} Example: SCREENS = "~(DosControl#?)" Action : The 'DosControl'-Screen won't be used. @ENDNODE @NODE Arg_Delay "ScreenClock/Argument" @{LINDENT 3} @{b}D=Delay/N@{ub} This number specifies the update-rate in which @{b}ScreenClock@{ub} updates the display. Number of 1/50 seconds. Minimal value is 10, maximal 100. Default 50. @ENDNODE @NODE Arg_Memory "ScreenClock/Argument" @{LINDENT 3} @{b}Mem=Memory/T@{ub} This toggle option specifies if the free memory should be appended to the date & time string. ON : @{b}Memory = ON@{ub} or @{b}Mem = ON@{ub} OFF: @{b}Memory = OFF@{ub} or @{b}Mem = OFF@{ub} Default is OFF. The "@{b}=@{ub}" is optional! @ENDNODE @NODE Arg_OPS "ScreenClock/Argument" @{LINDENT 3} @{b}OPS=OnlyPubScreens/T@{ub} This is the option to specify, if only (non-private) public screens should be used. ON : @{b}OnlyPubScreens = ON@{ub} or @{b}OPS = ON@{ub} OFF: @{b}OnlyPubScreens = OFF@{ub} or @{b}OPS = OFF@{ub} Default is OFF. The "@{b}=@{ub}" is optional! @ENDNODE @NODE Arg_Pri "ScreenClock/Argument" @{LINDENT 3} @{b}Pri=TaskPriority/K/N@{ub} This option specifies then priority of @{b}ScreenClock@{ub}. Only priorities between -3 and +3 will be accepted. Default is 0. @ENDNODE @NODE Arg_AV "ScreenClock/Argument" @{LINDENT 3} @{b}AV=AlwaysVisible/T@{ub} This option specifies if the date/time/mem should be written relative to visible right side of the screen (ON) or left to depth-gadget (OFF). @{b}AlwaysVisible = ON@{ub} or @{b}AV ON@{ub} -> always visible! @{b}AlwaysVisible = OFF@{ub} or @{b}AV OFF@{ub} -> always left to the depth-gadget Default is ON! The "@{b}=@{ub}" is optional! @ENDNODE @NODE Arg_ShowTicks "ScreenClock/Argument" @{LINDENT 3} @{b}ST=ShowTicks/T@{ub} This option specifies if you want to see 1/50ths of a second. @{b}ShowTicks = ON@{ub} or @{b}ST ON@{ub} -> yes, they will be displayed @{b}ShowTicks = OFF@{ub} or @{b}ST OFF@{ub} -> no, they won't be displayed Default is OFF! The "@{b}=@{ub}" is optional! Note: The 1/50ths of a second will be appended (with a "."), to the @{"DateFormat" link Arg_ShowTicks}. I did this, because ticks (1/50ths of a second) aren't supported by @{"Locale.FormatDate()" link Locale/FormatDate}. I think, this feature will not be used very often by much people, so it's not worth the work to extend @{"Locale.FormatDate()" link Locale/FormatDate}. If there exists more than one people who haven't their time at the end of the date and want the ticks to be displayed anywhere they want, I maybe change this;-) @ENDNODE @NODE Arg_DoubleTicks "ScreenClock/Argument" @{LINDENT 3} @{b}DT=DoubleTicks/T@{ub} This option specifies if you want to see pseudo 1/100ths of a second. Thats done by multiply the ticks (1/50ths of a second) with 2. @{b}DoubleTicks = ON@{ub} oder @{b}DT ON@{ub} -> yes, they will be doubled @{b}DoubleTicks = OFF@{ub} oder @{b}DT OFF@{ub} -> no, they won't be doubled Default is OFF! The "@{b}=@{ub}" is optional! Note: This option is only usefull in combination with @{"ShowTicks/T" link Arg_ShowTicks}! @ENDNODE @NODE Arg_CpuUsage "ScreenClock/Argument" @{LINDENT 3} @{b}CPU=CpuUsage/T@{ub} This option specifies if you the current CPU usage should be appended to the date, time & memory string (@{"CPU-Format" link Arg_CpuFormat}). This is done with help of @{b}sysinfo.library@{ub} by Petri Nordlund. ON : @{b}CpuUsage = ON@{ub} or @{b}CPU ON@{ub} OFF: @{b}CpuUsage = OFF@{ub} or @{b}CPU OFF@{ub} Defailt is OFF! The "@{b}=@{ub}" is optional! @ENDNODE @NODE Arg_CpuFormat "ScreenClock/Argument" @{LINDENT 3} @{b}CF=CpuFormat/K@{ub} This option specifies the format of the cpu-usage display. There are maximal 2 parameters (@{b}%ld@{ub}) supported: - the 1. is for the number @{b}before@{ub} the point - the 2. is for the number @{b}after@{ub} the point See also @{"Locale/FormatString()" link "Locale/FormatString"}. Default is: @{b}" - CPU = %2ld.%.1ld%%"@{ub}. The result is for example: @{b}" - CPU = 2.7%"@{ub}. If you set this option to @{b}""@{ub} while @{b}ScreenClock@{ub} is running, the default setting will be used again! You should use a space as the first character, because the created string is appended to the created date/time/mem string! Tip: If don't want to have a number after the point, you can set the string to: CF = " CPU = %2.2ld" @ENDNODE @NODE Arg_RecentCPU "ScreenClock/Argument" @{LINDENT 3} @{b}RecentCPU/T@{ub} This option specifies if you want to see the recent (last 60 sec.) cpu usage or the one for the last second. This is done with help of @{b}sysinfo.library@{ub} by Petri Nordlund. @{b}RecentCPU = ON@{ub} -> the recent cpu usage @{b}RecentCPU = OFF@{ub} -> the last cpu usage Defailt is OFF! The "@{b}=@{ub}" is optional! @ENDNODE @NODE Arg_NoLockScreen "ScreenClock/Argument" @{LINDENT 3} @{b}NLS=NoLockScreen/T@{ub} This options specifies if the screen should be locked during writing the the data to the titlebar. This could lead to a problem, if only one screen is open and the screen- mode is changes. [Reported by Marcin Andrzejak] @{b}NoLockScreen = ON@{ub} or @{b}NLS ON@{ub} -> no locking @{b}NoLockScreen = OFF@{ub} or @{b}NLS OFF@{ub}-> locking is used Default is OFF! @ENDNODE @NODE Arg_PrefsCommand "ScreenClock/Argument" @{LINDENT 3} @{b}PCMD=PrefsCommand/T@{ub} This options specifies if the program to call if the @{"hotkey" link Arg_CxPopKey} is pressed or the signal ctrl-f is send to @{b}ScreenClock@{ub}. @{b}PrefsCommand = "SYS:Prefs/ScreenClock"@{ub} or @{b}PCMD "SYS:Prefs/ScreenClock"@{ub} Default is "SYS:Prefs/ScreenClock"! @ENDNODE @NODE Arg_OnlyActiveScreen "ScreenClock/Argument" @{LINDENT 3} @{b}OAS=OnlyActiveScreen/T@{ub} If this option is set to OFF and the active screen doesn't has a titlebar, ScreenClock will use the previous screen to show its data on. If its set to ON, then no updating will be done, if the active screen doesn't has a screen titlebar. @{b}OnlyActiveScreen = ON@{ub} or @{b}OAS ON@{ub} -> option is on @{b}OnlyActiveScreen = OFF@{ub} or @{b}OAS OFF@{ub} -> option is off Default is OFF! @ENDNODE @NODE Arg_CxPopKey "ScreenClock/Argument" @{LINDENT 3} @{b}CX_POPKEY/T@{ub} This options specifies if the hotkey to start the @{"prefs-program" link Arg_PrefsCommand}. Note1: It is not be changeable while runtime! Note2: If you specify the same key like the one you have specified for the @{"prefsprogram" link Arg_PrefsCommand} and you have you prefs-programm stay in the background, then if you press the hotkey the first time (and the prefsprogram isn't in memory) it will be started. Then every time you press the hotkey again the prefsprogram will react on it! -> It will popup and not started again! @{b}CX_POPKEY = "ctrl alt c"@{ub} Default is "ctrl alt c"! @ENDNODE @NODE Errors "ScreenClock/Errormessages" @{LINDENT 3} @{u}@{b}@{fg shine}Possible error messages during startup:@{fg texte}@{ub}@{uu} @{LINDENT 6} @{fg shine}1@{fg text} : Failed to create the @{b}msg-port@{ub}. @{fg shine}2@{fg text} : @{b}Dos.AllocDosObject(Dos.rdArgs)@{ub} failed. @{fg shine}3@{fg text} : Notify to @{b}ENV:ScreenClock@{ub} failed. @{fg shine}4@{fg text} : Notify to @{b}ENV:SYS/locale.prefs@{ub} failed. @{fg shine}5@{fg text} : Failed to InitSysinfo(). @{fg shine}6@{fg text} : Failed to start the prefs-program! @{fg shine}7@{fg text} : Failed to init the broker! (-> no popupkey (but ctrl-f) and no commodity!) @{fg shine}8@{fg text} : Failed to create the popkey! @{LINDENT 3} If the env-var or the shell arguments couldn't be parsed an appropriate error message will be displayed. @ENDNODE @NODE Register "ScreenClock/Register" @{LINDENT 3} You only have to fill out the @{"register formular" link Registration} and send it to me. @{"Via eMail or snail mail" link Me}. The share for @{b}ScreenClock@{ub} is $10, 10DM or the appropriate amount of your countries money. @{"You can transfer it to my bank-account or send it in cash." link Me} @{b}Limitations:@{ub} @{LINDENT 5} @{b}ScreenClock@{ub} self, didnt' has any limitations! The prefs-program has the limitations! Only registered user can save/use the settings and only they can iconify the program! @{LINDENT 3} @ENDNODE @NODE Registration "ScreenClock/Registration" To: Please register me for "ScreenClock" Thomas Igracki Siegener Str. 34 13583 Berlin Germany _ FirstName: Name: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Street: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ZIP,City: Country: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ EMail: Phone: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Config: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Where do you get this programm? [ ] Aminet CD No. ŻŻŻŻ [ ] from my Homepage http://softory.home.pages.de/ [ ] ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ Payment by: [ ] Cash (please don't send coins) [ ] $10 (US dollar) [ ] 10 DM (Deutsche Mark) [ ] Money transfer of 10 DM to this account: Thomas Igracki Sparkasse Berlin Account 860 169 138 BLZ 100 500 00 Write a little note (who you are etc) on the transferformular! Comment: ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ (City, Date) (Signature) Thank you for registering ScreenClock! @ENDNODE @NODE Updates "ScreenClock/Updates" @{LINDENT 3} You can get updates directly by me via eMail (if you are registered) or from my homepage @{b}http://softory.home.pages.de/@{ub}! They can also be found in Aminet (util/time/ScreenClock.lha). @ENDNODE @NODE History "ScreenClock/Programhistory" @{LINDENT 3} @{b}Release 2.2:@{ub} Revision 38.33 1999/03/08 00:48:57 Fix: Env:OnlineTime was 1 char to long. Revision 38.32 1999/03/08 00:08:55 New: The online-time is now displayed while you're online! It starts bey setting the env-var ENV:ONLINE to 1, and stops by setting it to 0. If you set it to 0, you're gone offline, the time you were online will be saved in the env-var ENV:OnlineTime (hh:mm:ss). The online-time vanishes 5 secs after going offline automatically. Fix: ScreenClock failed to create the popkey sometimes ("ScreenClockError: 8" on startup) Doc: Updated eMail and www address. @{b}Release 2.1:@{ub} Revision 38.31 1997/02/28 20:22:24 Fix: A "quiet-screen" (ScreenQuiet set), won't be used anymore! New: If you send a CX_Show to ScreenClock, then it will run ScreenClockPrefs if its not started before and popup the prefs-window if the prefs-program is already started! New: CX_Hide implemented to hide the ScreenClockPrefs' window New: @{"OAS=OnlyActiveScreen/T" link Arg_OnlyActiveScreen}, if the active screen can't be used because it has no title-bar etc, then ScreenClock will use the last used screen, if this option is OFF. If it is ON, then no date/time/mem/cpu will be displayed. @{b}Release 2.0:@{ub} Revision 38.30 1996/06/30 15:46:19 tig Fix: The popkey couldn't be read correct. Revision 38.29 1996/06/30 14:46:38 tig New: ScreenClock is now a Commodity! New: Option: CX_POPKEY (not changable during running!) to call the prefs program New: ScreenClock comes with a great prefs program (MUI, Shareware) Revision 38.28 1996/06/20 17:19:54 tig New: Added option PCMD=PrefsCommand/K to specify the prefs- program ScreenClock should run if it receives a ctrl-f signal! @{b}Release 1.83:@{ub} Revision 38.27 1996/05/26 19:08:33 tig New: ScreenClock didn't needs the ShowTitle-Flag of a screen to work with. So now, ScreenClock works on MUI-Screens. New: Now you can choose between recent (last 60 sec) or last sec CpuUsage @{b}Release 1.82:@{ub} 38.26 (02.12.95): Fix: Recompiled with new SysInfo.library interface, because the spelling of the library changed (sysinfo -> SysInfo). Fix: I didn't checked if CpuUsageLastsec is implemented. If not implemented, then the cpu-usage is not available. @{b}Release 1.81:@{ub} 38.25 (25.11.95): Fix: fixes a bug if 'NoLockScreen' is off (the pubScreen wasn't unlocked) @{b}Release 1.8:@{ub} 38.24 (15.11.95): New: Option 'NLS=NoLockScreen/T' specifies, if the screen should be locked during writing the data to the titlebar. This could lead to a problem, if only one screen is open and the screenmode is changes. [Reported by Marcin Andrzejak] Chg: The Environment-Variable (SCREENCLOCK) can now contain upto 1024 chars. 38.23 (14.11.95): New: Options: CPU=CpuUsage/T,CF=CpuFormat/K The current CPU usage can be displayed additionaly! @{b}Release 1.73:@{ub} 38.22 (17.07.95): New: Option 'DoubleTicks/T' -> the 1/50 secs. get doubled, so you have pseudo 1/100 secs. Only in combination with 'ShowTicks/T'. Default is OFF. [Wished by Raj Joshi] Chg: The ticks will be shown with 2 or 3 digits (if DoubleTicks = ON). @{b}Release 1.72:@{ub} 38.21 (20.06.95): New: Option: 'ShowTicks/T' -> Display 1/50ths of a second? [Wished by Raj Joshi] With limitation, see @{"ST=ShowTicks/T" link Arg_ShowTicks} Default is OFF. Fix: After a notify-signal or Ctrl-C is received (Env-Var or Locale changed), ScreenClock won't do a delay. Fix: "Titlebar-flicker" reduced @{b}Release 1.71:@{ub} 38.20 (30.04.95): Chg: The Env-Var can contain multiple lines, they will be concated. 38.19 (26.04.95): Chg: Scr.defaultTitle AND Scr.title have to be NIL, to display nothing. [Wished by Rodney Hester, so he can use Klondike V1.8 ;-] IF .defaultTitle = NIL and .title # NIL, then .title will be used for matching. @{b}Release 1.7:@{ub} 38.18 (04.03.95): Doc: Node @{" What is it for? " link WhatItIs} improved. Doc: Node @{" How to contact me? " link Me} corrected. Fix: If the new string is shorter than the old, the display wasn't cleared. [Reported by J.Frede] [I have used "<" instead of ">";-(] Chg: Under OS v38, I now use color 0 on 1. That should be the last change;-) If it doesn't, I probaly will add 2 new options (front-, backpen) in the next version;-) [Reported by T.Schwarz] @{b}Release 1.6:@{ub} 38.17 (01.03.95): Chg: Error messages are displayed as numbers. Doc: Possible error messages explained. 38.16 (26.02.95): Fix: Pubscreens couldn't be recognized if OPS = ON. [reported by Hanno] @{b}Release 1.5:@{ub} 38.15 (16.02.95): Chg: The bars layer will get locked only direct around Int.PrintIText(). Doc: Start from Workbench explained. Doc: Icon added! 38.14 (15.02.95): Chg: Under OS v38, background color is 2, foreground color is 1. That should be the right combination!? Fix: If an autoscroll-screen with leftedge = 0 is used, the x pos. was calculated as if it was a normal screen. 38.13 (14.02.95): New: If the layer and the pub-screen was locked at the end of the program, they will be unlocked. This could (!) occure, if ScreenClock gets breaked during the calculating of a new date/time/mem-string by an error. This should avoid the rarely occured 'hanger'. 38.12 (13.02.95): New: Some NIL-checks added. New: The actual screen will be compared with the screen which was actual before calculating a new date/time/mem-string. This should make the program a little more stable with non-public-screens. 38.11 (12.02.95): Chg: Under OS v38, the shadow-pen (instead of the shine-pen) will be used as the background color. 38.10 (11.02.95): New: Option 'AV=AlwaysVisible' -> date/time/mem always visible? Default is ON! 38.9 (09.02.95): New: The date/time/mem is always visible! Usefull for oversized (autoscroll) screens! Doc: Examples for the option @{"Screens" link Arg_Screens} @{b}Release 1.4:@{ub} 38.8 (29.01.95): Fix: Screens with a title but no titlebar won't be used anymore! Chg: The screen will be written with Intuition.PrintIText(), so the rare 'color-changes' of the titlebar shouldn't appear anymore! Because this proc. sets the front- and backPen! Chg: Therefore ScreenClock doesn't needs a special version for OS v39! Also it won't be check anymore if OS is >= v38 (2.1)! Fix: FreeScreenDrawInfo() forgotten;-( Chg: It doesn't checks anymore before writing if a non-public screen is closed! @{b}Release 1.3a:@{ub} 38.7 (28.01.95): Fix: Check, if the barLayer is allready locked. If so then don't wait until its free! @{b}Release 1.3:@{ub} 38.6 (27.01.95): New: 'OPS=OnlyPubScreens/T' -> use only public screens? New: If the actual screen is public, it will be locked during writing, to prevent it of beeing closed! If not, it will be checked if its not closed yet before Gfx.Text(). Fix: 'Ugly' displays should be the past. New: 'Pri=TaskPriority/K/N' -> Priority of the task. -3 <= pri >= +3 New: Notify on 'ENV:sys/locale.prefs' 38.5 (26.01.95): Fix: Screen.barLayer is locked during the action. @{b}Release 1.2:@{ub} 38.4 (13.01.95): New: The right pens (like the titlebar) should (!) be used now. New: Two different versions for OS2.x (>=v38) and O3.x (>=v39) It will be checked during start. Fix: CloseLocale() have been forgotten at the end;-( Fix: Locale.FormatDate() appends one 0X too many on some formats (the abreviated!), therefore the date could be one char too short. Fix: If the notify fails, has been Dos.EndNotify() called though. Some cleaning ups. @{b}Release 1.1:@{ub} 38.3 (12.01.95): Fix: The reloading of the parameters didn't acts like it should. New: If MF = "" or DF = "" the defaults will be set again. 38.2 (11.01.95): New: The env var will be reloaded on changes! Chg: Option 'Memory' changed to a toggle option, s. docs 38.1 (09.01.95): Chg: Locale.FormatDate() instead of Dos.DateToStr() and SPrintF() used. Therefore the version bumps to 38! Chg: 'Seconds/S' isn't supported anymore. New: Option 'DF=DateFormat/K' -> Format of the date/time New: Option 'MF=MemoryFormat/K' -> Format of the memory New: Environment variable (ScreenClock) for the parameters @{b}Release 1.0:@{ub} 37.3 (05.01.95): New: Option 'Memory/S' -> show the memory too. Chg: Some internal changes -> less time needed!? 37.2 (03.01.95): New: Option 'Screen/K' - pattern for screens to use. New: A msg-port added to quit if double started. 37.1 (02.01.95): Beginning, because I realised that the clock is the only cause for KCX running;-) @{b}@{u}Abbreviations:@{uu}@{ub} New: Something new added. Chg: Something has changed. Fix: Some bugs removed. Doc: Documentation changed/improved. @ENDNODE @NODE Me "ScreenClock/How to contact me?" @{LINDENT 3} If you have suggestions, bug reports or any question you can reach me by the following addresses, e-mail preferred! eMail : T.Igracki@gmx.de WWW : http://softory.home.pages.de/ Mail : Thomas Igracki, Siegener Str. 34, Germany-13583 Berlin If you want to send me some money for my work on @{b}ScreenClock@{ub}, then send it by cash or transfer it to the following bank-account: Thomas Igracki Account 860 169 138 Sparkasse Berlin BLZ 100 500 00 Please add a note like "Gift for ScreenClock ". If you send me an email, I will notify you if a new version is out and send it to you if desired! At least you should write me an email if like my program! Have fun with my program! @ENDNODE @NODE SysInfo "SysInfo.library by Petri Nordlund" SysInfo.library ~~~~~~~~~~~~~~~ SysInfo.library was developed to bring together all the different utility programs that add some new features to Amiga task handling, like CPU usage calculation. SysInfo.library was first developed for Executive, but it's possible to rewrite it to support other similar programs. It's not necessary to support all SysInfo.library functions in all implementations. Please consult the file `SysInfo.doc' for more information. The provided examples can be compiled with GCC or SAS/C. You must copy the libs/SysInfo.library to your libs: directory. Copy the include files to appropriate directory: GCC: GCC:os-include/ SAS/C: INCLUDE: If you're using GCC, you must also copy the files in gcc/lib/ to GCC:lib/ and files in gcc/os-include/ to GCC:os-include/. @ENDNODE