Documented usage of the lz4_8088 decompressor, and added crab source …

…images

README.md

@@ -7,7 +7,7 @@ Type ```VGAPRIDE LIST | MORE``` to see a list of included flags
 
 # Building
 
-This project uses Borland Turbo C++ 3.0. 
+This project uses Borland Turbo C++ 3.0 and Borland Turbo Assembler 5.0. 
 
 1. First, you need to create the EGAVGA.OBJ file. Use the BGIOBJ.EXE file in TC\BGI to compile it with ```BGIOBJ EGAVGA```
 2. Copy the resulting OBJ file into the main project directory
@@ -18,4 +18,6 @@ This project uses Borland Turbo C++ 3.0.
 
 # License
 
-The code is licensed under the terms of the GPL, version 3.
+The code is licensed under the terms of the GPL, version 3.
+
+It uses Jim Leonard's [lz4_8088](http://www.oldskool.org/pc/lz4_8088), which is under the the Demoscene License.  

crabs/README.md

@@ -0,0 +1,9 @@
+Useful commands:
+
+``` 
+convert crabgay.png -colors 256 crabgay256.png
+identify -verbose crabgay256.png
+python planize.py
+lz4 -c2 stdin trans0.dat.lz4  0<trans0.dat
+xxd -i crab0.dat.lz4 >> ../crabs.c
+```

crabs/planize.py

@@ -0,0 +1,24 @@
+from PIL import Image
+im=Image.open('crabtran256.png')
+w,h=im.size
+buffers=[[],[],[],[]]
+bits=[1<<i for i in range(8)][::-1]
+for y in range(h):
+	for x in range(w):
+		v=im.getpixel((x,y))
+		for o in range(4):
+			buffers[o].append(1 if v&(1<<o) else 0)
+outbuffers=[]
+for buffer in buffers:
+	cbuffer=[]
+	for i in range(0,len(buffer),8):
+		x=buffer[i:i+8]
+		v=sum([a*b for (a,b) in zip(x,bits)])
+		#print v ,x
+		cbuffer.append(chr(v))
+	outbuffers.append(cbuffer)
+for i,buffer in enumerate(outbuffers):
+	with open('trans{}.dat'.format(i),'wb') as f:
+			f.write(''.join(buffer))
+
+