From 669ae779591f9f1d6adb8a73b75b29f398ced7bd Mon Sep 17 00:00:00 2001
From: Vince Weaver <vince@deater.net>
Date: Wed, 4 Apr 2018 01:13:25 -0400
Subject: [PATCH] mode7: update writeup

---
 mode7_demo/docs/figures/hidden_vmw.png | Bin 18547 -> 15818 bytes
 mode7_demo/docs/mode7_demo.tex         | 531 ++++++++++++++-----------
 2 files changed, 295 insertions(+), 236 deletions(-)

diff --git a/mode7_demo/docs/figures/hidden_vmw.png b/mode7_demo/docs/figures/hidden_vmw.png
index ed60bd6b40b2b13413dba97550ed5433ed6bfc2c..11677d7624477512366452383d6d5e28fa44a4c9 100644
GIT binary patch
literal 15818
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
UA#086+W-In07*qoM6N<$f(f(!8UO$Q

literal 18547
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

diff --git a/mode7_demo/docs/mode7_demo.tex b/mode7_demo/docs/mode7_demo.tex
index 31c8124f..fa79ef50 100644
--- a/mode7_demo/docs/mode7_demo.tex
+++ b/mode7_demo/docs/mode7_demo.tex
@@ -7,34 +7,37 @@
 \begin{document}
 
 \title{Making an 8k Low-resolution Graphics Demo for the Apple II}
-\author{DEATER, AKA Vincent M. Weaver}
+\author{by DEATER, AKA Vincent M. Weaver}
 \date{}
 \maketitle
 
 \section{Why would anyone do this?}
 
-I was making an inside-joke filled game for my retro system of choice,
-the Apple II.
-This involves a Final-Fantasy flying-over-the-planet scene, and while
-I was originally going to fake this I found that it was just barely
+While making an inside-joke filled game for my retro system of choice,
+the Apple II, I needed to create a Final-Fantasy-esque
+flying-over-the-planet sequence.
+I was originally going to fake this, but then I found that it was just barely
 possible to achieve this in real time.
-
-Once I got it working I realized this would be great as part of a
+Once I got the code working I realized it would be great as part of a
 graphics demo, so off on that tangent I went.
-This despite the fact that all I know about the demoscene I learned
-from a few viewings of the Future Crew Second Reality Demo plus some
-dimly remembered Commodore 64 and Amiga flamewars from a few decades ago.
+This went well, despite the fact that all I know about the demoscene I learned
+from a few viewings of the Future Crew {\em Second Reality} demo mixed with
+dimly remembered Commodore 64 and Amiga flamewars.
 
+% from a few decades ago.
 %  This started out as some SNES style mode7 pseudo-3d graphics code
 %  I came up with while working on my TF7 game.  The graphics looked
 %  pretty cool, so I started developing a demo around it.
 
-To make thins even better, the code ended up being roughly around 8kB so a
-lot of time was wasted fitting it under that arbitrary size limitation.
+%To make thins even better, the code ended up being roughly around 8kB so a
+%lot of time was wasted fitting it under that arbitrary size limitation.
 
-So in the end this ends up being impressive mostly because so few people
-have bothered to write demos for this particular platform.
-Though I must make a shout out to the FrenchTouch group whose Apple II
+While I hope you enjoy the description of the demo and the work that
+went into it, I do suspect the whole enterprise is only of note
+because so few people write demos for the Apple II platform.
+%So in the end this ends up being impressive mostly because so few people
+%have bothered to write demos for this particular platform.
+I would like to make a shout out to the FrenchTouch group whose Apple II
 demos put this one to shame.
 
 %  The codesize ended up being roughly around 8kB, so I thought I'd
@@ -86,78 +89,91 @@ demos put this one to shame.
 
 \section{The Hardware}
 
-	The Apple II was introduced in 1977.
-	This demo should run on an original system, though I do not
-	have hardware that old to test on.
-	Note this predates the Commodore 64 by five years.
+The Apple II was introduced in 1977.
+This demo should run on an original system, though I do not
+have hardware quite that old to test on.
+I like to troll C64 fans by noting this predates the Commodore 64 by 
+five years.
 
