1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/BUGS.txt	Fri Mar 13 00:39:12 2009 -0700
     1.3 @@ -0,0 +1,906 @@
     1.4 +bug 0001: Dual Marathon gimmick
     1.5 +
     1.6 +The keys control both a platform game (in the top window) and a
     1.7 +tetromino stacking game (in the bottom window).  If you die on
     1.8 +either window, you lose.
     1.9 +
    1.10 +
    1.11 +bug 0002: Customizable top out behavior
    1.12 +Parity: Tetris (NES), freepuzzlearena
    1.13 +
    1.14 +A rule can dictate that "top out" occurs when the following happens:
    1.15 +* Overlap or lock out: Entry overlapping blocks, or lock entirely
    1.16 +  above ceiling (current behavior)
    1.17 +* Partial lock out: Lock with any block above ceiling
    1.18 +* Garbage out: Entry with any block above ceiling
    1.19 +* Loose block out: Lock overlapping blocks; block can be shifted
    1.20 +  out of the way in some cases (like Tetris for NES)
    1.21 +
    1.22 +
    1.23 +bug 0003: Mode 7 style blitter for PC
    1.24 +Platform: PC
    1.25 +Parity: TOD
    1.26 +
    1.27 +Extend blitField(LJView *) to scale and rotate the field as it's
    1.28 +being copied to the screen.
    1.29 +
    1.30 +
    1.31 +bug 0004: Mode 7 style blitter for GBA and DS
    1.32 +Platform: GBA
    1.33 +
    1.34 +Extend blitField(LJView *) to calculate scaling and rotation factors
    1.35 +for each scanline, and extend other functions to start DMA.
    1.36 +
    1.37 +
    1.38 +bug 0005: Port Lockjaw: The Overdose (TOD)
    1.39 +Requires: 0002, 0003, 0004
    1.40 +Parity: TOD
    1.41 +
    1.42 +TOD used Carbon Engine.  I want to migrate away from Carbon Engine.
    1.43 +
    1.44 +
    1.45 +bug 0006: Ridin' Spinners
    1.46 +Requires: 0003, 0004
    1.47 +SRS and Infinity are turned on.  If you abuse lock delay, or you make
    1.48 +a "spin triple" twist, the screen begins to spin, and the music
    1.49 +changes to a cover of "Ridin' Spinners" by Three 6 Mafia.
    1.50 +
    1.51 +
    1.52 +bug 0007: Improve Items gimmick
    1.53 +Requires: 0008
    1.54 +Votes: Caithness
    1.55 +Parity: Tetris DS
    1.56 +
    1.57 +Give only one item at a time in the early stages.
    1.58 +
    1.59 +
    1.60 +bug 0008: Prerotated next queue
    1.61 +Parity: Tetris DS
    1.62 +
    1.63 +Store the orientation of each piece in the next queue.
    1.64 +
    1.65 +
    1.66 +bug 0009: TDS 4-player worldwide simulation
    1.67 +Parity: Tetris DS
    1.68 +
    1.69 +3/4 of the time you start it, it will play annoying music for
    1.70 +two minutes, give an 86420 error, and quit. The rest of the
    1.71 +time, it will play annoying music for between 15 seconds and
    1.72 +two minutes and then switch to Items gimmick.
    1.73 +
    1.74 +
    1.75 +bug 0010: Colored blocks
    1.76 +Parity: freepuzzlearena
    1.77 +
    1.78 +In active, hold, and next, have each block store its color.
    1.79 +
    1.80 +
    1.81 +bug 0011: H&R Blocks scoring method
    1.82 +Parity: freepuzzlearena
    1.83 +
    1.84 +First spotted in freepuzzlearena Tetanus.  Each piece is either
    1.85 +entirely dark or entirely light.  A line of all dark or all light
    1.86 +scores as 2 lines.  Score for n lines with one piece is n*(n+1)*50.
    1.87 +
    1.88 +
    1.89 +bug 0012: Two physical keys per vkey
    1.90 +Platform: PC
    1.91 +
    1.92 +Allow the player to set more than one key that operates a given,
    1.93 +game function, like StepMania does.
    1.94 +
    1.95 +
    1.96 +bug 0013: Two-player mode
    1.97 +Parity: freepuzzlearena
    1.98 +
    1.99 +Allow two players to play at once, and allow garbage to be sent back
   1.100 +and forth.
   1.101 +
   1.102 +
   1.103 +bug 0014: Store and display assertion text
   1.104 +
   1.105 +Lockjaw Engine has ljassert().  If an assertion fails, have some way
   1.106 +for front-ends to retrieve the text.
   1.107 +
   1.108 +
   1.109 +bug 0015: Rotation system should be array of structs
   1.110 +
   1.111 +A single struct should describe all aspects of a rotation system.
   1.112 +The descriptions in wktables.c should be an array of structs, not
   1.113 +struct of arrays.  While you're at it, extend the kick tables
   1.114 +from 5 to 8 positions.
   1.115 +
   1.116 +
   1.117 +bug 0016: Rotation system editor
   1.118 +Platform: PC
   1.119 +Requires: 0015
   1.120 +Votes: Needle, DIGITAL, (RA) Red Star, jujube, fnord
   1.121 +
   1.122 +Before developing Lockjaw Engine, I described Wall Kick Explorer, an
   1.123 +editor for rotation systems.  Make this.
   1.124 +* initial shift and orientation of each piece
   1.125 +* kick tables for +90deg and +270deg
   1.126 +
   1.127 +<tepples>
   1.128 +0.44 inverts rotation systems into a format that a loader might be
   1.129 +able to produce.
   1.130 +
   1.131 +
   1.132 +bug 0017: Adjustable window size
   1.133 +Votes: Bloodstar
   1.134 +Resolution: Fixed in 0.42
   1.135 +
   1.136 +The skin should control the screen resolution or the size of the
   1.137 +window.  This would make camstudio recording on older PCs feasible.
   1.138 +
   1.139 +
   1.140 +bug 0018: Store keypress count in .ljm
   1.141 +
   1.142 +Replays should store the number of keypresses, so that Baboo! result
   1.143 +screens are correct.
   1.144 +
   1.145 +
   1.146 +bug 0019: Start recording .ljm only during ARE
   1.147 +
   1.148 +It would probably simplify the code to start a replay only during
   1.149 +entry delay.  This would also allow playback to become slightly
   1.150 +more resilient to game engine changes, as the viewer would at least
   1.151 +be able to view block placements.
   1.152 +
   1.153 +
   1.154 +bug 0020: Option for fractional row kick
   1.155 +Parity: Tetris DX
   1.156 +
   1.157 +Right now, a floor kick will move a piece by the minimal amount
   1.158 +needed to place a block in the correct row.  This means downward
   1.159 +kicks move to the top of the row, and upward kicks move to the bottom
   1.160 +and immediately start lock delay.  Other games don't do this.
   1.161 +To simulate Tetris DX properly, we need a new option:
   1.162 +
   1.163 +Fractional floor kick
   1.164 +  Unchanged
   1.165 +> Minimal move (current behavior)
   1.166 +  Move to top (Tetris DX behavior)
   1.167 +
   1.168 +
   1.169 +bug 0021: Double buffer entire screen
   1.170 +Platform: PC
   1.171 +Votes: 4matsy
   1.172 +
   1.173 +On some video cards, the score flashes.  Double buffering the entire
   1.174 +screen, not just the well, would fix this.
   1.175 +
   1.176 +
   1.177 +bug 0022: Automatic exit on Vista
   1.178 +Platform: PC
   1.179 +Resolution: Fixed in 0.42
   1.180 +
   1.181 +One machine running Windows Vista had Esc perform an immediate exit
   1.182 +rather than a pause > exit.
   1.183 +
   1.184 +<tepples>
   1.185 +Might it have been caused by vsync() returning immediately?
   1.186 +If so, 0.42 fixes that.
   1.187 +
   1.188 +
   1.189 +bug 0023: Draw internal preview without clipping to well edge
   1.190 +Requires: 0020
   1.191 +Votes: 4matsy
   1.192 +
   1.193 +Internal preview should extend outside the well if the piece is close
   1.194 +enough to the wall.
   1.195 +
   1.196 +
   1.197 +bug 0024: Improve garbage options
   1.198 +Votes: Bloodstar, Lardarse
   1.199 +Parity: Tetris (NES)
   1.200 +
   1.201 +Add option for garbage density, especially for B-type
   1.202 +
   1.203 +Garbage density
   1.204 +  Half
   1.205 +  Two holes
   1.206 +> One hole
   1.207 +
   1.208 +Add option for garbage randomness (1-100)
   1.209 +
   1.210 +
   1.211 +bug 0025: Internet play
   1.212 +Requires: 0013
   1.213 +Votes: Bloodstar
   1.214 +Parity: Tetris DS
   1.215 +
   1.216 +Allow sending garbage over the Internet.
   1.217 +
   1.218 +
   1.219 +bug 0026: FreeType font support
   1.220 +Platform: PC
   1.221 +Votes: Bloodstar
   1.222 +
   1.223 +Use TrueType fonts instead of bitmapped fonts.
   1.224 +
   1.225 +
   1.226 +bug 0027: AVI export
   1.227 +Platform: PC
   1.228 +Votes: Bloodstar
   1.229 +Parity: Tetris (NES) in emulation
   1.230 +
   1.231 +FCE Ultra and Nestopia can convert a replay to an AVI.
   1.232 +Lockjaw should too.
   1.233 +
   1.234 +
   1.235 +bug 0028: Game_Music_Emu music support
   1.236 +Platform: PC
   1.237 +Votes: Bloodstar
   1.238 +Parity: Tetris (NES) in emulation
   1.239 +
   1.240 +I'd like to play nsf/sid/spc music without having to
   1.241 +convert it to .ogg first.
   1.242 +
   1.243 +
   1.244 +bug 0029: Height-sensitive music
   1.245 +Platform: PC
   1.246 +Votes: Bloodstar
   1.247 +Parity: Tetris (NES), Tetris (GB)
   1.248 +
   1.249 +Tetris DX changes the music when the stack surpasses a certain
   1.250 +height.  Lockjaw should too.
   1.251 +
   1.252 +
   1.253 +bug 0030: Music on GBA
   1.254 +Platform: GBA
   1.255 +Votes: Bloodstar
   1.256 +Parity: TOD
   1.257 +
   1.258 +GBA has sound effects.  I'd like some sort of music too.  Pimpmobile?
   1.259 +
   1.260 +
   1.261 +bug 0031: Debrief on handhelds
   1.262 +Platform: GBA, DS
   1.263 +Votes: Bloodstar, zzo38computer
   1.264 +Resolution: Fixed in 0.43
   1.265 +
   1.266 +PC has a result screen.  I want this on GBA and DS
   1.267 +
   1.268 +<tepples>
   1.269 +Fixed in 0.42 for DS.  To get this onto the GBA, we'd have to
   1.270 +eliminate three lines of text from the result screen.
   1.271 +
   1.272 +<tepples>
   1.273 +kesiev gave me a few ideas of how I could slim it down.  Fixing.
   1.274 +
   1.275 +
   1.276 +bug 0032: Baboo! should force infinite lock delay
   1.277 +Votes: caffeine
   1.278 +
   1.279 +right now, Baboo! is defined by use of 0g.  it should be
   1.280 +infinite lock delay instead.
   1.281 +
   1.282 +<tepples>
   1.283 +Why?  It would add an extra keystroke to Zangi-moves.
   1.284 +
   1.285 +
   1.286 +bug 0033: Move all skin-related files to a folder
   1.287 +Platform: PC
   1.288 +Votes: caffeine
   1.289 +Resolution: Fixed in 0.43
   1.290 +
   1.291 +Skin-related files should be kept together in the folder "skin".
   1.292 +
   1.293 +
   1.294 +bug 0034: Configure console buttons
   1.295 +Platform: PC
   1.296 +Votes: caffeine, 4matsy
   1.297 +Parity: StepMania
   1.298 +
   1.299 +Escape to pause, [ to record, ] to play should be configurable.
   1.300 +
   1.301 +<tepples>
   1.302 +4matsy said that MenuUp, MenuDown, MenuLeft, MenuRight,
   1.303 +MenuStart, and MenuBack also being configurable might help.
   1.304 +
   1.305 +
   1.306 +bug 0035: skip ready go and game over animations
   1.307 +Votes: caffeine
   1.308 +
   1.309 +I like to kill and restart games when I make one little mistake,
   1.310 +and startingAnimation and gameOverAnimation slow me down.
   1.311 +I want to skip them, even though each is less than 2 seconds.
   1.312 +
   1.313 +
   1.314 +bug 0036: Skip to mistakes
   1.315 +Platform: PC
   1.316 +Votes: caffeine
   1.317 +
   1.318 +While watching a replay, I want to skip to a piece that increases
   1.319 +the number of holes or whose active time is greater than three
   1.320 +times the average.
   1.321 +
   1.322 +
   1.323 +bug 0037: Hide active times in results
   1.324 +Votes: caffeine
   1.325 +
   1.326 +The Quadra-style "active time" statistics confuse me.  I want to
   1.327 +see stats based on wall time only.
   1.328 +
   1.329 +
   1.330 +bug 0038: Result time unit
   1.331 +Votes: caffeine
   1.332 +
   1.333 +I'd like to control whether statistics are expressed per minute
   1.334 +or per second.
   1.335 +
   1.336 +<tepples>
   1.337 +Why?  DDR is measured in beats per minute, and gasoline engine speed
   1.338 +is measured in revolutions per minute.
   1.339 +
   1.340 +
   1.341 +bug 0039: More garbage options
   1.342 +Votes: Caithness
   1.343 +
   1.344 +I want more realistic garbage.
   1.345 +
   1.346 +<tepples>
   1.347 +In what way?
   1.348 +
   1.349 +
   1.350 +bug 0040: Custom speed curves
   1.351 +Votes: Caithness, caffeine, Ezzelin, zzo38computer, DIGITAL, mushroom
   1.352 +
   1.353 +Let the user modify speed curves: for example, user should be
   1.354 +able to make rhythm speed up slower
   1.355 +
   1.356 +<tepples>
   1.357 +0.45 introduces a new speed curve format
   1.358 +
   1.359 +
   1.360 +bug 0041: Saved rule sets
   1.361 +Votes: Needle, kotetsu213, jujube, DIGITAL, Rich Nagel, Deets
   1.362 +Votes: Kukuunen
   1.363 +Parity: Tetris Worlds, Heboris
   1.364 +
   1.365 +Let the user create sets of options that override the user's
   1.366 +current options, and replace the gimmick selection screen
   1.367 +with preset selection.
   1.368 +
   1.369 +<tepples>
   1.370 +0.42 adds scenario support for the PC.  A scenario editor and
   1.371 +scenario support for handhelds will have to wait.
   1.372 +
   1.373 +
   1.374 +bug 0042: Release Lockjaw XLII
   1.375 +Requires: 0041
   1.376 +
   1.377 +Lockjaw 0.42 won't be released until noticeable progress is made
   1.378 +on these issues.
   1.379 +
   1.380 +<tepples>
   1.381 +As of Monday, January 28, 2008, scenario support is in, so Lockjaw
   1.382 +will be released the morning before the Super Bowl.
   1.383 +
   1.384 +
   1.385 +bug 0043: More rotation systems
   1.386 +Requires: 0016
   1.387 +Votes: herc
   1.388 +
   1.389 +Once the rotation system editor is in place, create these:
   1.390 +* Flat-up SRS
   1.391 +
   1.392 +
   1.393 +bug 0044: Vanish zone
   1.394 +Platform: PC
   1.395 +Votes: DIGITAL
   1.396 +
   1.397 +The skin should allow showing the vanish zone.
   1.398 +
   1.399 +
   1.400 +bug 0045: Handheld skin support
   1.401 +Platform: GBA
   1.402 +Votes: Dood77, matt_hatter83
   1.403 +Parity: TOD 
   1.404 +
   1.405 +GBA and DS should have skins too.
   1.406 +
   1.407 +
   1.408 +bug 0046: Pussy 20G
   1.409 +Votes: herc, DIGITAL
   1.410 +
   1.411 +Option for moving a piece up 1 cell when shifting it,
   1.412 +counting it as a floor kick.
   1.413 +
   1.414 +
   1.415 +bug 0047: Pentominoes
   1.416 +Votes: Dood77, jujube, colour_thief, Lardarse
   1.417 +Parity: Bombliss
   1.418 +
   1.419 +Add the 5-block pieces.
   1.420 +
   1.421 +
   1.422 +bug 0048: Bastet randomizer
   1.423 +Votes: zzo38computer
   1.424 +Parity: Abandoned Blocks
   1.425 +
   1.426 +In bastet, AI plays each possible next piece in each
   1.427 +possible position and gives one of the worst 3.
   1.428 +
   1.429 +
   1.430 +bug 0049: lj-contrib as skins
   1.431 +Platform: PC
   1.432 +Votes: Rich Nagel
   1.433 +
   1.434 +lj-contrib was written before .skin files were done.
   1.435 +
   1.436 +
   1.437 +bug 0050: Next above shadow (faint)
   1.438 +Platform: PC
   1.439 +Votes: cdsboy
   1.440 +
   1.441 +Draw next above shadow, but draw it semitransparent.
   1.442 +
   1.443 +
   1.444 +bug 0051: Separate keys for initial actions
   1.445 +Votes: DIGITAL
   1.446 +
   1.447 +I like initial actions, but not ARE.  Can I get separate
   1.448 +keys to perform initial actions on the next piece before
   1.449 +this one locks down?
   1.450 +
   1.451 +
   1.452 +bug 0052: Speed graph in debrief
   1.453 +Platform: PC
   1.454 +Votes: Cubicz
   1.455 +Parity: StepMania
   1.456 +
   1.457 +Screen 1 is results.  Screen 2 is settings.
   1.458 +Why not put a speed graph on screen 3?
   1.459 +
   1.460 +
   1.461 +bug 0053: High score table
   1.462 +Requires: 0041
   1.463 +Votes: Cubicz, Ezzelin, Rich Nagel, Kuukunen
   1.464 +
   1.465 +For each ruleset, keep the highest scores achieved on that
   1.466 +ruleset.
   1.467 +
   1.468 +
   1.469 +bug 0054: Disable ljconn
   1.470 +Platform: PC
   1.471 +Votes: kotetsu213, Needle
   1.472 +Parity: Tetris The Grand Master, The New Tetris
   1.473 +
   1.474 +The skin should be able to turn off ljconn for falling pieces
   1.475 +(as opposed to blocks in the stack).  That would improve
   1.476 +accuracy of TNT and TGM simulation.
   1.477 +
   1.478 +
   1.479 +bug 0055: Skin control for sound effects
   1.480 +Platform: PC
   1.481 +Votes: Cubicz, Needle
   1.482 +Parity: Lumines
   1.483 +
   1.484 +Allow skins to specify a .dat file or set of .wav files used
   1.485 +for sound effects.
   1.486 +
   1.487 +
   1.488 +bug 0056: Bleep gimmick
   1.489 +Votes: Lardarse
   1.490 +
   1.491 +Player must clear row 1, 2, 1, 3, 1, 4, 1, 5, 1, ..., 20, 1.
   1.492 +
   1.493 +
   1.494 +bug 0057: Bravo
   1.495 +Votes: Lardarse
   1.496 +Parity: Luminesweeper
   1.497 +
   1.498 +Several other falling block games display "BRAVO!" or another similar
   1.499 +message when there are no blocks left in the well after a line clear,
   1.500 +and award lots of bonus points.  Detect and score for this situation.
   1.501 +
   1.502 +
   1.503 +bug 0058: Vs. Elite garbage
   1.504 +Votes: PetitPrince
   1.505 +
   1.506 +you get 7 garbages after random(1,7) seconds, then random(3,5)
   1.507 +garbage every random (5,20) seconds
   1.508 +
   1.509 +
   1.510 +bug 0059: Wall kick control for IRS
   1.511 +Votes: jagorochi
   1.512 +Parity: TGM
   1.513 +
   1.514 +In TGM, initial rotation does not perform kicks.
   1.515 +Change the IRS option:
   1.516 +
   1.517 +Initial rotation 
   1.518 +  Off: do not IRS (current behavior)
   1.519 +  On, no kick: if collision, fail
   1.520 +> On: if collision, try wall kick (current behavior)
   1.521 +
   1.522 +<tepples>
   1.523 +0.43 disallows IRS kick entirely, changing the current behavior
   1.524 +from "On" to "On, no kick", by adding a new argument to
   1.525 +doRotateLeft and doRotateRight.  The change to this option (search
   1.526 +for !isFirstFrame) could be used to implement this option.
   1.527 +
   1.528 +
   1.529 +bug 0060: Menu background
   1.530 +Platform: PC
   1.531 +Votes: lvankeulen, Kuukunen
   1.532 +Parity: Tetris (NES)
   1.533 +
   1.534 +The skin should specify a background image to be drawn behind
   1.535 +the menu text.
   1.536 +
   1.537 +
   1.538 +bug 0061: Frame stepping
   1.539 +Platform: PC
   1.540 +Votes: jagorochi
   1.541 +Parity: Tetris (NES) in emulation
   1.542 +
   1.543 +To check the event loop for off-by-one errors that affect
   1.544 +accuracy against other games, it would be useful to be able
   1.545 +to step the game engine forward by one frame at a time.
   1.546 +
   1.547 +
   1.548 +bug 0062: Replay stepping by piece
   1.549 +Platform: PC
   1.550 +Votes: Lardarse
   1.551 +
   1.552 +Pause demo playback (with well still visible) with hold button;
   1.553 +advance to next lock with rotate button
   1.554 +
   1.555 +
   1.556 +bug 0063: Option for goal
   1.557 +Votes: Lardarse, caffeine, Rosti LFC, fnord, M.Bison
   1.558 +
   1.559 +Separate goal and countdown code out of gimmicks into an option,
   1.560 +controlled by LJField::goalType.  Goals include none, lines,
   1.561 +level, score, time, and keys, which activate comparisons against
   1.562 +goalCount.  This would obsolete many gimmicks.
   1.563 +
   1.564 +
   1.565 +bug 0064: Fill in missing sound effects on handhelds
   1.566 +Platform: GBA, DS
   1.567 +Votes: Lardarse
   1.568 +
   1.569 +These sounds are missing:
   1.570 +GBA: Ready, go, countdown
   1.571 +DS: Ready, go, lose, distinct countdown
   1.572 +
   1.573 +<tepples>
   1.574 +0.42 adds "lose" on DS
   1.575 +
   1.576 +
   1.577 +bug 0065: Bombliss game mode
   1.578 +Requires: 0010
   1.579 +Votes: Joshua
   1.580 +Parity: Bombliss
   1.581 +
   1.582 +When game mode is set to Bombliss, line clears no longer remove
   1.583 +lines from the field.  Instead, one block of each piece is
   1.584 +colored differently and explodes, removing blocks, when in a
   1.585 +line clear.
   1.586 +
   1.587 +
   1.588 +bug 0066: Dr. Mario clone
   1.589 +Requires: 0010
   1.590 +Votes: Lardarse
   1.591 +Parity: freepuzzlearena
   1.592 +
   1.593 +You made Vitamins. Can you make domino rotation, color matching,
   1.594 +and floating garbage with fast DAS, IRS, and 20G?
   1.595 +
   1.596 +
   1.597 +bug 0067: Puyo clone
   1.598 +Requires: 0010
   1.599 +Votes: Lardarse
   1.600 +Parity: freepuzzlearena
   1.601 +
   1.602 +You made a puyo clone in FPA. Can you port it to LJ?
   1.603 +
   1.604 +
   1.605 +bug 0068: Preload hold piece
   1.606 +Votes: Lardarse
   1.607 +
   1.608 +Option to load a specific piece (such as I or T) into the hold box
   1.609 +at game start.
   1.610 +
   1.611 +
   1.612 +bug 0069: Bag with good start
   1.613 +Votes: Rosti LFC
   1.614 +Parity: Tetris The Grand Master ACE
   1.615 +
   1.616 +Randomizer should always give a "preferred piece" (e.g. I, J, L, T)
   1.617 +first, like history does.
   1.618 +
   1.619 +
   1.620 +bug 0070: Small skins shouldn't hide the score
   1.621 +Votes: Rich Nagel
   1.622 +Platform: PC
   1.623 +
   1.624 +Make wiki.skin (and other small-blkW skins) not hide the score
   1.625 +
   1.626 +
   1.627 +bug 0071: Preview at left
   1.628 +Votes: DIGITAL
   1.629 +Platform: PC
   1.630 +
   1.631 +Skin should specify that the vertical preview ("Next at right")
   1.632 +can be moved to the left side of the playfield.
   1.633 +
   1.634 +
   1.635 +bug 0072: Volume for sfx
   1.636 +Votes: DIGITAL
   1.637 +Platform: PC
   1.638 +
   1.639 +Skin should specify volume for sound effects, as it does for music.
   1.640 +
   1.641 +
   1.642 +bug 0073: Make PC use GBA options
   1.643 +Votes: jujube
   1.644 +Platform: PC
   1.645 +Resolution: Fixed in 0.43
   1.646 +
   1.647 +Move non-GBA/DS specific code from gbaopt.c to options.c,
   1.648 +then take out everything in old_pc_options.c that isn't
   1.649 +load, save, or LJPCView related
   1.650 +
   1.651 +<tepples>
   1.652 +0.42 takes some steps in this direction.
   1.653 +
   1.654 +
   1.655 +bug 0074: Macro editor
   1.656 +Votes: deepdorp
   1.657 +
   1.658 +Make the actions performed by the macro vkeys editable.
   1.659 +
   1.660 +
   1.661 +bug 0075: Pattern randomizer
   1.662 +Votes: Rich Nagel
   1.663 +
   1.664 +Allow the player to define a piece sequence, such as the Sega
   1.665 +power-on pattern, and deal that.  It could replace iCheat(tm).
   1.666 +
   1.667 +
   1.668 +bug 0076: Skin should vary per section
   1.669 +Votes: Needle, Rich Nagel, DIGITAL
   1.670 +Parity: freepuzzlearena, Luminesweeper
   1.671 +
   1.672 +For speed curves that have sections, it should be possible for a
   1.673 +skin to specify a background image and music for each section.
   1.674 +
   1.675 +<Rich Nagel>
   1.676 +Option to load all skin files before the game starts, so as not to
   1.677 +make an unpredictable ARE at the start of a section.
   1.678 +
   1.679 +
   1.680 +bug 0077: Define conditions that trigger initial drop
   1.681 +Votes: Needle
   1.682 +Parity: Tetris The Absolute The Grand Master 2 PLUS
   1.683 +
   1.684 +In TAP, initial hard drop and initial soft drop don't get turned on
   1.685 +in Master 900+ or in Death 0+.  Find an appropriate rule for whether
   1.686 +to do initial hard drop, and document it.
   1.687 +
   1.688 +
   1.689 +bug 0078: Set random seed
   1.690 +Votes: Rich Nagel, colour_thief, Lardarse
   1.691 +Parity: FreeCell
   1.692 +
   1.693 +For competition purposes, it should be possible to seed the
   1.694 +randomizer to a constant value.  Note that this differs from the
   1.695 +"power on pattern" proposal of bug 0075.
   1.696 +
   1.697 +
   1.698 +bug 0079: Customizable speedometer sample window
   1.699 +Votes: matt_hatter83
   1.700 +
   1.701 +The speedometer uses a sliding window of 10 pieces.  Can one make it
   1.702 +shorter in options?
   1.703 +
   1.704 +
   1.705 +bug 0080: Portrait monitor support
   1.706 +Votes: PetitPrince
   1.707 +
   1.708 +Skin setting to rotate the entire playfield by 90 degrees.
   1.709 +
   1.710 +
   1.711 +bug 0081: DTET rotation system
   1.712 +Requires: 0015
   1.713 +Votes: cdsboy, caffeine, fnord
   1.714 +Parity: DTET
   1.715 +
   1.716 +Implement the rotation system of DTET, as described on the wiki.
   1.717 +This includes a third set of wall kick tables for each piece in each
   1.718 +rotation system for +180 (in addition to existing +90 and +270).
   1.719 +
   1.720 +
   1.721 +bug 0082: Paged options on PC
   1.722 +Votes: Cubicz
   1.723 +Resolution: Fixed in 0.43
   1.724 +
   1.725 +Break the PC options menu into pages like it is on the handhelds.
   1.726 +
   1.727 +
   1.728 +bug 0083: Undo
   1.729 +Votes: Kuukunen
   1.730 +
   1.731 +Press a button to take back one drop.  Useful for training.
   1.732 +
   1.733 +
   1.734 +bug 0084: Manual entry delay
   1.735 +Votes: Kuukunen
   1.736 +
   1.737 +Pause after each piece with game displayed.  Press a button to
   1.738 +resume.  Useful for training.
   1.739 +
   1.740 +
   1.741 +bug 0085: Forward progress lock delay reset
   1.742 +Votes: zaphod77
   1.743 +
   1.744 +Keep track of the lowest space that this piece has fallen to.
   1.745 +A floor kick should never reset lock delay, and only a net
   1.746 +downward movement below where it was when the lock delay was
   1.747 +last reset should reset lock delay.
   1.748 +
   1.749 +
   1.750 +bug 0086: Carbon Engine style lock delay reset
   1.751 +Parity: TOD
   1.752 +
   1.753 +Carbon Engine implemented lock delay as follows:  When a piece
   1.754 +rotates or shifts from landed to falling, recharge one row's
   1.755 +worth of lock delay for each row that the piece moves down.
   1.756 +
   1.757 +To implement this in Lockjaw Engine, move the piece down by
   1.758 +(lockDelay - stateTime).  If the piece is less than
   1.759 +(lockDelay - stateTime) * gravity above the shadow, only add
   1.760 +(y - shadowY) / gravity to stateTime.
   1.761 +
   1.762 +
   1.763 +bug 0087: Blackjack randomizer framework
   1.764 +Votes: Lardarse
   1.765 +
   1.766 +Lardarse and tepples described a language for describing randomizers
   1.767 +on tetrisconcept.com's wiki.  It is called Blackjack.
   1.768 +
   1.769 +
   1.770 +bug 0088: Option for piece color
   1.771 +Votes: Lardarse
   1.772 +Requires: 0010
   1.773 +
   1.774 +Once we have colors per block, add an option for piece colors,
   1.775 +which might replace the ljconnSRS vs. ljconnSega divide.
   1.776 +Skins would always be in Guideline order.
   1.777 +
   1.778 +> Set by rotation system (current behavior)
   1.779 +  SRS
   1.780 +  Sega
   1.781 +  Dualism (formerly H&R)
   1.782 +  Shuffle (randomize at game start)
   1.783 +  Super Shuffle (randomize every piece)
   1.784 +
   1.785 +
   1.786 +bug 0089: Long debrief lines are clipped
   1.787 +Requires: 0031
   1.788 +Votes: Lardarse, kesiev
   1.789 +Resolution: Fixed in 0.43
   1.790 +
   1.791 +The DS doesn't have a small font, so any debrief line longer than
   1.792 +about 48 characters will get clipped.  But in order to make this
   1.793 +line shorter, I need to move things around anyway.
   1.794 +
   1.795 +
   1.796 +bug 0089: Merge preliminary GNU/Linux support
   1.797 +Requires: 0091
   1.798 +Votes: kesiev
   1.799 +Resolution: Fixed in 0.43
   1.800 +
   1.801 +kesiev wrote a patch to let Lockjaw work with separate read-only
   1.802 +and read-write folders, as is often the case in GNU/Linux.
   1.803 +Merge these changes.
   1.804 +
   1.805 +<tepples>
   1.806 +kesiev's patch adds a function called 'turnslash' that turns '\' into
   1.807 +'/' in all path names.  In fact, I can use this on all platforms:
   1.808 +Mac and Linux use '/' as the native path separator, and the Windows
   1.809 +API accepts it even if some legacy command-line programs do not.
   1.810 +
   1.811 +LJVorbis_close: I must have missed that line in the ov_clear
   1.812 +documentation.
   1.813 +
   1.814 +
   1.815 +bug 0090: Process IRS before checking for block out
   1.816 +Votes: Kitaru
   1.817 +Parity: TGM series
   1.818 +Resolution: Fixed in 0.43
   1.819 +
   1.820 +TGM allows the player to IRS out of a block out situation.  So don't check for block out on the last frame of NEW_PIECE. Instead, check at
   1.821 +the end of the first frame (LJSND_SPAWN|LJSND_HOLD) of FALLING_PIECE.
   1.822 +
   1.823 +
   1.824 +bug 0091: Read-only vs. read-write directories
   1.825 +Votes: Ezzelin, kesiev
   1.826 +Resolution: Fixed in 0.43
   1.827 +
   1.828 +Lockjaw for PC currently runs as a "portable application".  But it
   1.829 +should support being installed in the same way as any other program
   1.830 +for Windows or Linux.  If an empty file called "installed" is in the
   1.831 +same folder as argv[0], switch to installed mode.
   1.832 +
   1.833 +Installed mode ignores the working directory when loading .dat,
   1.834 +.skin, .ini, etc.  Instead, it loads from the save data folder
   1.835 +($HOME/.lockjaw on Linux; %APPDATA%/Pin Eight/Lockjaw on Windows)
   1.836 +and then from the folder that contains argv[0].
   1.837 +
   1.838 +The program would usually be installed to /opt/Lockjaw under Linux
   1.839 +or %ProgramFiles%/Lockjaw under Windows.
   1.840 +
   1.841 +
   1.842 +bug 0092: Option to limit IRS to 90 degrees
   1.843 +Votes: jujube
   1.844 +Parity: TGM series
   1.845 +
   1.846 +Rotation limit
   1.847 +  90 degrees
   1.848 +> Unlimited (current behavior)
   1.849 +
   1.850 +And make Master and Death use 90 degrees.
   1.851 +
   1.852 +
   1.853 +bug 0093: Option to disable instant shifting
   1.854 +Parity: TGM series
   1.855 +
   1.856 +Add an option only to scenarios that limits shifting to 1G,
   1.857 +disallowing cheating with far left, far right, DAS=Instant.
   1.858 +
   1.859 +
   1.860 +bug 0094: World reverse
   1.861 +Votes: jujube
   1.862 +Parity: Ti
   1.863 +
   1.864 +Option in Game Keys to reverse rotation directions when playing
   1.865 +rotation systems that start the T flat-down (SRS, TOD M4).
   1.866 +
   1.867 +
   1.868 +bug 0095: Move mouse pointer out of the way
   1.869 +Votes: jujube
   1.870 +Resolution: Fixed in 0.43
   1.871 +
   1.872 +Some players navigate Lockjaw for PC entirely with the keyboard.
   1.873 +For these people, the mouse gets in the way after it has been used
   1.874 +in Replay or Skin (or, soon, Options and Game Keys).  Drop it to
   1.875 +the bottom of the window when the player goes to a screen that
   1.876 +doesn't use the mouse.
   1.877 +
   1.878 +
   1.879 +bug 0096: Allow options to "underride" skin settings
   1.880 +Votes: Rich Nagel
   1.881 +
   1.882 +Allow the user to change shift sound scale, next piece position,
   1.883 +playfield position, as it was in 0.41.  The game would use the
   1.884 +skin setting, or the user setting only if the skin does not specify.
   1.885 +
   1.886 +
   1.887 +bug 0097: Package as Windows installer
   1.888 +Requires: 0091
   1.889 +
   1.890 +Package the Windows executable as an installer that automatically
   1.891 +puts itself in %ProgramFiles%/Lockjaw.
   1.892 +
   1.893 +
   1.894 +bug 0098: Reactive speed curve and scoring
   1.895 +URL: http://www.jenovachen.com/flowingames/flowtheory.htm
   1.896 +Votes: herc
   1.897 +
   1.898 +Start with zero speed.  Track the player's speed using the existing
   1.899 +speedometer code.  Then once the player has dropped a few pieces,
   1.900 +start scaling up the delays and such so that entry + (20/gravity) +
   1.901 +lock delay equals the average time that the player took to place 
   1.902 +a piece.  Then multiply all line clear scores by the current speed.
   1.903 +
   1.904 +
   1.905 +bug 0100: Import old bugs
   1.906 +Parity: bugzilla.mozilla.org
   1.907 +
   1.908 +Bring some order to the old 'todo.txt' enhancement list.
   1.909 +

     2.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     2.2 +++ b/CHANGES.txt	Fri Mar 13 00:39:12 2009 -0700
     2.3 @@ -0,0 +1,1067 @@
     2.4 +0.46a (2008-11-09)
     2.5 +  * Preview at top is copied correctly from the back buffer
     2.6 +    (0.45a regression, reported by rednefed).
     2.7 +
     2.8 +_____________________________________________________________________
     2.9 +0.46 (2008-11-08)
    2.10 +  * Tracks number of 4x4 squares that the player forms
    2.11 +    (TOD parity; requested by Ghett0).
    2.12 +  * Added T-Party randomizer (requested by Lardarse).
    2.13 +  * Default lock delay for Zero set to 40 frames, even if it is
    2.14 +    played first (0.45 regression, reported by rck).
    2.15 +  * "[TC]" removed from scenario names (requested by caffeine).
    2.16 +  * PC: Uses fourCCs for option values in lj.ini.
    2.17 +  * PC: Uses double buffer for entire background (bug 0021).
    2.18 +  * PC: Can disable sound effects by deleting or renaming sound.dat
    2.19 +    (requested by moxie101).
    2.20 +  * PC: More of the code is 2-player-clean.
    2.21 +
    2.22 +_____________________________________________________________________
    2.23 +0.45 (2008-04-20)
    2.24 +  * New unified speed curve system: less code, more tables, for
    2.25 +    future loading from a file (bug 0040).
    2.26 +  * All speed curves except Rhythm and Rhythm Zero have been ported
    2.27 +    to the new system.  Notably, Master has been rewritten based on
    2.28 +    the tables from the wiki, and Exponential uses sections.  The
    2.29 +    lock delay speeds up as brutally after 600 pieces as always.
    2.30 +  * Added kludge in the basic makefile that allows building on *BSD
    2.31 +    and GNU/Linux: 'make linux' (patch by kesiev).
    2.32 +  * ljpath: Fixed a couple misspellings in the non-Windows code path
    2.33 +    (reported by kesiev).
    2.34 +  * ljpath: Supports libfat when running on Nintendo DS.
    2.35 +  * A few descriptions of options have been shortened to fit into
    2.36 +    the new GBA/DS look (reported by Bloodstar; patch by caffeine).
    2.37 +  * Writes result and options text to standard output as well as to
    2.38 +    lj-scores.txt. This allows you to do 'lj | postprocessor' even
    2.39 +    if you can't do 'tail -f lj-scores.txt' (requested by kesiev).
    2.40 +  * DS: Writes result and options to /data/lockjaw/lj-scores.txt.
    2.41 +
    2.42 +_____________________________________________________________________
    2.43 +0.44 (2008-02-20)
    2.44 +  * Computes the preview and hold offset of all pieces (was
    2.45 +    wkNextMove in <= 0.43) from the entry position of the I
    2.46 +    tetromino (was wkSpawnMove in <= 0.43).
    2.47 +  * Kick tables have been inverted to a single struct per rotation
    2.48 +    system, for future loading from a file (bug 0016).
    2.49 +  * SKIP_IF system for handling J/L/T exceptions in Arika is replaced
    2.50 +    with IF_NOT_CENTER: wall kicks are allowed if the free-space
    2.51 +    orientation overlaps any blocks other than in the center column.
    2.52 +  * Options DAS doesn't repeat too fast, even on those systems where
    2.53 +    vsync() is a no-op (0.43 regression, reported by caffeine).
    2.54 +    This has the same cause as 0022: Windows Vista ignores vsync().
    2.55 +  * Options DAS doesn't continue across page boundaries.
    2.56 +  * GBA/DS: Options has new look.
    2.57 +  * DS: Reads the touch screen and the X and Y buttons.  Right now,
    2.58 +    touch isn't mapped to anything, but X and Y are Far Right and
    2.59 +    Far Left.
    2.60 +
    2.61 +_____________________________________________________________________
    2.62 +0.43a (2008-02-11)
    2.63 +  * Arika modified to use SKIP_IF3 after (not before) the basic
    2.64 +    position.  This restores ability to rotate J, L, and T with
    2.65 +    kicks turned off, such as in IRS (reported by Lion).
    2.66 +  * PC: Uses shfolder.dll so that installability works even on
    2.67 +    Windows 98 (0.43 regression, reported by Rich Nagel).
    2.68 +  * PC: Key bindings to J, M, and Z are correctly saved (0.43
    2.69 +    regression, reported by DIGITAL).
    2.70 +  * PC: In Game Keys, the names of Up and Down key bindings are
    2.71 +    clearer (requested by 4matsy).
    2.72 +
    2.73 +_____________________________________________________________________
    2.74 +0.43 (2008-02-10)
    2.75 +  * Player can initial-rotate out of block out (bug 0090).
    2.76 +  * Initial rotation doesn't use wall kick (bug 0059).
    2.77 +  * Names for values in Drop scoring and Shadow fixed
    2.78 +    (0.42 regression, reported by Lardarse).
    2.79 +  * Number of line clears in DS debrief should be cut off at the
    2.80 +    right side less often (bug 0089; fix based on a patch by kesiev).
    2.81 +  * Fixed line clear gravity in cascade preset (reported by 4matsy).
    2.82 +  * Fixed Fibonacci scoring with more than 8 lines per piece
    2.83 +    (reported by 4matsy).
    2.84 +  * Debrief is more compact, allowing GBA to use debrief (bug 0031;
    2.85 +    fix based on a patch by kesiev).
    2.86 +  * Debrief: Zigzag secret grade requires the hole in the top row to
    2.87 +    be covered (reported by Kitaru).
    2.88 +  * PC: If installed.txt is in the same folder as the program,
    2.89 +    ignores the current directory and stores all writable files
    2.90 +    to the user's application data folder (bug 0091).
    2.91 +  * PC: When loading skins, searches for files in the folder with
    2.92 +    the .skin file instead of the current directory (bug 0033).
    2.93 +  * PC: Replay sets up playback gimmick (0.42 regression,
    2.94 +    reported by DIGITAL).
    2.95 +  * PC: LJVorbis doesn't double-fclose the .ogg file
    2.96 +    (reported by kesiev).
    2.97 +  * PC: Mouse drops to bottom after skin or replay selection
    2.98 +    (requested by jujube).
    2.99 +  * PC: Options is separated into pages, like on GBA/DS (bug 0082).
   2.100 +    This frees up room for larger type (requested by jujube).
   2.101 +
   2.102 +_____________________________________________________________________
   2.103 +0.42 (2008-02-03) aka LOCKJAW XLII
   2.104 +  * Docs: Most of TODO.txt has been converted to a numbered list
   2.105 +    of bugs (bug 0100).
   2.106 +  * An off-by-1/65536 error in enter below ceiling was fixed.
   2.107 +    This means it doesn't give one extra row of room to slide on
   2.108 +    at the top of the well (reported by Caithness and Kukuunen).
   2.109 +  * In case of a block out, draws the offending piece in the well
   2.110 +    before entering game over animation.
   2.111 +  * Extra 5-frame cascade delay removed.
   2.112 +  * With Lockdown set to Step reset, lock delay resets on the
   2.113 +    first floor kick.
   2.114 +  * Tengen rotation system tries kicking one space to the left
   2.115 +    (requested by zaphod77).
   2.116 +  * Options' names and values are looked up from fourCCs for future
   2.117 +    localizability.
   2.118 +  * Options: Names of speeds in fractions of 1G are computed.
   2.119 +  * Options skips unpacking options with a value of 255.
   2.120 +    This allows multiple pref structures to be unpacked on top
   2.121 +    of each other, and each overrides the ones before it.
   2.122 +  * Debrief displays options on a second page.
   2.123 +  * Debrief correctly displays soft drop speed as a fraction (0.41
   2.124 +    regression, reported by Lardarse).
   2.125 +  * Debrief: PC specific parts moved to separate source code file.
   2.126 +  * Debrief uses a lower-level function to format ISO 8601 date
   2.127 +    and time so as not to bring in the floating-point library's
   2.128 +    space overhead on platforms without an FPU.
   2.129 +  * Debrief plays a sound when turning the page.
   2.130 +  * PC: Delay for holding Esc to quit no longer depends on
   2.131 +    display refresh rate.  Instead, it uses the global 60 Hz
   2.132 +    timer (reported by Sara).
   2.133 +  * PC: Draws speedometer even when preview is at right,
   2.134 +    as long as there is room, that is, 3 or fewer next pieces
   2.135 +    (requested by Cubicz).
   2.136 +  * PC: Gimmick choice moved to Options to match GBA/DS.
   2.137 +  * PC: Select scenario before starting game (bug 0041).
   2.138 +  * PC options uses standardized GBA names (OPTIONS_*) instead of
   2.139 +    PC names (LJPREFS_*).
   2.140 +  * PC options Shift sound scale, Side, and Next position moved to
   2.141 +    skin.
   2.142 +  * PC options sets initial options using initOptions() from GBA/DS.
   2.143 +    Incidentally, this restores the initial randomizer to bag
   2.144 +    (0.41 regression and may make similar regressions less likely.
   2.145 +  * PC options uses unpackOptions() from GBA/DS.
   2.146 +  * PC options sound is also routed through the cross-platform
   2.147 +    sound manager.
   2.148 +  * PC: lj.ini uses fourCCs as names for easier saving and loading.
   2.149 +  * PC: Switching between windowed and full screen in Options
   2.150 +    no longer needs the user to restart the program.
   2.151 +  * PC: LJVorbis doesn't crash if polled while the music is stopped.
   2.152 +    This can happen when cross-platform code plays sound effects
   2.153 +    during debrief.
   2.154 +  * PC: Skin controls window size, or full screen resolution
   2.155 +    (bug 0017).
   2.156 +  * PC/DS: Displays a description of some option values in addition
   2.157 +    to descriptions of options themselves.
   2.158 +  * GBA/DS: Options disabled on the PC are disabled here.
   2.159 +  * GBA: Menus are faster now that part of the text engine has been
   2.160 +    moved to fast RAM.
   2.161 +  * DS: Plays sound for game over (bug 0064).
   2.162 +  * DS: Options displayed on touch screen for future touch operation.
   2.163 +  * DS: Displays debrief after game ends (bug 0031).
   2.164 +
   2.165 +_____________________________________________________________________
   2.166 +0.41 (2007-12-18)
   2.167 +  * Piece set and randomizer are decoupled (requested by Lardarse
   2.168 +    and Dood77).
   2.169 +  * New piece set: iCheat(tm) deals only I tetrominoes, like an
   2.170 +    infamous cheat code for some other game (requested by DIGITAL).
   2.171 +  * New garbage style "Preload zigzag", which preloads a zigzag
   2.172 +    pattern of holes.
   2.173 +  * At debrief time, if at least two rows of the zigzag pattern
   2.174 +    or at least four rows of a rectum (1-block-wide opening) are
   2.175 +    formed, shows a secret grade based on the number of pattern
   2.176 +    rows instead of the number of blocks left in the playfield.
   2.177 +  * Debrief options section sorted by position in options menu.
   2.178 +  * Debrief allows for multiple pages of reports.
   2.179 +
   2.180 +_____________________________________________________________________
   2.181 +0.40a (2007-11-30)
   2.182 +  * Does not attempt to create a ghost piece before the first
   2.183 +    falling piece.  This may fix a crash on some systems if the
   2.184 +    first game played during a session has deep drop turned on
   2.185 +    (reported by Rich Nagel on Windows 98 Second Edition).
   2.186 +  * Deep drop ghost piece code stops checking at the ceiling.
   2.187 +
   2.188 +_____________________________________________________________________
   2.189 +0.40 (2007-11-27)
   2.190 +  * Split out speed curves and randomizers to separate files called
   2.191 +    speed.c and random.c.
   2.192 +  * Adjusted master delays to be closer to TAP; 600-999 no longer
   2.193 +    overlap Death 000-399.
   2.194 +  * Displays short description of each option (requested by AXYPB).
   2.195 +  * Drill gimmick is back, with the new goal of clearing the bottom
   2.196 +    row (requested by DIGITAL).
   2.197 +  * Begin to add code for explosive line clear gimmick; not yet
   2.198 +    integrated (requested by Joshua).
   2.199 +  * Debrief shows number of floor kicks.
   2.200 +  * Bottom blocks is called Deep drop to match recent Multiblocks.
   2.201 +  * PC: Close box works in Options and Game Keys.
   2.202 +  * PC: Does not redraw title screen if close box is clicked.
   2.203 +  * PC: If skin sets transparentPF=1, hotlines and line clear
   2.204 +    animations are drawn transparent (requested by Rich Nagel).
   2.205 +  * GBA/DS: Can quit game from pause screen (requested by AXYPB).
   2.206 +  * GBA/DS: Copyright notice and options screen drawn with
   2.207 +    proportional font for readability.
   2.208 +  * GBA/DS: Menu uses the same sound manager that the game play
   2.209 +    uses, not the platform-specific sound manager.
   2.210 +  * GBA: Sound for end of game (requested by Lardarse).
   2.211 +  * DS: Closing the lid pauses the game and turns off the screens
   2.212 +    (requested by AXYPB).
   2.213 +  * DS: Unavailable hold piece is really grayed out.
   2.214 +  * DS: Real music and sound effects engine (requested by
   2.215 +    bob_fossil).
   2.216 +
   2.217 +_____________________________________________________________________
   2.218 +0.39 (2007-10-24)
   2.219 +  * Does not double line clear delay (unknown regression).
   2.220 +  * Source code includes new files options.h and old_pc_options.c
   2.221 +    which were mistakenly left out of 0.38 (reported by tr3).
   2.222 +  * Draws "hotline" symbol on lines being cleared (requested by
   2.223 +    Rosti LFC and kiwibonga).
   2.224 +  * Debrief no longer counts a zero line T-spin as a home run
   2.225 +    (0.28 regression; reported by Lardarse).
   2.226 +  * New randomizer 7+1-piece Bag adds one randomly selected
   2.227 +    tetromino to each bag (requested by colour_thief).
   2.228 +  * Refactored speed curve state information for pseudo-OO
   2.229 +    refactoring.
   2.230 +  * New option: Bottom blocks allows the falling piece to fall past
   2.231 +    blocks into an appropriately shaped hole (requested by mar).
   2.232 +  * Added bottom blocks and well size to debrief.
   2.233 +  * New gluing options Sticky and Sticky by color.
   2.234 +  * PC: Skin specifies the loop point and whether the music starts
   2.235 +    before or after the "Ready, Go" animation.
   2.236 +  * PC: Skin specifies music volume (requested by DIGITAL).
   2.237 +  * PC: Fixed off-by-one in sideways delay (reported by Lardarse).
   2.238 +  * PC: Fields with blkH > 24, especially blkH == 48 and Well height
   2.239 +    10, are more likely to fit on screen (reported by Needle).
   2.240 +
   2.241 +_____________________________________________________________________
   2.242 +0.38 (2007-09-11)
   2.243 +  * Plays a .ljm specified at the command line (requested by
   2.244 +    Rich Nagel).
   2.245 +  * More refactoring for multiplayer.
   2.246 +  * Added wall kick opcode SKIP_IF3, similar to SKIP_IF except it
   2.247 +    also checks the two cells above the specified cell.
   2.248 +  * L, J, and T in Arika use SKIP_IF3 to check the entire center
   2.249 +    column when rotating to vertical (requested by edo).
   2.250 +  * Moves new tetrominoes to be between the walls (fixing Tengen in
   2.251 +    width 4) and, if "Enter above playfield" is off, down far enough
   2.252 +    so that they're within the playfield (requested by Caithness).
   2.253 +  * New rotation system: Climbing, based on Tetris DX.  (No, you
   2.254 +    can't wall-climb yet because the sub-block behavior differs.)
   2.255 +  * Option "4x4 squares" is called "Gluing".  Other gluing options
   2.256 +    are planned.
   2.257 +  * In Square gluing, formation of a square adds a delay
   2.258 +    equal to line clear delay.
   2.259 +  * PC: Refactored to share some of the GBA/DS options logic.
   2.260 +  * PC: Moved most sound effect code into pcsound.c.
   2.261 +  * PC: Sound for 4x4 square formation (cribbed from TOD).
   2.262 +  * PC: Reloads the default skin's configuration before loading 
   2.263 +    the skin, so that skins always inherit from the default skin
   2.264 +    and not the last chosen skin (requested by Rich Nagel).
   2.265 +  * GBA: Uses duration as priority for square wave sound effects,
   2.266 +    which should prevent the section up sound from getting
   2.267 +    interrupted as often.
   2.268 +  * GBA/DS: Draws real-time speedometer.
   2.269 +
   2.270 +_____________________________________________________________________
   2.271 +0.37 (2007-07-09)
   2.272 +  * Requires "Up" and "Alt firm drop" to be pressed again when
   2.273 +    lock delay is turned off or less than DAS delay
   2.274 +    (requested by reivilo).
   2.275 +  * Keypress count is reset to 0 even in "Play .ljm" (reported by
   2.276 +    jujube).
   2.277 +  * Playing a broken .ljm from the gimmick menu gives an informative
   2.278 +    error message instead of crashing (0.32a regression; reported by
   2.279 +    Rosti LFC).
   2.280 +  * Rhythm section-up logic waits for 64 beats at L bpm, not L+1 bpm.
   2.281 +  * Fixed a potential buffer overflow in shuffleColumns (the "banana"
   2.282 +    item), brought on by the expansion of the playfield to 12 columns
   2.283 +    (0.33 regression).
   2.284 +  * Better comments in source code about wall kick entry macros
   2.285 +    WK(x, y), WKX(wk), WKY(wk) in lj.h (requested by Lardarse).
   2.286 +  * PC: Reinstate Bach music while investing a trademark claim.
   2.287 +  * PC: Separate music for Rhythm speed curves.
   2.288 +  * PC: Does not use stretch blitter when drawing the blocks of
   2.289 +    sprite pieces at full size (e.g. falling piece).
   2.290 +  * PC: blitField() blits adjacent rows in one call, which is
   2.291 +    faster on slow machines (requested by Matthew).
   2.292 +  * PC: Size of hold piece respects blkW and blkH.
   2.293 +  * README describes build instructions for GBA and DS.
   2.294 +  * For user convenience, the Allegro DLL is included with the
   2.295 +    executable, and the source code is in a separate archive.
   2.296 +
   2.297 +_____________________________________________________________________
   2.298 +0.36 (2007-05-21)
   2.299 +  * Allows DAS delay up to 400 ms (requested by Rich Nagel).
   2.300 +  * Option for entry within or above ceiling (requested by DIGITAL
   2.301 +    and Cubicz).
   2.302 +  * Option for hold piece behavior (requested by Lardarse).
   2.303 +  * PC: User can change individual game keys, like in StepMania
   2.304 +    (requested by DIGITAL and Rosti LFC).
   2.305 +  * PC: Minor changes to included background music.
   2.306 +  * PC: Option for playing a scale during sideways motion
   2.307 +    (requested by herc).
   2.308 +  * PC: Selecting a skin saves options (reported by Rich Nagel).
   2.309 +  * PC: When loading saved options, treats 16 ms DAS delay as valid
   2.310 +    (reported by jujube).
   2.311 +  * PC: Skin setting for a transparent background (requested by
   2.312 +    cdsboy and Bloodstar).
   2.313 +  * PC: Demo recording uses "Rec" and "Play" in addition to icons.
   2.314 +  * PC: Reallocates back buffer after each skin switch, avoiding
   2.315 +    problems related to changes in blkW and blkH (reported by
   2.316 +    Rich Nagel).
   2.317 +  * GBA/DS: Fixed line clear options (0.34 regression).
   2.318 +  * GBA/DS: Press Start after lose, rather than timing out to options
   2.319 +    (requested by Webby).
   2.320 +  * "Default" means not to pay back a loan.  Manual uses "initial"
   2.321 +    or "preset" instead (requested by Bruce Tognazzini).
   2.322 +
   2.323 +_____________________________________________________________________
   2.324 +0.35 (2007-04-25)
   2.325 +  * New speed curve Game Boy Heart.
   2.326 +  * New speed curve Death 300+, which starts three sections into
   2.327 +    Death just like cgwg's cheat for TAP (requested by Amnesia).
   2.328 +  * New randomizer 10-piece Memoryless.
   2.329 +  * First garbage line takes into account well width (reported by
   2.330 +    Lardarse).
   2.331 +  * Displays section number for NES, Game Boy, and Game Boy Heart
   2.332 +    speed curves (requested by Rich Nagel).
   2.333 +  * Debrief displays Quadra-style pieces per active minute
   2.334 +    (requested by Cubicz).
   2.335 +  * Debrief calls pieces "pieces" instead of "tetrominoes" in
   2.336 +    10-piece randomizers because I2, I3, L3 are not tetrominoes.
   2.337 +  * PC: Gimmick and level are displayed in skin foreground color
   2.338 +    (missed in 0.30; reported by Rich Nagel).
   2.339 +  * PC: Skin file name suffix is now .skin not .ini, so that skin.ini
   2.340 +    cannot be confused with lj.ini.  The default skin is called
   2.341 +    default.skin not skin.ini.
   2.342 +  * PC: Title screen has option to select skin (requested by
   2.343 +    cdsboy).
   2.344 +  * PC: Block size is no longer hard-coded at 24x24 pixels.
   2.345 +    The new .skin commands blkW= and blkH= control their size
   2.346 +    (requested by Bloodstar).
   2.347 +  * PC: Source code comes with new installation guide written by
   2.348 +    Lardarse in "docs/Compiling_on_Windows.txt".
   2.349 +
   2.350 +_____________________________________________________________________
   2.351 +0.34a (2007-03-27)
   2.352 +  * PC: Fixed hidden level in Next at right mode (0.33 regression).
   2.353 +  * DS: Fixed hidden sprites due to bug in devkitARM R20 libnds
   2.354 +    (0.34 regression).
   2.355 +  * DS: New touch screen code should eliminate erroneous low notes
   2.356 +    played upon pen-up.
   2.357 +
   2.358 +_____________________________________________________________________
   2.359 +0.34 (2007-03-23)
   2.360 +  * Fixed Move to Back piece set (0.14 regression: dang!).
   2.361 +  * Separate options for number of previewed pieces above shadow and
   2.362 +    outside field (requested by kiwibonga, caffeine, and Cubicz).
   2.363 +  * Option to disable IRS (requested by DIGITAL).
   2.364 +  * Garbage gimmicks (vs., drill 40, hr derby) replaced with new
   2.365 +    garbage option (requested by Cubicz).
   2.366 +  * In garbage style "Vs.", player can choose difficulty 1 through 4
   2.367 +    (requested by Caithness).
   2.368 +  * Option for line clear delay, independent of entry delay
   2.369 +    (requested by kiwibonga).
   2.370 +  * Garbage style Drill no longer automatically tops out on
   2.371 +    short playfields.
   2.372 +  * Garbage style Vs. generates garbage with SZSZ randomizer.
   2.373 +  * Frequency of Vs. w/Items bananas is independent of randomizer.
   2.374 +  * Fixed self-clearing garbage (0.33 regression).
   2.375 +  * GBA/DS: Fixed pause button hiding left and right walls
   2.376 +    (0.33 regression).
   2.377 +  * GBA/DS: R button also works as hold piece (requested by
   2.378 +    PetitPrince).
   2.379 +
   2.380 +_____________________________________________________________________
   2.381 +0.33 (2007-03-08)
   2.382 +  * New speed curve Rhythm Zero is identical to Rhythm except it
   2.383 +    operates at 0G instead of 20G (requested by Cubicz and caffeine).
   2.384 +  * Speed curves that do not use level reset level to 0.
   2.385 +    Therefore, playing a game of Death then a game of Exponential
   2.386 +    on GBA/DS no longer shows the level that the player finished
   2.387 +    Death on as the level during Exponential.
   2.388 +  * Maximum well width increased to 12 (requested by Zed0).
   2.389 +  * Hold piece does not reset floor kicks, lock delay time in entry
   2.390 +    reset, or Rhythm's placement timer.
   2.391 +  * GBA/DS: More shared code moved to file "ljgbads.inc".
   2.392 +  * PC: Stops end-of-section sound when game is over
   2.393 +    (requested by Bloodstar).
   2.394 +
   2.395 +_____________________________________________________________________
   2.396 +0.32a (2007-02-25)
   2.397 +  * PC: Fixed demo recording (0.32 regression; reported by Rosti LFC)
   2.398 +  * PC: Option to record all games from the start
   2.399 +    (requested by cdsboy, DIGITAL, Cubicz, and colour_thief).
   2.400 +  * PC: Added Play .ljm gimmick:
   2.401 +    Allegro file selector pops up, and the player can choose the
   2.402 +    filename of a demo to play back (requested by Lardarse).
   2.403 +
   2.404 +_____________________________________________________________________
   2.405 +0.32 (2007-02-13)
   2.406 +  * Changed a CPU yield behavior that was affecting battery
   2.407 +    efficiency on the GBA and DS front ends (reported by Mighty Max).
   2.408 +  * Removed Low Rider gimmick in favor of option for well height
   2.409 +    (requested by Matthew).
   2.410 +  * Option for well width, like Shimizu's Tetris Semipro-68k.
   2.411 +    Combine this with a low well height to simulate BIG mode of
   2.412 +    TGM and Heboris (requested by Matthew).
   2.413 +  * Options for entry delay and sideways delay have "max" added to
   2.414 +    their description to clarify things (requested by kotetsu213 and
   2.415 +    Ezzelin).
   2.416 +  * All speed options given in Hz or G are given in both.
   2.417 +  * PC: Next above shadow works in all playfield positions (reported
   2.418 +    by caffeine).
   2.419 +  * GBA/DS: Added option for soft drop speed (requested by Ezzelin).
   2.420 +  * GBA/DS: Some shared code moved to file "ljgbads.inc".
   2.421 +  * GBA: Unavailable hold piece is grayed out.
   2.422 +  * GBA/DS: Lock delay = no lock works (reported by Ezzelin).
   2.423 +  * GBA/DS: Fixed frames/ms display of delays (reported by Ezzelin).
   2.424 +
   2.425 +_____________________________________________________________________
   2.426 +0.31 (2007-02-03)
   2.427 +  * Draws the score and next pieces before blitting the playfield
   2.428 +    in case a front-end draws the score or next pieces inside the
   2.429 +    playfield.
   2.430 +  * In Baboo!, speed curve Zero sets the level to the number of
   2.431 +    keypresses so far.
   2.432 +  * PC, GBA: Plays sound effect for end of section in speed curves
   2.433 +    that use sections (Master, Death, NES, Game Boy).
   2.434 +  * PC: Option to draw next pieces inside the playfield, above the
   2.435 +    shadow (requested by caffeine, cdsboy, and Cubicz).
   2.436 +  * GBA, DS: Blocks within a piece are drawn connected once they lock
   2.437 +    (TOD parity, requested by Lardarse and Bloodstar).
   2.438 +  * GBA, DS: Baboo! no longer double-counts console buttons passed
   2.439 +    through the joypad reading code.
   2.440 +  * README: "color=image" clone-and-hack error fixed (reported by
   2.441 +    Bloodstar).
   2.442 +  * README: Explains black rectangle in upper left corner as an
   2.443 +    icon for stop (requested by herc).
   2.444 +  * README: Explains controls on GBA and DS.
   2.445 +
   2.446 +_____________________________________________________________________
   2.447 +0.30 (2007-02-01)
   2.448 +  * Fixed ARE display in debrief, which could cause a crash in some
   2.449 +    situations (0.26 regression?).
   2.450 +  * Garbage no longer self-clears in Cascade gravity (reported by
   2.451 +    Bloodstar).
   2.452 +  * In high gravity, land a T with one block over an overhang and
   2.453 +    rotate it once so that it falls and clears a line.  This is no
   2.454 +    longer counted as a T-spin.
   2.455 +  * During a replay, counts keypresses by the replay player.
   2.456 +  * PC: Scales undersized background images to the size of the window
   2.457 +    (requested by Bloodstar).
   2.458 +  * PC: If a piece enters during a skipped frame, a second upward
   2.459 +    trail is no longer drawn (reported by Bloodstar and caffeine).
   2.460 +  * PC: "Next at top" layout draws speedometer (requested by
   2.461 +    matt_hatter83).
   2.462 +  * PC: Trails option is saved properly (reported by caffeine).
   2.463 +  * PC: User can customize the game's text and background colors
   2.464 +    using skin.ini (requested by Bloodstar).
   2.465 +  * Added rudimentary port to Nintendo DS for people with MAX Media
   2.466 +    Dock, M3 Pro, SuperCard Rumble, or SLOT-1 cards, which can run
   2.467 +    DS homebrew but not GBA homebrew.
   2.468 +  * Moscow Nights removed from lj-contrib due to research into the
   2.469 +    copyright term extensions enacted by Russian Federation during
   2.470 +    the 1990s.
   2.471 +
   2.472 +_____________________________________________________________________
   2.473 +0.29 (2007-01-17)
   2.474 +  * TDS scoring recognizes chains properly (reported by Lardarse).
   2.475 +  * TDS scoring section factor stops increasing after 190 lines.
   2.476 +  * Added NES scoring method.
   2.477 +  * Added scoring for soft and hard drops to options and debrief.
   2.478 +  * Cascade no longer deletes the bottom row when lines high on the
   2.479 +    playfield are cleared (reported by Lardarse).
   2.480 +  * PC: Draws trails when a tetromino goes up or down rapidly.
   2.481 +    (Option to turn them off.)
   2.482 +  * PC: Handles dirty rectangles for next pieces and score
   2.483 +    separately.
   2.484 +  * Scoring section of README describes all scoring methods.
   2.485 +
   2.486 +_____________________________________________________________________
   2.487 +0.28 (2007-01-04)
   2.488 +  * Added Cascade gravity, as seen in Quadra, Tetris Worlds Cascade,
   2.489 +    and Tetris DS Touch.
   2.490 +  * Master/Death: Level starts at -1, so that the first piece is
   2.491 +    played at level 0 (requested by Lardarse).
   2.492 +  * Changed T-spin detection to save whether or not a rotation
   2.493 +    involved a kick (0: move; 1: rotate; 2: rotate with kick) so
   2.494 +    that scoring methods such as TDS can score T-spins with and
   2.495 +    without kicks differently.
   2.496 +  * Added TDS scoring method (line clears only).
   2.497 +  * New, more general, possibly easier to understand reshuffle code
   2.498 +    in bag randomizer (requested by Lardarse)
   2.499 +  * GBA: Gold and silver square colors added (requested by Lardarse).
   2.500 +  * PC: Game over in low ceiling no longer fades the area outside the
   2.501 +    playfield (reported by Lardarse).
   2.502 +  * PC: Close box interrupts starting and game over animations.
   2.503 +  * README warns that 4x4 squares mode needs ljconn.
   2.504 +
   2.505 +_____________________________________________________________________
   2.506 +0.27 (2006-12-20)
   2.507 +  * GBA version includes a valid header (requested by Ezzelin).
   2.508 +  * Fixed incorrect spawn orientations for Game Boy rotation system
   2.509 +    (0.25? regression, reported by Lardarse).
   2.510 +  * Fixed incorrect win/loss sound early in 180 seconds (0.25
   2.511 +    regression).
   2.512 +  * New randomizer 10-piece Bag, including the domino and both
   2.513 +    trominoes.
   2.514 +  * GBA version now reports entry and lock delays in both frames
   2.515 +    and milliseconds.
   2.516 +  * Possibly fixed off-by-one in Game Boy speed curve section
   2.517 +    computation, which caused an incorrect slowdown in 210-219
   2.518 +    section (reported by Ezzelin).
   2.519 +
   2.520 +_____________________________________________________________________
   2.521 +0.26 (2006-12-15)
   2.522 +  * Option to allow game to proceed in the background (requested by
   2.523 +    Ezzelin).  However, Windows doesn't appear to pass joystick
   2.524 +    presses to the game running in the background.  FCE Ultra has
   2.525 +    what appears to be exactly the same problem.
   2.526 +  * Added Game Boy and NES speed curves.
   2.527 +  * Options and Game Keys are accessed through title screen, not
   2.528 +    gimmick selection.
   2.529 +  * Option to hide playfield without changing the skin.
   2.530 +  * Rearranged rules section of options to correspond more closely to
   2.531 +    the sequence of operations for each tetromino.
   2.532 +  * Soft or hard drop set to "lock on release" no longer produces
   2.533 +    double locks at 20G.
   2.534 +  * Disable initial hard drop when set to "lock" and entry delay is
   2.535 +    greater than 0 but less than DAS delay.
   2.536 +  * Checks for 4x4 squares top to bottom per comparison with The New
   2.537 +    Tetris (N64).
   2.538 +  * Finer grained selections in entry delay (requested by
   2.539 +    matt_hatter83) and lock delay (requested by caffeine).
   2.540 +    They now are at 50ms increments at the low end.
   2.541 +  * Expanded TGM speed curve to 12 sections.  One comparatively slow
   2.542 +    section at 20G was added to Master before Death-equivalent starts
   2.543 +    (now Death 0 is equivalent to Master 600, not 500), and one
   2.544 +    faster section was added to the end of Death based on info posted
   2.545 +    to wiki by colour_thief.
   2.546 +  * Added H.R. Derby gimmick:
   2.547 +    Like Marathon, but every line you clear other than with a
   2.548 +    home run or a T-spin gives you garbage.
   2.549 +  * Ready Go animation is 1.2 seconds, not 2.0 seconds.
   2.550 +  * Preliminary support for Game Boy Advance, with experimental
   2.551 +    paged options replacing scrolling options.
   2.552 +
   2.553 +_____________________________________________________________________
   2.554 +0.25 (2006-11-28)
   2.555 +  * Fixed History 6 Rolls deciding between the first piece algorithm
   2.556 +    and the subsequent pieces algorithm (reported by Lardarse).
   2.557 +  * Fixed a signedness issue that broke 180 seconds gimmick in the
   2.558 +    case that a tetromino was kept active between 3:00 and 3:01 (0.24
   2.559 +    regression; reported by caffeine).
   2.560 +  * Allows ending the game with a piece in mid-air (0.24 regression).
   2.561 +  * Removed Arika and renamed Arika+TI to Arika.  For the old
   2.562 +    Arika behavior, set Options:Floor kicks to 0.
   2.563 +  * Options screen allows DAS, allowing future versions to make more
   2.564 +    options and more values for each option available in a less
   2.565 +    cumbersome way.
   2.566 +
   2.567 +_____________________________________________________________________
   2.568 +0.24 (2006-11-16)
   2.569 +  * Added Score style to options and debrief.
   2.570 +  * Choice of LJ or TNT64 scoring is based on chosen score style, not
   2.571 +    whether 4x4 squares are turned on.
   2.572 +  * Added Hotline scoring method, where only lines cleared on
   2.573 +    specific rows count toward scoring.  When enabled, draws white
   2.574 +    lines through empty spaces in these rows.
   2.575 +  * New soft drop and hard drop lock setting: Lock on release.  It's
   2.576 +    a spring-loaded system:  When you press the button, it doesn't
   2.577 +    lock, but when you let go, it locks (requested by colour_thief).
   2.578 +  * Option to override lock delay time (requested by caffeine).
   2.579 +  * Option to limit upward kicks (requested by Needle). This may
   2.580 +    obviate the difference between Arika and Arika+TI.
   2.581 +  * Sped up line clear in Master 300-499 to make less of a jarring
   2.582 +    transition to "death" style timings.
   2.583 +  * LJM loading fails even more gracefully on wrong format version,
   2.584 +    properly treating an LJM of the wrong version as not existing.
   2.585 +  * Fixed bug in 0.23's application switch pausing where switching
   2.586 +    away while already paused would require two Esc presses to
   2.587 +    continue (reported by caffeine).
   2.588 +  * Does not stop play until after the line clear animation finishes.
   2.589 +    This allows the game to properly update the single, double,
   2.590 +    triple, etc. counts for the last line that completes the goal
   2.591 +    (0.19 scoring regression?; reported by caffeine).
   2.592 +  * Refactored duplicated option loading code.
   2.593 +  * Options: Ditched parallel struct and array in favor of a
   2.594 +    single list of named indices.
   2.595 +  * Corrected Moscow Nights and Kalinka in lj-contrib for greater
   2.596 +    compatibility with obscure s3m players that can't handle odd
   2.597 +    numbers of channels (requested by Lardarse).
   2.598 +
   2.599 +_____________________________________________________________________
   2.600 +0.23 (2006-11-04)
   2.601 +  * Fixed S and Z in Sega 1988.
   2.602 +  * DUMB has been wrapped in a library called LJMusic and can be
   2.603 +    turned off at compile time (edit ljmusic.c and makefile) if you
   2.604 +    don't want to install DUMB.
   2.605 +  * Added support for Xiph.org's OggVorbis codec to LJMusic
   2.606 +    (requested by Needle).
   2.607 +  * Option to ignore sideways movement on first frame (like TGM
   2.608 +    series) (requested by Needle, seconded by caffeine).
   2.609 +  * Properly pauses the game when the player switches away from the
   2.610 +    window (requested by Lardarse).
   2.611 +  * Fails gracefully (does nothing) instead of crashing when loading
   2.612 +    replay files of a different format version.
   2.613 +  * Moved as much as possible below setting display mode so that
   2.614 +    people porting LJ to other platforms can toss up working alert()
   2.615 +    boxes earlier (requested by cdsboy).
   2.616 +
   2.617 +_____________________________________________________________________
   2.618 +0.22 (2006-10-23)
   2.619 +  * Fixed color system change after reloading (0.20 regression?,
   2.620 +    reported by lardarse).  Should always unpack options just before
   2.621 +    loading skin.
   2.622 +  * All numbers in saved states are stored big-endian, making movies
   2.623 +    compatible between 0.22 for Windows and Intel Mac and 0.22 for
   2.624 +    PowerPC Mac (requested by cdsboy).
   2.625 +  * Sega rotation systems renamed to Arika for less confusion with
   2.626 +    the rotation systems in Sega's Tetris games from 1988 and 1998
   2.627 +    (requested by Needle).
   2.628 +  * Added Sega 1988 rotation system (like Arika without wall kicks).
   2.629 +  * Preliminary Vorbis playback code is included in the source code
   2.630 +    distribution but has not been activated in the program.
   2.631 +    (The keys to compiling OggVorbis on MinGW+MSYS are 1. set the
   2.632 +    prefix to match the MINGDIR you used to build Allegro, and
   2.633 +    2. disable creation of the shared library.)
   2.634 +
   2.635 +_____________________________________________________________________
   2.636 +0.21 (2006-10-21)
   2.637 +  * Added new T-spin detection rule "3-corner T no kick", identical
   2.638 +    to 3-corner T except that a wallkick is not counted as a rotation
   2.639 +    (requested by kotetsu213).
   2.640 +  * Options that don't apply because of how another option is set
   2.641 +    are grayed out with an explanation (requested by Needle).
   2.642 +  * Debrief tells number of blocks left in the playfield and whether
   2.643 +    saved state was used (requested by caffeine).
   2.644 +  * Debrief tells what level the player stopped on.
   2.645 +  * Added support for saving input stream ("demo" or "movie") to file
   2.646 +    "demo.ljm".  Press [ to start/stop recording and ] to start/stop
   2.647 +    playback (requested by caffeine).
   2.648 +  * Pieces are actually random again (0.20 regression).
   2.649 +  * New lockdown mode: Entry reset.  Instead of resetting, the lock
   2.650 +    timer pauses while the piece is falling (requested by caffeine).
   2.651 +  * No +20 for banking more than 5 beats (requested by caffeine).
   2.652 +  * 250 ms entry delay option (requested by matt_hatter83).
   2.653 +  * Entry and sideways delays in Master and Death use the shorter of
   2.654 +    the speed curve's delay and the user's delay.
   2.655 +  * Added soft drop speed to options.
   2.656 +  * Added settings 8.6 Hz through 6.7 Hz to Sideways speed.
   2.657 +
   2.658 +_____________________________________________________________________
   2.659 +0.20 (2006-10-15)
   2.660 +  * Fixed color system change after options (0.19 regression).
   2.661 +  * Restored ability to hold first piece (0.17 regression?).
   2.662 +  * Requires down to be re-pressed only when entry delay is less
   2.663 +    than sideways delay.
   2.664 +  * In modes with ARE, allow initial hard drop even on first piece
   2.665 +    (requested by caffeine).
   2.666 +  * Visual refresh in Game Keys.
   2.667 +  * Game Keys ignores keypresses for 1/4 second after each key is
   2.668 +    set, which should fix problems with GameCube to USB adapters
   2.669 +    (requested by Caithness).
   2.670 +  * All platforms use a single randomizer, whose state is associated
   2.671 +    with the playfield.
   2.672 +  * ARE is a binary option again, as several speed curves ignored the
   2.673 +    old version's difference between constant and decreasing.
   2.674 +  * Moved version display to title screen.
   2.675 +  * Sound effect for win differs from that for game over.
   2.676 +  * Sound effect for rotating a piece on its first active frame.
   2.677 +  * Begun to add assertions, causing game over if they fail.
   2.678 +  * Added support for saving the state of the playfield.
   2.679 +    Press [ to save or ] to load.  Movies might be next.
   2.680 +
   2.681 +_____________________________________________________________________
   2.682 +0.19 (2006-09-28):
   2.683 +  * Use of SRS or Sega colors is determined by a flag set for each
   2.684 +    rotation system.  The rule is that rotation systems that use
   2.685 +    bounding box rotation should use SRS colors.
   2.686 +  * Added TOD M4 rotation system (face up entry + bounding box
   2.687 +    rotation + roughly TGM style compensation).
   2.688 +  * List items in Options flicker much less.
   2.689 +  * Beginning of an actual title screen.
   2.690 +  * Removed Rhythm gimmick in favor of speed curve option.
   2.691 +  * Added Master and Death speed curves (requested by Needle).
   2.692 +    Death hasn't been tested thoroughly because the developer
   2.693 +    sucks at death.
   2.694 +  * Blits only those playfield rows that have changed, making
   2.695 +    animation smoother on old, cheap, or mobile video cards
   2.696 +    (requested by cosmonaut).
   2.697 +  * Rhythm speed curve no longer has what feels like a big elbow
   2.698 +    (requested by caffeine).  Specifically it gives 20 points
   2.699 +    instead of banking more than 5 pieces' worth of time.
   2.700 +  * Doesn't draw the state after the tetromino spawns but before
   2.701 +    initial rotation has taken effect (requested by Needle).
   2.702 +  * Added sound effect for hold piece (requested by Needle).
   2.703 +  * Land and lock sound much better (requested by Needle).
   2.704 +  * Shuffle columns (seen only in Vs. w/ Items) correctly disconnects
   2.705 +    blocks horizontally.
   2.706 +  * In Square mode, T-spins cause avalanches.
   2.707 +  * In Square mode, lines containing a piece of a 4x4 block are worth
   2.708 +    more, and homers are worth less.
   2.709 +  * Fixed ignoring diagonal presses (0.17 regression).
   2.710 +  * Created a new struct "LJPrefs" to hold preferences set by the
   2.711 +    player in the Options menu separately from the parameters
   2.712 +    that the game actually uses. This allows gimmicks to override
   2.713 +    preferences more cleanly.
   2.714 +  * Added support for future scoring methods where the score per line
   2.715 +    at a given point in the chain is based on a formula.
   2.716 +  * Created a union that combines the new struct with the array that
   2.717 +    the Options menu edits to improve maintainability of Options.
   2.718 +
   2.719 +_____________________________________________________________________
   2.720 +0.18 (2006-09-16):
   2.721 +  * Fixed Classic lock reset (unknown regression).
   2.722 +  * Fixed misbehavior when hold is pressed after a piece
   2.723 +    lands but before it locks (0.17 regression).
   2.724 +  * Shadow is drawn using the piece's color, at 25% opacity,
   2.725 +    from rows 4 and 5 of ljblocks.
   2.726 +  * Fixed shadow option saving (0.17a regression).
   2.727 +  * Added option to hide shadow color or change shadow opacity.
   2.728 +  * Split Sega rotation system into one with and one without
   2.729 +    TGM3's upward kicks.
   2.730 +  * Added NES and Game Boy rotation systems.
   2.731 +  * README: Illustration of game play has an image map.  The reader
   2.732 +    can select (hover over) a region of the screenshot, and the
   2.733 +    browser will show the title of the region as a tooltip.
   2.734 +  * BPM is now called speed level in preparation for other
   2.735 +    speed curves (including TGM and TA Death).
   2.736 +
   2.737 +_____________________________________________________________________
   2.738 +0.17 (2006-09-13):
   2.739 +  * Option for sticky gravity per color, as seen in The Next Tetris.
   2.740 +  * "Ready, Go" is centered, even in low ceiling gimmicks.
   2.741 +  * Added TGM3's upward kick to Sega T rotations.
   2.742 +  * Added Tengen rotation system.
   2.743 +  * Removed TGM gimmick in favor of entry delay option.
   2.744 +  * Initial hold works at any time.  The key can be pressed and
   2.745 +    released during entry delay or even during line clear delay.
   2.746 +  * Initial actions do not inflate keypress count
   2.747 +    (helpful in Baboo! with entry delay).
   2.748 +  * Draws hold piece in garbage colors when it is not available.
   2.749 +  * Options scroll.
   2.750 +  * Option to draw next pieces to right in constant size or above.
   2.751 +  * Better looking scroll bar in options.
   2.752 +  * Debrief: In naive gravity, reports T-spin singles, doubles,
   2.753 +    and triples separately from non-T-spins.  In other line
   2.754 +    clear gravity modes, "home run" is now called "quad".
   2.755 +  * Fixed a buffer overflow bug in sticky: fillCLoop() no longer
   2.756 +    treats the right side of one row and the left side of the
   2.757 +    row above it as one region.
   2.758 +  * Clarified manual as to the purpose of the Vs. gimmicks.
   2.759 +  * Separated platform specific stuff into a separate struct.
   2.760 +  * Refactored scoring into a separate function for future movement
   2.761 +    to gimmick and option control.
   2.762 +  * Debrief formats the report into a string and then writes it
   2.763 +    to a file and the screen all at once.
   2.764 +  * Refactored play() to move everything in the game loop that is
   2.765 +    not platform specific out of ljpc.c into new file ljplay.c.
   2.766 +  * Wall kick table is no longer flipped, making it easier to add
   2.767 +    new rotation systems.
   2.768 +  * Unified counterclockwise and clockwise rotation code.
   2.769 +
   2.770 +_____________________________________________________________________
   2.771 +0.16 (2006-09-03):
   2.772 +  * Fixed instant sideways speed (0.15 regression).
   2.773 +  * In countdown modes, debrief screen displays whether clear was
   2.774 +    successful.
   2.775 +  * 6-piece Bag no longer makes Vs. ridiculously easy.
   2.776 +  * Counts score and garbage separately for future shift to
   2.777 +    gimmick-controlled scoring.
   2.778 +  * Displays score instead of garbage on the play screen.
   2.779 +  * Counts singles, doubles, triples, and homers, and displays them
   2.780 +    in debrief.
   2.781 +  * Option to hide falling piece in addition to shadow.
   2.782 +  * Can load mod, xm, or it music in addition to s3m.
   2.783 +  * Moved skin description from lj.ini to skin.ini, and the name of
   2.784 +    this skin description file name can be changed with the Skin=
   2.785 +    command in lj.ini.
   2.786 +  * Closes lj.ini when reading it.
   2.787 +  * All vkey->action game key handling code moved to macro.c for
   2.788 +    future refactoring.
   2.789 +  * Build process uses automatic generation of C files' dependencies
   2.790 +    for future refactoring of header files.
   2.791 +  * Added two versions of NES-style blocks to lj-contrib:
   2.792 +    one by tepples and one by deepdorp.
   2.793 +
   2.794 +_____________________________________________________________________
   2.795 +0.15 (2006-08-27):
   2.796 +  * Options for DAS delay, number of next pieces, and window vs.
   2.797 +    full screen.
   2.798 +  * Options scrolling doesn't cause the dialog's title and
   2.799 +    instructions to flicker.
   2.800 +  * Small font's 5 glyph is the same width as other digits.
   2.801 +  * Fixed O shape table.
   2.802 +  * Macros (vkey->action mappings past the first 8) are in a
   2.803 +    lookup table in the new file macro.c.  This paves the way
   2.804 +    for a future macro editor.
   2.805 +  * Added macros Alt. Firm Drop and Alt. Hold.
   2.806 +  * Game Keys displays names for all keys, not just printable keys.
   2.807 +  * In Sega rotation mode, reads block images from ljblocks-sega.bmp
   2.808 +    and ljconn-sega.bmp if available.
   2.809 +  * If ljbg.jpg is not available, uses a plain white backdrop.
   2.810 +  * Reads file names for block images, background image, and music
   2.811 +    from lj.ini, which the player can edit with a text editor.
   2.812 +  * New "6-piece Bag" randomizer is one stick short of a bundle.
   2.813 +  * Added an arrangement of the minuet from JS Bach's French Suite
   2.814 +    in B minor (BWV 814) to lj-contrib.
   2.815 +
   2.816 +_____________________________________________________________________
   2.817 +0.14 (2006-08-18):
   2.818 +  * pause() renamed to pauseGame() to fix namespace collision on
   2.819 +    platforms with unistd.h (Linux, BSD, Mac).
   2.820 +  * Gimmick settings for initial gravity, ARE, and ceiling height
   2.821 +    are initialized from a lookup table.
   2.822 +  * History 6 Rolls randomizer uses correct initial history (ZSZS)
   2.823 +    and correct selection for the first piece (I, J, L, or T).
   2.824 +  * Blocks are drawn connected within each tetromino if ljconn.bmp
   2.825 +    is present.
   2.826 +  * Corrected connection table for O tetromino.
   2.827 +  * Rhythm's BPM counter increases after every 64 beats, not every
   2.828 +    64 tetrominoes.
   2.829 +  * Added Low Vs. gimmick:
   2.830 +    Like Vs. CPU with a low ceiling.
   2.831 +
   2.832 +_____________________________________________________________________
   2.833 +0.13 (2006-08-15):
   2.834 +  * Hard drop lock option "Zangi" renamed to "Slide".
   2.835 +  * Added soft drop lock option.
   2.836 +  * Ignores diagonal presses differently: instead of pretending the
   2.837 +    keys are up, it pretends that they haven't changed from the last
   2.838 +    frame.  UP, UP+RIGHT, UP no longer makes a double hard drop.
   2.839 +  * Esc pauses the game and music instead of immediately quitting.
   2.840 +  * Added contributions from cdsboy to lj-contrib.
   2.841 +
   2.842 +_____________________________________________________________________
   2.843 +0.12 (2006-08-13):
   2.844 +  * Creates lj.ini if it doesn't exist, instead of crashing on
   2.845 +    startup.
   2.846 +  * Added half-size Aver16 font.
   2.847 +  * Zero gravity (as in Baboo!) + Zangi hard drop = land and lock,
   2.848 +    instead of just sit there
   2.849 +  * Option to use classic (Game Boy style) or step-reset (TGM style)
   2.850 +    lockdown instead of move-reset (SRS style) lockdown.
   2.851 +  * Contains connection tables for all pieces.  Not used yet,
   2.852 +    but will be used for Cascade (where gravity is based on shapes
   2.853 +    of pieces), Square (which forms big squares only out of whole
   2.854 +    tetrominoes), and Bombliss (which doesn't place a bomb in a block
   2.855 +    that has blocks on opposite sides of it within the piece, such as
   2.856 +    the middle of an I, J, L, or T).
   2.857 +  * Pieces can carry bomb blocks within them.  Not used yet,
   2.858 +    but will be used for Bombliss.
   2.859 +  * Option for sticky gravity.  This will also be used for Bombliss.
   2.860 +  * Options rearranged: game on top, control in middle,
   2.861 +    view on bottom.
   2.862 +  * Options menu uses a smaller font and scrolls if necessary (but
   2.863 +    it's not necessary just yet).
   2.864 +  * Zero isn't wider than other digits in the large or small font.
   2.865 +  * Split debrief screen into debrief.c.
   2.866 +  * Debrief displays lockdown and line clear gravity type.
   2.867 +  * List of options in debrief is written with smaller font.
   2.868 +  * Config screen does a better job of ignoring simultaneous presses
   2.869 +    on USB joystick adapters that map the Control Pad to both axes
   2.870 +    and buttons (such as EMS USB2).
   2.871 +  * Main menu and options always respond to the arrow keys (in
   2.872 +    addition to the keys set in Game Keys), allowing players to
   2.873 +    reset Game Keys even when the keys have become corrupted.
   2.874 +
   2.875 +_____________________________________________________________________
   2.876 +0.11 (2006-08-01):
   2.877 +  * Added Instant, 20 Hz, 15 Hz, and 12 Hz sideways speeds.
   2.878 +  * Added randomizer History 6 Rolls, very similar to Move to Back
   2.879 +    but sometimes repeating recent tetrominoes.
   2.880 +  * Allows separate wall kick tables for clockwise and anticlockwise
   2.881 +    rotation.
   2.882 +  * New "theta=default" in piece->block expansion reflects the
   2.883 +    rotation system's initial orientations for new pieces, next
   2.884 +    pieces, and the hold piece.
   2.885 +  * Option to use Sega rotations instead of SRS rotations.
   2.886 +  * Option for ignoring diagonal presses.
   2.887 +  * Option for locking or not when using hard drop (Up).
   2.888 +  * Option to turn off smooth gravity animation.
   2.889 +  * Option to use TNT style T-spin detection instead of TDS style.
   2.890 +  * Debrief displays rotation system and T-spin detection.
   2.891 +  * Saves options to lj.ini.
   2.892 +  * Split options screen and wall kick table into separate source
   2.893 +    code files.
   2.894 +  * Plays music in stereo.
   2.895 +  * Site distributes contributed graphics and music files to
   2.896 +    replace the defaults.
   2.897 +
   2.898 +_____________________________________________________________________
   2.899 +0.10 (2006-07-27):
   2.900 +  * Set default full screen color depth to 16-bit which may be more
   2.901 +    compatible than 15-bit.
   2.902 +  * Press Print Screen to save the current screen as ljsnap.bmp.
   2.903 +  * Plays next piece sound whenever the next column moves up.
   2.904 +    0.08-0.09 didn't do so for the first hold in a game.
   2.905 +  * No longer tries rotating right when rotating left fails.
   2.906 +  * Handles DirectDraw amnesia (screen corruption in Alt+Tab)
   2.907 +    correctly in menu, game play, and debrief screens.
   2.908 +  * Asset and video buffer cleanup consolidated into one function.
   2.909 +  * Gravity speeds up 50% faster.
   2.910 +  * Added options menu for selecting sideways movement speed and
   2.911 +    randomizer.
   2.912 +  * Added more randomizers: 14-piece bag, move-to-back (TGM style),
   2.913 +    memoryless (classic), and SZSZ (used in the well-known proof
   2.914 +    that memoryless cannot be played indefinitely).
   2.915 +  * Debrief screen displays date and time of report generation as
   2.916 +    well as randomizer and sideways speed, and logs what it displays
   2.917 +    to lj-scores.txt.
   2.918 +  * Moved all gimmick-specific code from lj.c to new file gimmicks.c.
   2.919 +  * Built against Allegro 4.2.0.  (Users of previous versions will
   2.920 +    need the new DLL.)
   2.921 +  * Countdown based gimmicks (40 lines, 180 seconds, Baboo!,
   2.922 +    TGM World, Drill 40) use the same countdown variable for
   2.923 +    end state detection that they had used for countdown sound.
   2.924 +  * Support for tracked music using DUMB.
   2.925 +  * Manual is HTML.
   2.926 +
   2.927 +_____________________________________________________________________
   2.928 +0.09 (2006-07-16):
   2.929 +  * Reverted sideways kicks of I tetromino rotating from horizontal
   2.930 +    to vertical based on testing I-I interactions in Tetris DS.
   2.931 +  * Key pretending is more consistent.
   2.932 +  * TGM World stops at 290 lines, more like Tetris The Grand Master.
   2.933 +  * In gimmicks with ARE (currently TGM World), allows initial
   2.934 +    hard drop.
   2.935 +  * Licensed as free software under GNU General Public License.
   2.936 +  * Fixed incomplete first bag (0.08 regression).
   2.937 +  * Has its own icon instead of the wall kick editor's icon.
   2.938 +  * No double initial rotation when using initial hold in TGM World.
   2.939 +  * Input actions are a 32-bit record for future recording.
   2.940 +  * Hidden next piece is a separate variable, which next piece
   2.941 +    sound also respects, fixing Items.
   2.942 +
   2.943 +_____________________________________________________________________
   2.944 +0.08 (2006-07-08):
   2.945 +  * Plays sounds for the next piece like TGM.
   2.946 +  * No longer allows 800x552 window now that 0.08 displays the
   2.947 +    gimmick name.
   2.948 +  * Supports spawn delay and line delay.
   2.949 +  * Supports initial hold and rotation.
   2.950 +  * Supports variable garbage randomness.
   2.951 +  * Begun to move gimmick code out of core.
   2.952 +  * Added TGM World gimmick:
   2.953 +    Standard S.M.G., except there's a half-second delay before each
   2.954 +    tetromino, and a half-second delay after each tetromino that
   2.955 +    forms at least one line. So if you want fast play, make more
   2.956 +    lines at once.
   2.957 +  * Added Drill 40 gimmick: 
   2.958 +    Like 40 lines, but the screen starts with 18 rows of garbage.
   2.959 +    Be prepared to rely on SRS infinite spin for the first few
   2.960 +    lines until your skill improves.
   2.961 +
   2.962 +_____________________________________________________________________
   2.963 +0.07 (2006-06-30):
   2.964 +  * Added Baboo gimmick:
   2.965 +    Standard S.M.G., except there is no gravity, and the game
   2.966 +    ends after 300 keypresses.
   2.967 +  * Cleaned up the font a bit.
   2.968 +  * Corrected wall kicks for I tetromino to match an updated
   2.969 +    description provided by nicholas.  Specifically, I tetromino
   2.970 +    prefers kick-down to kick-up.
   2.971 +  * Removed sound-not-found debug message.
   2.972 +  * Plays "ready, go!" like TGM.
   2.973 +  * Bigger font for lines and time.
   2.974 +
   2.975 +_____________________________________________________________________
   2.976 +0.06 (2006-06-25):
   2.977 +  * Gimmicks are sorted into columns.
   2.978 +  * Debrief responds to controller mapping.
   2.979 +  * Debrief shows keypresses per tetromino and garbage per minute.
   2.980 +  * Loads/saves vkey configuration from/to disk instead of
   2.981 +    prompting the user every time the program starts.
   2.982 +  * Build system switched to GNU Make.
   2.983 +  * Terminal window ("DOS box") hidden.
   2.984 +  * Responds to window system's close button.
   2.985 +  * Counts down 5-4-3-2-1 in line or time limited gimmicks.
   2.986 +  * Icon in the top left corner of the window is customized.
   2.987 +  * Displays ljbg.jpg in the window's blank space.
   2.988 +  * Displays blocks from ljblocks.bmp.
   2.989 +  * Releases the CPU for 5ms per frame when possible, so that
   2.990 +    background tasks such as a music player can keep up.
   2.991 +  * Increased sound effects' volume so that music players do not
   2.992 +    completely overpower them.
   2.993 +  * Added macros for rotate twice, move far left, and move far right.
   2.994 +  * Corrected fix to alternation between falling and landed states
   2.995 +    that occurred especially when sliding a tetromino to the right
   2.996 +    under high gravity.
   2.997 +  * Added Items gimmick:
   2.998 +    Standard S.M.G., except after the first 7 pieces you get
   2.999 +    random starting orientations, no rotation, and hidden next
  2.1000 +    pieces, and the speed goes to 1G.  Every time you are given an
  2.1001 +    I piece, either you get 2 lines of garbage or the columns of
  2.1002 +    blocks in the well are shuffled.
  2.1003 +  * Fixed scoring tables in README.txt.
  2.1004 +
  2.1005 +_____________________________________________________________________
  2.1006 +0.05 (2006-06-23):
  2.1007 +  * Included readme.txt.
  2.1008 +  * Debrief report shows more decimal places in time and PPM.
  2.1009 +  * Game over plays a simple animation and sound.
  2.1010 +  * Playfield can be resized (with a recompile).
  2.1011 +  * Removed hardcoded key binding help text.
  2.1012 +  * Window is bigger in preparation for wallpaper.
  2.1013 +  * Display mode is 15/16/24/32-bit in preparation for wallpaper.
  2.1014 +  * Added Low Rider gimmick:
  2.1015 +    Standard S.M.G. with an 8-block-tall visible playfield.
  2.1016 +
  2.1017 +_____________________________________________________________________
  2.1018 +0.04 (2006-06-22):
  2.1019 +  * Uses an OS-native bitmap rather than an Allegro bitmap,
  2.1020 +    which may allow faster drawing with some video cards.
  2.1021 +  * Allows play from a keyboard or a joystick.
  2.1022 +  * Presents a key configuration screen when the program starts.
  2.1023 +  * A 500ms delay after the game ends. Drama will come soon to this
  2.1024 +    space.
  2.1025 +
  2.1026 +_____________________________________________________________________
  2.1027 +0.03 (2006-06-21):
  2.1028 +  * Debriefing responds only to Esc, Enter, and keypad Enter.
  2.1029 +  * Compensates for refresh rates other than 60 Hz.
  2.1030 +  * Change log included with program.
  2.1031 +  * Plays sound effects for shift, rotate, land, lock, line, b2b.
  2.1032 +  * Bigger text using the "Aver" font.
  2.1033 +  * Lock delay in Marathon decreases gradually after gravity
  2.1034 +    surpasses 20G.
  2.1035 +  * Reads keys through a bitfield, allowing for custom key->vkey
  2.1036 +    bindings to be implemented in the future.
  2.1037 +  * (Internal) Does not alternate between "falling" and "landed"
  2.1038 +    states when resetting lock delay on slide.
  2.1039 +
  2.1040 +_____________________________________________________________________
  2.1041 +0.02 (2006-06-19):
  2.1042 +  * Speed level progresses 1/3 as fast.
  2.1043 +  * Added menu for selecting a gimmick (game mode) to play.
  2.1044 +  * Added Marathon gimmick:
  2.1045 +    Like Vs. but no garbage.
  2.1046 +  * Added 40 lines gimmick:
  2.1047 +    Like Marathon but ends after 40 lines.
  2.1048 +  * Added 3 minutes gimmick (like Marathon but ends after 10800
  2.1049 +    frames).
  2.1050 +  * Added Rhythm gimmick:
  2.1051 +    20G, and if you fall below the minimum PPM, it automatically
  2.1052 +    locks the tetromino, and the minimum PPM increases by 10 every
  2.1053 +    64 tetrominoes.
  2.1054 +  * Debriefing computes PPM and score.
  2.1055 +  * Debriefing returns to gimmick selection instead of exiting
  2.1056 +    the program.
  2.1057 +
  2.1058 +_____________________________________________________________________
  2.1059 +0.01 (2006-06-14):
  2.1060 +  * initial release
  2.1061 +  * full SRS implemented
  2.1062 +  * 7-piece bag randomizer
  2.1063 +  * 1G DAS
  2.1064 +  * smooth falling animation
  2.1065 +  * playfield size: 10w x 24h; pieces start above row 20
  2.1066 +  * 8 next pieces and 1 hold piece
  2.1067 +  * Vs. gimmick:
  2.1068 +    Standard S.M.G., except before every I tetromino after the first,
  2.1069 +    you get 4 garbage lines.
  2.1070 +

     3.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     3.2 +++ b/COPYING.txt	Fri Mar 13 00:39:12 2009 -0700
     3.3 @@ -0,0 +1,52 @@
     3.4 +Copying conditions for LOCKJAW:
     3.5 +
     3.6 +Copyright 2007 Damian Yerrick <tepples+lj@spamcop.net>
     3.7 +
     3.8 +This program is free software; you can redistribute it and/or
     3.9 +modify it under the terms of the GNU General Public License
    3.10 +as published by the Free Software Foundation; either version 2
    3.11 +of the License, or (at your option) any later version.
    3.12 +
    3.13 +This program is distributed in the hope that it will be useful,
    3.14 +but WITHOUT ANY WARRANTY; without even the implied warranty of
    3.15 +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    3.16 +GNU General Public License for more details.
    3.17 +
    3.18 +You should have received a copy of the GNU General Public License
    3.19 +(GPL.txt) along with this program.  If not, see
    3.20 +<http://www.gnu.org/licenses/>.
    3.21 +
    3.22 +_____________________________________________________________________
    3.23 +Copying conditions for LJVorbis:
    3.24 +
    3.25 +Copyright 2006 Damian Yerrick
    3.26 +Copyright 2002-2004 Xiph.org Foundation
    3.27 +
    3.28 +Redistribution and use in source and binary forms, with or without
    3.29 +modification, are permitted provided that the following conditions
    3.30 +are met:
    3.31 +
    3.32 +- Redistributions of source code must retain the above copyright
    3.33 +notice, this list of conditions and the following disclaimer.
    3.34 +
    3.35 +- Redistributions in binary form must reproduce the above copyright
    3.36 +notice, this list of conditions and the following disclaimer in the
    3.37 +documentation and/or other materials provided with the distribution.
    3.38 +
    3.39 +- Neither the name of the Xiph.org Foundation nor the names of its
    3.40 +contributors may be used to endorse or promote products derived from
    3.41 +this software without specific prior written permission.
    3.42 +
    3.43 +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
    3.44 +``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
    3.45 +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
    3.46 +A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION
    3.47 +OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    3.48 +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
    3.49 +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
    3.50 +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
    3.51 +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
    3.52 +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    3.53 +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    3.54 +
    3.55 +_____________________________________________________________________

     4.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     4.2 +++ b/GPL.txt	Fri Mar 13 00:39:12 2009 -0700
     4.3 @@ -0,0 +1,342 @@
     4.4 +		    GNU GENERAL PUBLIC LICENSE
     4.5 +		       Version 2, June 1991
     4.6 +
     4.7 + Copyright (C) 1989, 1991 Free Software Foundation, Inc.
     4.8 +                       59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
     4.9 + Everyone is permitted to copy and distribute verbatim copies
    4.10 + of this license document, but changing it is not allowed.
    4.11 +
    4.12 +			    Preamble
    4.13 +
    4.14 +  The licenses for most software are designed to take away your
    4.15 +freedom to share and change it.  By contrast, the GNU General Public
    4.16 +License is intended to guarantee your freedom to share and change free
    4.17 +software--to make sure the software is free for all its users.  This
    4.18 +General Public License applies to most of the Free Software
    4.19 +Foundation's software and to any other program whose authors commit to
    4.20 +using it.  (Some other Free Software Foundation software is covered by
    4.21 +the GNU Library General Public License instead.)  You can apply it to
    4.22 +your programs, too.
    4.23 +
    4.24 +  When we speak of free software, we are referring to freedom, not
    4.25 +price.  Our General Public Licenses are designed to make sure that you
    4.26 +have the freedom to distribute copies of free software (and charge for
    4.27 +this service if you wish), that you receive source code or can get it
    4.28 +if you want it, that you can change the software or use pieces of it
    4.29 +in new free programs; and that you know you can do these things.
    4.30 +
    4.31 +  To protect your rights, we need to make restrictions that forbid
    4.32 +anyone to deny you these rights or to ask you to surrender the rights.
    4.33 +These restrictions translate to certain responsibilities for you if you
    4.34 +distribute copies of the software, or if you modify it.
    4.35 +
    4.36 +  For example, if you distribute copies of such a program, whether
    4.37 +gratis or for a fee, you must give the recipients all the rights that
    4.38 +you have.  You must make sure that they, too, receive or can get the
    4.39 +source code.  And you must show them these terms so they know their
    4.40 +rights.
    4.41 +
    4.42 +  We protect your rights with two steps: (1) copyright the software, and
    4.43 +(2) offer you this license which gives you legal permission to copy,
    4.44 +distribute and/or modify the software.
    4.45 +
    4.46 +  Also, for each author's protection and ours, we want to make certain
    4.47 +that everyone understands that there is no warranty for this free
    4.48 +software.  If the software is modified by someone else and passed on, we
    4.49 +want its recipients to know that what they have is not the original, so
    4.50 +that any problems introduced by others will not reflect on the original
    4.51 +authors' reputations.
    4.52 +
    4.53 +  Finally, any free program is threatened constantly by software
    4.54 +patents.  We wish to avoid the danger that redistributors of a free
    4.55 +program will individually obtain patent licenses, in effect making the
    4.56 +program proprietary.  To prevent this, we have made it clear that any
    4.57 +patent must be licensed for everyone's free use or not licensed at all.
    4.58 +
    4.59 +  The precise terms and conditions for copying, distribution and
    4.60 +modification follow.
    4.61 +
    4.62 +		    GNU GENERAL PUBLIC LICENSE
    4.63 +   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
    4.64 +
    4.65 +  0. This License applies to any program or other work which contains
    4.66 +a notice placed by the copyright holder saying it may be distributed
    4.67 +under the terms of this General Public License.  The "Program", below,
    4.68 +refers to any such program or work, and a "work based on the Program"
    4.69 +means either the Program or any derivative work under copyright law:
    4.70 +that is to say, a work containing the Program or a portion of it,
    4.71 +either verbatim or with modifications and/or translated into another
    4.72 +language.  (Hereinafter, translation is included without limitation in
    4.73 +the term "modification".)  Each licensee is addressed as "you".
    4.74 +
    4.75 +Activities other than copying, distribution and modification are not
    4.76 +covered by this License; they are outside its scope.  The act of
    4.77 +running the Program is not restricted, and the output from the Program
    4.78 +is covered only if its contents constitute a work based on the
    4.79 +Program (independent of having been made by running the Program).
    4.80 +Whether that is true depends on what the Program does.
    4.81 +
    4.82 +  1. You may copy and distribute verbatim copies of the Program's
    4.83 +source code as you receive it, in any medium, provided that you
    4.84 +conspicuously and appropriately publish on each copy an appropriate
    4.85 +copyright notice and disclaimer of warranty; keep intact all the
    4.86 +notices that refer to this License and to the absence of any warranty;
    4.87 +and give any other recipients of the Program a copy of this License
    4.88 +along with the Program.
    4.89 +
    4.90 +You may charge a fee for the physical act of transferring a copy, and
    4.91 +you may at your option offer warranty protection in exchange for a fee.
    4.92 +
    4.93 +  2. You may modify your copy or copies of the Program or any portion
    4.94 +of it, thus forming a work based on the Program, and copy and
    4.95 +distribute such modifications or work under the terms of Section 1
    4.96 +above, provided that you also meet all of these conditions:
    4.97 +
    4.98 +    a) You must cause the modified files to carry prominent notices
    4.99 +    stating that you changed the files and the date of any change.
   4.100 +
   4.101 +    b) You must cause any work that you distribute or publish, that in
   4.102 +    whole or in part contains or is derived from the Program or any
   4.103 +    part thereof, to be licensed as a whole at no charge to all third
   4.104 +    parties under the terms of this License.
   4.105 +
   4.106 +    c) If the modified program normally reads commands interactively
   4.107 +    when run, you must cause it, when started running for such
   4.108 +    interactive use in the most ordinary way, to print or display an
   4.109 +    announcement including an appropriate copyright notice and a
   4.110 +    notice that there is no warranty (or else, saying that you provide
   4.111 +    a warranty) and that users may redistribute the program under
   4.112 +    these conditions, and telling the user how to view a copy of this
   4.113 +    License.  (Exception: if the Program itself is interactive but
   4.114 +    does not normally print such an announcement, your work based on
   4.115 +    the Program is not required to print an announcement.)
   4.116 +
   4.117 +These requirements apply to the modified work as a whole.  If
   4.118 +identifiable sections of that work are not derived from the Program,
   4.119 +and can be reasonably considered independent and separate works in
   4.120 +themselves, then this License, and its terms, do not apply to those
   4.121 +sections when you distribute them as separate works.  But when you
   4.122 +distribute the same sections as part of a whole which is a work based
   4.123 +on the Program, the distribution of the whole must be on the terms of
   4.124 +this License, whose permissions for other licensees extend to the
   4.125 +entire whole, and thus to each and every part regardless of who wrote it.
   4.126 +
   4.127 +Thus, it is not the intent of this section to claim rights or contest
   4.128 +your rights to work written entirely by you; rather, the intent is to
   4.129 +exercise the right to control the distribution of derivative or
   4.130 +collective works based on the Program.
   4.131 +
   4.132 +In addition, mere aggregation of another work not based on the Program
   4.133 +with the Program (or with a work based on the Program) on a volume of
   4.134 +a storage or distribution medium does not bring the other work under
   4.135 +the scope of this License.
   4.136 +
   4.137 +  3. You may copy and distribute the Program (or a work based on it,
   4.138 +under Section 2) in object code or executable form under the terms of
   4.139 +Sections 1 and 2 above provided that you also do one of the following:
   4.140 +
   4.141 +    a) Accompany it with the complete corresponding machine-readable
   4.142 +    source code, which must be distributed under the terms of Sections
   4.143 +    1 and 2 above on a medium customarily used for software interchange; or,
   4.144 +
   4.145 +    b) Accompany it with a written offer, valid for at least three
   4.146 +    years, to give any third party, for a charge no more than your
   4.147 +    cost of physically performing source distribution, a complete
   4.148 +    machine-readable copy of the corresponding source code, to be
   4.149 +    distributed under the terms of Sections 1 and 2 above on a medium
   4.150 +    customarily used for software interchange; or,
   4.151 +
   4.152 +    c) Accompany it with the information you received as to the offer
   4.153 +    to distribute corresponding source code.  (This alternative is
   4.154 +    allowed only for noncommercial distribution and only if you
   4.155 +    received the program in object code or executable form with such
   4.156 +    an offer, in accord with Subsection b above.)
   4.157 +
   4.158 +The source code for a work means the preferred form of the work for
   4.159 +making modifications to it.  For an executable work, complete source
   4.160 +code means all the source code for all modules it contains, plus any
   4.161 +associated interface definition files, plus the scripts used to
   4.162 +control compilation and installation of the executable.  However, as a
   4.163 +special exception, the source code distributed need not include
   4.164 +anything that is normally distributed (in either source or binary
   4.165 +form) with the major components (compiler, kernel, and so on) of the
   4.166 +operating system on which the executable runs, unless that component
   4.167 +itself accompanies the executable.
   4.168 +
   4.169 +If distribution of executable or object code is made by offering
   4.170 +access to copy from a designated place, then offering equivalent
   4.171 +access to copy the source code from the same place counts as
   4.172 +distribution of the source code, even though third parties are not
   4.173 +compelled to copy the source along with the object code.
   4.174 +
   4.175 +  4. You may not copy, modify, sublicense, or distribute the Program
   4.176 +except as expressly provided under this License.  Any attempt
   4.177 +otherwise to copy, modify, sublicense or distribute the Program is
   4.178 +void, and will automatically terminate your rights under this License.
   4.179 +However, parties who have received copies, or rights, from you under
   4.180 +this License will not have their licenses terminated so long as such
   4.181 +parties remain in full compliance.
   4.182 +
   4.183 +  5. You are not required to accept this License, since you have not
   4.184 +signed it.  However, nothing else grants you permission to modify or
   4.185 +distribute the Program or its derivative works.  These actions are
   4.186 +prohibited by law if you do not accept this License.  Therefore, by
   4.187 +modifying or distributing the Program (or any work based on the
   4.188 +Program), you indicate your acceptance of this License to do so, and
   4.189 +all its terms and conditions for copying, distributing or modifying
   4.190 +the Program or works based on it.
   4.191 +
   4.192 +  6. Each time you redistribute the Program (or any work based on the
   4.193 +Program), the recipient automatically receives a license from the
   4.194 +original licensor to copy, distribute or modify the Program subject to
   4.195 +these terms and conditions.  You may not impose any further
   4.196 +restrictions on the recipients' exercise of the rights granted herein.
   4.197 +You are not responsible for enforcing compliance by third parties to
   4.198 +this License.
   4.199 +
   4.200 +  7. If, as a consequence of a court judgment or allegation of patent
   4.201 +infringement or for any other reason (not limited to patent issues),
   4.202 +conditions are imposed on you (whether by court order, agreement or
   4.203 +otherwise) that contradict the conditions of this License, they do not
   4.204 +excuse you from the conditions of this License.  If you cannot
   4.205 +distribute so as to satisfy simultaneously your obligations under this
   4.206 +License and any other pertinent obligations, then as a consequence you
   4.207 +may not distribute the Program at all.  For example, if a patent
   4.208 +license would not permit royalty-free redistribution of the Program by
   4.209 +all those who receive copies directly or indirectly through you, then
   4.210 +the only way you could satisfy both it and this License would be to
   4.211 +refrain entirely from distribution of the Program.
   4.212 +
   4.213 +If any portion of this section is held invalid or unenforceable under
   4.214 +any particular circumstance, the balance of the section is intended to
   4.215 +apply and the section as a whole is intended to apply in other
   4.216 +circumstances.
   4.217 +
   4.218 +It is not the purpose of this section to induce you to infringe any
   4.219 +patents or other property right claims or to contest validity of any
   4.220 +such claims; this section has the sole purpose of protecting the
   4.221 +integrity of the free software distribution system, which is
   4.222 +implemented by public license practices.  Many people have made
   4.223 +generous contributions to the wide range of software distributed
   4.224 +through that system in reliance on consistent application of that
   4.225 +system; it is up to the author/donor to decide if he or she is willing
   4.226 +to distribute software through any other system and a licensee cannot
   4.227 +impose that choice.
   4.228 +
   4.229 +This section is intended to make thoroughly clear what is believed to
   4.230 +be a consequence of the rest of this License.
   4.231 +
   4.232 +  8. If the distribution and/or use of the Program is restricted in
   4.233 +certain countries either by patents or by copyrighted interfaces, the
   4.234 +original copyright holder who places the Program under this License
   4.235 +may add an explicit geographical distribution limitation excluding
   4.236 +those countries, so that distribution is permitted only in or among
   4.237 +countries not thus excluded.  In such case, this License incorporates
   4.238 +the limitation as if written in the body of this License.
   4.239 +
   4.240 +  9. The Free Software Foundation may publish revised and/or new versions
   4.241 +of the General Public License from time to time.  Such new versions will
   4.242 +be similar in spirit to the present version, but may differ in detail to
   4.243 +address new problems or concerns.
   4.244 +
   4.245 +Each version is given a distinguishing version number.  If the Program
   4.246 +specifies a version number of this License which applies to it and "any
   4.247 +later version", you have the option of following the terms and conditions
   4.248 +either of that version or of any later version published by the Free
   4.249 +Software Foundation.  If the Program does not specify a version number of
   4.250 +this License, you may choose any version ever published by the Free Software
   4.251 +Foundation.
   4.252 +
   4.253 +  10. If you wish to incorporate parts of the Program into other free
   4.254 +programs whose distribution conditions are different, write to the author
   4.255 +to ask for permission.  For software which is copyrighted by the Free
   4.256 +Software Foundation, write to the Free Software Foundation; we sometimes
   4.257 +make exceptions for this.  Our decision will be guided by the two goals
   4.258 +of preserving the free status of all derivatives of our free software and
   4.259 +of promoting the sharing and reuse of software generally.
   4.260 +
   4.261 +			    NO WARRANTY
   4.262 +
   4.263 +  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
   4.264 +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
   4.265 +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
   4.266 +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
   4.267 +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
   4.268 +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
   4.269 +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
   4.270 +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
   4.271 +REPAIR OR CORRECTION.
   4.272 +
   4.273 +  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
   4.274 +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
   4.275 +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
   4.276 +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
   4.277 +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
   4.278 +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
   4.279 +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
   4.280 +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
   4.281 +POSSIBILITY OF SUCH DAMAGES.
   4.282 +
   4.283 +		     END OF TERMS AND CONDITIONS
   4.284 +
   4.285 +	    How to Apply These Terms to Your New Programs
   4.286 +
   4.287 +  If you develop a new program, and you want it to be of the greatest
   4.288 +possible use to the public, the best way to achieve this is to make it
   4.289 +free software which everyone can redistribute and change under these terms.
   4.290 +
   4.291 +  To do so, attach the following notices to the program.  It is safest
   4.292 +to attach them to the start of each source file to most effectively
   4.293 +convey the exclusion of warranty; and each file should have at least
   4.294 +the "copyright" line and a pointer to where the full notice is found.
   4.295 +
   4.296 +    <one line to give the program's name and a brief idea of what it does.>
   4.297 +    Copyright (C) <year>  <name of author>
   4.298 +
   4.299 +    This program is free software; you can redistribute it and/or modify
   4.300 +    it under the terms of the GNU General Public License as published by
   4.301 +    the Free Software Foundation; either version 2 of the License, or
   4.302 +    (at your option) any later version.
   4.303 +
   4.304 +    This program is distributed in the hope that it will be useful,
   4.305 +    but WITHOUT ANY WARRANTY; without even the implied warranty of
   4.306 +    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   4.307 +    GNU General Public License for more details.
   4.308 +
   4.309 +    You should have received a copy of the GNU General Public License
   4.310 +    along with this program; if not, write to the Free Software
   4.311 +    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   4.312 +
   4.313 +
   4.314 +Also add information on how to contact you by electronic and paper mail.
   4.315 +
   4.316 +If the program is interactive, make it output a short notice like this
   4.317 +when it starts in an interactive mode:
   4.318 +
   4.319 +    Gnomovision version 69, Copyright (C) year name of author
   4.320 +    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
   4.321 +    This is free software, and you are welcome to redistribute it
   4.322 +    under certain conditions; type `show c' for details.
   4.323 +
   4.324 +The hypothetical commands `show w' and `show c' should show the appropriate
   4.325 +parts of the General Public License.  Of course, the commands you use may
   4.326 +be called something other than `show w' and `show c'; they could even be
   4.327 +mouse-clicks or menu items--whatever suits your program.
   4.328 +
   4.329 +You should also get your employer (if you work as a programmer) or your
   4.330 +school, if any, to sign a "copyright disclaimer" for the program, if
   4.331 +necessary.  Here is a sample; alter the names:
   4.332 +
   4.333 +  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
   4.334 +  `Gnomovision' (which makes passes at compilers) written by James Hacker.
   4.335 +
   4.336 +  <signature of Ty Coon>, 1 April 1989
   4.337 +  Ty Coon, President of Vice
   4.338 +
   4.339 +This General Public License does not permit incorporating your program into
   4.340 +proprietary programs.  If your program is a subroutine library, you may
   4.341 +consider it more useful to permit linking proprietary applications with the
   4.342 +library.  If this is what you want to do, use the GNU Library General
   4.343 +Public License instead of this License.
   4.344 +
   4.345 +

     5.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     5.2 +++ b/README.html	Fri Mar 13 00:39:12 2009 -0700
     5.3 @@ -0,0 +1,546 @@
     5.4 +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
     5.5 +<html lang="en">
     5.6 +<head>
     5.7 +<title>LOCKJAW - About</title>
     5.8 +<link rel="stylesheet" type="text/css" href="docs/ljhtml.css">
     5.9 +<link rel="icon" href="docs/appicon.ico" type="image/x-icon">
    5.10 +<link rel="shortcut icon" href="docs/appicon.ico" type="image/x-icon"> 
    5.11 +<meta http-equiv="Content-type" content="text/html;charset=iso-8859-1">
    5.12 +</head><body>
    5.13 +<h1><img src="docs/ljlogo192.png" alt="LOCKJAW Tetromino Game:"> About</h1>
    5.14 +<ul id="linkbar">
    5.15 +<li><a href="http://www.pineight.com/lj/">Home</a></li>
    5.16 +<li>About</li>
    5.17 +<li><a href="http://www.pineight.com/lj/dl">Download</a></li>
    5.18 +</ul>
    5.19 +<div id="content">
    5.20 +<p>
    5.21 +<a href="#installing">Installing</a> | <a href="#skin">Skinning</a> | <a href="#controls">Controls</a> | <a href="#scoring">Scoring</a> | <a href="#scenario">Scenario</a> | <a href="#options">Options</a> | <a href="#discussion">Discussion</a> | <a href="#legal">Legal</a>
    5.22 +</p><p>
    5.23 +LOCKJAW is a <a href="http://www.gnu.org/philosophy/free-sw.html">free software</a> implementation of the so-called Soviet Mind Game, a highly popular computer puzzle game that involves guiding tetrominoes into neat stacks in a well.  This game was designed in the mid-1980s by Russian game designer Alexey Pajitnov and was first implemented in a software product called <a href="http://en.wikipedia.org/wiki/Tetris">TETRIS</a>&reg;.<a href="#trademarks">*</a> Other products implementing the Soviet Mind Game include
    5.24 +<a href="http://quadra.sourceforge.net/">Quadra</a>,
    5.25 +<a href="http://abrick.sourceforge.net/">Abandoned Bricks</a>,
    5.26 +<a href="http://ksirtet.sourceforge.net/">KSirtet</a>,
    5.27 +<a href="http://fbg.sourceforge.net/">F.B.G.</a>,
    5.28 +<a href="http://www.neave.com/games/nblox/">N-Blox</a>, and
    5.29 +<a href="http://www.tetrisconcept.com/forum/viewtopic.php?t=54">Heboris</a>. While originally developed to parody the behavior of a few notorious implementations of the Soviet Mind Game, LOCKJAW is now a platform for research into the properties of the game, into the effects of rule variations, and into the capabilities of the human mind to react.
    5.30 +</p><p>
    5.31 +<a href="http://en.wikipedia.org/wiki/Tetromino">Tetrominoes</a> are geometric shapes made of four connected square blocks. There are seven distinct tetrominoes, shaped roughly like letters of the Latin alphabet:
    5.32 +</p><p>
    5.33 +<img src="docs/ijlo-stz.png" alt="(Illustration of the seven tetrominoes)"><br>
    5.34 +Tetrominoes. Top row: I, J, L, O. Bottom row: S, T, Z.
    5.35 +</p><p style="size: 80%">
    5.36 +Some products spell the term as "tetramino", "tetrimino", or "tetrad".
    5.37 +</p>
    5.38 +<div class="screenshot">
    5.39 +<img src="docs/ljsnap033.png" alt="(Game screenshot)" width="400" height="300" usemap="#ljsnap018_map">
    5.40 +<p>
    5.41 +LOCKJAW gameplay screen. Hover over objects to see their names.
    5.42 +</p>
    5.43 +<map name="ljsnap018_map">
    5.44 +<area shape="rect" coords="12,12,48,36" alt="Hold piece" title="Hold piece" style="border: 1px solid white">
    5.45 +<area shape="rect" coords="48,0,192,36" alt="Status" title="Status">
    5.46 +<area shape="rect" coords="96,48,132,108" alt="Falling piece" title="Falling piece">
    5.47 +<area shape="rect" coords="96,168,132,216" alt="Shadow" title="Shadow">
    5.48 +<area shape="rect" coords="12,36,132,276" alt="Well" title="Well">
    5.49 +<area shape="rect" coords="36,276,108,300" alt="Game mode" title="Game mode">
    5.50 +<area shape="rect" coords="144,36,192,252" alt="Next pieces" title="Next pieces">
    5.51 +<area shape="rect" coords="216,60,360,240" alt="Gus" title="Gus">
    5.52 +</map>
    5.53 +</div>
    5.54 +
    5.55 +<p>
    5.56 +The well is 10 blocks wide by 20 rows high. (There are four out-of-bounds rows above the top of the visible portion for a total of 24 rows.) The player can rotate and shift the tetrominoes as they fall in order to pack them tightly into the well.  If a tetromino lands on the floor or other blocks and remains motionless for half a second, it locks into place, and the next tetromino begins to fall. The next few tetrominoes to fall are displayed in a queue to the right of the playfield.  At any time, the player can swap the falling tetromino with the one in the hold box above the playfield, but a tetromino that has been swapped out cannot be immediately swapped back in. The gray blocks below the falling tetromino are the shadow, which shows where the tetromino will land.
    5.57 +</p><p>
    5.58 +A "line", or a complete row of blocks across the well, will disappear, and everything above it moves down by one row.  But if the well fills so high that a tetromino is placed entirely out of bounds or in a position such that the next tetromino does not have room to enter, the player "tops out" and the game is over.  So the goal is to stay alive by making more lines.
    5.59 +</p>
    5.60 +
    5.61 +<h2><a name="installing">Installing</a></h2>
    5.62 +<p>
    5.63 +The executable included with the official distribution is designed for Microsoft Windows systems. Unzip it into a folder on your hard disk or USB memory card. It ordinarily writes preferences and logs to the current directory, which is most often the folder containing <code>lj.exe</code>. (If you do not want to allow users to write to the program's folder, place an empty file called <code>installed.ini</code> in the same folder as <code>lj.exe</code>. This will make Game Keys and Options write settings to the user's application data folder, commonly <code>C:\Documents and Settings\Gus\Application Data\Pin Eight\Lockjaw</code>.)
    5.64 +</p><p>
    5.65 +The files <code>lj.exe</code>, <code>lj.dat</code>, <code>ljblocks.bmp</code>, and <code>alleg42.dll</code> are required to play.  (If you get an error about <code>alleg42.dll</code>, see the instructions on the LOCKJAW download page.) To start the game, run <code>lj.exe</code> in Windows Explorer.
    5.66 +</p><p>
    5.67 +The program should work on any PC running Microsoft Windows 98 or newer operating system with an 800x600 pixel display at 16-bit or greater color depth and DirectX 7 software installed.
    5.68 +Its source code is portable to any platform that supports the <a href="http://alleg.sourceforge.net/">Allegro library</a>, but it is tested only on Microsoft Windows because the author has access only to machines that run Windows. 
    5.69 +Occasionally, people manage to build and run it on other operating systems such as GNU/Linux or Mac OS X; if you are willing to maintain a port, <a href="http://www.pineight.com/contact/">get in touch with the author</a>.
    5.70 +</p><p>
    5.71 +For the handheld version, you only need the file <code>lj.gba</code> or <code>lj.nds</code>. Due to limitations in the DS homebrew operating system, the DS version always acts installed, writing user files to the folder <code>/data/lockjaw</code> on the memory card.
    5.72 +</p><p>
    5.73 +
    5.74 +<h3>Installing from source</h3>
    5.75 +<p>
    5.76 +To recompile the program, such as if you are testing a patch or porting it to another system:
    5.77 +</p><ol>
    5.78 +<li>Install GNU Coreutils and GNU Make. These are packaged as MSYS from <a href="http://www.mingw.org/MinGWiki/index.php/GettingStarted">MinGW.org</a></li>
    5.79 +<li>Install a GCC toolchain. This is packaged as MinGW from <a href="http://www.mingw.org/MinGWiki/index.php/GettingStarted">MinGW.org</a></li>
    5.80 +<li>Install Allegro 4.2.1 from <a href="http://alleg.sourceforge.net/">SourceForge.net</a></li>
    5.81 +<li>Install JPGalleg 2.5 from <a href="http://www.ecplusplus.com/index.php?page=projects&amp;pid=1">Enhanced Creations++</a></li>
    5.82 +<li>Install DUMB 0.9.3 from <a href="http://dumb.sourceforge.net/">SourceForge.net</a><br >
    5.83 +(Editor's note: DUMB has a dumb license, but section 6 allows relicensing under GNU GPL. Update: It appears <a href="http://packages.debian.org/changelogs/pool/main/libd/libdumb/libdumb_0.9.3-5/libaldmb1.copyright">Debian got the author to relicense it under a straight zlib style license</a>.)</li>
    5.84 +<li>Open a command prompt and <kbd>cd</kbd> to the folder containing the file <code>makefile</code></li>
    5.85 +<li>Type <code>make</code></li>
    5.86 +</ol><p>
    5.87 +Lardarse has written a detailed guide of how to recompile the program on Microsoft Windows OS. This guide is included with the source code inside the "docs" folder.
    5.88 +</p><p>
    5.89 +To recompile the program for Game Boy Advance or Nintendo DS:
    5.90 +</p><ol>
    5.91 +<li>Install devkitARM, libgba, libnds, and MSYS using devkitPro Updater at <a href="http://www.devkitpro.org/">devkitPro.org</a>.</li>
    5.92 +<li>Install a GCC toolchain, such as MinGW from <a href="http://www.mingw.org/MinGWiki/index.php/GettingStarted">MinGW.org</a></li>
    5.93 +<li>Open a command prompt and <kbd>cd</kbd> to the folder containing the file <code>gbamakefile</code> or <code>dsmakefile</code></li>
    5.94 +<li>Type <code>make -f gbamakefile</code> or <code>make -f dsmakefile</code></li>
    5.95 +</ol><p>
    5.96 +To recompile all three ports, type <code>make all</code>
    5.97 +</p><p>
    5.98 +TIP: On GNU/Linux, Windows, and several other platforms, GNU Make can compile multiple files in parallel. This can speed up a large rebuild by allowing GCC to compile one file while reading another from disk. Add <code>-j2</code> to the end of a Make command line to compile two files at once, or if you have a dual-core CPU, add <code>-j3</code> to have GCC run one core, the other core, and the disk at the same time.
    5.99 +</p>
   5.100 +
   5.101 +<h2><a name="skin">Skinning</a></h2>
   5.102 +<p>
   5.103 +You can customize the appearance of LOCKJAW Tetromino Game for PC by using Notepad or any other text editor to create a skin description that lists the images that shall be used. This skin description should be placed in a text file whose name ends in <code>.skin</code>. (You can create and edit <code>.ini</code> and <code>.skin</code> files using Notepad, Notepad++, vi, Emacs, or any other plain text editor.) LOCKJAW recognizes the following commands in a skin description:
   5.104 +</p><dl>
   5.105 +<dt><code>ljblocksSRS=<i>image</i></code></dt>
   5.106 +<dd>A grid of block images, used in bounding-box rotation systems (SRS and TOD M4). The image's size size should be 8 columns by 4 rows (usually 192x96 pixels) or 8 columns by 6 rows (usually 192x144 pixels). Rows 1 and 2 are for blocks in the well, and rows 3 and 4 are for the falling piece. If rows 5 and 6 are present, the shadow will use those; otherwise, it will use rows 3 and 4. If <tt>blkW</tt> or <tt>blkH</tt> is present, the program uses that size instead of 24x24.</dd>
   5.107 +<dt><code>ljblocksSega=<i>image</i></code></dt>
   5.108 +<dd>Same as <code>ljblocksSRS</code>, but used in other rotation systems.</dd>
   5.109 +<dt><code>ljconnSRS=<i>image</i></code></dt>
   5.110 +<dd>An image 8 rows and 8 columns in size (usually 192x192 pixels), containing an O tetromino of each color. The skin loader cuts this up to form tetrominoes with the blocks drawn connected, used for blocks in the well and the falling piece (not the shadow or empty areas of the well) in bounding-box rotation systems. If this file is not present, <code>ljblocksSRS</code> will be used instead.</dd>
   5.111 +<dt><code>ljconnSega=<i>image</i></code>
   5.112 +<dd>Same as <code>ljconnSRS</code>, but used in other rotation systems. If this file is not present, <code>ljblocksSega</code> will be used instead.</dd>
   5.113 +<dt><code>color=<i>#RRGGBB</i></code></dt>
   5.114 +<dd>A 3- or 6-digit hexadecimal color (e.g. <code>#ABC</code> or <code>#D0FFE3</code>) for text in the menus and during the game. If not present, the game will use black.</dd>
   5.115 +<dt><code>bgcolor=<i>#RRGGBB</i></code></dt>
   5.116 +<dd>A color for the menus' background. If not present, the game will use white.</dd>
   5.117 +<dt><code>hilitecolor=<i>#RRGGBB</i></code></dt>
   5.118 +<dd>A color for the background of highlighted text. If not present, the game will use pale yellow (#FFC).</dd>
   5.119 +<dt><code>pfcolor=<i>#RRGGBB</i></code></dt>
   5.120 +<dd>A color for text in front of the playfield. If not present, the game will use white.</dd>
   5.121 +<dt><code>pfbgcolor=<i>#RRGGBB</i></code></dt>
   5.122 +<dd>An "average" color for the playfield, to be displayed behind the pause screen and during the game over animation. If not present, the game will use black.</dd>
   5.123 +<dt><code>ljbg=<i>#RRGGBB</i></code></dt>
   5.124 +<dd>An 800x600 pixel image to be displayed behind the game. If this file is not 800x600 pixels, the image will be resized (sloppily) after being loaded. If this file is not present, the game will use a plain backdrop of the same color as <code>bgcolor</code>.</dd>
   5.125 +<dt><code>blkW=<i>length</i></code></dt>
   5.126 +<dd>The width in pixels of each block in the <tt>ljblocks</tt> and <tt>ljconn</tt>, if it is not 24 pixels.</dd>
   5.127 +<dt><code>blkH=<i>length</i></code></dt>
   5.128 +<dd>The height in pixels of each block in the <tt>ljblocks</tt> and <tt>ljconn</tt>, if it is not 24 pixels. This is allowed to differ from <code>blkW</code></dd>
   5.129 +<dt><code>transparentPF=<i>boolean</i></code></dt>
   5.130 +<dd>If this is set to the value 0, tile 0 of <code>ljblocksSRS</code> covers up the background within the playfield. If this is set to nonzero, the playfield background shows through.</dd>
   5.131 +<dt><code>bgm=<i>music file</i></code></dt>
   5.132 +<dd>A music file in Vorbis format (<code>.ogg</code>) or tracker format (<code>.mod</code>, <code>.s3m</code>, <code>.xm</code>, or <code>.it</code>) to be played during the game. You can create Vorbis format files by extracting audio from your CDs to <code>.wav</code> format using <a href="http://sourceforge.net/projects/cdexos/">CDex software</a> and converting them with <a href="http://www.rarewares.org/ogg.html">OggDropXPd software</a>. You can download tracker format files from <a href="http://www.modarchive.com/">The Mod Archive</a> or create them yourself using the <a href="http://lpchip.com/modplug/viewtopic.php?t=18">OpenMPT music editor</a>, the continuation of MODPlug Tracker. If this file is not present, the game will not play music.</dd>
   5.133 +<dt><code>bgmLoopPoint=<i>sampleNumber</i></code></dt>
   5.134 +<dd>For music in Vorbis format, sets the sample at which playback restarts once the music file ends. For example, if your .ogg file is 44100 Hz, 441000 represents rewinding to 10 seconds after the start. Has no effect with tracker format music, which specifies its own loop point, or Rhythm speed curve, whose music isn't supposed to loop anyway.</dd>
   5.135 +<dt><code>bgmRhythm=<i>music file</i></code></dt>
   5.136 +<dd>Like <code>bgm</code>, but used in the Rhythm speed curve. Music tempo should have 64 beats of 60 BPM, 64 beats of 70 BPM, 64 beats of 80 BPM, etc.</dd>
   5.137 +<dt><code>bgmReadyGo=<i>Boolean</i></code></dt>
   5.138 +<dd>If this is set to the value 0, the background music starts after the "Ready Go" sequence.  within the playfield. this is set to nonzero, the background music plays during the "Ready Go" sequence.</dd>
   5.139 +<dt><code>bgmVolume=<i>volume</i></code></dt>
   5.140 +<dd>Sets the volume of the music to balance it against the sound effects, where 256 is full volume. If not specified, uses 128; 1 <abbr title="decibel">dB</abbr> louder than this would be 144.</dd>
   5.141 +<dt><code>shiftScale=<i>Boolean</i></code></dt>
   5.142 +<dd>When set to 1, moving the falling piece sideways produces sound at a different pitch based on how far the piece is from the left side. (PC version only)</dd>
   5.143 +<dt>baseX=<i>distance</i></dt>
   5.144 +<dd>This moves all gameplay graphics to the left (0), middle (200), or right (400) of the screen.</dd>
   5.145 +<dt>nextPos=<i>style number</i></dt>
   5.146 +<dd>Controls where the next tetrominoes are displayed. Up to eight can fit to the right of the well, or up to 3 can fit above the well. A value of 0 places the pieces on the right; 2 places them on the top.</dd>
   5.147 +<dt><code>wndW=<i>length</i></code></dt>
   5.148 +<dd>Sets the width of the game window in pixels.</dd>
   5.149 +<dt><code>wndH=<i>length</i></code></dt>
   5.150 +<dd>Sets the height of the game window in pixels.</dd>
   5.151 +</dl><p>
   5.152 +You can create more than one skin description file and then switch among them by using the "Skin..." command at the main menu, which produces the following command in <code>lj.ini</code>:
   5.153 +</p><dl>
   5.154 +<dt><code>Skin=<i>skin description file</i></code></dt>
   5.155 +<dd>A skin description file. If the skin is not present, the game uses preset file names (<code>ljblocks.bmp</code>, <code>ljblocks-sega.bmp</code>, <code>ljconn.bmp</code>, <code>ljconn-sega.bmp</code>, <code>ljbg.jpg</code>, and <code>bgm.s3m</code>).</dd>
   5.156 +</dl><p>
   5.157 +Images can be in Windows bitmap (<code>.bmp</code>), PC-Paintbrush (<code>.pcx</code>), Truevision TGA (<code>.tga</code>), or JFIF/JPEG (<code>.jpg</code>) format. All color depths should be supported. Paths are interpreted relative to the folder containing the <code>.skin</code> file, that is, specifying <code>ljblocksSega=Gradient Blocks.bmp</code> will try to pull <code>Gradient Blocks.bmp</code> from the skin's folder. If you want to create a folder structure inside your skin package, it is best to use forward slashes (<code>'/'</code>) instead of backslashes (<code>'\'</code>) so that users of Mac OS X and GNU/Linux will be able to use your skin.
   5.158 +</p><p>
   5.159 +Example image and sound files are located in <code>lj-contrib.zip</code>, available from the <a href="http://www.pineight.com/lj/dl#contrib">Skins section of the download page</a>. You can also customize the sound effects by using <a href="http://www.allegro.cc/depot/Grabber/">Allegro Grabber software</a> to edit <code>lj.dat</code>.
   5.160 +</p>
   5.161 +
   5.162 +<h2><a name="controls">Controls</a></h2>
   5.163 +<h3>PC</h3>
   5.164 +<p>
   5.165 +The controls in LOCKJAW Tetromino Game for PC are initially set as follows:
   5.166 +</p>
   5.167 +<dl>
   5.168 +<dt>&larr; Shift left</dt><dd>Left arrow key</dd>
   5.169 +<dt>&rarr; Shift right</dt><dd>Right arrow key</dd>
   5.170 +<dt>&darr; Soft drop</dt><dd>Down arrow key</dd>
   5.171 +<dt><u>&darr;</u> Hard drop</dt><dd>Up arrow key</dd>
   5.172 +<dt>&#8624; Rotate left</dt><dd>Z, C</dd>
   5.173 +<dt>&#8625; Rotate right</dt><dd>X</dd>
   5.174 +<dt>&#8630; Rotate twice</dt><dd>W</dd>
   5.175 +<dt>&#8598; Hold piece</dt><dd>S, D</dd>
   5.176 +<dt>&#8676; Shift far left</dt><dd>Q</dd>
   5.177 +<dt>&#8677; Shift far right</dt><dd>E</dd>
   5.178 +<dt><u>&darr;</u> Firm drop</dt><dd>Enter</dd>
   5.179 +</dl><p>
   5.180 +Controls are configurable to the keyboard or any compatible joystick. (The key labeled "Item" is not used in single-player, and there is no multiplayer yet.)  From the main menu, choose "Game Keys..." and then press the keys in order as prompted. If you don't want to bind a key or button to a given function, press a key that you won't use. The key bindings are saved to the file <code>lj-keys.043</code>; if they become unusable, you can delete this file to reset them to the initial settings.
   5.181 +</p><p>
   5.182 +Some controls during game play are hard-coded to keyboard keys:
   5.183 +</p><ul>
   5.184 +<li>Esc pauses and resumes the game. Holding Esc for one second stops the game and goes to a result screen.</li>
   5.185 +<li>[ (left bracket) starts and stops demo recording, and ] (right bracket) starts and stops demo playback. An icon for stop, record, or play appears in the upper left corner of the window. The demo is saved to a file called <code>demo.ljm</code>. <strong>Caution:</strong> Demos recorded on one version of LOCKJAW may not play correctly on another version. Recording another demo will overwrite the last demo, so make sure to rename the demo when you record a good one.</li>
   5.186 +</ul><p>
   5.187 +In the menus, Esc acts as Rotate Left, and Enter acts as Rotate Right. In all screens, Print Screen (F13) saves a copy of the display to the file <code>ljsnap.bmp</code>.
   5.188 +</p>
   5.189 +
   5.190 +<h3>GBA and DS</h3>
   5.191 +<p>
   5.192 +Controls in the Game Boy Advance and Nintendo DS versions are hardcoded as follows:
   5.193 +</p><dl>
   5.194 +<dt>&larr; Shift left</dt><dd>Left on Control Pad</dd>
   5.195 +<dt>&rarr; Shift right</dt><dd>Right on Control Pad</dd>
   5.196 +<dt>&darr; Soft drop</dt><dd>Down on Control Pad</dd>
   5.197 +<dt><u>&darr;</u> Hard drop</dt><dd>Up on Control Pad</dd>
   5.198 +<dt>&#8624; Rotate left</dt><dd>B Button</dd>
   5.199 +<dt>&#8625; Rotate right</dt><dd>A Button</dd>
   5.200 +<dt>&#8598; Hold piece</dt><dd>L Button</dd>
   5.201 +</dl><p>
   5.202 +In the options menu, the B and A Buttons change screens, and the Start Button starts the game. Pressing A on the last screen of options also starts the game. Start pauses and resumes the game.
   5.203 +</p>
   5.204 +
   5.205 +<h3>Movement features</h3>
   5.206 +<p>
   5.207 +Unlike some other <abbr title="Soviet Mind Game">S.M.G.</abbr> implementations, LOCKJAW features Initial Actions. Holding a rotate button while a tetromino enters the playfield will cause the action to be performed the moment the tetromino enters. This is important for fast play. In addition, the hold key works at any time; if a piece is not falling yet, it will swap the hold piece with the next piece.
   5.208 +</p><p>
   5.209 +LOCKJAW also implements the so-called <a href="http://www.tetrisconcept.com/wiki/index.php?title=SRS">Super Rotation System (SRS)</a>, which allows a tetromino to rotate around obstacles for more mobility across the pile. Some players abuse SRS by <a href="http://infinitespin.ytmnd.com/">rotating a piece in place repeatedly</a>, but this will result in poorer scores in timed gimmicks. To replace this behavior with the "Sega style" behavior used in Arika's <i>Tetris The Grand Master 3: Terror-Instinct</i>, change the <a href="#options">Options described below</a>.
   5.210 +</p>
   5.211 +
   5.212 +<h2><a name="scoring">Scoring</a></h2>
   5.213 +<p>
   5.214 +LOCKJAW Tetromino Game allows the player to choose among several methods of calculating the score for a line clear.
   5.215 +The terms "single", "double", "triple", and "home run" refer to clearing 1, 2, 3, or 4 lines with one tetromino.
   5.216 +(A "home run" is called a "tetris" in some other games.)
   5.217 +"T-spin" means rotating a T piece as it lands to fit into a tight space.
   5.218 +</p><p>
   5.219 +In LJ and TDS, making a bonus line clear when your last line clear was also bonus ("back-to-back homer" or "back-to-back T-spin") will produce extra points. Making a T-spin that does not clear a line has no effect on bonus state.
   5.220 +</p>
   5.221 +
   5.222 +<h3>LJ</h3>
   5.223 +<p>
   5.224 +As you clear lines, you also produce garbage that depends on the number of lines that you clear with a single tetromino.  In single player mode, you earn 100 points per line cleared and 200 points per line of garbage, and in multiplayer mode (which is not yet implemented), the garbage will push up the blocks in another player's well.
   5.225 +</p>
   5.226 +<table summary="first row: column headings">
   5.227 +<caption>LJ scoring method</caption>
   5.228 +<thead>
   5.229 +<tr><th> </th><th>Lines</th><th>Garbage</th><th>Score</th><th>Bonus</th></tr>
   5.230 +</thead><tbody>
   5.231 +<tr><td>1 line </td><td>1</td><td>0</td><td>100</td><td>No</td></tr>
   5.232 +<tr><td>2 lines</td><td>2</td><td>1</td><td>400</td><td>No</td></tr>
   5.233 +<tr><td>3 lines</td><td>3</td><td>2</td><td>700</td><td>No</td></tr>
   5.234 +<tr><td>4 lines</td><td>4</td><td>4</td><td>1200</td><td>Yes</td></tr>
   5.235 +<tr><td>1 line T-spin </td><td>1</td><td>2</td><td>500</td><td>Yes</td></tr>
   5.236 +<tr><td>2 lines T-spin</td><td>2</td><td>4</td><td>1000</td><td>Yes</td></tr>
   5.237 +<tr><td>3 lines T-spin</td><td>3</td><td>6</td><td>1500</td><td>Yes</td></tr>
   5.238 +<tr><td>Back-to-back bonus</td><td> </td><td>1</td><td>200</td><td>Yes</td></tr>
   5.239 +</tbody>
   5.240 +</table><p>
   5.241 +LJ has a variant called "<a href="http://en.wikipedia.org/wiki/Nerf_%28computer_gaming%29" title="nerf, v. To weaken or remove (an element of play) as a method of rebalancing a game.">nerfed</a> spin" where T-spins produce half the garbage and only 300 points per line.
   5.242 +</p>
   5.243 +
   5.244 +<h3>Fibonacci</h3>
   5.245 +<p>
   5.246 +This extension of the scoring curve seen in <i>The New Tetris</i> is based on the <a href="http://en.wikipedia.org/wiki/Fibonacci_number" title="a sequence of integers where each element is the sum of the two preceding elements">Fibonacci sequence</a>.
   5.247 +</p>
   5.248 +<table summary="first row: column headings">
   5.249 +<caption>TNT scoring method</caption>
   5.250 +<thead>
   5.251 +<tr><th>Lines</th><th>Score</th></tr>
   5.252 +</thead><tbody>
   5.253 +<tr><td>1</td><td>100</td></tr>
   5.254 +<tr><td>2</td><td>200</td></tr>
   5.255 +<tr><td>3</td><td>300</td></tr>
   5.256 +<tr><td>4</td><td>500</td></tr>
   5.257 +<tr><td>5</td><td>800</td></tr>
   5.258 +<tr><td>6</td><td>1300</td></tr>
   5.259 +<tr><td>7</td><td>2100</td></tr>
   5.260 +<tr><td>8</td><td>3400</td></tr>
   5.261 +<tr><td>9</td><td>5500</td></tr>
   5.262 +<tr><td>10</td><td>8900</td></tr>
   5.263 +<tr><td>11</td><td>14400</td></tr>
   5.264 +<tr><td>12</td><td>23300</td></tr>
   5.265 +<tr><td>13</td><td>37700</td></tr>
   5.266 +</tbody>
   5.267 +</table><p>
   5.268 +Further lines score 20,000 points per line.
   5.269 +</p>
   5.270 +
   5.271 +<h3>Hotline</h3>
   5.272 +<p>
   5.273 +Only lines cleared on specific rows are worth points. There is no back-to-back bonus nor T-spin bonus.
   5.274 +</p>
   5.275 +<table summary="first row: column headings">
   5.276 +<caption>Hotline scoring method</caption>
   5.277 +<thead>
   5.278 +<tr><th>Row</th><th>Score</th></tr>
   5.279 +</thead><tbody>
   5.280 +<tr><td>5</td><td>100</td></tr>
   5.281 +<tr><td>10</td><td>200</td></tr>
   5.282 +<tr><td>14</td><td>300</td></tr>
   5.283 +<tr><td>17</td><td>400</td></tr>
   5.284 +<tr><td>19</td><td>500</td></tr>
   5.285 +<tr><td>20</td><td>600</td></tr>
   5.286 +</tbody>
   5.287 +</table>
   5.288 +
   5.289 +<h3>TDS</h3>
   5.290 +<p>
   5.291 +Each line clear score is multiplied by a section number, computed by dividing the total number of lines cleared before this line by 10 and adding 1. Thus, lines cleared later in the game when gravity is faster are worth more than lines cleared earlier. In TDS, the section number stops increasing after 190 lines.
   5.292 +</p>
   5.293 +<table summary="first row: column headings">
   5.294 +<caption>TDS scoring method</caption>
   5.295 +<thead>
   5.296 +<tr><th> </th><th>Lines</th><th>Score</th><th>Bonus</th></tr>
   5.297 +</thead><tbody>
   5.298 +<tr><td>1 line </td><td>1</td><td>100 * section</td><td>No</td></tr>
   5.299 +<tr><td>2 lines</td><td>2</td><td>300 * section</td><td>No</td></tr>
   5.300 +<tr><td>3 lines</td><td>3</td><td>500 * section</td><td>No</td></tr>
   5.301 +<tr><td>4 lines</td><td>4</td><td>800 * section</td><td>Yes</td></tr>
   5.302 +<tr><td>0 lines T-spin (wall kick)   </td><td>0</td><td>100 * section</td><td> </td></tr>
   5.303 +<tr><td>0 lines T-spin (no wall kick)</td><td>0</td><td>400 * section</td><td> </td></tr>
   5.304 +<tr><td>1 line T-spin (wall kick)    </td><td>1</td><td>200 * section</td><td>Yes</td></tr>
   5.305 +<tr><td>1 line T-spin (no wall kick) </td><td>1</td><td>800 * section</td><td>Yes</td></tr>
   5.306 +<tr><td>2 lines T-spin               </td><td>2</td><td>1200 * section</td><td>Yes</td></tr>
   5.307 +<tr><td>3 lines T-spin               </td><td>3</td><td>1600 * section</td><td>Yes</td></tr>
   5.308 +<tr><td>Back-to-back bonus</td><td> </td><td>50% more</td><td>Yes</td></tr>
   5.309 +</tbody></table>
   5.310 +
   5.311 +<h3>NES</h3>
   5.312 +<p>
   5.313 +Each line clear is multiplied by the section number, as in TDS. The section number does not stop increasing. There is no back-to-back bonus nor T-spin bonus.
   5.314 +</p>
   5.315 +<table summary="first row: column headings">
   5.316 +<caption>NES scoring method</caption>
   5.317 +<thead>
   5.318 +<tr><th>Lines</th><th>Score</th></tr>
   5.319 +</thead><tbody>
   5.320 +<tr><td>1</td><td>40 * section</td></tr>
   5.321 +<tr><td>2</td><td>100 * section</td></tr>
   5.322 +<tr><td>3</td><td>300 * section</td></tr>
   5.323 +<tr><td>4</td><td>1200 * section</td></tr>
   5.324 +</tbody></table>
   5.325 +
   5.326 +<h3>Drop scoring</h3>
   5.327 +<p>
   5.328 +Some games award extra points every time the tetromino lands if the player used soft drop or hard drop. LOCKJAW can simulate these.
   5.329 +</p><dl>
   5.330 +<dt>None</dt><dd>Award no points.</dd>
   5.331 +<dt>Continuous</dt><dd>Award 1 point per row for hard drops. Award 1 point per row between when a soft drop starts when the piece lands. A soft drop that is started, then stopped, then started again, will award points only for the last soft drop.</dd>
   5.332 +<dt>Drop</dt><dd>Award 1 point per row for hard drops and for soft drops, whether or not they are interrupted.</dd>
   5.333 +<dt>Soft x1 Hard x2</dt><dd>Award 1 point per row for soft drops and 2 points per row for hard drops.</dd>
   5.334 +</dl>
   5.335 +
   5.336 +<h3>lj-scores.txt</h3>
   5.337 +<p>
   5.338 +On the PC and DS version, each game's results are written to standard output and <code>lj-scores.txt</code> once it ends. This way, the user can copy the results to an online forum, or the user can <code>lj | something else</code> or <code>tail -f lj-scores.txt | something else</code> in order to have an external program analyze each game as it finishes.
   5.339 +</p>
   5.340 +
   5.341 +<h2><a name="scenario">Scenarios</a></h2>
   5.342 +<p>
   5.343 +In the PC version, scenarios are predefined sets of rules for the game. Most scenarios leave several rules unspecified so that you can further customize them in Options. On the Play menu, you can choose from over ten preset scenarios, or you can design your own rules in Options and then activate them with Custom Game.
   5.344 +</p><p>
   5.345 +Future versions of LOCKJAW Tetromino Game will allow the user to edit scenarios and to use scenarios on handhelds.
   5.346 +</p>
   5.347 +
   5.348 +<h2><a name="options">Options</a></h2>
   5.349 +<p>
   5.350 +In Tetris, rules change you. But in LOCKJAW, <strong>you</strong> change the rules:
   5.351 +</p>
   5.352 +
   5.353 +<h3>Definitions</h3>
   5.354 +<dl>
   5.355 +<dt>Frame</dt>
   5.356 +<dd>All video games are turn-based. Real-time games make each turn take a fraction of a second, where each turn lasts only one frame of animation. LOCKJAW always uses 60 frames per second, regardless of the refresh rate of the attached monitor.</dd>
   5.357 +<dt>G</dt>
   5.358 +<dd>1G is a velocity of 1 cell per frame, or 60 cells per second. "20G" means that tetrominoes fall through the entire height of the well in one frame.</dd>
   5.359 +<dt>Hertz (Hz)</dt>
   5.360 +<dd>1 Hz is a rate of 1 event per second.</dd>
   5.361 +</dl>
   5.362 +
   5.363 +<h3><a name="gimmicks">Gimmicks</a></h3>
   5.364 +<dl>
   5.365 +<dt>Marathon</dt>
   5.366 +<dd>The game gets faster and faster as each tetromino enters the well. Play until you top out. Some people play for lines; others play for points.</dd>
   5.367 +<dt>40 lines</dt>
   5.368 +<dd>Play until you clear 40 lines, or until you top out, whatever comes first. The author's record is 1:00.70.</dd>
   5.369 +<dt>180 seconds</dt>
   5.370 +<dd>Play for three minutes, or until you top out, whatever comes first.</dd>
   5.371 +<dt>Vs. w/Items</dt>
   5.372 +<dd>This mode is a joke. After the first 7 pieces you get random starting orientations, no rotation, and hidden next pieces, and the speed goes to 1G. Every time you're about to get an I tetromino, either you get 2 lines of garbage or the columns of blocks in the well are shuffled. It is debatable whether this mode is even playable. This mode exists primarily as a criticism of a similar mode in the game <i>Tetris DS</i>.</dd>
   5.373 +<dt>Baboo!</dt>
   5.374 +<dd>Standard S.M.G. with zero gravity, ending after 300 keypresses. Some players recommend practicing Baboo!, claiming that the way to fast play in other gimmicks involves using as few keystrokes as possible to place each tetromino.</dd>
   5.375 +</dl>
   5.376 +
   5.377 +<h3>Well rules</h3>
   5.378 +<dl>
   5.379 +<dt>Well width</dt>
   5.380 +<dd>Standard S.M.G. uses 10 columns; it can be set anywhere between 4 and 12.</dd>
   5.381 +<dt>Well height</dt>
   5.382 +<dd>Standard S.M.G. uses 20 rows; it can be decreased to 8.</dd>
   5.383 +<dt>Enter above ceiling</dt>
   5.384 +<dd>Normally, tetrominoes enter the well above the ceiling. But when this is turned off, tetrominoes enter inside the well.</dd>
   5.385 +<dt>Speed curve</dt>
   5.386 +<dd>This controls how fast tetrominoes fall:
   5.387 +<ul>
   5.388 +<li>Exponential is the familiar behavior where the game speeds up gradually as pieces enter the well. For the first 600 pieces, it speeds up every 30 pieces, doubling every 60. Then, the gravity hits 20G, and lock delay begins to decrease in harmonic progression: 2/(3 + 9/256 * (<i>n</i> - 609)) seconds.</li>
   5.389 +<li>In Zero, tetrominoes do not fall on their own. It's pointless for setting endurance records but useful for practicing tricky stacking methods.</li>
   5.390 +<li>Rhythm starts at 0G or 20G; if your play speed drops below the stated level, tetrominoes will lock on their own. This level starts at 60 tetrominoes per minute and increases by 10 every 64 beats.</li>
   5.391 +<li>Master and Death are similar to Exponential and Rhythm but resemble some Japanese S.M.G. implementations: every line cleared advances the level by 1, and except at levels 99, 199, 299, etc., so does every tetromino dropped. (Death is a bit faster than starting Master at level 600, where blocks fall at 20G. Death 300+ is what it sounds like: starting Death at level 300.)</li>
   5.392 +<li>NES and Game Boy speed curves approximate the behavior of the classic 8-bit games published by Nintendo. Game Boy Heart is like Game Boy but starting 100 lines in.</li>
   5.393 +</ul></dd>
   5.394 +<dt>Max entry delay</dt>
   5.395 +<dd>When set greater than 0, there is a brief delay before each tetromino enters the playfield, and another delay when one or more lines are cleared.
   5.396 +(So if you want fast play, make more lines at once.)
   5.397 +During entry delay, sometimes called "ARE", the player can hold the next piece, rotate the next piece (if turned on), and charge up the autorepeat of sideways movement.
   5.398 +This delay is considered a "maximum", as it decreases over the course of the game in Master and Death speed curves.
   5.399 +Caution: When entry delay is on, hard drop also functions as an Initial Action.</dd>
   5.400 +<dt>Piece set</dt>
   5.401 +<dd>This selects which pieces are used:
   5.402 +<ul>
   5.403 +<li>"All pieces" deals all tetrominoes, plus trominoes of 3 blocks (I3, L3) and the domino of 2 blocks (I2). In history randomizer, it starts with I, J, L, T, or L3.</li>
   5.404 +<li>"Tetrominoes" includes the seven pieces with four blocks (I, J, L, O, S, T, and Z). In history randomizer, it starts with I, J, L, or T.</li>
   5.405 +<li>"No sticks" is one stick short of a bundle because it generates all tetrominoes other than I, which is sometimes called a "stick" or "bar". It's useful for practicing "push" and T-spins. In history randomizer, it starts with J, L, or T.</li>
   5.406 +<li>"SZSZ" deals only S and Z tetrominoes. History randomizers will deal an alternating sequence (S, Z, S, Z). It was used in a <a href="http://www2.math.uic.edu/~burgiel/Tetris/explanation.html">proof that S.M.G. with the Memoryless randomizer cannot be played forever</a>.</li>
   5.407 +<li>"iCheat&trade;" generates <em>only</em> I tetrominoes, simulating cheat modes on some other games.</li>
   5.408 +<li>"T-Party" generates only T tetrominoes.</li>
   5.409 +</ul></dd>
   5.410 +<dt>Randomizer</dt>
   5.411 +<dd>This selects the function used to shuffle the pieces:
   5.412 +<ul>
   5.413 +<li>"Memoryless" has a more or less equal probability of choosing each piece at any given time, as seen in most <abbr title="Soviet Mind Game">S.M.G.</abbr> implementations (including Tetris brand games from before 2001).</li>
   5.414 +<li>"Bag" treats the pieces as sets and deals a randomized sequence of all different pieces, as if drawing them from a bag, before the next set. Advanced players like to "count cards", keeping track of the "seams" between bags of seven tetrominoes. This randomizer has a weakness: it can easily be <a href="http://www.tetrisconcept.com/wiki/index.php?title=Playing_forever">played forever</a>.</li>
   5.415 +<li>"Bag + 1" is like Bag but tosses a duplicate piece into each bag.</li>
   5.416 +<li>"Double bag" adds an extra copy of each piece to the bag, as a compromise between the even distribution of Bag and unpredictability of Memoryless.</li>
   5.417 +<li>"Strict history" will not deal a piece that was recently dealt. For tetrominoes, it will not deal one of the previous four. This way the player never gets a clump of all the same piece.</li>
   5.418 +<li>"History 6 rolls" is similar to strict history but sometimes (about 3.5%) generates repeats of recent pieces.</li>
   5.419 +</ul></dd>
   5.420 +</dl>
   5.421 +
   5.422 +<h3>Movement rules</h3>
   5.423 +<dl>
   5.424 +<dt>Hold piece</dt>
   5.425 +<dd>Controls the behavior of the hold piece. Empty leaves the hold box empty at the start of the game; the first time the player uses hold piece, the falling piece goes to the hold box, and the next piece enters instead of the hold piece. Random fills the hold piece with a random piece at the start of the game. Hold to next holds to the next piece box instead of the hold box. Off disables hold entirely.</dd>
   5.426 +<dt>Rotation system</dt>
   5.427 +<dd>In different rotation systems, tetrominoes may enter the field at different positions, and they behave differently when rotated against the walls and the other blocks. This option can be set to SRS (easiest), TOD M4 (like SRS in free space but less forgiving in wall kicks), Arika (like Sega with basic wall kicks), Sega or NES or Game Boy (no kicks), or Tengen (strict, with even stranger twists). Apart from one set of graphics for SRS and TOD M4 and one set for other systems, this option does not affect the colors of the tetrominoes; use the <code>.skin</code> commands to select replacement images that contain other colors. It also does not affect lockdown behavior.</dd>
   5.428 +<dt>Floor kicks</dt>
   5.429 +<dd>SRS and Arika rotation systems move a tetromino upward when a rotation would strike the floor or blocks under the tetromino. As this makes some tetrominoes easy to spin in place, this can detract from the immediacy of the game. This option limits the number of times each tetromino can be kicked upward.</dd>
   5.430 +<dt>Lockdown</dt>
   5.431 +<dd>Controls the interpretation of the delay between when each tetromino lands and when it locks. Classic disables the delay, as was the case in the oldest S.M.G. implementations; this makes slide moves more difficult. Entry reset allows only a constant amount of this delay per tetromino; instead of resetting, the lock timer pauses while the tetromino is falling. With Step reset, the delay resets every time the tetromino moves downward. With Move reset, the delay resets every time the tetromino moves at all. (Outside of Zero and Exponential speed curves, Classic behaves as Step reset.)</dd>
   5.432 +<dt>Lock delay</dt>
   5.433 +<dd>Controls the length of this delay. It can be set to a constant amount of time, or it can be controlled by the speed curve.</dd>
   5.434 +<dt>Deep drop</dt>
   5.435 +<dd>When this is on, a piece can fall past blocks in the playfield to fill appropriately shaped holes. This is potentially more controversial than the "T-spin triple" of SRS.</dd>
   5.436 +</dl>
   5.437 +
   5.438 +<h3>Line clear rules</h3>
   5.439 +<dl>
   5.440 +<dt>Line clear delay</dt>
   5.441 +<dd>Controls the length of the delay after a line clear. It can be set to a constant amount of time, or it can be controlled by the speed curve.</dd>
   5.442 +<dt>Clear gravity</dt>
   5.443 +<dd>Controls what happens to blocks after a line clear.
   5.444 +Naive means that blocks move down by exactly the number of cleared lines below them, potentially causing floating blocks.
   5.445 +In Sticky, tetrominoes stick together when they lock, and contiguous groups fall together.
   5.446 +It's possible for a group to fall past the cleared lines, causing chain reactions.
   5.447 +Sticky by color is similar to Sticky except only blocks of a single color stick together.
   5.448 +Cascade treats each piece as a separate entity unless Gluing is turned on.</dd>
   5.449 +<dt>Gluing</dt>
   5.450 +<dd>When turned on, this controls how pieces glue themselves together after they land:
   5.451 +<ul>
   5.452 +<li>In Square, when the player makes a 4x4 block square out of four complete tetrominoes, it will become a large square of solid gold or silver. Pieces that have been broken by a line clear cannot make squares and are thus drawn as garbage. A line containing a row of a silver square is worth 500 bonus points; a line containing a row of a gold square is worth 1000. <strong>Caution:</strong> This mode is displayed incorrectly if the current <a href="#skin">skin</a> lacks the appropriate <code>ljconn</code> file.</li>
   5.453 +<li>Sticky and Sticky by color act much like the corresponding Clear gravity settings. If a skin using connected blocks has a bright border around each piece, this can be used to draw a white border around each mass of pieces. Garbage always acts Sticky by color.</li>
   5.454 +</ul>
   5.455 +</dd>
   5.456 +<dt>Scoring</dt>
   5.457 +<dd>Choose a scoring method for line clears, as described <a href="#scoring">above</a>.</dd>
   5.458 +<dt>Drop scoring</dt>
   5.459 +<dd>Choose a scoring method for drops, as described <a href="#scoring">above</a>.</dd>
   5.460 +<dt>T-spin detection</dt>
   5.461 +<dd>Controls the definition of a T-spin used by the scoring method. When turned off, T-spins are not rewarded. When set to Immobile, a line is a T-spin line if the tetromino that completes it could not have moved left, right, or up. When set to 3-corner T, a line is a T-spin line if all of the following are true:
   5.462 +<ul>
   5.463 +<li>The line is completed with a T tetromino.</li>
   5.464 +<li>At least 3 of the 4 boxes diagonal to the center of the tetromino are either the wall or occupied with a block.</li>
   5.465 +<li>The tetromino has not shifted sideways or down by one or more spaces since it was last rotated.</li>
   5.466 +</ul>
   5.467 +3-corner T no kick adds an additional restriction: The rotation itself did not move the tetromino.</dd>
   5.468 +<dt>Garbage</dt>
   5.469 +<dd>Pushes up the lines in your playfield. In Level 1 through 4, a simulated computer opponent occasionally sends you this many lines of garbage. In Home Run Derby, every line you clear other than with a home run or a T-spin gives you garbage. In Drill and Preload Zigzag, the well is full of garbage except for the top few rows. Be prepared to rely on infinite spin for the first few lines until your skill improves.</dd>
   5.470 +</dl>
   5.471 +
   5.472 +<h3>Control options</h3>
   5.473 +<dl>
   5.474 +<dt>Max sideways delay</dt>
   5.475 +<dd>This controls the time the left or right key has to be held down before sideways movement begins. This can be set in 16.7 <abbr title="millisecond">ms</abbr> increments from 16.7 ms to 300 ms.
   5.476 +This delay is considered a "maximum", as it decreases over the course of the game in Master and Death speed curves.</dd>
   5.477 +<dt>Sideways speed</dt>
   5.478 +<dd>This controls how fast the tetromino moves sideways. It can be set at Instant (tetromino reaches side instantly as soon as sideways delay expires) or 10 to 60 moves per second.</dd>
   5.479 +<dt>Initial sideways motion</dt>
   5.480 +<dd>When this is turned on, the tetromino can move sideways in the first frame that it appears. This affects mobility at very high speeds (e.g. Death or Rhythm).</dd>
   5.481 +<dt>Initial rotation</dt>
   5.482 +<dd>When this is turned on, the player can rotate a piece before it enters by holding down a rotate button.</dd>
   5.483 +<dt>Allow diagonal motion</dt>
   5.484 +<dd>When this is turned off, the Left, Right, Up, and Down keys will be ignored if Left or Right is pressed at the same time as Up or Down. Some players who use joysticks or gamepads claim that such "4-way" logic reduces misdrops. Keyboard players should leave it turned on, as it is necessary for "Lock on release" to work properly.</dd>
   5.485 +<dt>Soft drop speed</dt>
   5.486 +<dd>Controls how fast the tetromino moves downward in a soft drop. Can be set to 1G, 1/2G, or 1/3G.</dd>
   5.487 +<dt>Soft drop</dt>
   5.488 +<dd>Controls how tetrominoes behave when they land after being soft dropped with the Down key. "Lock" means that they will lock instantly. "Slide" allows the player to place a tetromino under an overhang in one smooth motion (move down, move sideways, then press Up to lock). "Lock on release" is similar to "Slide" but locks when the player lets go of Down.</dd>
   5.489 +<dt>Hard drop</dt>
   5.490 +<dd>Controls how tetrominoes behave when they land after being hard dropped with the Up key. "Lock" means that hard-dropped tetrominoes will lock instantly.  "Slide" allows the player to place a tetromino under an overhang in one smooth motion (move down, move sideways, then press Down to lock). (The "Firm drop" key acts as a hard drop set to "Slide".) "Lock on release" is similar to "Slide" but locks when the player lets go of Up.</dd>
   5.491 +</dl>
   5.492 +
   5.493 +<h3>Display options</h3>
   5.494 +<p>
   5.495 +The details may vary between the PC version and the GBA and DS versions:
   5.496 +</p><dl>
   5.497 +<dt>Shadow</dt>
   5.498 +<dd>Controls how the falling tetromino and its shadow are displayed. It can show the falling tetromino along with a transparent colored shadow, opaque colored shadow, or colorless shadow. It's also possible to hide the shadow entirely or (for experts only) hide both the shadow and the falling tetromino.</dd>
   5.499 +<dt>Hide blocks in well</dt>
   5.500 +<dd>When turned on, hides the blocks that have locked down in the well. Useful for practicing for "invisible challenge" in another game.</dd>
   5.501 +<dt>Next pieces</dt>
   5.502 +<dd>Controls the number of previewed pieces displayed next to the well.</dd>
   5.503 +<dt>Smooth gravity</dt>
   5.504 +<dd>When this is turned off, tetrominoes fall in units of one block. When turned on, they fall pixel by pixel, and only the bottom edge of each block in a tetromino is tested for collision against the blocks in the well.</dd>
   5.505 +<dt>Next above shadow</dt>
   5.506 +<dd>Controls the number of previewed pieces displayed above the shadow. (PC version only)</dd>
   5.507 +<dt>Drop trails</dt>
   5.508 +<dd>When this is turned on, hard drops and fast piece gravity cause a piece to make a trail as it falls. It makes players feel faster at the game. (PC version only)</dd>
   5.509 +<dt>Pause on task switch</dt>
   5.510 +<dd>When turned on, automatically pauses the game when the player switches to another window. (PC version only; DS version always pauses on lid close)</dd>
   5.511 +<dt>Record all games</dt>
   5.512 +<dd>Automatically records each game to <tt>demo.ljm</tt>. Remember to rename your record-setting replays. (PC version only)</dd>
   5.513 +<dt>Display</dt>
   5.514 +<dd>Choose full screen or windowed mode. If windowed mode does not work, try excluding LOCKJAW from your window decoration theming program. (PC version only; GBA and DS always run in full screen)</dd>
   5.515 +</dl><p>
   5.516 +The PC version saves these options to <code>lj.ini</code> every time you exit the options screen. Other options not shown are also saved to <code>lj.ini</code> and can be changed with a text editor.
   5.517 +</p>
   5.518 +
   5.519 +<h2><a name="discussion">Discussion</a></h2>
   5.520 +<p>
   5.521 +If you want to discuss the game, you can do so at <a href="http://www.tetrisconcept.com/forum/viewtopic.php?t=100">TetrisConcept.com forum</a>.
   5.522 +</p><p>
   5.523 +If you want a Tetris shot, ask your doctor.
   5.524 +</p>
   5.525 +
   5.526 +<h2><a name="legal">Legal</a></h2>
   5.527 +<div style="border: 1px solid black; padding: 1em 2em">
   5.528 +<p>
   5.529 +Copyright 2006&ndash;2008 Damian Yerrick &lt;<a href="http://www.pineight.com/contact/">tepp&#108;es+lockjaw (at) spam&#99;op (full stop) net</a>&gt;. This manual is under the following license:
   5.530 +</p><p>
   5.531 +This work is provided 'as-is', <span style="font-variant: small-caps">without any express or implied warranty.</span>  In no event will the authors be held liable for any damages arising from the use of this work.
   5.532 +</p><p>
   5.533 +Permission is granted to anyone to use this work for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
   5.534 +</p><ol>
   5.535 +<li>The origin of this work must not be misrepresented; you must not claim that you wrote the original work. If you use this work in a product, an acknowledgment in the product documentation would be appreciated but is not required.</li>
   5.536 +<li>Altered source versions must be plainly marked as such, and must not be misrepresented as being the original work.</li>
   5.537 +<li>This notice may not be removed or altered from any source distribution.</li>
   5.538 +</ol><p>
   5.539 +The term "source" refers to the preferred form of a work for making changes to it.
   5.540 +</p>
   5.541 +</div>
   5.542 +<p>
   5.543 +The LOCKJAW software described by this manual is distributed under the <a href="http://www.gnu.org/copyleft/gpl.html">GNU General Public License, version 2 or later</a>, <span style="font-variant: small-caps">with absolutely no warranty.</span> See <code>COPYING.txt</code> for details.
   5.544 +</p><p>
   5.545 +<a name="trademarks">*</a> Tetris is a trademark of The Tetris Company.  The Software is not sponsored or endorsed by Alexey Pajitnov, Tetris Holding, Apple, Cloudmakers, Free Software Foundation, Microsoft, or Nintendo.
   5.546 +</p>
   5.547 +</div>
   5.548 +</body>
   5.549 +</html>
   5.550 \ No newline at end of file

     6.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     6.2 +++ b/TODO.txt	Fri Mar 13 00:39:12 2009 -0700
     6.3 @@ -0,0 +1,13 @@
     6.4 +As of LOCKJAW 0.42, TODO.txt is being migrated to a bug list format;
     6.5 +see BUGS.txt.  Not yet migrated:
     6.6 +
     6.7 +cdsboy wants:
     6.8 +  * DTET rush mode (please describe this in detail)
     6.9 +  * DTET lives (please describe this in detail)
    6.10 +  * Editable game keys presets (please describe the UI)
    6.11 +
    6.12 +DIGITAL wants:
    6.13 +  * Ability to switch tetromino colors in game (huh?)
    6.14 +  
    6.15 +Zed0 wants:
    6.16 +  * Tetrinet client

     7.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     7.2 +++ b/binzip.in	Fri Mar 13 00:39:12 2009 -0700
     7.3 @@ -0,0 +1,25 @@
     7.4 +alleg42.dll
     7.5 +lj.exe
     7.6 +lj.dat
     7.7 +COPYING.txt
     7.8 +GPL.txt
     7.9 +README.html
    7.10 +CHANGES.txt
    7.11 +TODO.txt
    7.12 +BUGS.txt
    7.13 +ljbg.jpg
    7.14 +ljblocks.bmp
    7.15 +ljconn.bmp
    7.16 +ljblocks-sega.bmp
    7.17 +ljconn-sega.bmp
    7.18 +bgm.s3m
    7.19 +bgm-rhythm.s3m
    7.20 +sound.dat
    7.21 +lj.gba
    7.22 +lj.nds
    7.23 +docs/ljlogo192.png
    7.24 +docs/titlebarbg.png
    7.25 +docs/ljsnap033.png
    7.26 +docs/ijlo-stz.png
    7.27 +docs/appicon.ico
    7.28 +docs/ljhtml.css

     8.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     8.2 +++ b/docs/Compiling_on_Windows.txt	Fri Mar 13 00:39:12 2009 -0700
     8.3 @@ -0,0 +1,103 @@
     8.4 +______________________________________________________________________
     8.5 +
     8.6 +Guide to compiling LOCKJAW on Microsoft Windows
     8.7 +by Lardarse and tepples
     8.8 +
     8.9 +You will need the following files:
    8.10 +
    8.11 +* Dev-C++ 5.0 Beta
    8.12 +  http://prdownloads.sourceforge.net/dev-cpp/devcpp-4.9.9.2_setup.exe
    8.13 +* devkitPro Updater
    8.14 +  http://www.devkitpro.org/
    8.15 +* Allegro 4.2.0
    8.16 +  http://www.pineight.com/lj/all420.zip
    8.17 +* Minimal DirectX 7 SDK for MinGW
    8.18 +  http://alleg.sourceforge.net/files/dx70_mgw.zip
    8.19 +* libogg 1.1.3
    8.20 +  http://www.pineight.com/lj/libogg-1.1.3.zip
    8.21 +* libvorbis 1.1.2
    8.22 +  http://www.pineight.com/lj/libvorbis-1.1.2.zip
    8.23 +* DUMB 0.9.3
    8.24 +  http://www.pineight.com/lj/dumb-0.9.3.zip
    8.25 +* JPGalleg 2.5
    8.26 +  http://www.pineight.com/lj/jpgalleg-2.5.tar.gz
    8.27 +
    8.28 +______________________________________________________________________
    8.29 +Install MinGW
    8.30 +
    8.31 +Put all of those files into a folder on your desktop. Run the Dev-C++
    8.32 +installer, installing into C:\Dev-Cpp, and using the default settings,
    8.33 +unless you have a reason for not wanting to associate C source file
    8.34 +types with Dev-C++.
    8.35 +
    8.36 +______________________________________________________________________
    8.37 +Install MSYS and devkitARM
    8.38 +
    8.39 +Run the devkitPro Updater. It will ask you if you want to get a newer
    8.40 +version.  Answer yes to this, and then install everything that it asks
    8.41 +to, except devkitPSP and devkitPPC.  MSYS should be installed into
    8.42 +C:\devkitPro\msys, and just press Enter to all of the questions that
    8.43 +it asks when installing it.  The other parts will install without user
    8.44 +intervention, unless the downloading is interrupted.
    8.45 +
    8.46 +______________________________________________________________________
    8.47 +Make MinGW and MSYS available
    8.48 +
    8.49 +Right-click My Computer and go to Properties -> Advanced ->
    8.50 +Environment Variables.  Add MINGDIR = C:\Dev-Cpp and make sure
    8.51 +that Path starts with C:\Dev-Cpp\Bin;c:\devkitPro\msys\bin;
    8.52 +
    8.53 +Extract dx70_mgw.zip into C:\Dev-Cpp, over-writing files as
    8.54 +necessary.  Extract the other 5 files that were downloaded earlier
    8.55 +into C:\, where each one will be in its own folder.  Now open a
    8.56 +command prompt (Start -> Run -> cmd) and enter the following commands:
    8.57 +
    8.58 +______________________________________________________________________
    8.59 +Make and install required libraries
    8.60 +
    8.61 +cd \
    8.62 +cd allegro
    8.63 +fix.bat mingw32
    8.64 +make
    8.65 +make install
    8.66 +cd \
    8.67 +cd libogg-1.1.3
    8.68 +sh configure --prefix=C:\Dev-Cpp --disable-shared
    8.69 +make
    8.70 +make install
    8.71 +cd \
    8.72 +cd libvorbis-1.1.2
    8.73 +sh configure --prefix=C:\Dev-Cpp --disable-shared
    8.74 +make
    8.75 +make install
    8.76 +cd \
    8.77 +cd dumb-0.9.3
    8.78 +make
    8.79 +
    8.80 +This command will ask you 2 questions.  Answer M to the first
    8.81 +and Y to the second.
    8.82 +
    8.83 +make install
    8.84 +cd \
    8.85 +cd jpgalleg-2.5
    8.86 +fix.bat mingw32
    8.87 +make
    8.88 +make install
    8.89 +
    8.90 +At this point you can now close this window.
    8.91 +
    8.92 +Now open another command window and navigate to the folder where you
    8.93 +have Lockjaw installed.  You may prefer to use a different folder
    8.94 +than your usual playing folder.  If you are going to be compiling
    8.95 +a lot, and you are using Windows XP, then you may want to install
    8.96 +the Open Command Window Here powertoy:
    8.97 +http://www.microsoft.com/windowsxp/downloads/powertoys/xppowertoys.mspx
    8.98 +
    8.99 +Once you are in the folder, just type in make, and within a few
   8.100 +seconds, it should be compiled.  The lj.exe will be roughly twice the
   8.101 +size of that in the official distribution; you can fix this with UPX.
   8.102 +http://upx.sourceforge.net/
   8.103 +
   8.104 +Now to try to do something intersting with it...
   8.105 +
   8.106 +Now grab yourself a drink. You deserve it...

     9.1 Binary file docs/appicon.ico has changed

    10.1 Binary file docs/appicon.xcf has changed

    11.1 Binary file docs/dsicon.bmp has changed

    12.1 Binary file docs/favicon.ico has changed

    13.1 Binary file docs/ijlo-stz.png has changed

    14.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    14.2 +++ b/docs/ljhtml.css	Fri Mar 13 00:39:12 2009 -0700
    14.3 @@ -0,0 +1,47 @@
    14.4 +body {
    14.5 +  margin: 0 0 1em 0; font-family: Bitstream Vera Sans, sans-serif
    14.6 +}
    14.7 +h1 {
    14.8 +  height: 192px; margin: 0; padding: 0 1em; background: url(titlebarbg.png); color: #FFF
    14.9 +}
   14.10 +h1 img {
   14.11 +  vertical-align: middle;
   14.12 +}
   14.13 +#content {
   14.14 +  margin: 0; padding: 1em 2em;
   14.15 +  color: #000; background: #FFF
   14.16 +}
   14.17 +#linkbar {
   14.18 +  position: absolute; top: 1em; left: 480px; color: #fff; margin: 0; font-size: 120%;
   14.19 +  padding-left: 1em
   14.20 +}
   14.21 +#linkbar a:link { color: #99f }
   14.22 +#linkbar a:visited { color: #f69 }
   14.23 +#linkbar a:hover { color: #ccf }
   14.24 +#linkbar a:active { color: #fff }
   14.25 +
   14.26 +.precis  {
   14.27 +  margin: 2em 2em 2em 2em;
   14.28 +  border: 1px solid #c00;
   14.29 +  background: #ffc;
   14.30 +  padding: 1em 2em 1em 2em;
   14.31 +  font-size: 120%;
   14.32 +}
   14.33 +
   14.34 +.precis-ad  {
   14.35 +  margin: 2em 160px 2em 2em;
   14.36 +  border: 1px solid #c00;
   14.37 +  background: #ffc;
   14.38 +  padding: 1em 2em 1em 2em;
   14.39 +  font-size: 120%;
   14.40 +}
   14.41 +
   14.42 +.screenshot {
   14.43 +  float: right;
   14.44 +  margin: 0 0 1em 2em;
   14.45 +  font-size: 80%;
   14.46 +}
   14.47 +
   14.48 +img.screenshot, .screenshot img {
   14.49 +  border: 0px none;
   14.50 +}

    15.1 Binary file docs/ljlogo192.png has changed

    16.1 Binary file docs/ljsnap018.png has changed

    17.1 Binary file docs/titlebarbg.png has changed

    18.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    18.2 +++ b/dsmakefile	Fri Mar 13 00:39:12 2009 -0700
    18.3 @@ -0,0 +1,136 @@
    18.4 +# Makefile for Nintendo DS version of LOCKJAW
    18.5 +#
    18.6 +# Copr. 2006-2007 Damian Yerrick
    18.7 +# 
    18.8 +# This work is free software; you can redistribute it and/or modify
    18.9 +# it under the terms of the GNU General Public License as published by
   18.10 +# the Free Software Foundation; either version 2 of the License, or
   18.11 +# (at your option) any later version.
   18.12 +# 
   18.13 +# This program is distributed in the hope that it will be useful,
   18.14 +# but WITHOUT ANY WARRANTY; without even the implied warranty of
   18.15 +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   18.16 +# GNU General Public License for more details.
   18.17 +# 
   18.18 +# You should have received a copy of the GNU General Public License
   18.19 +# along with this program; if not, write to the Free Software
   18.20 +# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   18.21 +
   18.22 +srcdir := src
   18.23 +objdir := obj/ds
   18.24 +EXE := $(objdir)/ljds.elf
   18.25 +EXE7 := $(objdir)/ljds7.elf
   18.26 +ASSETSFILE := $(objdir)/assets.s
   18.27 +ASSETS := $(srcdir)/text.chr $(srcdir)/gbablk.chr $(objdir)/vwfont.bin
   18.28 +ARMGCC=arm-eabi-gcc
   18.29 +ARMOBJ=arm-eabi-objcopy
   18.30 +CFLAGS7=-std=gnu99 -Wall -O2 -mcpu=arm7tdmi -mtune=arm7tdmi -fomit-frame-pointer -ffast-math -mthumb-interwork
   18.31 +CFLAGS9=-std=gnu99 -Wall -O2 -mcpu=arm9tdmi -mtune=arm9tdmi -fomit-frame-pointer -ffast-math -mthumb-interwork -DDEBRIEF_SHORT -DHAS_FOPEN
   18.32 +LDLIBS9=-lfat -lnds9
   18.33 +NDSLIB_INCLUDE=$(DEVKITPRO)/libnds/include
   18.34 +NDSLIB_LIB=$(DEVKITPRO)/libnds/lib
   18.35 +DEPOBJS := \
   18.36 +$(objdir)/ljds.o $(objdir)/ljplay.o $(objdir)/lj.o \
   18.37 +$(objdir)/gimmicks.o $(objdir)/wktables.o $(objdir)/macro.o \
   18.38 +$(objdir)/gbaopt.o $(objdir)/speed.o $(objdir)/options.o \
   18.39 +$(objdir)/fontdraw.o $(objdir)/dssleep.o $(objdir)/random.o \
   18.40 +$(objdir)/ljlocale.o $(objdir)/debrief.o $(objdir)/dsdebrief.o \
   18.41 +$(objdir)/gbamenus.o $(objdir)/ljpath.o $(objdir)/dsjoy.o
   18.42 +OBJS := $(DEPOBJS) $(ASSETSFILE)
   18.43 +EMU := start
   18.44 +GAMEICON := docs/dsicon.bmp
   18.45 +
   18.46 +CC := gcc
   18.47 +CFLAGS := 
   18.48 +
   18.49 +# The wintermute-approved way to ensure devkitARM is in the PATH
   18.50 +ifeq ($(strip $(DEVKITPRO)),)
   18.51 +$(error "Please set DEVKITPRO in your environment. export DEVKITPRO=<path to>devkitPro)
   18.52 +endif
   18.53 +ifeq ($(strip $(DEVKITARM)),)
   18.54 +$(error "Please set DEVKITARM in your environment. export DEVKITARM=<path to>devkitARM)
   18.55 +endif
   18.56 +export PATH	:=	$(DEVKITARM)/bin:$(PATH)
   18.57 +
   18.58 +.PHONY: run clean cf
   18.59 +
   18.60 +run: lj.nds
   18.61 +	$(EMU) $<
   18.62 +
   18.63 +lj.nds: $(objdir)/ljds.bin $(objdir)/ljds7.bin $(GAMEICON)
   18.64 +	ndstool -c $@ -9 $(objdir)/ljds.bin -7 $(objdir)/ljds7.bin -b $(GAMEICON) "LOCKJAW DS;The Soviet Mind Game"
   18.65 +
   18.66 +%.nds.gba: %.nds
   18.67 +	dsbuild $< -o $@
   18.68 +
   18.69 +%.bin: %.elf
   18.70 +	$(ARMOBJ) -O binary $< $@
   18.71 +
   18.72 +$(EXE): $(OBJS)
   18.73 +	$(ARMGCC) -g -mthumb-interwork -mno-fpu -specs=ds_arm9.specs $^ -L$(NDSLIB_LIB) $(LDLIBS9) -o $@
   18.74 +
   18.75 +$(objdir)/ljds7.elf: $(objdir)/dsarm7.o $(objdir)/lookup_tables7.o $(objdir)/dssound7.o
   18.76 +	$(ARMGCC) -g -mthumb-interwork -mno-fpu -specs=ds_arm7.specs $^ -L$(NDSLIB_LIB) -lnds7 -o $@
   18.77 +
   18.78 +$(objdir)/%7.o: $(srcdir)/%7.c
   18.79 +	$(ARMGCC) $(CFLAGS7) -I$(NDSLIB_INCLUDE) -MMD -DARM7 -c $< -o $@
   18.80 +	@cp $(objdir)/$*.d $(objdir)/$*.P; \
   18.81 +	sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
   18.82 +	-e '/^$$/ d' -e 's/$$/ :/' < $(objdir)/$*.d >> $(objdir)/$*.P; \
   18.83 +	rm -f $(objdir)/$*.d
   18.84 +
   18.85 +$(objdir)/%.o: $(srcdir)/%.c $(srcdir)/ljds.h
   18.86 +	$(ARMGCC) $(CFLAGS9) -I$(NDSLIB_INCLUDE) -MMD -DARM9 -c $< -o $@
   18.87 +	@cp $(objdir)/$*.d $(objdir)/$*.P; \
   18.88 +	sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
   18.89 +	-e '/^$$/ d' -e 's/$$/ :/' < $(objdir)/$*.d >> $(objdir)/$*.P; \
   18.90 +	rm -f $(objdir)/$*.d
   18.91 +
   18.92 +%.o: %.s
   18.93 +	$(ARMGCC) $(CFLAGS9) -I$(NDSLIB_INCLUDE) -MMD -DARM9 -c $< -o $@
   18.94 +	@cp $(objdir)/$*.d $(objdir)/$*.P; \
   18.95 +	sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
   18.96 +	-e '/^$$/ d' -e 's/$$/ :/' < $(objdir)/$*.d >> $(objdir)/$*.P; \
   18.97 +	rm -f $(objdir)/$*.d
   18.98 +
   18.99 +$(ASSETSFILE): $(ASSETS)
  18.100 +	bin2s $^ > $@
  18.101 +
  18.102 +# Handle header dependencies
  18.103 +
  18.104 +-include $(DEPOBJS:%.o=%.P)
  18.105 +# The master copy of the variable width font library is in another folder
  18.106 +
  18.107 +src/fontdraw%: /e/games/ac/double/rac/src/fontdraw%
  18.108 +	cp $< $@
  18.109 +
  18.110 +#ejector is at http://jimprice.com/jim-soft.shtml#eject
  18.111 +#and is not necessary for building the program
  18.112 +cf: lj.nds
  18.113 +	cp lj.nds /h/
  18.114 +	ejector H:
  18.115 +
  18.116 +# PC side rules
  18.117 +
  18.118 +tools/fontconv.exe: tools/fontconv.o
  18.119 +	gcc -Wall -s $^ -lalleg -o $@
  18.120 +
  18.121 +tools/mktables.exe: tools/mktables.o
  18.122 +	gcc -Wall -s $^ -o $@
  18.123 +
  18.124 +tools/%.o: tools/%.c
  18.125 +	gcc -Wall -O2 -std=gnu99 -c $< -o $@
  18.126 +
  18.127 +$(objdir)/vwfont.bin: tools/fontconv.exe $(srcdir)/font.bmp
  18.128 +	$^ $@
  18.129 +
  18.130 +$(objdir)/lookup_tables7.s: tools/mktables.exe
  18.131 +	$<
  18.132 +
  18.133 +# Cleanup rules
  18.134 +
  18.135 +clean:
  18.136 +	-rm $(objdir)/*.s
  18.137 +	-rm $(objdir)/*.o
  18.138 +	-rm $(objdir)/*.P
  18.139 +

    19.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    19.2 +++ b/gbamakefile	Fri Mar 13 00:39:12 2009 -0700
    19.3 @@ -0,0 +1,135 @@
    19.4 +# Makefile for Game Boy Advance version of LOCKJAW
    19.5 +#
    19.6 +# Copr. 2006-2007 Damian Yerrick
    19.7 +# 
    19.8 +# This work is free software; you can redistribute it and/or modify
    19.9 +# it under the terms of the GNU General Public License as published by
   19.10 +# the Free Software Foundation; either version 2 of the License, or
   19.11 +# (at your option) any later version.
   19.12 +# 
   19.13 +# This program is distributed in the hope that it will be useful,
   19.14 +# but WITHOUT ANY WARRANTY; without even the implied warranty of
   19.15 +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   19.16 +# GNU General Public License for more details.
   19.17 +# 
   19.18 +# You should have received a copy of the GNU General Public License
   19.19 +# along with this program; if not, write to the Free Software
   19.20 +# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   19.21 +
   19.22 +
   19.23 +srcdir := src
   19.24 +objdir := obj/gba
   19.25 +EXE := $(objdir)/lj.elf
   19.26 +ASSETSFILE := $(objdir)/assets.s
   19.27 +INCGBA := -I$(DEVKITPRO)/libgba/include
   19.28 +LIBGBA := -L$(DEVKITPRO)/libgba/lib -lgba
   19.29 +THUMB_CFLAGS := -mthumb -Wall -O2 -std=gnu99 -mcpu=arm7tdmi \
   19.30 +-DFONTDRAW_SPLIT_COMPILE -DNO_DATETIME -DDEBRIEF_SHORT
   19.31 +ARM_CFLAGS := -marm -Wall -O2 -std=gnu99 -mcpu=arm7tdmi \
   19.32 +-DFONTDRAW_SPLIT_COMPILE
   19.33 +CC := arm-eabi-gcc -mthumb-interwork
   19.34 +LD := arm-eabi-gcc -mthumb-interwork
   19.35 +LDFLAGS := -mthumb -Wall -specs=gba_mb.specs
   19.36 +
   19.37 +MUSICOBJS := $(objdir)/gbasound.o $(objdir)/gbanotefreq.o
   19.38 +MUSICLIBS := 
   19.39 +
   19.40 +# The wintermute-approved way to ensure devkitARM is in the PATH
   19.41 +ifeq ($(strip $(DEVKITPRO)),)
   19.42 +$(error "Please set DEVKITPRO in your environment. export DEVKITPRO=<path to>devkitPro)
   19.43 +endif
   19.44 +ifeq ($(strip $(DEVKITARM)),)
   19.45 +$(error "Please set DEVKITARM in your environment. export DEVKITARM=<path to>devkitARM)
   19.46 +endif
   19.47 +export PATH	:=	$(DEVKITARM)/bin:$(PATH)
   19.48 +
   19.49 +# Objects
   19.50 +
   19.51 +LDLIBS := $(LIBGBA)
   19.52 +DEPOBJS := \
   19.53 +$(objdir)/ljgba.o $(objdir)/gbaopt.o $(objdir)/gbaisr.iwram.o \
   19.54 +$(objdir)/ljplay.o $(objdir)/lj.o $(objdir)/speed.o $(objdir)/gimmicks.o \
   19.55 +$(objdir)/options.o $(objdir)/wktables.o $(objdir)/fontdraw.o \
   19.56 +$(objdir)/fontdraw.iwram.o $(objdir)/macro.o $(objdir)/random.o \
   19.57 +$(objdir)/gba_asm.o $(objdir)/ljlocale.o $(objdir)/debrief.o \
   19.58 +$(objdir)/dsdebrief.o $(objdir)/gbamenus.o $(objdir)/dsjoy.o \
   19.59 +$(MUSICOBJS)
   19.60 +ASSETS := $(srcdir)/text.chr $(srcdir)/gbablk.chr $(objdir)/vwfont.bin
   19.61 +#deleted: ljpc pcjoy options debrief ljreplay ljmusic
   19.62 +
   19.63 +OTHEROBJS := $(ASSETSFILE)
   19.64 +
   19.65 +run: lj.gba
   19.66 +	start $<
   19.67 +
   19.68 +#ejector is at http://jimprice.com/jim-soft.shtml#eject
   19.69 +#and is not necessary for building the program
   19.70 +cf: lj.gba
   19.71 +	cp lj.gba /h/gba/
   19.72 +	ejector H:
   19.73 +
   19.74 +$(EXE): $(DEPOBJS) $(OTHEROBJS)
   19.75 +	$(LD) $(LDFLAGS) $^ $(MUSICLIBS) $(LDLIBS) -o $@
   19.76 +
   19.77 +$(ASSETSFILE): $(ASSETS)
   19.78 +	bin2s $^ > $@
   19.79 +
   19.80 +# Compilation rules
   19.81 +
   19.82 +%.gba: $(objdir)/%.elf
   19.83 +	arm-eabi-objcopy -O binary $< $@
   19.84 +	gbafix -tLOCKJAW $@
   19.85 +
   19.86 +$(objdir)/%.iwram.o: $(srcdir)/%.iwram.c
   19.87 +	$(CC) $(ARM_CFLAGS) -MMD -c -o $@ $< $(INCGBA)
   19.88 +	@cp $(objdir)/$*.iwram.d $(objdir)/$*.iwram.P; \
   19.89 +	sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
   19.90 +	-e '/^$$/ d' -e 's/$$/ :/' < $(objdir)/$*.iwram.d >> $(objdir)/$*.iwram.P; \
   19.91 +	rm -f $(objdir)/$*.iwram.d
   19.92 +
   19.93 +$(objdir)/%.o: $(srcdir)/%.c
   19.94 +	$(CC) $(THUMB_CFLAGS) -MMD -c -o $@ $< $(INCGBA)
   19.95 +	@cp $(objdir)/$*.d $(objdir)/$*.P; \
   19.96 +	sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
   19.97 +	-e '/^$$/ d' -e 's/$$/ :/' < $(objdir)/$*.d >> $(objdir)/$*.P; \
   19.98 +	rm -f $(objdir)/$*.d
   19.99 +
  19.100 +$(objdir)/%.o: $(srcdir)/%.s
  19.101 +	$(CC) -MMD -c -o $@ $< $(INCGBA)
  19.102 +	@cp $(objdir)/$*.d $(objdir)/$*.P; \
  19.103 +	sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
  19.104 +	-e '/^$$/ d' -e 's/$$/ :/' < $(objdir)/$*.d >> $(objdir)/$*.P; \
  19.105 +	rm -f $(objdir)/$*.d
  19.106 +    
  19.107 +$(objdir)/%.o: $(objdir)/%.s
  19.108 +	$(CC) -c -o $@ $<
  19.109 +
  19.110 +# The master copy of the variable width font library is in another folder
  19.111 +
  19.112 +src/fontdraw%: /e/games/ac/double/rac/src/fontdraw%
  19.113 +	cp $< $@
  19.114 +
  19.115 +src/font.bmp: /e/games/ac/double/rac/src/font.bmp
  19.116 +	cp $< $@
  19.117 +
  19.118 +$(objdir)/vwfont.bin: tools/fontconv.exe $(srcdir)/font.bmp
  19.119 +	$^ $@
  19.120 +
  19.121 +tools/fontconv.exe: tools/fontconv.o
  19.122 +	gcc -Wall -s $^ -lalleg -o $@
  19.123 +
  19.124 +tools/%.o: tools/%.c
  19.125 +	gcc -Wall -O2 -std=gnu99 -c $< -o $@
  19.126 +
  19.127 +# Header dependencies
  19.128 +
  19.129 +-include $(DEPOBJS:%.o=%.P)
  19.130 +
  19.131 +
  19.132 +# Cleanup rules
  19.133 +.PHONY: clean run cf
  19.134 +
  19.135 +clean:
  19.136 +	-rm $(objdir)/*.s
  19.137 +	-rm $(objdir)/*.o
  19.138 +	-rm $(objdir)/*.P

    20.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    20.2 +++ b/makefile	Fri Mar 13 00:39:12 2009 -0700
    20.3 @@ -0,0 +1,108 @@
    20.4 +# Makefile for Allegro version of LOCKJAW
    20.5 +# under Windows and Linux
    20.6 +#
    20.7 +# Copr. 2006-2007 Damian Yerrick
    20.8 +# 
    20.9 +# This work is free software; you can redistribute it and/or modify
   20.10 +# it under the terms of the GNU General Public License as published by
   20.11 +# the Free Software Foundation; either version 2 of the License, or
   20.12 +# (at your option) any later version.
   20.13 +# 
   20.14 +# This program is distributed in the hope that it will be useful,
   20.15 +# but WITHOUT ANY WARRANTY; without even the implied warranty of
   20.16 +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   20.17 +# GNU General Public License for more details.
   20.18 +# 
   20.19 +# You should have received a copy of the GNU General Public License
   20.20 +# along with this program; if not, write to the Free Software
   20.21 +# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   20.22 +
   20.23 +
   20.24 +EXE := lj.exe
   20.25 +CFLAGS := -Wall -O2 -std=gnu99 -DWITH_REPLAY=1 -DHAS_FPU
   20.26 +CC := gcc
   20.27 +LD := gcc
   20.28 +LDFLAGS := -Wall -s -mwindows
   20.29 +srcdir := src
   20.30 +objdir := obj/win32
   20.31 +
   20.32 +# Set this to the drive letter of your CF or SD card adapter
   20.33 +# so that 'make cf' works
   20.34 +# for info about Ejector by Jim Price, see the GBA makefile
   20.35 +CFDRIVE := h
   20.36 +
   20.37 +MUSICOBJS := $(objdir)/ljvorbis.o 
   20.38 +MUSICLIBS := -laldmb -ldumb -lvorbisfile -lvorbis -logg
   20.39 +
   20.40 +LDLIBS := -lshfolder -ljpgal -lalleg
   20.41 +LINUXLDLIBS := -ljpgal `allegro-config --libs`
   20.42 +DEPOBJS := $(objdir)/ljpc.o $(objdir)/lj.o $(objdir)/ljplay.o \
   20.43 +$(objdir)/pcjoy.o $(objdir)/gimmicks.o $(objdir)/random.o \
   20.44 +$(objdir)/wktables.o $(objdir)/speed.o $(objdir)/options.o \
   20.45 +$(objdir)/debrief.o $(objdir)/macro.o $(objdir)/ljreplay.o \
   20.46 +$(objdir)/ljmusic.o $(objdir)/old_pc_options.o $(objdir)/pcsound.o \
   20.47 +$(objdir)/pcdebrief.o $(objdir)/ljlocale.o $(objdir)/scenario.o \
   20.48 +$(objdir)/ljpath.o \
   20.49 +$(MUSICOBJS)
   20.50 +
   20.51 +OTHEROBJS := $(objdir)/winicon.o
   20.52 +
   20.53 +.PHONY: pc clean lj.gba lj.nds cf all run
   20.54 +
   20.55 +# Scripts to coordinate building the PC, GBA, and DS versions
   20.56 +
   20.57 +pc: $(EXE)
   20.58 +
   20.59 +run: $(EXE)
   20.60 +	./lj
   20.61 +
   20.62 +all: $(EXE) lj.gba lj.nds
   20.63 +
   20.64 +cf: /$(CFDRIVE)/gba/lj.gba /$(CFDRIVE)/lj.nds
   20.65 +	#ejector from http://www.jimprice.com/jim-soft.shtml#eject
   20.66 +	ejector $(CFDRIVE):
   20.67 +
   20.68 +/$(CFDRIVE)/gba/lj.gba: lj.gba
   20.69 +	cp $< $@
   20.70 +
   20.71 +/$(CFDRIVE)/lj.nds: lj.nds
   20.72 +	cp $< $@
   20.73 +
   20.74 +lj.gba:
   20.75 +	+make -f gbamakefile $@
   20.76 +
   20.77 +lj.nds:
   20.78 +	+make -f dsmakefile $@
   20.79 +
   20.80 +# Content of executable
   20.81 +
   20.82 +$(EXE): $(DEPOBJS) $(OTHEROBJS)
   20.83 +	$(LD) $(LDFLAGS) $^ $(MUSICLIBS) $(LDLIBS) -o $@
   20.84 +
   20.85 +# kesiev's makefile for GNU/Linux
   20.86 +
   20.87 +linux: $(DEPOBJS)
   20.88 +	$(LD) $(LDFLAGS) $^ $(MUSICLIBS) $(LINUXLDLIBS) -o lj
   20.89 +
   20.90 +# Compilation rules
   20.91 +
   20.92 +$(objdir)/%.o: $(srcdir)/%.c
   20.93 +	$(CC) $(CFLAGS) -MMD -c -o $@ $<
   20.94 +	@cp $(objdir)/$*.d $(objdir)/$*.P; \
   20.95 +	sed -e 's/#.*//' -e 's/^[^:]*: *//' -e 's/ *\\$$//' \
   20.96 +	-e '/^$$/ d' -e 's/$$/ :/' < $(objdir)/$*.d >> $(objdir)/$*.P; \
   20.97 +	rm -f $(objdir)/$*.d
   20.98 +
   20.99 +$(objdir)/%.o: src/%.rc docs/favicon.ico
  20.100 +	windres -i $< -o $@
  20.101 +
  20.102 +# Header dependencies
  20.103 +
  20.104 +-include $(DEPOBJS:%.o=%.P)
  20.105 +
  20.106 +
  20.107 +# Cleanup rules
  20.108 +
  20.109 +clean:
  20.110 +	-rm $(objdir)/*.o
  20.111 +	-rm $(objdir)/*.P

    21.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    21.2 +++ b/mkzip.bat	Fri Mar 13 00:39:12 2009 -0700
    21.3 @@ -0,0 +1,16 @@
    21.4 +@echo off
    21.5 +echo Compressing
    21.6 +upx -9 lj.exe
    21.7 +
    21.8 +echo Sending zip to local copy of Pin Eight
    21.9 +zip -9 -u lj-src.zip -@ < zip.in
   21.10 +
   21.11 +zip -9 -u lj.zip -@ < binzip.in
   21.12 +
   21.13 +copy lj.zip E:\p8\lj\
   21.14 +copy lj-src.zip E:\p8\lj\
   21.15 +copy lj-contrib.zip E:\p8\lj\
   21.16 +copy README.html E:\p8\lj\
   21.17 +copy docs\ljhtml.css E:\p8\lj\docs\
   21.18 +start E:\p8\lj
   21.19 +echo Now FTP this to the server.
   21.20 \ No newline at end of file

    22.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    22.2 +++ b/obj/ds/index.txt	Fri Mar 13 00:39:12 2009 -0700
    22.3 @@ -0,0 +1,1 @@
    22.4 +Windows object files go here. 

    23.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    23.2 +++ b/obj/gba/index.txt	Fri Mar 13 00:39:12 2009 -0700
    23.3 @@ -0,0 +1,1 @@
    23.4 +Windows object files go here. 

    24.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    24.2 +++ b/obj/win32/index.txt	Fri Mar 13 00:39:12 2009 -0700
    24.3 @@ -0,0 +1,1 @@
    24.4 +Windows object files go here. 

    25.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    25.2 +++ b/src/debrief.c	Fri Mar 13 00:39:12 2009 -0700
    25.3 @@ -0,0 +1,603 @@
    25.4 +/* PC frontend for LOCKJAW, an implementation of the Soviet Mind Game
    25.5 +
    25.6 +Copyright (C) 2006 Damian Yerrick <tepples+lj@spamcop.net>
    25.7 +
    25.8 +This work is free software; you can redistribute it and/or modify
    25.9 +it under the terms of the GNU General Public License as published by
   25.10 +the Free Software Foundation; either version 2 of the License, or
   25.11 +(at your option) any later version.
   25.12 +
   25.13 +This program is distributed in the hope that it will be useful,
   25.14 +but WITHOUT ANY WARRANTY; without even the implied warranty of
   25.15 +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   25.16 +GNU General Public License for more details.
   25.17 +
   25.18 +You should have received a copy of the GNU General Public License
   25.19 +along with this program; if not, write to the Free Software
   25.20 +Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
   25.21 +
   25.22 +Original game concept and design by Alexey Pajitnov.
   25.23 +The Software is not sponsored or endorsed by Alexey Pajitnov, Elorg,
   25.24 +or The Tetris Company LLC.
   25.25 +
   25.26 +*/
   25.27 +#include "ljplay.h"
   25.28 +#include "options.h"
   25.29 +#include <stdio.h>
   25.30 +#ifndef NO_DATETIME
   25.31 +#include <time.h>
   25.32 +#endif
   25.33 +
   25.34 +#define USING_DEBRIEF_PAGE 1
   25.35 +#define MIN_RECTUM_ROWS 4
   25.36 +#define MIN_ZIGZAG_ROWS 2
   25.37 +
   25.38 +// On newlib, use a variant of sprintf that doesn't handle floating
   25.39 +// point formats. On other C libraries, use standard sprintf.
   25.40 +#ifdef HAS_FPU
   25.41 +#define siprintf sprintf
   25.42 +#ifndef HAS_FOPEN
   25.43 +#define HAS_FOPEN
   25.44 +#endif
   25.45 +#define DEBRIEF_TO_STDOUT
   25.46 +#endif
   25.47 +
   25.48 +#ifdef HAS_FOPEN
   25.49 +#include "ljpath.h"  // for ljfopen
   25.50 +#endif
   25.51 +
   25.52 +const char *const debriefBoolNames[2] = {
   25.53 +  "Off", "On"
   25.54 +};
   25.55 +
   25.56 +typedef struct TimeResultMSF {
   25.57 +  unsigned int pieces_100m;
   25.58 +  unsigned int garbage_100m;
   25.59 +  unsigned int minutes;
   25.60 +  unsigned char seconds;
   25.61 +  unsigned char frames;
   25.62 +} TimeResultMSF;
   25.63 +
   25.64 +void frames2msf(unsigned int gameTime,
   25.65 +                unsigned int nPieces,
   25.66 +                unsigned int outGarbage,
   25.67 +                TimeResultMSF *out) {
   25.68 +  unsigned int gameSeconds = gameTime / 60U;
   25.69 +  unsigned int gameMinutes = gameSeconds / 60U;
   25.70 +  out->pieces_100m = gameTime
   25.71 +                     ? 360000ULL * nPieces / gameTime
   25.72 +                     : 0;
   25.73 +  out->garbage_100m = gameTime
   25.74 +                      ? 360000ULL * outGarbage / gameTime
   25.75 +                      : 0;
   25.76 +  out->minutes = gameMinutes;
   25.77 +  out->seconds = gameSeconds - gameMinutes * 60U;
   25.78 +  out->frames = gameTime - gameSeconds * 60U;
   25.79 +}
   25.80 +
   25.81 +static unsigned int countBlocksLeft(const LJField *p) {
   25.82 +  unsigned int n = 0;
   25.83 +
   25.84 +  for (int y = 0; y < LJ_PF_HT; ++y) {
   25.85 +    for (int x = 0; x < LJ_PF_WID; ++x) {
   25.86 +      if (p->b[y][x]) {
   25.87 +        ++n;
   25.88 +      }
   25.89 +    }
   25.90 +  }
   25.91 +  return n;
   25.92 +}
   25.93 +
   25.94 +/**
   25.95 + * Calculates the number of rows starting at the bottom that
   25.96 + * conform to a zigzag pattern.
   25.97 + * @param p the playfield to test
   25.98 + * @return the number of rows successfully completed
   25.99 + */
  25.100 +unsigned int calcZigzagGrade(const LJField *p) {
  25.101 +  unsigned int hole = p->leftWall;
  25.102 +  int delta = 1;
  25.103 +
  25.104 +  for (size_t y = 0; y < p->ceiling; ++y) {
  25.105 +
  25.106 +    // invariant:
  25.107 +    // at this point, y equals the number of rows known to conform
  25.108 +    for (size_t x = p->leftWall; x < p->rightWall; ++x) {
  25.109 +      unsigned int blk = p->b[y][x];
  25.110 +
  25.111 +      // A block should be in all cells of the row
  25.112 +      // except for the hole cell, which should be empty.
  25.113 +      if (x == hole) {
  25.114 +
  25.115 +        // if there's a block where a hole should be, this row
  25.116 +        // doesn't conform, but all the rows below do conform
  25.117 +        if (blk) {
  25.118 +          return y;
  25.119 +        }
  25.120 +      } else {
  25.121 +
  25.122 +        // if there's a hole where a block should be, this row
  25.123 +        // doesn't conform, but all the rows below do conform
  25.124 +        if (!blk) {
  25.125 +          return y;
  25.126 +        }
  25.127 +      }
  25.128 +    }
  25.129 +
  25.130 +    // if this hole isn't covered up on the next row,
  25.131 +    // this row doesn't conform either
  25.132 +    // changed in 0.43 after a clarification from Kitaru
  25.133 +    if (!p->b[y + 1][hole]) {
  25.134 +      return y;
  25.135 +    }
  25.136 +
  25.137 +    // by now we know that the row conforms,
  25.138 +    // so move the hole for the next row
  25.139 +    if (hole == p->rightWall - 1) {
  25.140 +      delta = -1;
  25.141 +    } else if (hole == p->leftWall) {
  25.142 +      delta = 1;
  25.143 +    }
  25.144 +    hole += delta;
  25.145 +
  25.146 +  }
  25.147 +  return p->ceiling;
  25.148 +}
  25.149 +
  25.150 +
  25.151 +/**
  25.152 + * Calculates the number of rows in a playfield that were prepared
  25.153 + * for an I tetromino.
  25.154 + * Rule for this pattern:
  25.155 + * 1. Only one hole on the bottom row.
  25.156 + * 2. This column must be unoccupied below the ceiling.
  25.157 + * 3. Conforming rows must be full except for the hole.
  25.158 + *
  25.159 + * Easy test procedure for this pattern:
  25.160 + * Level 4 garbage
  25.161 + * @return the number of rows that conform to constraint 3, or 0 if the
  25.162 + * field does not conform to constraint 1 or 2.
  25.163 + */
  25.164 +unsigned int calcRectumGrade(const LJField *p) {
  25.165 +  unsigned int hole = LJ_PF_WID;
  25.166 +
  25.167 +  // search for the first hole on the bottom row
  25.168 +  for (unsigned int x = p->leftWall;
  25.169 +       x < p->rightWall;
  25.170 +       ++x) {
  25.171 +    if (!p->b[0][x]) {
  25.172 +      hole = x;
  25.173 +      break;
  25.174 +    }
  25.175 +  }
  25.176 +
  25.177 +  // If there is no hole in the bottom row, then 0 rows conform.
  25.178 +  // This shouldn't happen in standard smg because the line would be
  25.179 +  // cleared, but eventually LJ will support games other than SMG,
  25.180 +  // and checking the array bounds is O(1), so why not?
  25.181 +  if (hole >= p->rightWall) {
  25.182 +    return 0;
  25.183 +  }
  25.184 +
  25.185 +  // make sure that the row is clear through the whole visible
  25.186 +  // portion of the playfield
  25.187 +  for (unsigned int y = 0; y < p->ceiling; ++y) {
  25.188 +
  25.189 +    // If this column isn't empty, the whole field doesn't conform.
  25.190 +    if (p->b[y][hole]) {
  25.191 +      return 0;
  25.192 +    }
  25.193 +  }
  25.194 +
  25.195 +  for (unsigned int y = 0; y < p->ceiling; ++y) {
  25.196 +
  25.197 +    // At this point, the bottom y rows conform.
  25.198 +    for (unsigned int x = p->leftWall; x < p->rightWall; ++x) {
  25.199 +
  25.200 +      // Disregarding the hole column, if there's an empty cell
  25.201 +      // in this row, then this row does not conform.
  25.202 +      if (x != hole && !p->b[y][x]) {
  25.203 +        return y;
  25.204 +      }
  25.205 +    }
  25.206 +  }
  25.207 +  return p->ceiling;
  25.208 +}
  25.209 +
  25.210 +/**
  25.211 + * Converts a rank number (0-19) to a text rank.
  25.212 + * 0-9: 10-1 kyu; 10-99: 1-90 dan; 100+: grandmaster
  25.213 + * @return number of characters written
  25.214 + */
  25.215 +static size_t printSecretGrade(char *dst, int rank) {
  25.216 +  if (rank >= 100) {
  25.217 +    return siprintf(dst, "GM");
  25.218 +  } else if (rank >= 10) {
  25.219 +    return siprintf(dst, "S%d", rank - 9);
  25.220 +  } else {
  25.221 +    return siprintf(dst, "%d", 10 - rank);
  25.222 +  }
  25.223 +}
  25.224 +
  25.225 +static size_t printFracG(char *dst, unsigned int value) {
  25.226 +  if (value == 0) {
  25.227 +    return siprintf(dst, "Instant");
  25.228 +  } else if (value == 1) {
  25.229 +    return siprintf(dst, "1G");
  25.230 +  } else {
  25.231 +    return siprintf(dst, "1/%dG", value);
  25.232 +  }
  25.233 +}
  25.234 +
  25.235 +#include <string.h>  // remove once fourcc transition is complete
  25.236 +static size_t printFourCC(char *dst, FourCC f) {
  25.237 +  const char *data = ljGetFourCCName(f);
  25.238 +  if (data) {
  25.239 +    int pos = 0;
  25.240 +    for(pos = 0; *data; ++pos) {
  25.241 +      dst[pos] = *data++;
  25.242 +    }
  25.243 +    return pos;
  25.244 +  } else {
  25.245 +    int pos = 0;
  25.246 +    for(pos = 0; f.c[pos] && pos < 4; ++pos) {
  25.247 +      dst[pos] = f.c[pos];
  25.248 +    }
  25.249 +    return pos;
  25.250 +  }
  25.251 +}
  25.252 +
  25.253 +size_t buildOptionsReportPage(char *dst, const LJView *v) {
  25.254 +  size_t pos = 0;
  25.255 +  
  25.256 +
  25.257 +#if USING_DEBRIEF_PAGE
  25.258 +  const LJField *p = v->field;
  25.259 +
  25.260 +  pos += siprintf(dst + pos,
  25.261 +                  "Options\n\n"
  25.262 +                  "Well: %dx%d%s, Enter: %s\n"
  25.263 +                  "Speed: ",
  25.264 +                  p->rightWall - p->leftWall,
  25.265 +                  p->ceiling,
  25.266 +                  v->hidePF ? " invisible" : "",
  25.267 +                  p->enterAbove ? "Above" : "Below");
  25.268 +  pos += printFourCC(dst + pos, 
  25.269 +             optionsSpeedCurveNames[(size_t)p->speedState.curve]);
  25.270 +  pos += siprintf(dst + pos,
  25.271 +                  ", ARE: %d ms\n"
  25.272 +                  "Randomizer: ",
  25.273 +                  v->field->areStyle * 50 / 3);
  25.274 +  pos += printFourCC(dst + pos, 
  25.275 +                     optionsRandNames[(size_t)p->randomizer]);
  25.276 +  pos += siprintf(dst + pos, " of ");
  25.277 +  pos += printFourCC(dst + pos, 
  25.278 +                     optionsPieceSetNames[(size_t)p->pieceSet]);
  25.279 +  pos += siprintf(dst + pos, "\nHold: ");
  25.280 +  pos += printFourCC(dst + pos, 
  25.281 +                     optionsHoldStyleNames[(size_t)p->holdStyle]);
  25.282 +  pos += siprintf(dst + pos, ", Rotation: ");
  25.283 +  pos += printFourCC(dst + pos, 
  25.284 +                     optionsRotNames[(size_t)p->rotationSystem]);
  25.285 +  if (p->maxUpwardKicks < 20) {
  25.286 +    pos += siprintf(dst + pos,
  25.287 +                    " %d FK",
  25.288 +                    (int)p->maxUpwardKicks);
  25.289 +  }
  25.290 +  if (v->control->initialRotate) {
  25.291 +    pos += siprintf(dst + pos, "+initial");
  25.292 +  }
  25.293 +
  25.294 +  pos += siprintf(dst + pos,
  25.295 +                  "\nLock: ");
  25.296 +  if (p->setLockDelay >= 128) {
  25.297 +    pos += siprintf(dst + pos, "Never");
  25.298 +  } else {
  25.299 +    if (p->setLockDelay > 0) {
  25.300 +      pos += siprintf(dst + pos,
  25.301 +                       "%d ms ",
  25.302 +                       p->setLockDelay * 50 / 3);
  25.303 +    }
  25.304 +    pos += printFourCC(dst + pos, 
  25.305 +                       optionsLockdownNames[(size_t)p->lockReset]);
  25.306 +  }
  25.307 +  pos += siprintf(dst + pos,
  25.308 +                   ", Deep: %s\n",
  25.309 +                   debriefBoolNames[p->bottomBlocks]);
  25.310 +
  25.311 +  pos += siprintf(dst + pos,
  25.312 +                  "Line clear: %d ms ",
  25.313 +                  p->speed.lineDelay * 50 / 3);
  25.314 +  pos += printFourCC(dst + pos,
  25.315 +                     optionsGravNames[(size_t)p->clearGravity]);
  25.316 +  pos += siprintf(dst + pos,
  25.317 +                  ", Gluing: ");
  25.318 +  pos += printFourCC(dst + pos,
  25.319 +                     optionsGluingNames[(size_t)p->gluing]);
  25.320 +  pos += siprintf(dst + pos,
  25.321 +                  "\nDrop score: ");
  25.322 +  pos += printFourCC(dst + pos,
  25.323 +                optionsDropScoringNames[(size_t)p->dropScoreStyle]);
  25.324 +  pos += siprintf(dst + pos,
  25.325 +                  ", T-spin: ");
  25.326 +  pos += printFourCC(dst + pos,
  25.327 +                     optionsTspinNames[(size_t)p->tSpinAlgo]);
  25.328 +  pos += siprintf(dst + pos,
  25.329 +                  "\nGarbage: ");
  25.330 +  pos += printFourCC(dst + pos,
  25.331 +                     optionsGarbageNames[(size_t)p->garbageStyle]);
  25.332 +  pos += siprintf(dst + pos,
  25.333 +                   ", DAS: %d ms ",
  25.334 +                   v->control->dasDelay * 50 / 3);
  25.335 +  pos += printFracG(dst + pos, v->control->dasSpeed);
  25.336 +  pos += siprintf(dst + pos,
  25.337 +                   "\nSoft drop: ");
  25.338 +  pos += printFracG(dst + pos, v->control->softDropSpeed + 1);
  25.339 +  dst[pos++] = ' ';
  25.340 +  pos += printFourCC(dst + pos,
  25.341 +                     optionsZangiNames[v->control->softDropLock]);
  25.342 +  pos += siprintf(dst + pos,
  25.343 +                  ", Hard drop: ");
  25.344 +  pos += printFourCC(dst + pos,
  25.345 +                     optionsZangiNames[v->control->hardDropLock]);
  25.346 +  pos += siprintf(dst + pos, "\nShadow: ");
  25.347 +  pos += printFourCC(dst + pos,
  25.348 +                     optionsShadowNames[v->hideShadow]);
  25.349 +  pos += siprintf(dst + pos,
  25.350 +                  ", Next: %d\n",
  25.351 +                  v->nextPieces);
  25.352 +#else
  25.353 +  pos += siprintf(dst, "\n\nDebrief disabled.\n");
  25.354 +#endif
  25.355 +
  25.356 +  dst[pos] = 0;
  25.357 +  return pos;
  25.358 +}
  25.359 +
  25.360 +#ifdef DEBRIEF_SHORT
  25.361 +static const char *const naiveGravity[8] = {
  25.362 +  "1L", "2L", "3L", "4L",
  25.363 +  "T1", "T2", "T3"
  25.364 +};
  25.365 +static const char *const cascadeGravity[8] = {
  25.366 +  "1L", "2L", "3L", "4L",
  25.367 +  "5L", "6L", "7L", "8L+"
  25.368 +};
  25.369 +#else
  25.370 +static const char *const naiveGravity[8] = {
  25.371 +  "single", "double", "triple", "home run",
  25.372 +  "T single", "T double", "T triple"
  25.373 +};
  25.374 +static const char *const cascadeGravity[8] = {
  25.375 +  "single", "double", "triple", "quad",
  25.376 +  "5L", "6L", "7L", "8L+"
  25.377 +};
  25.378 +#endif
  25.379 +
  25.380 +static size_t printLineCounts(char *dst, const LJField *p) {
  25.381 +  size_t pos = 0;
  25.382 +  const char *const *names = (p->clearGravity == LJGRAV_NAIVE)
  25.383 +                             ? naiveGravity : cascadeGravity;
  25.384 +  dst[pos++] = '(';
  25.385 +  for (int i = 0; i < 8; ++i) {
  25.386 +    if (names[i]) {
  25.387 +      pos += siprintf(dst + pos,
  25.388 +                      "%s%s: %u",
  25.389 +                      i ? "; " : "",
  25.390 +                      names[i],
  25.391 +                      p->nLineClears[i]);
  25.392 +    }
  25.393 +  }
  25.394 +  dst[pos++] = ')';
  25.395 +  dst[pos++] = '\n';
  25.396 +  return pos;
  25.397 +}
  25.398 +
  25.399 +
  25.400 +size_t buildDebriefPage(char *dst, const LJView *v) {
  25.401 +  size_t pos = 0;
  25.402 +
  25.403 +#if USING_DEBRIEF_PAGE
  25.404 +#ifndef NO_DATETIME
  25.405 +  const time_t finishTimeUNIX = time(NULL);
  25.406 +  const struct tm *finishTime = localtime(&finishTimeUNIX);
  25.407 +  char finishTimeStr[64];
  25.408 +  
  25.409 +  /* I would have used
  25.410 +  strftime(finishTimeStr, sizeof(finishTimeStr), "%Y-%m-%d at %H:%M", finishTime);
  25.411 +  but it brings in the floating-point library on GBA/DS. */
  25.412 +  siprintf(finishTimeStr,
  25.413 +           "%04d-%02d-%02d at %02d:%02d",
  25.414 +           finishTime->tm_year + 1900,
  25.415 +           finishTime->tm_mon + 1, finishTime->tm_mday,
  25.416 +           finishTime->tm_hour, finishTime->tm_min);
  25.417 +#endif
  25.418 +
  25.419 +  const LJField *p = v->field;
  25.420 +  unsigned long int keys_100m = p->nPieces
  25.421 +                                ? 100U * v->control->presses / p->nPieces
  25.422 +                                : 666;
  25.423 +  TimeResultMSF gameMSF, activeMSF;
  25.424 +  const char *wordPieces = (p->nPieces != 1) ? "tetrominoes" : "tetromino";
  25.425 +  if (p->pieceSet == LJRAND_234BLK) {
  25.426 +    wordPieces = (p->nPieces != 1) ? "pieces" : "piece";
  25.427 +  }
  25.428 +  
  25.429 +  /* Secret grades */
  25.430 +  unsigned int nBlocksLeft = countBlocksLeft(p);
  25.431 +  unsigned int nZigzagRows = calcZigzagGrade(p);
  25.432 +  unsigned int nRectumRows = calcRectumGrade(p);
  25.433 +
  25.434 +  pos += siprintf(dst + pos,
  25.435 +                   "Result:\n\n%s ",
  25.436 +                   v->control->countdown <= 0 ? "Cleared" : "Stopped");
  25.437 +  pos += printFourCC(dst + pos, gimmickNames[p->gimmick]);
  25.438 +  pos += siprintf(dst + pos,
  25.439 +                  " at level %d\n",
  25.440 +                  p->speedState.level);
  25.441 +#if !defined(NO_DATETIME) || defined(WITH_REPLAY)
  25.442 +#ifndef NO_DATETIME
  25.443 +  pos += siprintf(dst + pos, "on %s", finishTimeStr);
  25.444 +#endif
  25.445 +#ifdef WITH_REPLAY
  25.446 +  if (p->reloaded) {
  25.447 +    pos += siprintf(dst + pos, " from saved state");
  25.448 +  }
  25.449 +#endif
  25.450 +  dst[pos++] = '\n';
  25.451 +#endif
  25.452 +
  25.453 +  frames2msf(p->gameTime, p->nPieces, p->outGarbage, &gameMSF);
  25.454 +  frames2msf(p->activeTime, p->nPieces, p->outGarbage, &activeMSF);
  25.455 +
  25.456 +  pos += siprintf(dst + pos,
  25.457 +                   "Played %d %s in %u:%02u.%02u (%u.%02u/min)\n",
  25.458 +                   p->nPieces,
  25.459 +                   wordPieces,
  25.460 +                   gameMSF.minutes,
  25.461 +                   (unsigned int)gameMSF.seconds,
  25.462 +                   gameMSF.frames * 5U / 3U,
  25.463 +                   (unsigned int) (gameMSF.pieces_100m / 100),
  25.464 +                   (unsigned int) (gameMSF.pieces_100m % 100));
  25.465 +  pos += siprintf(dst + pos,
  25.466 +                   "(active time only: %u:%02u.%02u, %u.%02u/min)\n",
  25.467 +                   activeMSF.minutes,
  25.468 +                   (unsigned int)activeMSF.seconds,
  25.469 +                   activeMSF.frames * 5U / 3U,
  25.470 +                   (unsigned int) (activeMSF.pieces_100m / 100),
  25.471 +                   (unsigned int) (activeMSF.pieces_100m % 100));
  25.472 +  pos += siprintf(dst + pos,
  25.473 +                   "Pressed %u keys (%u.%02u/piece)\n\n",
  25.474 +                   v->control->presses,
  25.475 +                   (unsigned int) (keys_100m / 100),
  25.476 +                   (unsigned int) (keys_100m % 100));
  25.477 +
  25.478 +  pos += siprintf(dst + pos,
  25.479 +                  "Made %u lines",
  25.480 +                  p->lines);
  25.481 +  if (p->gluing == LJGLUING_SQUARE) {
  25.482 +    pos += siprintf(dst + pos,
  25.483 +                    " and %u pure + %u squares",
  25.484 +                    p->monosquares, p->multisquares);
  25.485 +  }
  25.486 +  dst[pos++] = '\n';
  25.487 +  pos += printLineCounts(dst + pos, p);
  25.488 +  pos += siprintf(dst + pos,
  25.489 +                   "Sent %u garbage (%u.%02u per minute)\n",
  25.490 +                   p->outGarbage,
  25.491 +                   (unsigned int) (gameMSF.garbage_100m / 100),
  25.492 +                   (unsigned int) (gameMSF.garbage_100m % 100));
  25.493 +  if (nZigzagRows >= MIN_ZIGZAG_ROWS) {
  25.494 +    pos += siprintf(dst + pos,
  25.495 +                    "Made %u rows of > for grade ",
  25.496 +                    nZigzagRows);
  25.497 +    pos += printSecretGrade(dst + pos,
  25.498 +                            nZigzagRows >= 19 ? 100 : nZigzagRows);
  25.499 +  } else if (nRectumRows >= MIN_RECTUM_ROWS) {
  25.500 +    pos += siprintf(dst + pos,
  25.501 +                    "Made %u-row rectum for grade ",
  25.502 +                    nRectumRows);
  25.503 +    pos += printSecretGrade(dst + pos,
  25.504 +                            nRectumRows >= 20 ? 100 : nRectumRows - 1);
  25.505 +  } else if (nBlocksLeft >= 110 && nBlocksLeft <= 111) {
  25.506 +    pos += siprintf(dst + pos,
  25.507 +                    "Secret grade: Eleventy%s",
  25.508 +                    (nBlocksLeft & 1) ? "-one" : "");
  25.509 +  } else {
  25.510 +    pos += siprintf(dst + pos,
  25.511 +                    "Left %d blocks behind",
  25.512 +                    nBlocksLeft);
  25.513 +  }
  25.514 +  dst[pos++] = '\n';
  25.515 +  dst[pos++] = '\n';
  25.516 +  pos += printFourCC(dst + pos, optionsScoringNames[p->scoreStyle]);
  25.517 +
  25.518 +  pos += siprintf(dst + pos,
  25.519 +                   " score: %d\n",
  25.520 +                   p->score);
  25.521 +  
  25.522 +      /*
  25.523 +      tod stats not in lj
  25.524 +
  25.525 +        points/line, 40 lines score, silver squares, gold squares
  25.526 +        
  25.527 +        */
  25.528 +
  25.529 +#else
  25.530 +  pos += siprintf(dst, "\n\nDebrief disabled. Score: %u\n", v->field->score);
  25.531 +#endif
  25.532 +  return pos;
  25.533 +}
  25.534 +
  25.535 +void debriefDrawPage(const char *page, size_t pageNumber);
  25.536 +LJBits debriefHandleKeys(void);
  25.537 +extern volatile char redrawWholeScreen;
  25.538 +
  25.539 +
  25.540 +/**
  25.541 + * Reports the player's performance.
  25.542 + */
  25.543 +void debrief(LJView *v) {
  25.544 +  char pageData[2000];  // current length is under 1000 chars
  25.545 +  char *page[2] = {pageData, "Page coming soon!"};
  25.546 +  int curPage = 0;
  25.547 +  
  25.548 +  {
  25.549 +    size_t pos;
  25.550 +
  25.551 +    pos = buildDebriefPage(page[0], v);
  25.552 +    page[1] = page[0] + (++pos);
  25.553 +    pos += buildOptionsReportPage(page[1], v);
  25.554 +  }
  25.555 +#ifdef HAS_FOPEN
  25.556 +  FILE *logFile = ljfopen("lj-scores.txt", "at");
  25.557 +  if (logFile) {
  25.558 +    fputs("\n\n\n", logFile);
  25.559 +    fputs(page[0], logFile);
  25.560 +    fputs(page[1], logFile);
  25.561 +#ifdef DEBRIEF_TO_STDOUT
  25.562 +    fputs(page[0], stdout);
  25.563 +    fputs(page[1], stdout);
  25.564 +#endif
  25.565 +    fclose(logFile);
  25.566 +  }
  25.567 +#endif
  25.568 +
  25.569 +  LJBits lastKeys = ~0;
  25.570 +  redrawWholeScreen = 1;
  25.571 +  debriefHandleKeys();  // call once to clear key buffer
  25.572 +
  25.573 +  for (;;) {
  25.574 +    LJBits sounds = 0;
  25.575 +
  25.576 +    if (redrawWholeScreen) {
  25.577 +      redrawWholeScreen = 0;
  25.578 +      debriefDrawPage(page[curPage], curPage);
  25.579 +    }
  25.580 +    LJBits keys = debriefHandleKeys();
  25.581 +    LJBits newKeys = keys & ~lastKeys;
  25.582 +
  25.583 +    if (newKeys & VKEY_LEFT) {
  25.584 +      if (curPage > 0) {
  25.585 +        curPage -= 1;
  25.586 +        redrawWholeScreen = 1;
  25.587 +        sounds |= LJSND_HOLD;
  25.588 +      }
  25.589 +    }
  25.590 +    
  25.591 +    if (newKeys & VKEY_RIGHT) {
  25.592 +      if (curPage + 1 < sizeof(page) / sizeof(page[0])) {
  25.593 +        curPage += 1;
  25.594 +        redrawWholeScreen = 1;
  25.595 +        sounds |= LJSND_HOLD;
  25.596 +      }
  25.597 +    }
  25.598 +    
  25.599 +    if (newKeys & (VKEY_ROTR | VKEY_ROTL)) {
  25.600 +      break;
  25.601 +    } else {
  25.602 +      lastKeys = keys;
  25.603 +    }
  25.604 +    playSoundEffects(v, sounds, 100);
  25.605 +  }
  25.606 +}