grafx - Extensible Java Graphics Package Code

Fixing a slight problem in Javadoc, in SNDFileCreator.

Doing some work on level 28.

Adding 'excellent7.blo' and 'excellent8.blo'.

Changing level 21 slightly.

Adding some intricacies to ComputerPlayer. Defining m_dropped field which is
used during a race condition w.r.t. user drops and system drops. The method
run_dropBlock() now takes a boolean input parameter, 'isBlockTouchingBottom'.
The changes made here are purely theoretical and have not been tested. About
to do that. Compiles successfully though.

NewBlockStartsEvent given a new member, which exposes isBlockTouchingBottom().
As a result EventEncoder and SimpleGameLogic had to be changed as well. Adding
member variable m_touchingBottom to class SimpleGameLogic, which tells if the
current playing block (in the case that it is in play) is grazing the bottom
(either the bottom of pit boundary or grazing frozen cruft below). That new
member variable is used in the following situation. When the block is already
touching bottom and when the user drop sequence is initiated, instead of
freezing the block immediately, the block is given m_hitBottomDelay
milliseconds before freezing in order to be able to perform some final post
drop sequence of events. The computer player needs this logic, because there
is no way to poll these kinds of situations; in particular if the computer
player initiates a user drop but at the same exact time a system drop block
event is created, then before, there would be no chance to perform post drop
events, and now with this change, a small time window is available to perform
these movements.

Adding 'excellent5.blo' and 'excellent6.blo'. Not really sure why I'm adding
these, perhaps I'll keep the best ones eventually.

Removing a line of code which defines local variable 'startPos', since that was
never used anywhere.

Importing net.blockout.production.BlockDistribution.WeightedBlock for greatly
reduced verbosity in code. Adding new level 28, which includes 6-er blocks but
has a pit size of 6x4. This level is very difficult.

Importing net.blockout.impl.BlockPlacementStrategy.Move to be able to refer to
class 'Move' directly, greatly reducing verbosity of code in certain sections.
Local variable 'TreeMap<Long, Move> qBestMoves' now uses generics, is
parameterized with proper types. With m_postDropActionExec, now only changing
the operation bits one by one as the moves are made and detected; leaving the
negate bits alone. No longer assuming direct correlation between
AttemptedBlockMovementEvent.X_AXIS & Move.POST_DROP_SLIDE_X,
AttemptedBlockMovementEvent.Y_AXIS & Move.POST_DROP_SLIDE_Y, rather assigning
these in a 'switch' statement.