@database
@node MAIN
@title "MR. WOLF"
@{fg shine}                                   MR. WOLF@{fg text}
                         The cheeky, speaking-clock.
                               (version 3.2)
                       © Copyright Vic E Babes (98/99)
                                 @{fg shine}/@{fg text}\        @{fg shine}/@{fg text}\
                                @{fg shine}//@{fg text}\\      @{fg shine}//@{fg text}\\
                               @{fg shine}||  @{fg text}||    @{fg shine}||  @{fg text}||
                               @{fg shine}||  @{fg text}||@{fg shine}____||  @{fg text}||
                               @{fg shine}||            @{fg text}||
                              @{fg shine}//              @{fg text}\\
                             @{fg shine}||                @{fg text}||
                            @{fg shine}//     @{fg text}(@{fg shine})    @{fg text}(@{fg shine})     @{fg text}\\
                           @{fg shine}||         __         @{fg text}||
                            @{fg shine}\\       (@{fg text}__)       //
                             @{fg shine}\\ @{fg text}_            __//
                                @{fg shine}\\          @{fg text}//
                                 @{fg shine}\\   @{fg text}(@{fg shine})   @{fg text}//
                                  @{fg shine}\\      @{fg text}//
                                   @{fg shine}\\ @{fg text}___//

                        @{" What time is it, Mr. Wolf? " link Contents}
@endnode

@node Contents
@title "MR. WOLF"
@{fg shine}                                   MR. WOLF@{fg text}
                         The cheeky, speaking-clock.
                               (version 3.2)
                       © Copyright Vic E Babes (98/99)
@{fg shine}@{i}                         What time is it, Mr. Wolf?@{ui}@{fg text}

                 @{"Rainbow Islands" link RI} : VERY IMPORTANT!!!
                 @{"Legalities     " link Distribution} : Not as important!
                 @{"Requirements   " link Requirements} : Importantish.

                 @{"What       " link Description} : is it?  Why is it here?
                 @{"Launching  " link Launch1} : How to run Mr. Wolf.
                 @{"Operating  " link Operating1} : What your mouse-buttons do.
                 @{"Preferences" link Preferences1} : How to change colours, etc.

                 @{"Talk-2-Me  " link information} : speech GUI on Aminet.

                 @{"Credits    " link Credits} : Inspiration and stuff.
                 @{"Blitz      " link Blitz} : Notes for Blitz programmers.
@endnode

@node information
@title "MR WOLF"

                @{fg shine}Talk-2-Me@{fg text}

  I think that Amiga speech (especially since V37) is good enough to
  be used, for example, in a Monkey Island type game.  For this
  reason, after finishing this version of Mr. Wolf, I decided to write
  a GUI that is geared towards the fast creation of voices and sentences
  that can be saved to disk, and exported as data statements for inclusion
  in your source-code.

  FEATURES:

  * A listview in which you can store upto 50 voices, and save them to
    disk.  Can be set to automatically speak the current sentence when
    you click on a voice in the listview - for quick testing of sentences
    with different voices.

  * Slider gadgets for altering V36 and V37 settings.  Can be set to
    automatically speak the current sentence whenever you release one
    of these gadgets.

  * A listview in which you can store upto 100 sentences, and save them
    to disk.  Can be set to automatically speak the sentence that you
    click on, in the listview, for quickly testing lots of sentences
    with one voice.

  * A search facility for finding specific sentences in the listview.

  * The 'sentence' string-gadget can be set to automatically speak when you
    press [RETURN], and will reactivate itself, so that you can quickly
    make changes to a sentence to get it sounding right.

  * An Export facility, for exporting voices/sentences as data statements
    for direct inclusion in source-code.  Ability to state which features
    of the speech settings should be included, so that you can exclude
    what you don't need (i.e. volume).

  * Some example sentences to show you different ways of achieving stress
    and inflection, i.e. 'no' sounds different to 'kno'.

  Talk-2-me should be on Aminet within a week of the upload of Mr. Wolf.

 @{"Cool..." link Contents}@{fg text}
@endnode

@node Description
@title "MR. WOLF"
@{fg shine}
 Who wants a speaking-clock that only tells you the time?  Not me!
@{fg text}

 Version 3.2 is a bugfix of version 3.0, which I managed to get
 deleted off Aminet.  I apologize to anyone who had the misfortune
 to download it during the few days it was on there.

 Mr. Wolf opens a transparent window, on the current screen, with
 a picture of himself in it.

 He adjusts his aspect-ratio and size according to the screen's
 resolution.

 Click above his eyes, and he will tell you the day and the date.

 Click below his eyes, and he MIGHT tell you the time, or he might not:
 because Mr. Wolf is the cheekiest clock you've ever met (so far).

 He tells you the time, roughly, i.e. ~nearly half-past three", and he
 has a reasonably acceptable voice, and a fair attempt at inflection.

 He also has special messages for you at Christmas and such-like - if
 you're sad enough to be using your Amiga on Christmas day.  Not too
 many of these, as different English-speaking countries, have
 different 'special days' - I'm not even sure that April Fool's day
 exists in Australia/America, etc.

 Mr. Wolf will also let you know if your system clock has been trashed.