-	{\bf CPU, RAM and Storage}
+\vspace{1ex}
+\noindent
+{\bf CPU, RAM and Storage:}
 
-	The Apple II has a 6502 processor running at roughly 1.023MHz.
+The Apple II has a 6502 processor running at roughly 1.023MHz.
+Early models only shipped with 4k of RAM, but later 48k, 64k, and 128k
+systems were common.
+While the demo itself fits in 8k, it decompresses to a larger size and uses
+a full 48k of RAM;
+this would have been very expensive in 1977.
 
-	Early models only shipped with 4k of RAM, but later 48k, 64k, and 128k
-	systems were common.
-	The demo requires 48k; this would have been very expensive in 1977.
-
-	Also in 1977 you would probably be loading this from cassette tape, as
-	it would be another year before Woz's single-sided
-	$5\frac{1}{4}$" Disk II came about (eventually offering 140k of
-	storage per side with the release of Apple DOS3.3 in 1980). 
+Also in 1977 you would probably be loading this from cassette tape.
+It would be another year before Woz's single-sided
+$5\frac{1}{4}$" Disk II came about (eventually offering 140k of
+storage per side with the release of Apple DOS3.3 in 1980). 
 	
-	{\bf Sound}
+\vspace{1ex}
+\noindent
+{\bf Sound:}
 
-	The only sound available is a bit-banged speaker.
-	There was no timer interrupt,
-	if you wanted music you had to cycle-count via the CPU.
+The only sound available in a stock Apple II is a bit-banged speaker.
+There was no timer interrupt; if you wanted music you had to cycle-count
+via the CPU to get the waveforms you needed.
 
-	This demo uses the Mockingboard soundcard which was introduced in
-	1981.  This board is extremely simple, with dual AY-3-8910 sound
-	chips controlled by 6522 I/O chips.
-	Each chip provides 3 channels of square waves, with noise and
-	envelope effects available.
+The demo uses a Mockingboard soundcard which was introduced in 1981.
+This board contains dual AY-3-8910 sound generation chips connected via
+6522 I/O chips.
+Each sound chip provides 3 channels of square waves as well as noise and
+envelope effects.
 
-	{\bf Graphics}
+\vspace{1ex}
+\noindent
+{\bf Graphics:}
 
-	The Apple II had nice graphics for its time, with this time being
-	around 1977.  Otherwise it is quite limited.
+It is hard to imagine now, but the Apple II had nice graphics for its time.
+Compared to later competitors, however, it had some limitations.
 
-	\begin{center}
-	\begin{tabular}{|c|c|}
-	\hline
-	Hardware Sprites     &	No \\
-	Linear framebuffer   &	No \\
-	User-defined charset &	No \\
-	Blanking interrupts  &	No \\
-	Palette selection    &	No \\
-	Hardware scrolling   &	No \\
-	Hardware page flip   &	Yes \\
-	\hline
-	\end{tabular}
-	\end{center}
+\begin{center}
+\begin{tabular}{|c|c|}
+\hline
+Hardware Sprites     &	No \\
+User-defined charset &	No \\
+Blanking interrupts  &	No \\
+Palette selection    &	No \\
+Linear framebuffer   &	No \\
+Hardware scrolling   &	No \\
+Hardware page flip   &	Yes \\
+\hline
+\end{tabular}
+\end{center}
 
-	The hi-res graphics mode was a complex mess of NTSC hacks by Woz.
-	You got 280x192 graphics, with 6 colors available.  However the colors
-	were from NTSC artifacts and there were limitations on which colors
-	could be next to each other (in blocks of 3.5 pixels) as well as
-	fringing.  Also the addresses were interleaved, so not a linear
-	framebuffer.  Hi-res page0 is at
-	\$2000\footnote{On 6502 systems hexadecimal values are 
-	indicated by the dollar sign}
-	 and page1 at \$4000.
-	Optionally 4 lines of text can be shown at the bottom of the
-	screen instead of graphics.
+The hi-res graphics mode was a complex mess of NTSC hacks by Woz.
+You got approximately 280x192 resolution, with 6 colors available.
+However the colors were from NTSC artifacts and there were limitations 
+on which colors could be next to each other (in blocks of 3.5 pixels).
+There was plenty of fringing on edges, and colors changed depending on
+whether they were drawn at odd or even pixels.
+To add to the madness, the framebuffer is interleaved in a complex way,
+and pixels are drawn least-significant-bit first (all of this to make
+DRAM refresh better and to shave a few 7400 series logic chips from the design).
+You do get two pages of graphics, Page 1 is at
+\$2000\footnote{On 6502 systems hexadecimal values are 
+indicated by the dollar sign}
+and Page 2 at \$4000.
+Optionally 4 lines of text can be shown at the bottom of the
+screen instead of graphics.
 
