VClock v1.7c
-------------

This is a real speech clock. It runs as a commodity, uses little memory,
and has some neat features.

- 12 or 24 hour clock
- AM/PM(12hr) or Hours(24hr) endings can be turned off or on
- Hourly, 1/2 hour, and 1/4 hour Chime
- VClock can be deactivated at any time.
- High quality 8-bit samples, sampled at 22Khz
- Enhanced Chime. Voice, Chime, or both.
- Samples can be replaced by your own voice if you have a sampler
  handy
- Uses Play16.
- Prefs Window. Now you can edit, test, and save most of VClock's
  prefs with this window.
- Option to Speak On Startup (S.O.S)
- Tooltypes

Requirements:
-------------

- Amiga
- OS 2.x+
- Play16 1.8+
- 512K ram

Usage:
------

Click on it or throw it in your WBStartup Drawer. If you move the main
exe out of the VCLock dir (like the WBStartup drawer) don't forget to set
the PATH tooltype in VClock's Icon.


CX_ Keys can be changed to any combination you like.


Tooltypes that VCLock Sets.

NOTE: Only the CX_ tooltypes need to be edited by hand, The rest can be
saved through the new Prefs Window.

PATH      - < path > where ever your samples for VClock are.

PLAY16    - The Play16 file by name and path.

24Hr      - Sets 24hr mode: 0=OFF  1=ON

BEGINING  - Intro for the time. 0=OFF  1=Begining 1  2=Begining 2

FORMAT    - Short or Long versions of the time: 0=OFF  1=ON (default)

S.O.S     - Speak On Startup. Will say the time when VClock is first
            started. 0=OFF   1=ON (default)

NOTIFY    - Speak the time every 1/2 hour or every hour on the hour:
            0=OFF  1=Every hour on the hour   2=Every 1/2 hour

CHIME     - 0=Voice  1=Chime  2=Both

CHIMEONCE - 0=OFF  1=ON. If OFF the Chime will sound according to what hour
            it is, ie: 9:00 the chime will sound 9 times. If ON it will
            sound only once and the time will be spoken on the hour.

VOLUME    - Sets how loud or quiet VClock speaks. (0-100) 100 is the default.

CX_SPEAK  - Hotkey to make VClock speak (lshift lalt f10).

CX_SLEEP  - Hotkey to turn make VClock quiet. On or off (lshift lalt z). This
            only has an effect if the NOTIFY is on."

CX_SHOW   - Brings up VClock's Prefs Window. (lshift lalt v)


Making your own Samples:
-----------------------

It is very easy. Just get a microphone and a sampler and sample your own.
Listen to the samples in the VSamples dir. Make your samples and replace
the old files with yours or make a new directory and have VClock use those
instead.


I added a real Chime, So I changed "Chime" in the prefs window to "Notify"
Play with the prefs window to see what it does. The chime will ring out the
hours aswell, ie: At 3:00 it will chime 3 times if the Once gadget is set
to off.


History
-------

1.0   - Wrong tooltype, should have been ENDING, not HOURS

1.0b  - Changed audio channel mask to channels #2 and #3. Seems to be a bit
        more friendly when other sounds try to use the audio.device.

1.0c  - Added Commodity Support

1.0d  - Chime added

1.0e  - Play16 used now for audio playback. Tooltype for Play16 path and
        name added.
      - 2 alternate Beginings:
        Begining=1 will say "The Time Is"
        Begining=2 will say "It Is Now"

1.0f  - 24 hour and Beginning phrase was somewhat messed up. Fixed.

1.0g  - Chime can now be set to 1/2 hour and every hour on the hour or both.

1.0h  - Resampled "OClock" and "AM" samples.

1.1   - Added Chime Hotkey to turn Chime on or off while VClock is running.
      - Volume Toolype added.
      - Aminet Release.