@{fg shine}
 @{"So that's what it is..." link Contents}@{fg text}
@endnode

@node Launch1
@title "MR. WOLF 3.2"
@{fg shine}
                         Launching Mr. Wolf
@{fg text}
 To launch Mr. Wolf, just double click his icon, or stick the program
 in your WBStartup drawer.  Make sure DONOTWAIT is in the icon's
 tool types.

 The only thing you need from this archive is the Mr. Wolf program,
 the prefs.pic is used by the guide, and can be deleted once you are
 familiar with Mr. Wolf.
@{fg shine}
 @{"End of Launching..." link Contents}
@{fg text}
@endnode

@node Operating1
@title "MR. WOLF 3.2"
@{fg shine}
                         Operating Mr. Wolf

LMB@{fg text} Click the left mouse-button above his eyes and he will tell you
    the date.

    Click the left mouse-button below his eyes and he MIGHT tell you
    the time - if he's in the mood.
@{fg shine}
RMB@{fg text} Click the right mouse-button ON his window and it will change
    to one that can be dragged to another area of the screen.  Click the
    window's close-button when you are happy with its new position.

    NOTE: the window needs to be active in order ot read the RMB - if you
    use a commodity that activates the window that the mouse-pointer is over,
    you don't need to worry about this, otherwise, you'll need to activate
    the window with the LMB first.

    In the window will be one gadget, with a "-" in it.  If you use a hi-res
    mode, and you can't see this gadget, then you must be using a screen
    font >12 - in that case - why are you using such a large screen font, in
    such a low screen res?

    If you want to change Mr. Wolf's colours, click on the "-" gadget; the
    reason this gadget uses a "-" is because I wanted his draggable window
    to be kept the same size as his normal window, and in hi-res mode, there
    isn't enough room for a gadget that can display anything bigger - all
    other modes are fine though.

@{fg shine}
RMB/LMB-combo@{fg text} Hold the left mouse-button and click the right, or hold
              the right mouse-button and click the left to quit - the
              one that works depends on whether you've got MultiCX
              running or not (as, for some reason,  this affects the
              values read by Blitz Basic for mouse-button presses).
@{fg shine}
 NOTE@{fg text} When I say that Mr. Wolf's window is transparent, that is
      not, strictly-speaking, true.  The truth is that Mr. Wolf grabs an
      image of whatever is behind his window, and copies it into his
      window.

      This means that if you change your workbench pattern/picture while
      Mr. Wolf is running, he'll still have what was your previous pattern
      in his window.

      Or if you have a window open underneath him when he is launched, he
      will look a bit odd when you close that window.

      To remedy this, simply bring up his draggable window with a RMB click
      and then close it again.  Mr. Wolf will then grab the image again.

@{fg shine}
 @{"End of Operating..." link Contents}
@{fg text}
@endnode

@node Preferences1
@title "MR. WOLF 3.2"
@{fg shine}
                              Preferences

 @{"View preferences image first" link Mr.Wolf_Prefs.pic/main}@{fg text} : Click 'Retrace' to come back.
@{fg shine}

 Mr. Wolf should adjust the size and font for his preferences window
 according to the screen's resolution - the fonts required came with
 WB 3.0, so you should have them - if you don't then the default system
 font will be used.  These fonts are only loaded if you open his
 preferences window.

 Colour@{fg text} Click on the cycle gadget to choose the area colour that you want
        to change, and the relevant colour will appear in the box below
        the cycle gadget.

        Click on your chosen colour in the palette gadget, and this new
        colour will appear in the box under the cycle gadget, and the
        appropriate area of Mr. Wolf's image will also change to that
        colour.

        Any area that is colour 0 (grey usually) will be transparent.
        So you could make him completely invisible if you wanted!  Then
        you could draw your own image on your Workbench picture, and put
        Mr. Wolf's window over it.
@{fg shine}
 Birthday@{fg text} This text gadget requires a date in the format dd/mm

          (i.e. 09/01 = ninth of January)

          Mr. Wolf will use this information to wish you a happy birthday
          - coz he's thoughtful like that.

          Mr. Wolf promises not to misuse this data,
@{fg shine}
 Delay Startup@{fg text} If your startup sequence takes a long time,
               Mr. Wolf can sometimes grab an image from Workbench for
               his window, before Workbench has displayed your Workbench
               picture.  If you put a value in here, Mr. Wolf will delay
               grabbing this image for the time specified.  A value of
               50 (PAL) or 60 (NTSC) will delay grabbing for 1 second.
               Multiply this value by the number of seconds needed.
