@DATABASE engineguide.guide
@WORDWRAP

===== Main Page =========================================================

@NODE main "WBPerplexity v1.5b - E-Mail: engine9@ukonline.co.uk - Visit: www.engine9.cjb.net"
@{BG SHINE}
    WBPerplexity v1.5b by Matt Briggs, (C)Engine Nine Design 2000.
@{BG BACK}
@{"  " LINK disc} disclaimer
@{"  " LINK requ} system requirements
@{"  " LINK shar} shareware details @{I}<< Please show your support! >>@{UI}

@{"  " LINK forw} forward

@{"  " LINK info} program info @{bg fill}@{fg filltext} New! @{bg back}@{fg text}
@{"  " LINK play} how to play
@{"  " LINK pref} wbperplexity prefs
@{"  " LINK addi} additional info
@{"  " LINK faq} FAQ

@{"  " LINK vote} Your vote!
@{"  " SYSTEM "Run >NIL: Yam:Yam MAILTO=engine9@ukonline.co.uk SUBJECT=WBPerplexity1.5b"} e-mail the author @{I}<< Please show your support! >>@{UI}

@{"  " LINK hist} history + what's new @{bg fill}@{fg filltext} New! @{bg back}@{fg text}
@{"  " LINK feed} feed back
@{"  " LINK cred} credits
@{"  " LINK cont} contacting us
@ENDNODE

===== Disclaimer ========================================================

@NODE disc "disclaimer"
@{BG SHINE}
    copyright
@{BG BACK}
i.   This software is copyrighted by its developer(s), which means that
     you are NOT ALLOWED to modify the program(s) and or documentation in
     any way. 

ii.  You are NOT allowed to use this software or any part of it for any
     other purpose than the one stated within this documentation, this
     also includes any fonts, images or samples.

iii. You may NOT de-compile any binary executable files within this
     package or modify this documentation or any other data files in
     ANY way.
@{BG SHINE}
    distribution
@{BG BACK}
This package is freely distributable, meaning that you are allowed to
re-distribute this package as long as you follow these points:-

i.   Any re-distribution must include all files in this archive, with
     out any modifications. You are NOT allowed to add or remove any
     files to and or from this archive.

ii.  This package may be freely distributed via BBSs, Internet/UseNet,
     software libraries such as Fred Fish's and Aminet® CD-ROM, and
     other similar electronic channels.

iii. Disk magazines and services that charge extra for file transfers
     may NOT distribute it without written permission from Engine Nine
     Design.
@{BG SHINE}
    disclaimer
@{BG BACK}
By using this product, you accept the full responsibility for any
damage or loss that might occur through its use or the inability to use
it. Engine Nine Design or anyone related with Engine Nine Design can NOT
be held responsible.

@{"<<" link main} go back
@ENDNODE

===== System requirements ===============================================

@NODE requ "system requirements"
@{BG SHINE}
    system requirements
@{BG BACK}
WBPerplexity requires an Amiga with the following system specification:

OS 3.0 or higher
1.0 Mb of ram
standard JPEG, GIF, PNG & ILBM datatypes
YAM (to email meeeeee! :)
Play16 (located in C:)
MagicWb palette (recommended)

@{"<<" link main} go back
@ENDNODE

===== Shareware =========================================================

@NODE shar "shareware details"
@{BG SHINE}
    shareware details
@{BG BACK}
Please note that this software IS shareware. This means that if you like
this program AND/OR any of our other programs you are kindly requested to
consider sending us a donation for our efforts. By registering our software
you are giving us the incentive to CONTINUE developing software for the Amiga.

ENGiNE NiNE DESiGN
50 Thicket Drive
Maltby
Rotherham
South Yorkshire
S66 7LB
U.K.

E-Mail: @{"engine9@ukonline.co.uk" SYSTEM "Run >NIL: Yam:Yam MAILTO=engine9@ukonline.co.uk SUBJECT=WBPerplexity1.5b"}

If we receive a donation from you for Ł5.00 or over, we will send you our latest software productions. If sending cheques please make them payable to
Matthew Briggs.

Please make sure that you give us details about:

Your name,
Address,
Day time phone number (if available)
& your system spec and configuration.
 
Thanks for taking the time to read this. Long Live Amiga!

@{"<<" link main} go back
@ENDNODE

===== Forward ===========================================================
@NODE forw "Forward"
@{BG SHINE}
    forward
