README.md
Vexed 2.1 Beta 1 Readme.txt - May 25, 2003

Contents

0. What's new in Vexed 2.1

1. Introduction

2. Installation

3. Instructions
Basic Game Play
Scoring
Undo, Memorize, Recall, Replay, Restart, Block Check
Game Options
Level Packs
Solutions
Menus
Screen Layout

4. Other info

5. Contact us

6. Known bugs / Todo's

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

0. What's new in Vexed 2.1

Here are primary new functions:

- Grayscale support for monochrome devices (six new grayscale
block sets)
- New animation and graphics on the congratulations screen,
donated by Scott Ludwig
- Congrats screen displays levelpack score
- Added 10 new levelpacks, numbers 3-12 (600 new levels)
- Added new "tap" function: tap block to move, then
destination (no drag required, but dragging still works.)
This should help reduce screen wear.
- New "move pending" icon to support tap operation
- Start of OS 5 hires support, not complete with Beta 1

Here are the main fixes in this release:

- Fixed vertical bar video bug on OS 5 devices
- Fixed drag errors, where invalid dragging could increment
the score
- If a level already played, keep the lower of the two scores
- Allow power off in the congrats screen
- OK to show solution to level without penalty if level
previously solved

For a complete list of changes, see the changes.txt file included
with the program.

1. Introduction

Welcome to Vexed! Vexed is a great puzzle game for Palm OS
devices written by James McCombe. He released the game and its
source code in 1999 under the GNU General Public License.

Now there's a group of people working together to improve Vexed as
an Open Source project on SourceForge.net. Visit the Vexed
SourceForge project page at http://sourceforge.net/projects/vexed
for more information.

--------------------------------------------------------------------------------

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

2. Installation

To install, simply install Vexed version 2.1 using your Palm
install tool of choice. You may safely install over previous
versions of Vexed.

The program and all external level packs are contained in the
vexed21Beta1.zip file. The source code to Vexed and all of the
Vexed tools is in the vexed21Beta1Src.zip file.

You should be aware that the Classic and Classic II level packs
are built-in to the Vexed 2.1 PRC file. If you beam Vexed 2.1
to another device, it will have access to those two level packs
automatically.

All other level packs are external databases and should be
installed via any Palm install tool. Support for beaming
individual level packs is available from the Level Packs screen in
Vexed.

See the Instructions section below for a description of the level
packs.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

3. Instructions

Basic Game Play

Vexed is a puzzle game in which your goal is to move similar
blocks together, which causes them to disappear. Once all the
blocks are gone, you've solved the level and you're presented with
a new level to solve.

You move blocks by putting the stylus on them and dragging to
either the right or left. If an empty space is encountered,
"gravity" takes over and the blocks fall towards the bottom.

You can move more than one block left or right with a single
drag of the stylus. The block move stops on the first block in
which an action can occur, or where you ended dragging the stylus.

New with Version 2.1 is a "tap" method of moving blocks in
addition to dragging. Use your stylus to tap the block you wish
to move. Then tap the open space where you want the block to move
to. The destination must be an open space to be valid. The tap
method lets you tap on a row different from the block.

Scoring

The Vexed scoring is based on a golf-like "par" concept. The
level pack has a solution stored for each level. If you solve the
level in the same number of moves as what is stored in the level
pack, you get a score of 0, or par, for that level. Note that the
stored solution may not be the most efficient one, so you can beat
"par" and have a negative score.

The score displayed in the title bar is a cumulative score for the
entire level pack.

Using the Solution feature adds five to your score.

Undo, Memorize, Recall, Replay, Restart, Block Check

Undo

There is a 15-move undo facility. Once you've made a move a "U"
icon appears at the bottom of the screen. Tapping it will undo the
previous move. The buffer holds 15 moves. The undo buffer is not
saved across invocations of Vexed.

Memorize and Recall

Solving a difficult level might take many attempts involving many
moves. The memorize feature lets you save where you are in a
level, and restart from that point. Tap the "M" icon at the
bottom of the screen, and an "R" icon appears. Tap the "R"
(recall) icon to restore the game board to its status when you
memorized it.

Level Replay

You can replay all of the moves made in the current level, and
also of the previous level. These options are under the "Game"
menu.

Note! The replay functions use the memorize buffer described
above. If you replay a level, your current memorize buffer will
be emptied.

Restart

Tap the restart icon at the bottom right of the screen to restart
a level from the beginning.

Note! The Undo, Memorize, and Replay data is not saved when you
exit Vexed!

Block Check

You can display just one type of blocks in order to help you solve
the puzzle. Hold the stylus down on a block while pressing the page
up key, and only blocks of that type will be displayed. Once you
lift the stylus, the game board is redrawn.

