From 0d6bed04f741b9906b01adc8226bec51c0b57471 Mon Sep 17 00:00:00 2001
From: John Bintz <hello@theindustriousrabbit.com>
Date: Wed, 14 Feb 2024 20:15:55 -0500
Subject: [PATCH] init

---
 .gitignore     |   5 +
 bmp_loader.c   | 135 +++++++++++++++
 bmp_loader.h   |  23 +++
 build.bat      |   6 +
 chicken.bmp    | Bin 0 -> 83082 bytes
 game.c         |  38 +++++
 in_progress.md |   2 +
 keyboard.c     |  56 ++++++
 keyboard.h     |  21 +++
 mouse_io.c     |  48 ++++++
 mouse_io.h     |  18 ++
 pc_stuff.c     |  23 +++
 pc_stuff.h     |  25 +++
 sprtsht.bmp    | Bin 0 -> 4302 bytes
 types.h        |   3 +
 unch1.c        | 155 +++++++++++++++++
 vga.c          | 456 +++++++++++++++++++++++++++++++++++++++++++++++++
 vga.h          |  51 ++++++
 18 files changed, 1065 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 bmp_loader.c
 create mode 100644 bmp_loader.h
 create mode 100644 build.bat
 create mode 100644 chicken.bmp
 create mode 100644 game.c
 create mode 100644 in_progress.md
 create mode 100644 keyboard.c
 create mode 100644 keyboard.h
 create mode 100644 mouse_io.c
 create mode 100644 mouse_io.h
 create mode 100644 pc_stuff.c
 create mode 100644 pc_stuff.h
 create mode 100644 sprtsht.bmp
 create mode 100644 types.h
 create mode 100644 unch1.c
 create mode 100644 vga.c
 create mode 100644 vga.h

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..d9ab992
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,5 @@
+*.zip
+*.OBJ
+*.ERR
+*.EXE
+.ccls-cache/
diff --git a/bmp_loader.c b/bmp_loader.c
new file mode 100644
index 0000000..74429e0
--- /dev/null
+++ b/bmp_loader.c
@@ -0,0 +1,135 @@
+#include <stdio.h>
+#include <string.h>
+#include <malloc.h>
+#include <dos.h>
+
+#include "bmp_loader.h"
+#include "pc_stuff.h"
+#include "vga.h"
+
+int readBMPHeader(FILE *fh, struct BMPImage *info) {
+  int sizeOfHeader;
+  unsigned int numberOfUsedColors;
+
+  if ((fgetc(fh) != 'B') || (fgetc(fh) != 'M')) {
+    printf("Not a BMP file\n");
+    return 1;
+  }
+
+  fseek(fh, 12, SEEK_CUR);
+
+  fread(&sizeOfHeader, sizeof(int), 1, fh);
+  fread(&info->width, sizeof(int), 1, fh);
+  fread(&info->height, sizeof(int), 1, fh);
+  fseek(fh, 2, SEEK_CUR);
+  fread(&info->bpp, sizeof(word), 1, fh);
+
+  // for gimp, you need to add colors to the color map until it hits
+  // 16 colors, then the image will be a 256 color, 8 bpp image
+  //
+  // https://www.gimp-forum.net/Thread-indexing-into-8-bit?pid=13233#pid13233
+  if (info->bpp != 8) return 1;
+
+  fseek(fh, 16, SEEK_CUR);
+  fread(&numberOfUsedColors, sizeof(unsigned int), 1, fh);
+  if (numberOfUsedColors > 256) return 1;
+
+  // get down to color data
+  fseek(fh, 14 + sizeOfHeader, SEEK_SET);
+
+  fread(info->colors, sizeof(struct BMPColor), numberOfUsedColors, fh);
+
+  return 0;
+}
+
+int readBMPIntoMemory(FILE *fh, struct BMPImage *info) {
+  int x, y, plane;
+  int result;
+  byte *currentPointer;
+
+  result = readBMPHeader(fh, info);
+  if (result) return result;
+
+  currentPointer = info->memoryStart;
+
+  for (y = 0; y < info->height; ++y) {
+    for (x = 0; x < info->width; ++x) {
+      currentPointer[(info->height - 1 - y) * info->width + x] = fgetc(fh);
+    }
+  }
+
+  return 0;
+}
+
+int readBMPIntoUnchainedMemory(FILE *fh, struct BMPImage* info) {
+  int x, y, plane;
+  int writeX, writeY, offset;
+  int unchainedLineWidth;
+  int result;
+  byte *rowHolder;
+
+  result = readBMPHeader(fh, info);
+  if (result) return result;
+
+  unchainedLineWidth = info->width / 4;
+
+  // reserve a row's worth of data
+  // read the bitmap data into the row, interleaving for planes
+  // for each plane, memcpy the data to the plane
+  for (y = 0; y < info->height; ++y) {
+    writeY = ((info->height - 1) - y) * unchainedLineWidth;
+
+    for (x = 0; x < info->width; ++x) {
+      plane = x & 0x03;
+      writeX = (x >> 2);
+
+      offset = plane * (unchainedLineWidth * info->height);
+
+      info->memoryStart[offset + writeY + writeX] = fgetc(fh);
+    }
+  }
+
+  return 0;
+}
+
+int readBMPIntoUnchainedVGAMemory(FILE *fh, struct BMPImage* info) {
+  int x, y, plane;
+  int unchainedLineWidth;
+  int result;
+  byte *rowHolder;
+
+  result = readBMPHeader(fh, info);
+  if (result) return result;
+
+  rowHolder = malloc(info->width);
+  unchainedLineWidth = info->width / 4;
+
+  // reserve a row's worth of data
+  // read the bitmap data into the row, interleaving for planes
+  // for each plane, memcpy the data to the plane
+  for (y = 0; y < info->height; ++y) {
+    for (x = 0; x < info->width; ++x) {
+      rowHolder[((x & 3) * 80) + (x >> 2)] = fgetc(fh);
+    }
+
+    for (plane = 0; plane < 4; ++plane) {
+      setActiveVGAMemoryPlanes(1 << plane);
+
+      memcpy(info->memoryStart + ((info->height - 1) - y) * info->width / 4, rowHolder + unchainedLineWidth * plane, unchainedLineWidth);
+    }
+  }
+
+  free(rowHolder);
+
+  return 0;
+}
+
+void bmp256ColorPaletteToVGAColorPalette(struct BMPImage* bmpImage, struct VGAColor colors[]) {
+  int i;
+
+  for (i = 0; i < 256; ++i) {
+    colors[i].red = bmpImage->colors[i].red >> 2;
+    colors[i].green = bmpImage->colors[i].green >> 2;
+    colors[i].blue = bmpImage->colors[i].blue >> 2;
+  }
+}
diff --git a/bmp_loader.h b/bmp_loader.h
new file mode 100644
index 0000000..b216371
--- /dev/null
+++ b/bmp_loader.h
@@ -0,0 +1,23 @@
+#include <stdio.h>
+
+#include "types.h"
+
+struct BMPColor {
+  byte blue;
+  byte green;
+  byte red;
+  byte _a;
+};
+
+struct BMPImage {
+  int width;
+  int height;
+  word bpp;
+  struct BMPColor colors[256];
+  byte *memoryStart;
+};
+
+int readBMPIntoUnchainedMemory(FILE *, struct BMPImage *);
+int readBMPIntoMemory(FILE *, struct BMPImage *);
+void bmp256ColorPaletteToVGAColorPalette(struct BMPImage*, struct VGAColor[]);
+
diff --git a/build.bat b/build.bat
new file mode 100644
index 0000000..112a3aa
--- /dev/null
+++ b/build.bat
@@ -0,0 +1,6 @@
+wcc386.exe -q bmp_loader.c
+wcc386.exe -q mouse_io.c
+wcc386.exe -q pc_stuff.c
+wcc386.exe -q vga.c
+wcc386.exe -q keyboard.c
+wcl386.exe -q unch1.c bmp_load.obj mouse_io.obj pc_stuff.obj vga.obj keyboard.obj
diff --git a/chicken.bmp b/chicken.bmp
new file mode 100644
index 0000000000000000000000000000000000000000..f0db92fc872d2f7810a7985e4ea7896232856c30
GIT binary patch
literal 83082
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