-	The lo-res mode is a bit easier to use.  It is 40x48 blocks
-	(40x40 if 4 lines of text are displayed at the bottom).
-	15 colors are available, though there is fringing at the edges.
-	Again the addresses are interleaved.  Lo-res page0 is at \$400
-	and page1 is at \$800.
+The lo-res mode is a bit easier to use.  
+It provides 40x48 blocks (40x40 if the four
+lines of text are displayed at the bottom).
+Fifteen colors are available (there are two greys which are indistinguishable).
+Again the addresses are interleaved.  Lo-res Page 1 is at \$400
+and Page 2 is at \$800.
 
-	Some amazing effects can be achieved by cycle counting, reading
-	the floating bus, and racing the beam while toggling graphics
-	modes on the fly.
-	Unfortunately for you this demo does not do any of those things
-	so you will not be reading about that today.
+Some amazing effects can be achieved by cycle counting, reading
+the floating bus, and racing the beam while toggling graphics
+modes on the fly.
+Unfortunately for you this demo does not do any of those things
+so you will not be reading about that today.
 
 %Later models added double low-res (80x48) and double hi-res (x y in
 %NTSC 15 color) but didn't appear until 198x, and only on later IIe, IIc
@@ -168,19 +184,20 @@ demos put this one to shame.
 %sadness of the users (Apple II forever).
 
 
-\section{Setup Ramblings}
+\section{Development Setup}
 
-I do my development on Linux, using the nano text editor.  I use the
-ca65 assembler from the cc65 project, which I find to be a reasonable
-tool although most ``real'' Apple II programmers look down on it for some
+I do all of my coding under Linux, using the nano text editor.
+I use the ca65 assembler from the cc65 project, which I find to be a reasonable
+tool although many ``real'' Apple II programmers look down on it for some
 reason.
+I cross-compile the code, construct Apple DOS3.3 disk images using
+custom tools I have written, and then do most testing in an emulator.
+AppleWin (run under the wine emulator) is the easiest to use, but
+MESS/MAME has cleaner sound.
 
-I cross-compile on x86 Linux, construct Apple DOS33 disk images using
-some tools I've written, and then do most testing in an emulator.
-(These days usually AppleWin under the wine emulator, or else MESS/MAME
-which has cleaner sound output).  Once things work then I'll stick things
-on a USB stick and transfer to the CFFA3000 disk emulator installed in
-the actual Apple II.
+Once the code appears to work, I put it on a USB stick and transfer
+to actual hardware using a CFFA3000 disk emulator installed in
+the actual Apple II (an Apple IIe platinum edition).
 
 %\section{Related Work}
 %
@@ -197,137 +214,167 @@ the actual Apple II.
 
 \subsection{BOOTLOADER}
 
-   An Applesoft BASIC "HELLO" program loads the binary.
-   This just makes things auto-boot at startup, this doesn't count
-   towards the executable size, you could manually BRUN the 8k program
-   if you wanted.
+An Applesoft BASIC ``HELLO'' program loads the binary automatically at bootup.
+This does not count towards the executable size, as you could manually BRUN 
+the 8k program if you wanted.
 
-   The binary is loaded at \$2000 (hi-res page0) and BASIC kicks into
-   HIRES mode before loading so you can watch as the memory is loaded
-   from disk in a seemingly random pattern.
+To make the loading time slightly more interesting the binary is loaded at
+address \$2000 (hi-res page1) and BASIC is nice enough to enable
+graphics mode first so you can watch the display get filled with the random
+pattern of the compressed image.
+This entirely fills the 8k of the display, or would
+if we POKEd the right address to turn off
+the 4 lines of text on the bottom of the screen.
 