Game Options

The preferences options you set in the preferences menu option are
saved in something called the "saved preferences." This data is
also saved back to your PC when you hotsync, so if you do a hard
reset, you'll be able to restore this information.

The state of the current level is also saved in preferences, but
this time in the "unsaved preferences."

This means that when you re-invoke Vexed, it'll go to your most
recent level and you won't start the level from the beginning.
Instead, it will go to the point at which you left off. But this
data is not included with your hotsync to your PC, so you'll have
to restart the level from the beginning in the event of a hard
reset / restore sequence.

Preferences

You can set the following settings affecting how the program works
in the preferences screen found in the Game menu (or the "/R"
shortcut):

Piece move animation

This animates (and slows down) the movement of blocks as they move
sideways. Unselect this to speed up game play.

Gravity animation

This animates (and slows down) the movement of blocks as they fall
due to gravity. Unselect this to speed up game play.

Piece elimination animation

This animates (and slows down) the erasing of blocks as they
disappear. Unselect this to speed up game play.

Blinds Effect

This is the animation effect you see when a level is first loaded
or reloaded. Unselect this to speed up game play.

Skip Intro

Select this option to skip the animated introduction each time you
run Vexed. You can also tap the screen or press the page up /
page down keys to interrupt the animated introduction.

Sound

Select this option to turn on sound effects.

Block Set

This is a pop-up menu to let you select between 3 monochrome or 6
different block sets.

Note! If you turn off the first three animations, the replay and
solution functions will be very fast, so you probably need to keep
at least one of them on if you use Solution or Replay.

Level Packs

There are now 19 different level packs available. The Classic and
Classic II levels are built-in to the Vexed prc file, while the
others are installed on the Palm separately. Use the Level Packs
option from the Levels Menu to work with level packs. The level
packs screen will display which level packs you have installed
on your device. For each level pack it also shows your current
score, the highest level you've solved, and how many levels are in
the level pack, for example:

Confusion Pack:10 (4/60)

The level packs screen also gives you information about the source
of the level pack and types of levels found within.

These are the current level packs:

Classic Original Vexed 1.3 levels

Classic II First expansion pack from Steve Haynal,
previously released as Vexed 1.4a.

Children's Very easy levels meant for children.

Variety I These levels provide a full spectrum of difficulties
from easy to hard.

Variety II Continuation of the Variety Pack. From easy to hard.

Twister Difficult. Many of these levels have twists that add
challenge.

Confusion Pack Hard! These levels are tricky and require careful
planning to solve.

Panic Very hard! So hard you'll panic after the first one.

Impossible Impossible. You need to be Einstein to make it through
this game pack!

Variety 3-12 Packs New level packs in Vexed 2.1 Beta 1

Solutions

You can elect to see the solution for a level. Select the Show
Solution option from the Levels Menu to view the solution. Viewing
solutions adds 5 to your score!

Selecting the Show Solution option saves your current level state
and the solution screen is drawn. It automatically starts
displaying the solution and will continue unless you tap the
screen or press the page up / page down keys. If you interrupt
it, use the arrow icons at the bottom of the screen or the page up
/ page down keys to step forward and back through the solution.

Tapping the restart icon in the bottom right corner of the screen
restarts the solution from the beginning.

Tap the Done button to exit the solution and return to the level
where you left off.

Menus

Tapping on the title bar will open up the two pull down menus
available, Game and Levels.

Game Menu

The Game Menu has the following options:

Preferences

Use this option to set the Game Options described above. They are
stored in the Palm's "saved preferences."

Replay Current Level

Show all the moves made so far in the current level from the
beginning.

Replay Previous Level

Show all moves made in the previous level. If you haven't solved
a level yet in your current session this option is not available.

Beam Vexed

This menu option lets you beam the Vexed program to another
device. Go into the Level Packs menu form to beam individual
level packs.

How To Play

This displays some brief instructions on how to play the game.

About

Displays information about Vexed. Tap the Credits button for
information about the authors of Vexed.

Levels Menu

The Levels Menu has the following options:

Level Packs

This option opens up a screen to deal with level packs. Move the
cursor up and down through the list to see information about each
level, including the author and a description of the level pack.

This is the format of the level packs in the list:

"<name>:<level pack score> (<highest level completed> / <number of
levels in the pack>)

For example,

"Confusion Pack: 10 (4/60)"

To load a level pack, move the cursor to the pack desired and tap
on OK.

You can beam level packs to another device by selecting the pack
to beam with the cursor and tapping on Beam.

You can delete a level pack by moving the cursor to the level pack
you wish to delete and tapping on Delete.