@{fg shine}
 Save@{fg text} Mr. Wolf saves these preferences to a file in Sys:Prefs/Env-Archive
      called "Wolf.prefs".  If Mr. Wolf can't find this file, he launches
      with the factory settings.
@{fg shine}
 Rift@{fg text} When Mr. Wolf saves your preferences, he also saves the current date.
      This allows Mr. Wolf to check whether your clock has been corrupted.
      If it has, Mr. Wolf will advise you the next time you click on him.

      At this point you should investigate your time settings - if there is
      nothing wrong with your time, quit Mr. Wolf, and then run him again.
      The reason that there might be nothing wrong, is because you may have
      quitted him before he had a chance to tell you, in which case, his
      preferences will hold the corrupted date.
@{fg shine}
 Cancel@{fg text} Each time you push this button, Mr. Wolf will write you a cheque
        for 50 quid.
@{fg shine}
 @{"End of Preferences..." link Contents}
@{fg text}
@endnode

@node Credits
@title "MR WOLF"
@{fg shine}
                                   Credits
@{fg text}
 I gained inspiration for Mr. Wolf from the following clocks:

 @{fg shine}  SayTime@{fg text}    - for the speech part.
 @{fg shine}  AboutClock@{fg text} - for the rough timing.
 @{fg shine}  VClock8@{fg text}    - for the moving/location of the clock.
 @{fg shine}  Tolleuhr@{fg text}   - (hope I spelt it right) for the grabbing of Workbench -
                at least I presume that's how it did it.

 The trouble with the Amiga is that just about every owner has written a
 clock program, and choosing between them is impossible, so I thought
 I'd write my own, with the best features from the ones I've seen.

 Mr. Wolf was the outcome.

 I wish I could credit the authors of the above clocks, but I no longer
 have them - sorry.

 Thanks to Curt Esser for informing me of a couple of bugs that I hadn't
 noticed :)

@{fg shine}
 @{"These credits were written and produced by me..." link Contents}
@{fg text}
@endnode

@node RI
@title "MR WOLF"
@{fg shine}
                               Rainbow Islands
@{fg text}
 I got a @{fg shine}4th@{fg text} rainbow on Rainbow Islands (April '98).
@{fg shine}
 @{"Yahoo..." link Contents}
@{fg text}
@endnode

@node Distribution
@title "MR WOLF"
@{fg shine}                                Distribution
@{fg text}
 This program is freely-distributable - so if you send me lots of money,
 I'll just send it right back!

@{fg shine}
                                Disclaimer
@{fg text}
 I accept no responsibility for any damage resulting from the use of
 this program.


@{fg shine} @{"Okay..." link Contents}@{fg text}
@endnode

@node Requirements
@title "MR WOLF"
@{fg shine}
                               Requirements
@{fg text}
 You need the @{fg shine}narrator.device@{fg text} in your DEVS drawer. and the
 @{fg shine}translator.library@{fg text} in your LIBS drawer.

 These are not supplied, for copyright reasons, but they shouldn't be too
 difficult to get hold of if you haven't got them - they came with WB 2.04,
 but were not included with 3.0 for some reason.

 Tested on:

 A1200, A1200 + 4mb, A1200 030/40 + 8mb, A1200 030/50 +16mb, but should
 work on WB 2.04 I think.

 Haven't a clue if it will work on GFX cards, as I don't have one yet,
 but am saving my pennies for a Pixel64.  I am told that the BitMapToWindow
 command works on GFX cards, but I don't know if Scroll does.

@{fg shine}
 @{"Right oh..." link Contents}
@{fg text}
@endnode

@node Blitz
@title "BLITZ"
@{fg shine}
                                 Blitz notes

 Frac@{fg text} This command returns some ridiculous results.
@{fg shine}
 Divide by zero@{fg text} Blitz doesn't appear to check for this, in fact, if you
                try:

                    n=50/0
                    nprint n

                you will actually get an answer!  And if you just try:

                    nprint 50/0

                you'll naturally get a crash!

                And multiplying by fractions tends to give incorrect
                answers as well - try:

                    100*0.1

                Of course you could divde 100 by 10 instead, but I
                read once that computers multiply by fractions
                quicker than they divide.  I read that

                    100*0.25 is quicker than 100/4

                of course

                    100 LSR 2

                is even quicker - but you can't do that for numbers
                like 73.  Actually, I've just realised that you can
                do

                     73 ASR 2 instead.

                So what am I talking about?

@{fg shine}
 @{"Did I tell you that I got a 4th rainbow on Rainbow Islands?" link Contents}
@{fg text}
@endnode