home *** CD-ROM | disk | FTP | other *** search
-
- vclock/vclock vclock/vclock
-
- VCLOCK.DOC
-
- A DIGITAL VECTOR CLOCK
-
- Tobias Ferber
- Goethestraße 32
- 76135 Karlsruhe
- Deutschland
-
- ukjg@ibm3090.rz.uni-karlsruhe.de
-
-
- VCLOCK [options]
-
- VCLOCK a utility like Commodore's Clock. It opens a sizable window
- showing the current time using 7 segment digits. It's main purpose
- however is not to come up with an impressing amout of functionality
- but to show you the simple usage of the timer.device and AreaXXXX()
- functions in the graphics.library.
-
- VCLOCK and source is in the PUBLIC DOMAIN. I claim no copyright at
- all. That means you can do with it whatever you want -- you may even
- sell it (if you can find anyone who would like to pay for it :)
- However donations in any form are not rejected -- preferably post
- cards with a photo of YOUr home-town and the name of the program
- i.e. VCLOCK in this case.
-
- OPTIONS
-
- VCLOCK supports both AmigaDOS and UNIX style options (with a leading
- minus sign '-'). Options may occur anywhere on the command line but
- they *MUST* occur singly. I.e. -a -b instead of -ab. Options
- requiring a (numeric) value may occur with or without an intervening
- space. -x17 and -x 17 are both legal. Last applies to the UNIX
- style options only; AmigaDOS keywords MUST be seperated with one or
- more spaces from their value. The usage of an equals sign '=' instead
- of a space character is NOT legal. All options must of course be
- seperated with one or more spaces.
-
- VCLOCK options are NOT case-sensitive except for the ToolTypes entries
- which are due to the FindToolType() function in the icon.library.
- This may change in future revisions of this library. ToolType keywords
- are the same as the AmigaDOS keywords.
-
- Here is a short overview of legal options:
-
- X/N,Y/N,WIDTH/N,HEIGHT/N,SETPEN/N,UNSETPEN/N,OUTLINE/N,BACKFILL/N,
- BORDERLESS/S,BACKDROP/S,NOTITLE/S,NOGADGETS/S,BLANK/N:
-
- X or '-x' opening position; left edge (default 0)
- Y or '-y' top edge (default 0)
- WIDTH or '-w' initial window size; width (default 350)
- HEIGHT or '-h' height (default 55)
- SETPEN or '-s' pen used for set segments (default 2)
- UNSETPEN or '-u' for unset segments (default 3)
- OUTLINE or '-o' for segment's outline (default 0)
- BACKFILL or '-b' to fill the background (default 3)
- BORDERLESS or '-i' don't render the window border
- BACKDROP or '-d' force vclock to be behind all other windows
- NOTITLE or '-t' don't display the date in the window title
- NOGADGETS or '-g' do not render system gadgets
- BLANK or '-q' open screen and show clock w/ given colour table
-
- You can get this list by simply starting VCLOCK with a '?' as argument.
- The trailing /N in AmigaDOS options indicates the need of a [N]umerical
- argument to a keyword. This parameter is considered a decimal number.
- If an invalid number is specified, an error will be returned. The '/N'
- must not be typed in command-line with the keyword.
-
-
- -x <xpos> set the left edge of the VCLOCK window to <xpos>.
- <xpos> therefore must be a numerical argument >= 0.
-
- -y <ypos> set the top edge of the VCLOCK window to <ypos>.
- <ypos> therefore must be a numerical argument >= 0.
-
- The specified (x|y) position is moved towards (0|0)
- if your width and/or height value would blow up the
- size of the Workbench Screen.
-
- -w <width> set the width of the VCLOCK window to <width>.
- <width> therefore must be a numerical argument >=0.
-
- -h <height> set the height of the VCLOCK window to <height>
- <height> therefore must be a numerical argument >=0.
-
- If your width and/or height values were beyond the scope
- of the Workbench Screen size then VCLOCK tries to move
- your window towards the top left corner of the screen.
- Only if they are still too large they are shrunk.
-
- -s <pen> Specify the pen used for set segments of the lcd digits.
-
- The number of available pens is limited by the depth of
- of your Workbench Screen. There are 2^n pens available
- if n is the number of bitplans in your Workbench Screen.
-
- -u <pen> Specify the pen used for unset segments of the lcd digits.
-
- -o <pen> Set the outline pen of all lcd segments no matter if
- they're set or not. Set this value to either setpen
- or unsetpen to hide unset segments.
-
- -b <pen> Set the background colour. What has been said about pens
- in the description of the '-s' option applies to all pens
- of course.
-
- -i The intuition WFLG_BORDERLESS will be set for vClock's window.
- This will result in a window sans border.
-
- -d vClock's window will open and stay behind all other windows.
-
- -t No window title will be rendered. This might be what you're
- looking for when trying out BORDERLESS and NOGADGETS option.
-
- -g No system gadgets will be rendered. In fact the will won't
- even be a closing gadget. To quit vClock there now is a
- Project/Quit menu item.
-
- -q [map] This option is a by-product of a screen blanker. It should
- be the only option in the command line. However it doesn't
- really need to be the only one but all the other options
- will be ignored ;)
-
- In fact this type of "blanker" hasn't been realized since
- the main idea of a screen blanker is to change or turn off
- the display in order to save monitor lifetime. All this
- does not apply to what you get using the '-t' option. :)
- What you get is a HIRES screen with a centered lcd clock.
- Additionally you may destroy everything that reminds you
- of a blanker by specifying the colour table id [map].
- There are 6 (0..5) built-in colour maps -- try them out.
-
- That's all. Have fun
-
-
- -Tobi
-