@{BG BACK}
One of the best known of all puzzles is the Fifteen Puzzle, which was invented by Sam Loyd the elder about 1878. It is also known as the Boss Puzzle, Jeu de Taquin, and Diablotin. It became popular all over Europe almost at once. It consists essentially of a shallow square tray that holds 15 small square counters numbered from 1 to 15, and one square blank space. With the 15 squares initially placed in random order and with the blank space in the lower right-hand corner, the puzzle is to rearrange them in numerical order by sliding only, with the blank space ending up back in the lower right-hand corner. It may overwhelm the reader to learn that there are more than 20,000,000,000,000 possible different arrangements that the pieces (including the blank space) can assume.
@{BG SHINE}
    impossibilities?
@{BG BACK}
In 1879 two American mathematicians proved that only one-half of all possible initial arrangements, or about 10,000,000,000,000, admitted of a solution. The mathematical analysis is as follows. Basically, no matter what path it takes, as long as it ends its journey in the lower right-hand corner of the tray, any numeral must pass through an even number of boxes. In the normal position of the squares, regarded row by row from left to right, each number is larger than all the preceding numbers; i.e., no number precedes any number smaller than itself. In any other than the normal arrangement, one or more numbers will precede others smaller than themselves. Every such instance is called an inversion. For example, in the sequence 9, 5, 3, 4, the 9 precedes three numbers smaller than itself and the 5 precedes two numbers smaller than itself, making a total of five inversions. If the total number of all the inversions in a given arrangement is even, the puzzle can be solved by bringing the squares back to the normal arrangement; if the total number of inversions is odd, the puzzle cannot be solved. Theoretically, the puzzle can be extended to a tray of (m x n) spaces with (mn - 1) numbered counters.

In order to stop impossibilities from occurring, I have added a "placement" function into WBPerplexity which allows you to select either "Jumble" and "Randomized". Jumble takes the completed puzzle and moves the tiles around for a short period of time, which makes it entirely possible for the puzzle to be solved. Randomized, however will cause the tiles to be placed regardless and therefore impossible solutions may occur.

@{"<<" link main} go back
@ENDNODE

===== Program Info ======================================================
@NODE info "program info"
@{BG SHINE}
    program info
@{BG BACK}
WBPerplexity is a workbench* puzzle game in which you have to rearrange a picture which has been split into a certain amount of sections. In the case of this game the amount of sections is @{b}8, 15 @{ub}or @{b}24@{ub} with one left over square in which you can move your pieces in and out of.

This game now features a new animated puzzle format called ".APuz". Unfortunetly, APuz does not fully support amigas with graphic cards at the moment. Using "Animation Rate" in the Preferences menu, you can define the playback rate of the puzzle.

WBPerplexity is ideal if your bored whilst waiting for something to download or process as this game uses very little CPU (upto less than 0.30%) when its window is inactive or if it is Iconified.

*Also compatible with Directory Opus and Scalos.

@{"<<" link main} go back
@ENDNODE

===== Usage =============================================================

@NODE play "how to play"
@{BG SHINE}
    how to play
@{BG BACK}
To play WBPerplexity, slide the tiles around by moving them into the gap in order to complete the picture. You can select different puzzles by loading a new game in the pull down menu. WBPerplexity is also an app window, which means that you can drag puzzle and game files into it's window for them to load. 

If the puzzle you are trying to complete is too difficult for you, press the help key for a preview of what the completed picture looks like.
@{BG SHINE}
    saving your game
@{BG BACK}
It is now possible to save you game and load it back at a later date by going to "Save As..." in the pull-down game menu. Saving your game will record the positions of your tiles, the puzzle file loaded and the moves and time taken.
@{BG SHINE}
    additional puzzle sets