literal 0
HcmV?d00001

diff --git a/game.c b/game.c
new file mode 100644
index 0000000..d303251
--- /dev/null
+++ b/game.c
@@ -0,0 +1,38 @@
+#include "vga.h"
+#include "keyboard.h"
+#include "mouse_io.h"
+
+struct VGAColor colors[4] = {
+  { 0, 0, 0 }, { 255, 255, 255 }, { 255, 0, 0 }, { 0, 0, 255 }
+}
+
+int main(void) {
+  int keepRunning = 1;
+  struct MouseStatus mouseStatus;
+
+  installKeyboardHandler();
+  activateMouse(&mouseStatus);
+
+  while (keepRunning) {
+
+  }
+  // states:
+  // * main menu
+  //   * play
+  //   * quit
+  // * play
+  //   * draw base map
+  //   * draw sidebar
+  //   * Game loop
+  //     * get mouse
+  //     * get keyboard
+  //     * set character position
+  //     * check for enemy spawn and spawn enemy if needed
+  //     * check for character firing and able to fire, spawn bullet if allowed
+  //     * check for each enemy firing and able to fire, spawn enemy bullet if allowed
+  //     * check for bullet collisions
+  //       * enemies are destroyed
+  //       * character is damaged
+  //     * check for bullets hitting the edges of the screen and remove
+  //     * 
+}
diff --git a/in_progress.md b/in_progress.md
new file mode 100644
index 0000000..7f8f974
--- /dev/null
+++ b/in_progress.md
@@ -0,0 +1,2 @@
+* Preserve video mode
+* Rename files to 8.3
diff --git a/keyboard.c b/keyboard.c
new file mode 100644
index 0000000..2581197
--- /dev/null
+++ b/keyboard.c
@@ -0,0 +1,56 @@
+#include <dos.h>
+#include <conio.h>
+
+#include "keyboard.h"
+
+unsigned char keystateBits[16];
+struct KeyboardKeydownState keyboardKeydownState;
+
+void far (interrupt *int9Save)();
+
+void populateKeyboardKeydownState() {
+  keyboardKeydownState.KEY_W = keystateBits[2] & 0x02;
+  keyboardKeydownState.KEY_A = keystateBits[3] & 0x40;
+  keyboardKeydownState.KEY_S = keystateBits[3] & 0x80;
+  keyboardKeydownState.KEY_D = keystateBits[4] & 0x01;
+}
+
+void far interrupt keyboardHandler(void) {
+  unsigned char rawcode, scancode, ksbByte, temp;
+  unsigned char mask = 1;
+
+  _disable();
+
+  rawcode = inp(0x60);
+
+  scancode = rawcode & 0x7f;
+  mask = 1 << (scancode & 0x07);
+  ksbByte = scancode >> 3;
+
+  // https://github.com/id-Software/wolf3d/blob/05167784ef009d0d0daefe8d012b027f39dc8541/WOLFSRC/ID_IN.C#L152-L154
+  outp(0x61, (temp = inp(0x61)) | 0x80);
+  outp(0x61, temp);
+
+  /* break */
+  if (rawcode & 0x80) {
+      mask = 0xff - mask;
+      keystateBits[ksbByte] &= mask;
+  /* make */
+  } else {
+      keystateBits[ksbByte] |= mask;
+  }
+
+  // acknowledge we're done with the interrupt
+  outp(0x20, 0x20);
+
+  _enable();
+}
+
+void installKeyboardHandler() {
+  int9Save = _dos_getvect(9);
+  _dos_setvect(9, keyboardHandler);
+}
+
+void uninstallKeyboardHandler() {
+  _dos_setvect(9, int9Save);
+}
diff --git a/keyboard.h b/keyboard.h
new file mode 100644
index 0000000..28e145e
--- /dev/null
+++ b/keyboard.h
@@ -0,0 +1,21 @@
+#ifndef __KEYBOARD_H__
+#define __KEYBOARD_H__ 1
+
+#include "types.h"
+
+extern unsigned char keystateBits[];
+
+struct KeyboardKeydownState {
+  byte KEY_W;
+  byte KEY_A;
+  byte KEY_S;
+  byte KEY_D;
+};
+
+extern struct KeyboardKeydownState keyboardKeydownState;
+
+void installKeyboardHandler();
+void uninstallKeyboardHandler();
+void populateKeyboardKeydownState();
+
+#endif
diff --git a/mouse_io.c b/mouse_io.c
new file mode 100644
index 0000000..8bf4eb3
--- /dev/null
+++ b/mouse_io.c
@@ -0,0 +1,48 @@
+#include <dos.h>
+#include <conio.h>
+
+#include "mouse_io.h"
+
+int activateMouse(struct MouseStatus *status) {
+  union REGS regs;
+  int mouseActivated;
+
+  regs.w.ax = MOUSE_DRIVER_RESET;
+  int386(MOUSE_DRIVER_INTERRUPT, &regs, &regs);
+
+  mouseActivated = regs.w.ax;
+
+  if (mouseActivated) {
+    status->isActive = regs.w.ax;
+    status->buttonCount = regs.w.bx;
+
+    // set horiz and vert range
+    regs.w.ax = 0x07;
+    regs.w.cx = 0;
+    regs.w.dx = VGA_DISPLAY_WIDTH - 1;
+    int386(MOUSE_DRIVER_INTERRUPT, &regs, &regs);
+
+    regs.w.ax = 0x08;
+    regs.w.cx = 0;
+    regs.w.dx = VGA_DISPLAY_HEIGHT - 1;
+    int386(MOUSE_DRIVER_INTERRUPT, &regs, &regs);
+  }
+
+  return mouseActivated;
+}
+
+void readMouse(struct MouseStatus *status) {
+  union REGS regs;
+  int buttonStatus;
+
+  regs.w.ax = MOUSE_DRIVER_READ_STATE;
+  int386(MOUSE_DRIVER_INTERRUPT, &regs, &regs);
+
+  buttonStatus = regs.w.bx;
+  status->xPosition = regs.w.cx;
+  status->yPosition = regs.w.dx;
+
+  status->leftButtonDown = buttonStatus & 1;
+  status->rightButtonDown = (buttonStatus >> 1) & 1;
+}
+
diff --git a/mouse_io.h b/mouse_io.h
new file mode 100644
index 0000000..4759877
--- /dev/null
+++ b/mouse_io.h
@@ -0,0 +1,18 @@
+#include "vga.h"
+
+typedef struct MouseStatus {
+  int isActive;
+  int buttonCount;
+  int xPosition;
+  int yPosition;
+  int leftButtonDown;
+  int rightButtonDown;
+};
+
+#define MOUSE_DRIVER_INTERRUPT (0x33)
+#define MOUSE_DRIVER_RESET (0x00)
+#define MOUSE_DRIVER_READ_DELTA_MOTION (0x0B)
+#define MOUSE_DRIVER_READ_STATE (0x03);
+
+int activateMouse(struct MouseStatus *);
+void readMouse(struct MouseStatus *);
diff --git a/pc_stuff.c b/pc_stuff.c
new file mode 100644
index 0000000..d28eb77
--- /dev/null
+++ b/pc_stuff.c
@@ -0,0 +1,23 @@
+#include "pc_stuff.h"
+
+#define INPUT_STATUS (0x03da)
+#define VBLANK (0x08)
+#define BIOS_SET_VIDEO_MODE   (0x00)
+
+byte *VGA = (byte *)0xA0000;
+
+void setVideoMode(byte videoMode) {
+  union REGS regs;
+
+  regs.h.ah = BIOS_SET_VIDEO_MODE;
+  regs.h.al = videoMode;
+  int386(BIOS_VIDEO_INTERRUPT, &regs, &regs);
+}
+
+void waitStartVbl() {
+    while (inp(INPUT_STATUS) & VBLANK);
+}
+
+void waitEndVbl() {
+    while (!(inp(INPUT_STATUS) & VBLANK));
+}
diff --git a/pc_stuff.h b/pc_stuff.h
new file mode 100644
index 0000000..b12718b
--- /dev/null
+++ b/pc_stuff.h
@@ -0,0 +1,25 @@
+#ifndef __PC_STUFF_H__
+#define __PC_STUFF_H__
+
+#include <conio.h>
+#include <dos.h>
+
+#include "types.h"
+
+extern byte *VGA;
+
+#define BIOS_GET_VIDEO_MODE   (0x0F)
+#define BIOS_VIDEO_INTERRUPT  (0x10)
+
+#define VIDEO_MODE_VGA_256    (0x13)
+#define VIDEO_MODE_80x25_TEXT (0x03)
+
+// remember, little endian, so the "first" value is "last"
+#define outpw_to_register(indexPort, dataRegister, data) \
+  outpw(indexPort, (((word)(data) << 8)) + (dataRegister))
+
+#endif
+
+void setVideoMode(byte);
+void waitStartVbl();
+void waitEndVbl();
diff --git a/sprtsht.bmp b/sprtsht.bmp
new file mode 100644
index 0000000000000000000000000000000000000000..534d3a476020ff74877c5f077eb724901f190e0e
GIT binary patch
literal 4302
zcmeH_F%H5o3`G;Bj&KHc&QNt>V&N*RoUvCbPMY{TjU`$MG5v^?7uU~4zf6z$9P*mw
z`j$PG9m60bOYUE9>%Pb_?GTpw$*1Z5d}TOrIc<8EG?R-7FaajO1egF5U;<2l2`~XB
z@UH}7v+7f0tn}@>(bYQQ;|Z`pxa*Vc1cQ7FRoe*$q0=YZ2?qHVs<smhLZ?r*Q(4}F
zz6xK{syb4soZX!Rs*?s5F6O=gy|12v{#XY(-&h76b1iNEzm3xz{1Khs6ny80)ei`N
B3g`d;

literal 0
HcmV?d00001

diff --git a/types.h b/types.h
new file mode 100644
index 0000000..a445af9
--- /dev/null
+++ b/types.h
@@ -0,0 +1,3 @@
+typedef unsigned char byte;
+typedef unsigned short int word;
+typedef unsigned long int ulong;
diff --git a/unch1.c b/unch1.c
new file mode 100644
index 0000000..d39fb0d
--- /dev/null
+++ b/unch1.c
@@ -0,0 +1,155 @@
+#include <conio.h>
+#include <dos.h>
+#include <stdio.h>
+#include <malloc.h>
+#include <string.h>
+#include <time.h>
+
+#include "types.h"
+#include "mouse_io.h"
+#include "pc_stuff.h"
+#include "bmp_loader.h"
+#include "vga.h"
+#include "keyboard.h"
+
+byte MOUSE_POINTER[8][8] = {
+  { 2, 2, 2, 2, 2, 0, 0, 0 },
+  { 2, 1, 1, 1, 2, 0, 0, 0 },
+  { 2, 1, 1, 1, 2, 0, 0, 0 },
+  { 2, 1, 1, 1, 2, 0, 0, 0 },
+  { 2, 2, 2, 255, 1, 2, 0, 0 },
+  { 0, 0, 0, 0, 2, 1, 2, 0 },
+  { 0, 0, 0, 0, 0, 2, 1, 2 },
+  { 0, 0, 0, 0, 0, 0, 2, 0 },
+};
+
+byte WALKER[9][8] = {
+  { 0, 0, 0, 4, 4, 0, 0, 0 },
+  { 0, 0, 4, 5, 5, 4, 0, 0 },
+  { 0, 4, 5, 5, 5, 5, 4, 0 },
+  { 0, 0, 0, 4, 4, 0, 0, 0 },
+  { 0, 0, 4, 5, 255, 4, 0, 0 },
+  { 0, 4, 5, 5, 5, 5, 4, 0 },
+  { 0, 0, 0, 4, 4, 0, 0, 0 },
+  { 0, 0, 4, 5, 5, 4, 0, 0 },
+  { 0, 4, 5, 5, 5, 5, 4, 0 }
+};
+
+int main(void) {
+  FILE *fh;
+  struct BMPImage bmpImage, spriteSheetImage;
+  struct MouseStatus mouseStatus = { .xPosition = 0, .yPosition = 0, .leftButtonDown = 0 };
+  struct VGAColor colors[256];
+  byte *spriteSheet, *chicken, *drawBuffer;
+  int i, x, y;
+
+  int currentMouseSprite = 0;
+  int mouseSpriteDelayCount = 0;
+
+  float measuredTime;
+
+  int walkerX = 0, walkerY = 0;
+  int yOffset;
+
+  struct SpriteRender mousePointer = {
+    .data = (byte *)MOUSE_POINTER,
+    .transparentColor = 0,
+    .width = 8,
+    .height = 8,
+    .modulo = 48
+  };
+
+  struct SpriteRender walker = {
+    .data = (byte *)WALKER,
+    .transparentColor = 0,
+    .width = 8,
+    .height = 9,
+    .modulo = 0
+  };
+
+  installKeyboardHandler();
+
+  initializeDrawBuffer();
+
+  spriteSheet = malloc(64 * 64);
+  spriteSheetImage.memoryStart = spriteSheet;
+
+  fh = fopen("sprtsht.bmp", "rb");
+  if (readBMPIntoMemory(fh, &spriteSheetImage)) return 1;
+  fclose(fh);
+
+  setVideoMode(VIDEO_MODE_VGA_256);
+
+  chicken = malloc(320 * 256);
+  bmpImage.memoryStart = chicken;
+
+  fh = fopen("chicken.bmp", "rb");
+  readBMPIntoMemory(fh, &bmpImage);
+  fclose(fh);
+
+  mousePointer.data = spriteSheet;
+  mousePointer.width = 16;
+  mousePointer.height = 16;
+  mousePointer.modulo = 48;
+
+  bmp256ColorPaletteToVGAColorPalette(&bmpImage, colors);
+  setVGAColors(colors);
+
+  activateMouse(&mouseStatus);
+  readMouse(&mouseStatus);
+
+  while (!mouseStatus.leftButtonDown) {
+    readMouse(&mouseStatus);
+
+    populateKeyboardKeydownState();
+
+    if (keyboardKeydownState.KEY_W) walkerY -= 1;
+    if (keyboardKeydownState.KEY_S) walkerY += 1;
+    if (keyboardKeydownState.KEY_A) walkerX -= 1;
+    if (keyboardKeydownState.KEY_D) walkerX += 1;
+
+
+    drawBuffer = getDrawBuffer();
+
+    memcpy(drawBuffer, chicken, 320 * 200);
+
+    mousePointer.x = mouseStatus.xPosition;
+    mousePointer.y = mouseStatus.yPosition;
+    drawSprite(&mousePointer);
+
+    for (i = 0; i < 100; ++i) {
+      walker.x = walkerX + i;
+      walker.y = walkerY + i;
+      drawSprite(&walker);
+    }
+
+    waitStartVbl();
+    memcpy((byte *)0xa0000, drawBuffer, 320 * 200);
+    waitEndVbl();
+
+    //drawBufferToUnchainedMemory();
+
+
+    //copyUnchainedMemoryToActive(chicken);
+
+    //swapPlanes();
+
+    mouseSpriteDelayCount += 1;
+    if (mouseSpriteDelayCount >= 15) {
+      currentMouseSprite = 1 - currentMouseSprite;
+      mousePointer.data = spriteSheet + (currentMouseSprite * 16);
+      mouseSpriteDelayCount = 0;
+    }
+  }
+
+  uninstallKeyboardHandler();
+  setVideoMode(VIDEO_MODE_80x25_TEXT);
+  free(spriteSheet);
+  free(chicken);
+
+  freeDrawBuffer();
+
+  fprintf(stderr, "%lu %lu %lu\n", startTime, endTime, (clock_t)(endTime - startTime));
+
+  return 0;
+}
diff --git a/vga.c b/vga.c
new file mode 100644
index 0000000..d13360a
--- /dev/null
+++ b/vga.c
@@ -0,0 +1,456 @@
+#include "vga.h"
+#include "pc_stuff.h"
+#include <malloc.h>
+#include <conio.h>
+#include <string.h>
+#include <stdio.h>
+#include <time.h>
+
+#define VGA_SEQUENCE_CONTROLLER_INDEX (0x03C4)
+#define VGA_SEQUENCE_CONTROLLER_DATA  (0x03C5)
+
+#define VGA_SEQUENCE_CONTROLLER_MEMORY_MODE (0x04)
+#define VGA_SEQUENCE_CONTROLLER_ODD_EVEN_SEQUENTIAL_ACCESS (0x04)
+#define VGA_SEQUENCE_CONTROLLER_EXTENDED_MEMORY (0x02)
+
+#define VGA_SEQUENCE_CONTROLLER_MAP_MASK_MODE (0x02)
+#define VGA_SEQUENCE_CONTROLLER_ALL_PLANES (0xff)
+
+#define VGA_GRAPHICS_REGISTERS_INDEX (0x03CE)
+#define VGA_GRAPHICS_REGISTERS_DATA (0x03CF)
+
+#define VGA_GRAPHICS_DATA_ROTATE (0x03)
+
+#define VGA_CRT_CONTROLLER_INDEX (0x03d4)
+#define VGA_CRT_CONTROLLER_DATA (0x03d5)
+
+#define VGA_CRT_CONTROLLER_UNDERLINE_MODE (0x14)
+#define VGA_CRT_CONTROLLER_MODE_CONTROL (0x17)
+
+#define VGA_CRT_CONTROLLER_DISPLAY_HIGH_ADDRESS (0x0c)
+#define VGA_CRT_CONTROLLER_DISPLAY_LOW_ADDRESS (0x0d)
+
+#define VGA_CRT_CONTROLLER_VERTICAL_RETRACE_START (0x10)
+#define VGA_CRT_CONTROLLER_VERTICAL_RETRACE_END (0x11)
+#define VGA_CRT_CONTROLLER_VERTICAL_DISPLAY_END (0x12)
+#define VGA_CRT_CONTROLLER_VERTICAL_BLANK_START (0x15)
+#define VGA_CRT_CONTROLLER_VERTICAL_BLANK_END (0x16)
+#define VGA_CRT_CONTROLLER_VERTICAL_TOTAL (0x06)
+#define VGA_CRT_CONTROLLER_OVERFLOW (0x07)
+
+int activePage = 0;
+byte *drawBuffer, *displayMirrorBuffer;
+
+void initializeDrawBuffer() {
+  int i;
+
+  drawBuffer = (byte *)malloc(VGA_DISPLAY_WIDTH * VGA_DISPLAY_HEIGHT);
+  displayMirrorBuffer = (byte *)malloc(VGA_DISPLAY_WIDTH * VGA_DISPLAY_HEIGHT);
+
+  for (i = 0; i < VGA_DISPLAY_WIDTH * VGA_DISPLAY_HEIGHT; ++i) {
+    drawBuffer[i] = 0;
+    displayMirrorBuffer[i] = 0;
+  }
+}
+
+void freeDrawBuffer() {
+  free(drawBuffer);
+  free(displayMirrorBuffer);
+}
+
+void setActiveVGAMemoryPlanes(int planes) {
+  outpw_to_register(
+    VGA_SEQUENCE_CONTROLLER_INDEX,
+    VGA_SEQUENCE_CONTROLLER_MAP_MASK_MODE,
+    planes
+  );
+}
+
+byte *getDrawBuffer() {
+  return drawBuffer;
+}
+
+clock_t startTime, endTime;
+
+void drawBufferToUnchainedMemory() {
+  int x, y, plane, pageOffset, yOffset, yDisplayOffset;
+  byte *vgaStart;
+  unsigned long data;
+
+  int rowsToCopy[VGA_DISPLAY_HEIGHT], minRow = -1, maxRow = 0;
+
+  unsigned long *drawBufferLong = (unsigned long *)drawBuffer,
+                *displayMirrorBufferLong = (unsigned long *)displayMirrorBuffer;
+
+  byte copyRow[VGA_DISPLAY_WIDTH];
+
+  startTime = clock();
+
+  pageOffset = activePage * PAGE_SIZE;
+  vgaStart = (byte *)(VGA + pageOffset);
+
+  for (y = 0; y < VGA_DISPLAY_HEIGHT; ++y) {
+    rowsToCopy[y] = 0;
+    yOffset = y * VGA_UNCHAINED_LINE_WIDTH;
+
+    for (x = 0; x < VGA_UNCHAINED_LINE_WIDTH; x++) {
+      data = *(drawBufferLong++);
+
+      if (displayMirrorBufferLong[yOffset] != data) {
+        rowsToCopy[y] = 1;
+
+        break;
+      }
+
+      yOffset++;
+    }
+  }
+
+  memcpy(displayMirrorBuffer, drawBuffer, VGA_DISPLAY_WIDTH * VGA_DISPLAY_HEIGHT);
+
+  for (y = 0; y < VGA_DISPLAY_HEIGHT; ++y) {
+    if (rowsToCopy[y]) {
+      if (minRow == -1) minRow = y;
+      maxRow = y;
+    }
+  }
+
+
+  if (minRow == -1) return;
+
+  drawBufferLong = (unsigned long *)drawBuffer;
+
+  for (y = minRow; y <= maxRow; ++y) {
+    if (!rowsToCopy[y]) continue;
+
+    yOffset = y * VGA_UNCHAINED_LINE_WIDTH;
+
+    for (x = 0; x < VGA_UNCHAINED_LINE_WIDTH; ++x) {
+      data = drawBufferLong[yOffset + x];
+
+      for (plane = 0; plane < 4; plane++) {
+        copyRow[x + (plane * VGA_UNCHAINED_LINE_WIDTH)] = data & 0xff;
+        data >>= 8;
+      }
+    }
+
+    for (plane = 0; plane < 4; ++plane) {
+      setActiveVGAMemoryPlanes(1 << plane);
+
+      memcpy(vgaStart + yOffset, copyRow + (plane * VGA_UNCHAINED_LINE_WIDTH), VGA_UNCHAINED_LINE_WIDTH);
+    }
+  }
+
+  endTime = clock();
+
+}
+
+void enableUnchainedVGAMode() {
+  word clearOffset;
+
+  // convert VGA pointer into a word sized 
+  ulong *ptr = (ulong *)VGA;
+
+  // The VGA registers are (mostly) byte sized, and are grouped
+  // logically behind a pair of index/data ports.
+  // To access them, you prep the index port on the VGA card
+  // for the register you want to access, then do that access
+  // via the data port.
+  //
+  // Visual: VGA has pouches which contain organization boxes of
+  // registers.
+
+  // target the Sequence Memory Mode Register for Memory Mode
+  // enable sequential access and extended memory
+  outpw_to_register(
+    VGA_SEQUENCE_CONTROLLER_INDEX,
+    VGA_SEQUENCE_CONTROLLER_MEMORY_MODE,
+    VGA_SEQUENCE_CONTROLLER_EXTENDED_MEMORY | VGA_SEQUENCE_CONTROLLER_ODD_EVEN_SEQUENTIAL_ACCESS
+  );
+
+  // target the Sequence Memory Mode Register for map mask
+  outpw_to_register(
+    VGA_SEQUENCE_CONTROLLER_INDEX,
+    VGA_SEQUENCE_CONTROLLER_MAP_MASK_MODE,
+    VGA_SEQUENCE_CONTROLLER_ALL_PLANES
+  );
+
+  for (clearOffset = 0; clearOffset < PAGE_SIZE; ++clearOffset) {
+    *ptr++ = 0;
+  }
+
+  // there's a way to address memory as words or longs, but we're
+  // going to set it to byte addressing because it makes mroe sense.
+  outpw_to_register(
+    VGA_CRT_CONTROLLER_INDEX,
+    VGA_CRT_CONTROLLER_UNDERLINE_MODE,
+    0x00
+  );
+
+  // * enable hsync and vsync
+  // * activate byte Mode
+  // * ...something with address wrapping that I don't quite understand yet...
+  // * ...even more with address funkiness that I don't understand
+  outpw_to_register(
+    VGA_CRT_CONTROLLER_INDEX,
+    VGA_CRT_CONTROLLER_MODE_CONTROL,
+    0xe3
+  );
+
+  outp(0x3c2, 0xe3);
+}
+
+void enable320x256VGAMode() {
+  outpw_to_register(
+    VGA_CRT_CONTROLLER_INDEX,
+    VGA_CRT_CONTROLLER_VERTICAL_RETRACE_END,
+    0x2c
+  );
+  outpw_to_register(
+    VGA_CRT_CONTROLLER_INDEX,
+    VGA_CRT_CONTROLLER_VERTICAL_TOTAL,
+    0x0d
+  );
+  outpw_to_register(
+    VGA_CRT_CONTROLLER_INDEX,
+    VGA_CRT_CONTROLLER_OVERFLOW,
+    0x3e
+  );
+  outpw_to_register(
+    VGA_CRT_CONTROLLER_INDEX,
+    VGA_CRT_CONTROLLER_VERTICAL_RETRACE_START,
+    0xea
+  );
+  outpw_to_register(
+    VGA_CRT_CONTROLLER_INDEX,
+    VGA_CRT_CONTROLLER_VERTICAL_RETRACE_END,
+    0xac
+  );
+  outpw_to_register(
+    VGA_CRT_CONTROLLER_INDEX,
+    VGA_CRT_CONTROLLER_VERTICAL_DISPLAY_END,
+    0xdf
+  );
+  outpw_to_register(
+    VGA_CRT_CONTROLLER_INDEX,
+    VGA_CRT_CONTROLLER_VERTICAL_BLANK_START,
+    0xe7
+  );
+  outpw_to_register(
+    VGA_CRT_CONTROLLER_INDEX,
+    VGA_CRT_CONTROLLER_VERTICAL_BLANK_END,
+    0x06
+  );
+}
+
+void clearWithColor(byte color) {
+  int x, y;
+  int pageOffset, drawY;
+  long *start;
+  long newColor = (color << 24) + (color << 16) + (color << 8) + (color);
+
+  // write to all planes
+  outpw_to_register(
+    VGA_SEQUENCE_CONTROLLER_INDEX,
+    VGA_SEQUENCE_CONTROLLER_MAP_MASK_MODE,
+    0xff
+  );
+
+  pageOffset = activePage * PAGE_SIZE;
+  start = (long *)(VGA + pageOffset);
+
+  for (y = 0; y < VGA_DISPLAY_HEIGHT; ++y) {
+    for (x = 0; x < VGA_UNCHAINED_LINE_WIDTH / 4; ++x) {
+      *(start++) = newColor;
+    }
+  }
+}
+
+/**
+ * this is very temporary
+ */
+void copyUnchainedMemoryToActive(byte *src) {
+  int y, plane, _testSize, _testOffset;
+
+  _testSize = 80 * 240;
+  _testOffset = 80 * 256;
+
+  for (plane = 0; plane < 4; ++plane) {
+    // copying to/from VGA memory requires setting the plane to write to...
+    outpw_to_register(
+      VGA_SEQUENCE_CONTROLLER_INDEX,
+      VGA_SEQUENCE_CONTROLLER_MAP_MASK_MODE,
+      1 << plane
+    );
+
+    memcpy(VGA + activePage * PAGE_SIZE, src + plane * _testOffset, _testSize);
+  }
+}
+
+void copyScratchPlanesToActive() {
+  int y, plane;
+
+  for (plane = 0; plane < 4; ++plane) {
+    // copying to/from VGA memory requires setting the plane to write to...
+    outpw_to_register(
+      VGA_SEQUENCE_CONTROLLER_INDEX,
+      VGA_SEQUENCE_CONTROLLER_MAP_MASK_MODE,
+      1 << plane
+    );
+
+    // and to read from
+    outpw_to_register(
+      0x3ce,
+      0x04,
+      plane
+    );
+
+    memcpy(VGA + activePage * PAGE_SIZE, VGA + SCRATCH_PAGE, PAGE_SIZE);
+  }
+}
+
+void copyScratchPlanesToActiveViaLatches() {
+  int pixel;
+  byte *src, *dest;
+  
+  // TODO: VGA latches
+  outpw_to_register(
+    VGA_SEQUENCE_CONTROLLER_INDEX,
+    VGA_SEQUENCE_CONTROLLER_MAP_MASK_MODE,
+    0xff
+  );
+
+  outpw_to_register(
+    VGA_GRAPHICS_REGISTERS_INDEX,
+    VGA_GRAPHICS_DATA_ROTATE,
+    0x10
+  );
+
+  src = VGA + SCRATCH_PAGE;
+  dest = VGA + activePage * PAGE_SIZE;
+
+  for (pixel = 0; pixel < PAGE_SIZE; ++pixel) {
+    volatile char _temp = *(src++);
+    *(dest++) = 0;
+  }
+
+  outpw_to_register(
+    VGA_GRAPHICS_REGISTERS_INDEX,
+    VGA_GRAPHICS_DATA_ROTATE,
+    0x00
+  );
+}
+
+void drawSprite(struct SpriteRender* sprite) {
+  int x, y;
+  byte pixel;
+
+  byte* spriteData = sprite->data;
+  byte* drawBufferPos = drawBuffer + sprite->x + (sprite->y * VGA_DISPLAY_WIDTH);
+
+  for (y = 0; y < sprite->height; ++y) {
+    for (x = 0; x < sprite->width; ++x) {
+      pixel = *(spriteData++);
+      if (pixel != sprite->transparentColor) {
+        *(drawBufferPos) = pixel;
+      }
+
+      drawBufferPos++;
+    }
+
+    drawBufferPos += (VGA_DISPLAY_WIDTH - sprite->width);
+    spriteData += sprite->modulo;
+  }
+}
+
+void drawUnchainedSprite(struct SpriteRender* sprite) {
+  int dataX, dataY, currentPlane;
+  int drawX, drawY, vgaWriteYStart;
+  int startY, endY;
+  int nextStartX = 1;
+  int planeSampleX = 0, readPositionOffset;
+  int vgaWritePosition, readPosition, spriteAdvance;
+  int activePageOffset, alwaysVGAWriteStart, startVGAWritePosition;
+  byte readResult;
+
+  // precalculate sprite sheet handling and VGA plane
+  currentPlane = sprite->x & 3;
+  spriteAdvance = sprite->width + sprite->modulo;
+
+  outpw_to_register(
+    VGA_SEQUENCE_CONTROLLER_INDEX,
+    VGA_SEQUENCE_CONTROLLER_MAP_MASK_MODE,
+    1 << currentPlane
+  );
+
+  // precalculate x pixel drawing
+  activePageOffset = activePage * PAGE_SIZE;
+
+  alwaysVGAWriteStart = sprite->y;
+  if (alwaysVGAWriteStart < 0) alwaysVGAWriteStart = 0;
+  alwaysVGAWriteStart *= VGA_DISPLAY_WIDTH;
+
+  // precalculate y pixel drawing
+  startY = sprite->y;
+  endY = sprite->y + sprite->height;
+  readPositionOffset = 0;
+
+  if (startY < 0) {
+    readPositionOffset = (spriteAdvance * (-startY));
+    startY = 0;
+  }
+  if (endY > VGA_DISPLAY_HEIGHT) { endY = VGA_DISPLAY_HEIGHT; }
+
+  startVGAWritePosition = activePageOffset + (sprite->x + alwaysVGAWriteStart) / PLANE_PIXEL_DISTANCE;
+
+  for (dataX = 0; dataX < sprite->width; ++dataX) {
+    if (planeSampleX >= sprite->width) {
+      planeSampleX = nextStartX;
+      nextStartX++;
+      currentPlane = (currentPlane + 1) & 3;
+
+      startVGAWritePosition = activePageOffset + (planeSampleX + sprite->x + alwaysVGAWriteStart) / PLANE_PIXEL_DISTANCE;
+
+      // save a second out
+      outp(
+        VGA_SEQUENCE_CONTROLLER_DATA,
+        1 << currentPlane
+      );
+    }
+
+    drawX = planeSampleX + sprite->x;
+    if (drawX >= 0 && drawX < VGA_DISPLAY_WIDTH) {
+      vgaWritePosition = startVGAWritePosition;
+      readPosition = planeSampleX + readPositionOffset;
+
+      for (drawY = startY; drawY < endY; ++drawY) {
+        readResult = sprite->data[readPosition];
+        if (readResult != sprite->transparentColor) {
+          VGA[vgaWritePosition] = readResult;
+        }
+        vgaWritePosition += VGA_UNCHAINED_LINE_WIDTH;
+        readPosition += spriteAdvance;
+      }
+    }
+
+    startVGAWritePosition++;
+    planeSampleX += 4;
+  }
+}
+void swapPlanes() {
+  outpw(VGA_CRT_CONTROLLER_INDEX, VGA_CRT_CONTROLLER_DISPLAY_HIGH_ADDRESS | ((PAGE_SIZE * activePage) & 0xff00));
+  outpw(VGA_CRT_CONTROLLER_INDEX, VGA_CRT_CONTROLLER_DISPLAY_LOW_ADDRESS | ((PAGE_SIZE * activePage) << 8));
+
+  activePage = 1 - activePage;
+}
+
+void setVGAColors(struct VGAColor colors[], int totalColors) {
+  int i;
+
+  outp(0x3c8,0);
+  for (i = 0; i < totalColors; ++i) {
+    outp(0x3c9, colors[i].red);
+    outp(0x3c9, colors[i].green);
+    outp(0x3c9, colors[i].blue);
+  }
+}
diff --git a/vga.h b/vga.h
new file mode 100644
index 0000000..cf9837a
--- /dev/null
+++ b/vga.h
@@ -0,0 +1,51 @@
+#ifndef __VGA_H__
+#define __VGA_H__
+
+#include "types.h"
+#include <time.h>
+
+#define PLANE_PIXEL_DISTANCE (4)
+#define VGA_DISPLAY_WIDTH (320)
+#define VGA_DISPLAY_HEIGHT (200)
+#define VGA_UNCHAINED_LINE_WIDTH (VGA_DISPLAY_WIDTH / PLANE_PIXEL_DISTANCE)
+
+// there are four of these in a row
+#define PAGE_SIZE (VGA_DISPLAY_WIDTH*VGA_DISPLAY_HEIGHT/4)
+#define SCRATCH_PAGE (PAGE_SIZE * 2)
+
+struct VGAColor {
+  byte red;
+  byte green;
+  byte blue;
+};
+
+struct SpriteRender {
+  byte* data;
+  int x;
+  int y;
+  unsigned int width;
+  unsigned int height;
+  int transparentColor;
+  unsigned int modulo;
+};
+
+extern clock_t startTime, endTime;
+
+void enableUnchainedVGAMode();
+void enable320x256VGAMode();
+void setVGAColors(struct VGAColor[], int);
+void copyUnchainedMemoryToActive();
+void copyScratchPlanesToActive();
+void copyScratchPlanesToActiveViaLatches();
+void drawSprite(struct SpriteRender *sprite);
+void swapPlanes();
+void setActiveVGAMemoryPlanes(int);
+void clearWithColor(byte);
+
+void initializeDrawBuffer();
+void freeDrawBuffer();
+void drawBufferToUnchainedMemory();
+
+byte *getDrawBuffer();
+
+#endif