home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: InfoMgt / InfoMgt.zip / dskclk10.zip / DeskClk.inf (.txt) < prev    next >
OS/2 Help File  |  2000-01-04  |  10KB  |  193 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. This is configurable clock for your Desktop. You can configure date and time 
  5. display and add your message to display with date and/or time. When started, 
  6. Desktop Clock becomes (and remains) the bottom window - behind all other 
  7. windows on your Desktop. Click on Desktop Clock's area (message text, date or 
  8. time display), brings Desktop Clock to the foreground. 
  9.  
  10. Features 
  11.  
  12.      Various date and time display formats 
  13.      User's message (stopped or scrolling from right to left) 
  14.      Selectable foreground and background color, position, size, font and 
  15.       fontsize 
  16.      Source code for Desktop Clock is included - to modify source, you need 
  17.       DrDialog, a visual programming environment for REXX. 
  18.  
  19.  REXX MUST BE INSTALLED ON YOUR SYSTEM TO RUN DESKTOP CLOCK AND INSTALL 
  20.  PROCEDURE. 
  21.  
  22.  Files in archive dskclk10.zip: 
  23.  
  24.       File name           Description 
  25.       DeskClk.exe         Desktop Clock - program 
  26.       DeskClk.ico         Desktop Clock - icon 
  27.       DeskClk.inf         Desktop Clock - manual (this file) 
  28.       DeskWPS.cmd         Desktop Clock - installation procedure 
  29.       source.zip          Source files for Desktop Clock 
  30.  
  31.  File FastIni.dll (not included in this archive) is not required, but it's 
  32.  recommended for faster reading/writing to configuration file. 
  33.  
  34.  Installation procedure (DeskWPS.cmd) writes Desktop Clock's specific entry in 
  35.  OS2.INI file, App ToolsByGoran, creates Desktop Clock's program object on your 
  36.  Desktop and creates shadow of Desktop Clock in startup folder (if you select 
  37.  so). 
  38.  
  39.  To Install Desktop Clock, run install procedure with parameter i - DeskWPS i. 
  40.  If you have previous version (0.90) installed, uninstall it before installing 
  41.  Desktop Clock 1.00 (to do it go to Desktop Clock 0.90 directory and run 
  42.  install procedure with parameter i - DeskWPS i). 
  43.  
  44.  On first start, Desktop Clock will create configuration file (DESKCLK.INI) 
  45.  with default values. Desktop Clock resides on Desktop behind all other 
  46.  windows, until you click on it (bring it to front). If it is invisible (i.e. 
  47.  hidden behind other opened windows), select Desktop Clock in Window List 
  48.  (press Ctrl-Esc). Then you can use following keys: 
  49.  
  50.  F1   Show Help (this document) 
  51.  F9   Open Settings dialog 
  52.  F3   Exit Desktop Clock. 
  53.  
  54.  If you want to uninstall Desktop Clock, run install procedure with parameter u 
  55.  - DeskWPS u 
  56.  
  57.  
  58. ΓòÉΓòÉΓòÉ 2. Settings ΓòÉΓòÉΓòÉ
  59.  
  60. When you click on Desktop Clock's area (message text, date or time display) and 
  61. press F9 key, Settings dialog opens. Following values can be changed: 
  62.  
  63.  Message 
  64.       Enter your message (32 characters max) to display with date and/or time. 
  65.       Message text can be Stopped (text will not move), or you can select to 
  66.       Scroll message text from right to left (it will act like banner). 
  67.  
  68.  Color settings 
  69.       Select foreground (Font radio button) and background (Back radio button) 
  70.       color. 
  71.       Use spin buttons for Red, Green and Blue components until you get desired 
  72.       color. 
  73.  
  74.  Font settings 
  75.       Select one of displayed font names in the list and select it's style 
  76.       (Bold and/or Italic). You can select Font size (between 8 and 100). 
  77.  
  78.  Size settings 
  79.       X position - left edge of Desktop Clock (in pixels - between 0 and screen 
  80.       width-150), 
  81.       Y position - bottom edge of Desktop Clock (in pixels - between 0 and 
  82.       screen height-50), 
  83.       Width (in pixels - between 150 and screen width), 
  84.       Height (in pixels - between 50 and screen height). 
  85.  
  86.  Date settings - format of date display: 
  87.       Year 
  88.       Month - (01, 02, 03 ...). If you select to display month, then month name 
  89.       is disabled. 
  90.       Month name - (Jan, Feb, Mar ...). If you select to display month name, 
  91.       then month is disabled. 
  92.       Day (01, 02, 03 ...) 
  93.       Day of week - (Mon, Tue, Wed ...) 
  94.  
  95.  Time settings - format of time display: 
  96.       Hours 
  97.       Minutes 
  98.       Seconds 
  99.       AM/PM - AM/PM mode - 12-hour display. 
  100.       Refresh - refresh rate in time display (between 1 and 59 seconds). 
  101.  
  102.  After you changed settings values press Apply button to refresh display. 
  103.  If you don't like new settings, press Default button to reset changes and load 
  104.  default settings. Then you can change settings again. 
  105.  
  106.  Note:  If configuration file (DESKCLK.INI) is missing or dammaged, Desktop 
  107.         Clock will create new configuration file with default values. 
  108.  
  109.  
  110. ΓòÉΓòÉΓòÉ 3. Tips & tricks ΓòÉΓòÉΓòÉ
  111.  
  112.  Limitations 
  113.       If you are using background bitmap for your Desktop, Desktop Clock's 
  114.       border is always visible. If somebody knows how to set transparent 
  115.       background for DrDialog controls, please let me know. 
  116.  
  117.  Background color 
  118.       Desktop Clock reads background color from OS2.INI file and uses it as 
  119.       Desktop Clock's background color (trying to do "seamless" integration 
  120.       with background. If this color does not match with real background color 
  121.       on your Desktop, open Settings dialog (press F9 key) and change 
  122.       background color. 
  123.       To get correct values for RGB components, open Desktop's Settings 
  124.       notebook, select Background page, press Change color button and read red, 
  125.       green and blue values of background color. Select identical values in 
  126.       Desktop Clock's Settings dialog for it's background color (select Back 
  127.       radio button). 
  128.  
  129.  Size (width and height, font size) 
  130.       Desktop Clock keeps itself at the bottom of all the windows on the 
  131.       screen. The desktop icons are part of the Desktop, and if you maximize 
  132.       Desktop Clock's width and height (to the screen width and height), whole 
  133.       Desktop (and icons!) will be hidden. 
  134.       Suggestion: sort desktop icons and set Desktop Clock's size smaller than 
  135.       screen size to keep desktop icons visible. If you want to set Desktop 
  136.       Clock's size to screen size, add your favorite folders and programs to 
  137.       LaunchPad (called Toolbar in Warp 4). It will be above Desktop Clock. 
  138.  
  139.       Note:  DO NOT use Desktop Clock and "wallpaper" programs at the same 
  140.              time, because both attempt to remain on the Desktop. 
  141.  
  142.  Refresh time and "flashing" 
  143.       Desktop Clock updates time display every second. If you see annoying 
  144.       "flash", increase refresh rate (up to 59 seconds) and/or unselect seconds 
  145.       display. 
  146.  
  147.  New fonts 
  148.       Here are three predefined fonts: Courier, Helvetica and Times New Roman. 
  149.       To add new font, exit Desktop Clock (if it is running), edit DESKCLK.INI 
  150.       file, Application: DeskClock, Key: Fonts, and add new font name. Font 
  151.       names must be separated with space, and spaces within font name must be 
  152.       changed with _ character (like Times_New_Roman in predefined fonts). 
  153.       Next time you start Desktop Clock, there will be new font in the list and 
  154.       you can select it. 
  155.  
  156.       Note:  Don't add system fonts (like System Proportional or WarpSans) to 
  157.              Font list - you won't be able to select font size you want. 
  158.  
  159.  
  160. ΓòÉΓòÉΓòÉ 4. About ΓòÉΓòÉΓòÉ
  161.  
  162.  Author         Goran Ivankovic 
  163.  Address        Ulica Josipa Poduje 8 
  164.                 HR-52100 Pula 
  165.                 Croatia 
  166.  email          duga1@pu.tel.hr 
  167.  Home page      http://Goran_Ivankovic.tripod.com/ 
  168.  
  169.  This program is provided free under the terms of the GPL. You can use it, 
  170.  modify it and distribute it. If you modify or distribute it the new source 
  171.  must accompany the distribution. I would appreciate a copy of any changes. 
  172.  You may not distribute Desktop Clock 1.00 in any way which leads to your 
  173.  making a profit from it. 
  174.  
  175.  The author makes no representations about the accuracy or suitability of this 
  176.  material for any purpose. It is provided "as is", without any express or 
  177.  implied warranties. The author will assume no liability for damages either 
  178.  from the direct use of this product or as a consequence of the use of this 
  179.  product. 
  180.  
  181.  Thanks to people who tested Desktop Clock and helped me with their comments 
  182.  and suggestions: 
  183.       David Coward 
  184.       Brian Crook 
  185.       Kaare Thor Olsen 
  186.       Klaus Staedtler - special thanks for Desktop Clock's icon :) 
  187.  
  188.  Ideas, comments, corrections, suggestions and bug reports are welcome. 
  189.  
  190.      OS/2 is Trademark of International Bussines Machines Corporation 
  191.      DrDialog is Copyright of International Bussines Machines Corporation 
  192.      FastIni.dll is Copyright of Dennis Bareis - OS/2 Developer in Australia 
  193.