@{BG BACK}
Additional puzzle sets for WBPerplexity can be found on the engine nine design web site ( http://www.enginenine.cjb.net ) or from aminet. Most puzzle sets are in standard IFF ILBM format, however some may be in either PNG, JFIF/JPEG or GIF format, in which case you will require additional system datatypes to be installed for you to be able to play them.
@{BG SHINE}
    make your own puzzles!
@{BG BACK}
If you would like to produce your own puzzle sets for WBPerplexity, then please read the text file found in the Puzzles drawer. Don't forget to send us a copy of your set(s)! :)

@{"<<" link main} go back
@ENDNODE

===== Prefs =============================================================
@NODE pref "wbperplexity preferences"
@{BG SHINE}
    menu prefs
@{BG BACK}
@{B}Use Datatypes@{UB}
Use this function for puzzles that are not in an ILBM format. Datatypes also has a scale function which enables you to load any picture you wish and it will be resized to fit the game window (providing you have a compatible datatype installed and enough CHIP mem).

If you are not using datatypes then WBPerplexity will use internal image decoding, which is not as advanced as datatype decoding as it does not lock pens (yet!). The Animated Puzzle (APUZ) format is not supported by Datatypes and therefore you will have to use internal image decoding.

Internal image decoding can only handle upto eight bit screenmodes and therefore non AGA users may experience difficulties.

@{B}Quick Move@{UB}
When moving more than one tile at once this setting will cause them to move as one block instead of one after another. You may wish to enable quick move when playing animated puzzles.

@{B}Auto About@{UB}
This setting will cause the information requester to automatically pop up every time a new puzzle is loaded.

@{B}Auto Grid Change@{UB}
Automatically changes grid mode if you select a different grid.

@{B}Show Setup@{UB}
Displays the tiles being shifted around if you are in Quick or Long Jumble placement mode. Be warned: This may take some time. You can press ESC at any time to stop this.

@{B}Grid@{UB}
You can select either 3x3, 4x4 or 5x5 grid modes to play. 5x5 is much harder as it takes more time and moves to complete.

@{B}Remapping@{UB}
Selects the quality of puzzle remapping for @{B}internal image decoding@{ub}. The "Best" mode will remap with a much greater accuracy, however it will use more CPU and take slightly longer.

@{B}Placement@{UB}
Allows you to select the tile placement method. Read the @{"forward" LINK forw} for more information on this.

@{B}Sounds@{UB}
Toggle between the sound modes. "None" will turn off all sounds, "Beep Only" will play a system error sound if you make an illegal move and "All" will use an external sound player to play samples.

@{B}Animation@{UB}
Allows you to set the play back rate for Animated Puzzles. Faster playback results in more CPU usage.

@{B}Save Prefs On Exit@{UB}
WBPerplexity will save your preferences when you quit.
@{BG SHINE}
    tooltype prefs
@{BG BACK}
With WBPerplexity v1.5b and above you can alter various settings that are not present in the prefs menu of the game. In order to modify these settings, click on the WBPerplexity icon and go to "Information" in the "Icons" menu of your workbench. There you can alter the various tooltypes.

@{B}Browser@{UB}
Sets the location of your default internet browser i.e. "BROWSER=Apps:Internet/Voyager/V".

@{B}Home@{UB}
Sets the location of our home page. Defaults to "www.enginenine.cjb.net".

@{B}Email@{UB}
Sets the location of your email client so that you can @{"contact me!!" SYSTEM "Run >NIL: Yam:Yam MAILTO=engine9@ukonline.co.uk SUBJECT=WBPerplexity1.5b"}

@{B}Soundplayer@{UB}
WBPerplexity v1.4 orginally used the command Play16 for playing audio samples within the game. This can now be changed to something like "SOUNDPLAYER=C:Playsound".

@{B}WINX@{UB}
Sets the horizontal X position of the WBPerplexity window. If this setting can not be found the X position of the game window will be centered.

@{B}WINY@{UB}
Sets the vertical Y position of the WBPerplexity window. If this setting can not be found the Y position of the game window will be centered.

@{B}XYMOUSE@{UB}
Opens the WBPerplexity window at the mouse cursor location if set to "YES". I.e. "XYMOUSE=YES"

@{B}BLANK@{UB}
Remaps the blank tile to the colour specified in base 16. If this setting can not be found it will default to the colour of pen four. Ideal for graphic card users or those who do not have MagicWB installed.

@{B}SHADOW@{UB}
Same as above, except this sets the shadow colour for 4x4 and 5x5 grid modes.

@{B}GRID@{UB}
Turns off the overlay grid if set to "NO". Defaults to YES. Try this -- Its cool! :D

@{B}FONT@{UB}
Sets the font to be used in the status bar. I.e. FONT=topaz.font

@{"<<" link main} go back
@ENDNODE


===== Additional info ===================================================

@NODE addi "additional info"
@{BG SHINE}
    additional info
@{BG BACK}
Some puzzles may be extremely difficult to complete in 4x4 or 5x5 grid modes as they may contain identical tiles e.g. two or more blank (white/black) tiles. New puzzle sets may contain warnings if such difficult puzzles are present.

@{"<<" link main} go back
@ENDNODE

===== FAQ ===============================================================
@NODE faq "frequently asked questions"
@{BG SHINE}
    faq
@{BG BACK}
> @{i}When I try to load certain puzzles I get an error message.@{ui}
Make sure you have installed compatible PNG, GIF, ILBM and JPEG datatypes and that the "Use Datatypes" option is checked in the prefs menu.

> @{i}I do not hear any sounds.@{ui}
Make sure the command Play16 is installed. This should be located in your System:C/ directory. Play16 is available from Aminet [ mus/play ]

> @{i}My workbench screen is in a mode higher than 8 bit (256 colours) and I can't see the puzzle correctly as the colours are wrong.@{ui}
WBPerplexity's internal ILBM image decoder does not support graphic cards. Use datatypes instead for better results.

> @{i}This game is too hard for me. Are their any cheats?@{ui}
Yes, but I'm not going to tell you! Try @{"contacting" LINK cont} me.

@{"<<" link main} go back
@ENDNODE

@NODE vote "Your vote"
@{BG SHINE}
    your vote!
@{BG BACK}
Do you think that this game is better than Microsoft Mines? If so please tell us when you @{"contact" link cont} us! The results of this silly little vote will be published on our site :o)