-   Since this is an 8k demo, the entirety of the program is shown on
-   the screen (or would be if we POKEd the right address to turn off
-   the 4 lines of text on the bottom of the screen).
-
-   Execution starts at address \$2000
+Upon loading, execution starts at address \$2000
 
 \subsection{DECOMPRESSER}
 
+\begin{figure}[tb]
+\begin{center}
+\includegraphics[width=2in]{figures/hidden_vmw.png}
+\end{center}
+\caption{VMW logo hidden in the executable data.\label{fig:vmw}}
+\end{figure}
 
-   The binary is LZ4 encoded.  The decompresser flips to HGR page 1 so
-   we can watch memory as the program is decompressed.
+The binary is encoded with the LZ4 algorithm.
+We flip to hi-res Page 2 and decompress there so the user continues to get
+a show of random noise.
 
-   The LZ4 decompression code was written by qkumba (Peter Ferrie).
-	http://pferrie.host22.com/misc/appleii.htm
+The 6502 size-optimized LZ4 decompression code was written by qkumba
+(Peter Ferrie).
+%	http://pferrie.host22.com/misc/appleii.htm
+The program and data decompress to around 22k starting at \$4000.
+It over-writes parts of DOS3.3, but since we will not be using the disk 
+any more this is not an issue.
 
-   The actual program/data decompresses to around 22k starting at \$4000.
-   It over-writes parts of DOS3.3, but since we won't be using the disk 
-   anymore this isn't an issue.
+If you look carefully at the upper left corner of the screen during
+decompress you will see my triangular logo, which is supposed to evoke
+my VMW initials (see Figure~\ref{fig:vmw}).
+To do this I had to put the proper bit pattern at the interleaved
+addresses of \$4000, \$4400, \$4800, and \$4C00.  
+This turned out to be way more trouble than it was worth.
+As an interesting note, the image data at \$4000 is executed as it maps
+to (mostly) harmless code.
 
-   At the top left corner of the screen you'll see the VMW triangles logo
-   as it decompresses.  To do this I had to put the proper bit pattern
-   at \$4000, \$4400, \$4800, and \$4C00.  I mean to have some words too
-   but ran out of disk space.  The bit pattern at \$4000 is executable
-   and is run as code.
-
-   Optimizing for code size inside of a compressed binary is a pain.
-   Removing instructions sometimes made the binary larger as it no longer
-   compressed as well.  Long runs of values (such as 0 padding) are 
-   essentially free.  This was a difficult challenge.
+The demo was optimized to fit in 8k, and this is difficult when your program
+is compressed.
+Removing instructions sometimes makes the binary {\em larger} as it no longer
+compresses as well.
+Long runs of values (such as 0 padding) are essentially free.
+This mostly turned into an exercise of guess-and-check until everything fit.
 
 \subsection{FADE EFFECT}
 
-  The title screen fades in from black.
+The title screen fades in from black.
 
-  This is a software hack, with a lookup table copying from an off-screen
-  buffer.  The Apple II doesn't have any palette support.
+This is a software hack as the Apple II does not have palette support.
+The image is loaded to an off-screen buffer and a lookup table is used to
+copy in the faded versions on the fly.
 
 \subsection{TITLE SCREEN}
 
-   Once things are decompressed, we jump to \$4000.  We switch to low-res
-   mode for the rest of the DEMO.
+\begin{figure}[tb]
+\begin{center}
+\includegraphics[width=\columnwidth]{figures/mode7_demo_title.png}
+\end{center}
+\caption{The title screen.\label{fig:title}}
+\end{figure}
 
-   A background image is loaded from disk.  This is RLE encoded (probably
-   unnecessary when being further LZ4 encoded).
+Once decompression is done, execution continues at address \$4000.
+We switch to low-res mode for the rest of the demo.
 