Blocks Remaining

This option displays how many blocks there are remaining of each
type.

Clear Solved Levels

The program remembers which level you were playing and how many
levels were solved when the program exits. Use this option if you
want to reset this and have the program think you're starting over
on the very first level.

Show Solution

Select this option to see how to solve the current level as
described above. Viewing the solution will add 5 to your score.

Screen Layout

Refer to the icon at the top left of this page for an example of
the Vexed screen.

Title Bar

This is the format of the information on the title bar:


Level number

The number of the level within the level pack, starting with
level 0.

Level name

Each level pack has a theme used to assign names to individual
levels. For example, the Children's Pack uses ice cream flavors.
It's more fun to be stuck on level Chocolate Chip than level 23,
isn't it? If you wish to modify the level names there is a tool
to add titles to the level pack databases within the source code
zip file.

Current number of moves

How many moves you've taken so far in the level.

Par moves

The number of moves for this level in the solution stored in the
level pack ("par"). Note that the solution stored may not be the
most efficient, so it is possible to beat par and get a negative
score.

Score

Your total score for the entire level pack. It is the sum of your
moves above or below par for each level completed. The lower the
number, the better your score.


Gameboard

Under the title bar is the game play area, a grid of blocks 10 by
8.

Control Icons

Underneath the game board are a set of control icons. From left
to right, here are their functions:

First

The left-most icon jumps to the first level in the level pack,
level 0.

Previous

The second icon with the arrow pointing to the left moves to the
previous level. If you're on level 0 this does nothing.

Level Select

The magnifiying glass icon brings up a form to let you select
exactly which level you want to select. Use the up and down
arrows or the page up / page down keys to select the new level.
It will display all levels in the level pack, but you cannot
select a level higher than one past the highest level you've
solved.

Next

The right-hand pointing arrow will move up to the next level past
your current level. You are only allowed to move to levels up to
one past the highest level you've solved.

Last

The fifth icon jumps to the one past the highest level you've
solved.

Undo

The sixth icon from the left is an uppercase "U" character. This
icon appears after you've made your first move in a level.
Tapping this icon moves back one move. The buffer for the undo
function holds 15 moves, so you may only go back that many moves.

Recall

The seventh icon from the left is an uppercase "R" character. It
appears when you tap the "Memorize" icon, discussed next. Tap
the Recall icon to return the gameboard to the state it was in
when you memorized it.

Memorize

The eighth icon from the left is an uppercase "M" character. Use
this function to memorize the current state of the gameboard in
order to return to it later.

Restart

The icon in the bottom right erases all moves taken in the current
level and lets you start the level over from the beginning.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

4. Other Info

Vexed Home Page http://vexed.sourceforge.net

Vexed Project on SourceForge http://sourceforge.net/projects/vexed

Vexed Users Mailing List http://lists.sourceforge.net/lists/listinfo/vexed-users

Vexed Developers Mailing List http://lists.sourceforge.net/lists/listinfo/vexed-developers

Vexed Announcements Mailing List http://lists.sourceforge.net/lists/listinfo/vexed-announce

Vexed CVS Source Tree http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/?cvsroot=vexed

Scott Ludwig's Home Page http://www.tinyware.com

Matthew McClintock's Home Page http://work.colum.edu/~matma/

Steve Haynal's Vexed Page http://softerhardware.com/vexed.html

Irked - Windows/PocketPC Vexed http://www.ipidooma.net/irked/

Vexed for Psion Computers http://www.freepoc.de/vexed.htm

If you are interested in making your own Vexed level packs, or
perhaps a Vexed level editor, please send a note to Scott Ludwig
(scottlu@eskimo.com). There are now tools to generate and solve
levels, but it takes some horsepower and time to do it. You can
get more information about the tools by downloading the Vexed
source code from the Vexed SourceForge project page, and then
Scott will help you to get started.

Also, there is a tool called "titler" which can add the level
titles seen at the top of each level. You can run this tool to
create your own level titles.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

5. Contact us

You can subscribe to Vexed announce, users, and beta mailing
lists, and participate in discussions about Vexed in the forums
at the Vexed project on SourceForge.net. See the links above.

You can also send mail to members of the Vexed team listed on
the Vexed Home Page.

This is beta software. You should understand that there are
bugs in this version! Please report any problems or issues you
have with either the program or the level packs. Enter the
problem and the hardware you're using here:

http://sourceforge.net/forum/forum.php?forum_id=104648

Thanks!

6. Known bugs / Todo's

- The About screen needs some formatting on certain devices
- Hires support is incomplete (should be part of next beta)
- VFS support should be added
- The tap from the about screen can be passed into the program
and taken as a move