1.2   - Added the Prefs Window
      - 1/4 hour chime option added.
      - Added Play16 argument string gadget. Gives you more control
        over how Play16 plays the samples.
      - Changed default CX hotkeys. Should not conflict with popular
        applications.
      - CX_Quit hotkey is no longer needed. Use the CX_Show to access the
        Prefs window and quit from there.
      - Changed "Begining" tooltype to "Intro"
      - VisualPrefs workaround. Damn hacks!

1.3   - Proper format for 24 hour speech. I think :)
      - Resampled "0.iff" (oh). Sounds much better than the older one.
      - FORMAT Tooltype replaces ENDING. Short or Long versions of both
        AM/PM and 24hr modes can be used.

1.4   - Fixed FORMAT Tooltype. Was not being set porperly.
      - Added Speak On Startup (S.O.S)



1.5   - Path Requester will automatically pop up if the VClock Samples can
        not be found.
      - Default Hotkey CX_Show changed to "lshift lalt v"
      - CX_Chime changed to CX_Sleep (This it to avoid confusion with the new
        Chime function. Default Hotkey is "lshift lalt z"
      - Changed Chime to Notify.
      - Chime is now better. Can be Voice, Chime, or both
        Default Chime is Cuckoo.iff. Feel free to replace this wacky bird
        with something else.
      - Version String Changed

1.6   - Sorry, I skipped to 1.7 :)

1.7   - Fixed some bugs that made VClock misbehave
      - Removed the Play16 Args parameters. Who cares
        anyway :)

1.7b  - VClock quits properly now. No longer messes up the system. Various
        other program exit related problems fixed as well.

1.7c  - Fixed: Chime didn't work properly.
      - Fixed: Notify would run every 15 minutes regardless of of it's
               setting. Thanks to Daniel Westerberg for bringing this to
               my attention.



This is the last version of VClock. Thanks to all who helped in bug reports.

If you find this thing useful or have any comments or suggestions, please
e-mail me at splayersrogers.com. Feel free to check out SPlayer 1.9e.
The Mpega/Play16/Audio CD GUI. It's on Aminet under mus/play