-   Why not just load the program at \$400 and load the graphics image for
-   free?  Well, remember the graphics are 40x48 (shared with the text).
-   Really it's 40x24, with each text char mapping to 4-bits top/bottom
-   for color.  Do the math, we have 1k reserved for this mode but 40x24
-   is only 960 bytes.  It turns out there are "holes" in the address range
-   that aren't displayed, and various pieces of hardware use these holes
-   as scratchpad memory.  So if you just blindly uncompress graphics data
-   there you can corrupt the scratchpad.  So you have to be careful
-   when uncompressing to skip the holes.
+A title screen is loaded, as seen in Figure~\ref{fig:title}.
+The image is run-length encoded (RLE) which is
+probably unnecessary when being further LZ4 encoded.
+(The LZ4 compression was a late addition to this endeavor).
 
-   The title screen has scrolling text at the bottom.  This is nothing fancy,
-   the text is in a buffer off screen and a 40x4 chunk of RAM is copied in
-   every so many cycles.
+Why not save some space and just load our demo at \$400 and negate the need
+to copy the image in place?
+Remember the graphics are 40x48 (shared with the text display region).
+It might be easier to think of it as 40x24 characters, with the top / bottom
+4-bits of each ASCII character being interpreted as colors for a half-height
+block.
+If you do the math you will find this takes 960 bytes of space, but the memory
+map reserves 1k for this mode.
+There are ``holes'' in the address range that are not displayed, and 
+various pieces of hardware can use these as scratchpad memory.  
+This means just overwriting the whole 1k with data might not work out well
+unless you know what you are doing.
+To this end the RLE decompression code skips the holes just to be safe.
 
-   You might notice that there is tearing/jitter in the scrolling, even
-   though we are double-buffering the graphics.  This is because there is
-   not a reliable cross-platform way to get the VBLANK info (especially
-   on older machines) so we are having some bad luck about when we flip
-   pages.
+The title screen has scrolling text at the bottom.
+This is nothing fancy, the text is in a buffer off screen and a 40x4 
+chunk of RAM is copied in every so many cycles.
+You might notice that there is tearing/jitter in the scrolling even
+though we are double-buffering the graphics.  
+Sadly there is not a reliable cross-platform way to get the VBLANK info 
+on Apple II machines, especially the older models.
+This is even more noticeable in the recorded video, as the capture card and
+movie encoding conspire to make this look worse than things look in person.
 
 \subsection{MOCKINGBOARD MUSIC}
 
-   I like chiptune music, especially that for AY-3-8910 based systems.
-   Before obtaining a Mockingboard I built a Raspberry Pi chiptune player
-   that is essentially the same hardware.
+No demo is complete without some exciting background music.
+I like chiptune music, especially the kind you can find that is made
+for AY-3-8910 based systems.
+I gained some expertise during the long wait for my Mockingboard to arrive
+by building a Raspberry Pi chiptune player that is essentially the same
+hardware.
 
-   Most of my sound infrastructure involves YM5 files, which are often used
-   by ZX Spectrum and ATARI ST users.  These are usually register dumps
-   taken typically at 50Hz.  So to play them back you just have to interrupt
-   50 times a second and write the registers.
+The song being played is a stripped down and re-arranged version of
+``Electric Wave'' from CC'00 by EA (Ilya Abrosimov). 
 
-   To program the Mockingboard, each AY-3-8910 chip has 14 sound related
-   registers that control the 3 channels.  Each AY chip has a dedicated
-   VIA 6522 parallel I/O chip that handles the I/O.
+Most of my sound infrastructure involves YM5 files, a format commonly
+used  by ZX Spectrum and ATARI ST users.
+These are essentially just AY-3-8910 register dumps taken at 50Hz.  
+To play these back just set up the sound card to interrupt 50 times a second
+and then write out the 14 register values from that frame.
 
-   Doing this quickly enough is a challenge on the Apple II.  For each
-   register you have to do a handshake, set the register \# and the value.
-   This can take upwards of 40 1MHz cycles per register.
+%   To program the Mockingboard, each AY-3-8910 chip has 14 sound related
+%   registers that control the 3 channels.  Each AY chip has a dedicated
+%   VIA 6522 parallel I/O chip that handles the I/O.
 