@{"<<" link main} go back
@ENDNODE

===== History ===========================================================

@NODE hist "program history"
@{BG SHINE}
    program history
@{BG BACK}
v1.5b  -   Added "FONT" Tooltype - Now possible to change counter font
           Added WBPerplexity.font
           Added APuz frame counter in puzzle Information
           Fixed several bugs from v1.5

v1.5   -   New animated puzzle format!
           Fixed nasty transparent puzzle glitches
           Added image scaling function!
           Uses less startup chip memory
           Added tooltype options
             -  Turn grid on/off
             -  Set blank tile and shadow colour
             -  Alter sound player
             -  Set window position
             -  Extra animation functions
             -  Customize your web browser and email
           Shifted menus around (teehehe)
           Click for info

v1.4   -   Added Jumble and Random placement
           Show setup
           Load/Save game
           Sound support with play16
           Now possible to play with cursor keys.
           Fixed an embarrassing bug in 5x5 grid mode :o)
           Fixed timer bug
           Window now has a zoom

v1.3   -   4x4 and 5x5 grid modes
           Datatype bug fix
           Auto grid & About
           Remap quality

v1.2   -   Added timer and move counter
           Help mode
           How to play function
           Prefs menu
           Datatype functions added
           Save settings added
           CLI arguments added
           Hidden cheat added! :) <?>
           New icons (thanx to Luca :)
           Move two blocks at once
           App icon added
           Timer bug fixed
           Few other bugs fixed

v1.1   -   Not released

v1.0   -   First release to Aminet July 1999

@{"<<" link main} go back
@ENDNODE

===== Feedback ==========================================================

@NODE feed "feedback"
@{BG SHINE}
    feedback
@{BG BACK}
Hi,

Your game is cool !

Bye

@{B}@{I}Jerome Chesnot@{UI}@{UB}

Overall this is a really enjoyable game. It has some great features and
gives endless possibility with the option to be able to make your own
puzzles. Brilliant work!

@{B}@{I}Chris Seward, AIO review@{UI}@{UB}

Hello,
good prog!
Kind regards

@{B}@{I}Arch. Piergiorgio MONGIOJ@{UI}@{UB}

Cze¶ć!!!,

I'm writing because ....  "About" window and "EMail Me" gadget in
WBPerplexity ;DDD It's very cool game - and it's only game where I can win
;D
Sorry about my strange english.
And some polish greetings: Trzymaj się ramy, to się nie posramy ;D
Bye!

@{B}@{I}Grzegorz Kaszuba, Poland@{UB}@{UI}

Hola, congratulations for this program.

@{B}@{I}Atentament, Miquel, Spain@{UB}@{UI}

Congratulations for WBPerplexity, it's a very enjoyable game!

@{B}@{I}Paolo D'Urso, Managing Director of Darkage Software@{UB}@{UI}

An aptly named puzzle game

@{B}@{I}Amiga Format cover disk info@{UB}@{UI}

@{"<<" link main} go back
@ENDNODE

===== Credits ===========================================================

@NODE cred "credits"
@{BG SHINE}
    credits
@{BG BACK}
Programming & Design        Matt Briggs

Additional coding           Curt Esser
                            Leigh Parry

Play16                      Thomas Wenzel

Puzzles                     Matt Briggs
                            Robert Livesey
                            Jake
                            Graeme Porter
                            Matthew Hampton

Additional puzzle sets      Chris Seward

Icon Set & Cool ideas       Luca 'Hexaae' Longone

Testing                     Robert Livesey
                            Jerome Chesnot
                            Alexi Tzitzas
                            Roy Krister
                            Gaz & Mick
                            
This software is copyright © Engine Nine Design 1999/2000

@{"<<" link main} go back
@ENDNODE

===== Contacting the author =============================================

@NODE cont "contacting us"
@{BG SHINE}
    contacting the author
@{BG BACK}
If you wish to contact the author of this software, then please do not hesitate to write to:

Matt Briggs
Engine Nine Design
50 Thicket Drive
Maltby
Rotherham
South Yorkshire
S66 7LB
U.K.

EMail: @{"engine9@ukonline.co.uk" SYSTEM "Run >NIL: Yam:Yam MAILTO=engine9@ukonline.co.uk SUBJECT=WBPerplexity1.5"}
WWW:   www.enginenine.cjb.net

@{"<<" link main} go back
@ENDNODE