Regards,
Allan Versaevel

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  720    1687  42.7% -lh5- 0945 Dec 31  2001 VClock_v1.7/VClock.info
[generic]                 4614    8454  54.6% -lh5- 0ff7 Dec 24  1997 VClock_v1.7/VSamples/9.iff
[generic]                 7715   18182  42.4% -lh5- 90d2 Oct 30  1998 VClock_v1.7/VSamples/AM.iff
[generic]                 6951   11720  59.3% -lh5- 385f Mar  7  1999 VClock_v1.7/VSamples/Cuckoo.iff
[generic]                 7817   13026  60.0% -lh5- 383e Jan  4  1998 VClock_v1.7/VSamples/Hours.iff
[generic]                 8183   15350  53.3% -lh5- 5a28 Dec  9  1998 VClock_v1.7/VSamples/Mins.iff
[generic]                11368   20788  54.7% -lh5- c94f Oct 22  1998 VClock_v1.7/VSamples/Now.iff
[generic]                 6826   14666  46.5% -lh5- 7dee Oct 30  1998 VClock_v1.7/VSamples/OClock.iff
[generic]                 6861   13190  52.0% -lh5- 0138 Dec 24  1997 VClock_v1.7/VSamples/PM.iff
[generic]                18192   30068  60.5% -lh5- 8b4d Oct 22  1998 VClock_v1.7/VSamples/Time.iff
[generic]                 7783   13768  56.5% -lh5- 0b2e Jan  4  1998 VClock_v1.7/VSamples/Zero.iff
[generic]                11969   19254  62.2% -lh5- 8b79 Jan  4  1998 VClock_v1.7/VSamples/21.iff
[generic]                11331   19228  58.9% -lh5- f7ec Jan  4  1998 VClock_v1.7/VSamples/22.iff
[generic]                10480   17968  58.3% -lh5- dca6 Jan  4  1998 VClock_v1.7/VSamples/23.iff
[generic]                 4816    9878  48.8% -lh5- 1688 Dec  9  1998 VClock_v1.7/VSamples/3.iff
[generic]                 5234    8256  63.4% -lh5- 5f02 Mar 25  1999 VClock_v1.7/VSamples/30.iff
[generic]                 5997   11848  50.6% -lh5- e1c4 Dec 24  1997 VClock_v1.7/VSamples/30.iff.bak
[generic]                 4653    8828  52.7% -lh5- e88f Dec 24  1997 VClock_v1.7/VSamples/4.iff
[generic]                 6886   12518  55.0% -lh5- 84fc Dec 24  1997 VClock_v1.7/VSamples/40.iff
[generic]                 4971    9164  54.2% -lh5- ff65 Jan  4  1998 VClock_v1.7/VSamples/5.iff
[generic]                 6622   11848  55.9% -lh5- 8e36 Dec 24  1997 VClock_v1.7/VSamples/50.iff
[generic]                 7060   11848  59.6% -lh5- 1f6a Dec 24  1997 VClock_v1.7/VSamples/6.iff
[generic]                 6933   13524  51.3% -lh5- ea79 Dec 24  1997 VClock_v1.7/VSamples/7.iff
[generic]                 4280    7150  59.9% -lh5- c8ed Dec 24  1997 VClock_v1.7/VSamples/8.iff
[generic]                 4827    8492  56.8% -lh5- 43ef Dec 24  1997 VClock_v1.7/VSamples/1.iff
[generic]                 5645    9834  57.4% -lh5- 9069 Dec 24  1997 VClock_v1.7/VSamples/10.iff
[generic]                 7112   11848  60.0% -lh5- 15f8 Dec 24  1997 VClock_v1.7/VSamples/11.iff
[generic]                 6112   11176  54.7% -lh5- 22e1 Dec 24  1997 VClock_v1.7/VSamples/12.iff
[generic]                 8526   15538  54.9% -lh5- 8d38 Dec 24  1997 VClock_v1.7/VSamples/13.iff
[generic]                 8403   15538  54.1% -lh5- 57f0 Dec 24  1997 VClock_v1.7/VSamples/14.iff
[generic]                 9113   16210  56.2% -lh5- 4599 Dec 24  1997 VClock_v1.7/VSamples/15.iff
[generic]                10432   18222  57.2% -lh5- eac5 Dec 24  1997 VClock_v1.7/VSamples/16.iff
[generic]                11622   20906  55.6% -lh5- 58d0 Dec 24  1997 VClock_v1.7/VSamples/17.iff
[generic]                 8765   16210  54.1% -lh5- 3809 Dec 24  1997 VClock_v1.7/VSamples/18.iff
[generic]                 9289   18222  51.0% -lh5- b32e Dec 24  1997 VClock_v1.7/VSamples/19.iff
[generic]                 4101    8492  48.3% -lh5- 4a01 Dec 24  1997 VClock_v1.7/VSamples/2.iff
[generic]                 5447    8828  61.7% -lh5- 232b Dec 24  1997 VClock_v1.7/VSamples/20.iff
[generic]                  608    1032  58.9% -lh5- 6e06 Dec 30  2001 VClock_v1.7.info
[generic]                  326     840  38.8% -lh5- 0d1c Dec 30  2001 VClock_v1.7/VClock.doc.info
[generic]                 4580    7476  61.3% -lh5- 1099 Dec 12  1998 VClock_v1.7/VSamples/0.iff
[generic]                 6268   12220  51.3% -lh5- 3f2f Jan  4  1998 VClock_v1.7/VSamples/00.iff
[generic]                 2677    5845  45.8% -lh5- c6b6 Jan  8  2003 VClock_v1.7/VClock.doc
[generic]                45172   94328  47.9% -lh5- a7e6 Jan  8  2003 VClock_v1.7/VClock
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        43 files  337287  623468  54.1%            Jan 17  2003