-   For complex chiptune files (especially those written on an ST with much
-   faster hardware) it's sometimes not possible to get exact playback
-   due to the delay.  Also one AY is on the left channel and one on the right
-   so you have to write both if you want sound from both speakers.
+Writing out the registers quickly enough is a challenge on the Apple II.
+For each register you have to do a handshake then set both the register 
+number and the value.
+It is hard to do this in less than forty 1MHz cycles for each register.
+With complex chiptune files (especially those written on an ST with much
+faster hardware) it is sometimes not possible to get exact playback
+due to the delay.
+Further slowdown happens as you want to write both AY chips (the output
+is stereo, with one AY on the left and one on the right).
 
-   I have a whole suite of code for manipulating YM sound data, in my
-   vmw-meter git repository.
+%   I have a whole suite of code for manipulating YM sound data, in my
+%   vmw-meter git repository.
 
-   The first step for getting this to work is detecting if a mockingboard is
-   there.  This can be in any slot 1-7 on the Apple II, though typically
-   Slot 4 is standard (in this demo we only check slot 4).
-
-   The board is initialized, and then one of the 6522 timers is set to
-   interrupt at 25Hz (it has to be an on-board timer as the default
-   Apple II has no timers).
-
-   Why 25Hz and not 50Hz?  At 50Hz with 14 registers you use 700 bytes/s.
-   So a 2 minute song would take 84k of RAM, much more than is available.
-
-   For this demo I run at 25Hz, and also pack the 14 registers of the data
-   into 11 (there are various fields that are not packed well, we can
-   unpack at play time).  Also I stripped out the envelope data as many
-   songs do not use it (so this is a lossy compression method).
-
-   Also, we keep track of the last values written last frame and only
-   write out to the board if things change, which helps with the latency
-   a bit.
-
-   The sound quality suffered a bit, but it's hard to fit a catchy chiptune
-   file in 8K.
-
-   The song being played is a stripped down and re-arranged version of
-   "Electric Wave" from CC'00 by EA (Ilya Abrosimov). 
+Our code detects a Mockingboard at startup, we are lazy and only support
+finding the card in Slot 4 (which is a fairly typically location).
+%   The first step for getting this to work is detecting if a Mockingboard is
+%%  there.  This can be in any slot 1-7 on the Apple II, though typically
+%   Slot 4 is standard (in this demo we only check slot 4).
+The board is initialized, and then one of the 6522 timers is set to
+interrupt at 25Hz.
+% (it has to be an on-board timer as the default
+%   Apple II has no timers).
+Why 25Hz and not 50Hz?  At 50Hz with 14 registers you use 700 bytes/s.
+So a 2 minute song would take 84k of RAM, much more than is available.
+To allow the song to fit in memory (without the fancy circular buffer
+decompression utilized in my Chiptune Player Music Disk demo) we have
+to reduce the size significantly.
+First we reduce the music to only need to be updated at 25Hz.
+We reduce the register data from 14 bytes to 11 bytes by stripping off
+the envelope effects and packing together some of the fields that have
+unused bits.
+To help with latency on playback we keep track of the last frame written
+and only write to the registers that have changed.
 
+In the end the sound quality suffered a bit, but we were able to fit an
+acceptably catchy chiptune inside of our 8k payload.
 
 \subsection{MODE7 BACKGROUND}
 
-  "MODE7" was a Super Nintendo (SNES) graphics mode that took a tiled
+``MODE7'' is a Super Nintendo (SNES) graphics mode that took a tiled
   background and transformed it to look as if it was squashed out to
   the horizon, giving a 3d look.  The SNES did this in hardware, but
   in this demo we do this in software.
@@ -371,6 +418,14 @@ the actual Apple II.
 
 \subsection{BOUNCING BALL ON CHECKERBOARD}
 
+\begin{figure}
+\begin{center}
+\includegraphics[width=\columnwidth]{figures/m7_screen1.jpg}
+\caption{Bouncing ball on infinite checkerboard.\label{fig:ball}}
+\end{center}
+\end{figure}
+
+
   What would a demo be without some sort of bouncing geometric shape.
 
   This is just done with 16 sprites.  The sphere was modeled in OpenGL
@@ -381,10 +436,17 @@ the actual Apple II.
 
   The clicking noise on bounce is just touching the speaker at \$C030.
   It's mostly there to give some sound effects for those playing the demo
-  without a mockingboard.
+  without a Mockingboard.
 
 \subsection{TFV SPACESHIP FLYING}
 
+\begin{figure}[tb]
+\begin{center}
+\includegraphics[width=\columnwidth]{figures/m7_screen4.jpg}
+\end{center}
+\caption{Spaceship flying over an island.\label{fig:tb1}}
+\end{figure}
+
   The spaceship, water splash, and shadows are all sprites.  This is all
   done in software, the Apple II has no sprite hardware.
 
@@ -394,6 +456,14 @@ the actual Apple II.
 
 \subsection{STARFIELD}
 
+\begin{figure}[tb]
+\begin{center}
+\includegraphics[width=\columnwidth]{figures/m7_screen3.jpg}
+\end{center}
+\caption{Spaceship with starfield.\label{fig:stars}}
+\end{figure}
+
+
   The starfield is your typical starfield code.  Only 16 stars are modeled.
   It re-uses the fast-multiply code from the mode7 graphics.
 
@@ -413,6 +483,14 @@ the actual Apple II.
 
 \subsection{RASTERBARS/CREDITS}
 
+\begin{figure}[tb]
+\begin{center}
+\includegraphics[width=\columnwidth]{figures/m7_screen2.jpg}
+\end{center}
+\caption{Rasterbars, stars, and credits.\label{fig:credits}}
+\end{figure}
+
+
   The credits happen with the starfield continuing to run.
 
   The text is written in the bottom 4 lines of the screen.  Some inverse-mode
@@ -443,63 +521,44 @@ More details, disk image, and full source can be found at the website:
 \url{http://www.deater.net/weave/vmwprod/mode7_demo/}
 
 \begin{table}
+\begin{center}
 \begin{verbatim}
 
- --------  $ffff
-| ROM/IO |
- --------  $c000
-|        |      32k decompress
- --------  $4000
-|  load  |      8k
- --------  $2000
-|  free  |
- --------  $1c00
-| Scroll |
-|  Data  |
- --------  $1800
-|Multiply|
-| Tables |	
- --------  $1000
-|GR pg 2 |	1k
-|--------  $0c00
-|GR pg 1 |	1k
-|--------  $0800
-|GR pg 0 |	1k
- --------  $0400
-|        |	0.5
- --------  $0200
-| stack  |	0.25
- --------  $0100
-|zero pg |	0.25
- -------   $0000
+ -------------  $ffff
+|    ROM/IO   |
+ -------------  $c000
+|             |
+| Uncompressed|
+| Code/Data   |
+|             |
+ -------------  $4000
+| Compressed  |
+|   Code      |
+ -------------  $2000
+|   free      |
+ -------------  $1c00
+|   Scroll    |
+|    Data     |
+ -------------  $1800
+|  Multiply   |
+|   Tables    |	
+ -------------  $1000
+| LORES pg 3  |
+ -------------  $0c00
+| LORES pg 2  |
+ -------------  $0800
+| LORES pg 1  |
+ -------------  $0400
+|free/vectors |
+ -------------  $0200
+|    stack    |
+ -------------  $0100
+|   zero pg   |
+ -------------  $0000
 
 \end{verbatim}
+\end{center}
 \caption{Memory Map (not to scale)}
 \end{table}
 
-\begin{figure}
-\includegraphics[width=\columnwidth]{figures/hidden_vmw.png}
-\caption{Blah}
-\end{figure}
-
-\begin{figure}
-\includegraphics[width=\columnwidth]{figures/m7_screen2.jpg}
-\end{figure}
-
-\begin{figure}
-\includegraphics[width=\columnwidth]{figures/m7_screen4.jpg}
-\end{figure}
-
-\begin{figure}
-\includegraphics[width=\columnwidth]{figures/m7_screen1.jpg}
-\end{figure}
-
-\begin{figure}
-\includegraphics[width=\columnwidth]{figures/m7_screen3.jpg}
-\end{figure}
-
-\begin{figure}
-\includegraphics[width=\columnwidth]{figures/mode7_demo_title.png}
-\end{figure}
-
 \end{document}