Initial migration to Maven and Git.

Author: a2geek

.gitignore

@@ -0,0 +1,4 @@
+/target/
+/.settings/
+/.classpath
+/.project

LICENSE

@@ -0,0 +1,42 @@
+# Overview
+
+This application will convert a modern image into a format usable by an Apple II - lores, double lores, and super hires are currently supported. It also includes basic compression capabilities. The color palettes go through an optimization phase to the standard 16 color palette, or, of the existing palette in the case of a super hires. 
+
+**Requires:** Java 1.8 (originally implemented for Java 1.4, but being rebuilt with modern tools, hence Java 1.8 requirement). 
+
+**Tip:** You can drag an image into the original tab instead of digging around for it. 
+
+Currently supported Apple II graphic formats: 
+
+Format | Width | Height | Colors
+------ | ----- | ------ | ------ 
+Lores | 40 | 40 | Standard Apple 16 colors 
+Double | Lores | 80 | 40 | Standard Apple 16 colors 
+Super Hires | 320 | 200 | 16 palettes of 16 colors; each palette entry is 12 bit color (4 bits per red, green, blue). 
+
+Currently supported "compression" formats: RLE, Variable RLE, PackBits, 'deflate' method of Zip, GZip, BitPack #1 - #3 (my attempts and they're worthless).
+
+The [original TODO list](TODO.md) has been preserved for any future efforts.
+
+# Screen Shots
+
+This is the original tab with a 2048x1536 image taken on my digital camera. If you're not sure what you are looking at, it is the upper-left corner of the image in the next picture. 
+
+!(doc/images/a2ie-original.png)
+
+Choose the image type to convert to and click the convert button. If you wish, you can save the raw Apple II data. Note that for lores and double lores, no screen holes are saved. 
+
+!(doc/images/a2ie-convert.png)
+
+If you want some ideas about compressability, click the compression tab. You can enter the "max size allowed" which I use to figure out if the image can fit into the memory I've allocated for it on the Apple II. Click the Compress button to run through all the possibilities. Those that fit in the size given are colored green, the rest are red. If the compression method fails for some reason, it does not show up (note that Bit Pack #1 is missing - it only works on images less than 64 pixels wide or high or something like that). Note that each compression method's results can be saved to disk. 
+
+!(doc/images/a2ie-compression.png)
+
+# Installation
+
+Apple Image Encoder is distributed in a self-executing Java JAR file. What this means is that once Java has been installed on your system, you just need to (a) click the link and open the program to run it or (b) save the file to your hard disk and then double-click on that file. Use whichever works best for you.
+
+# Version History
+
+* 09/12/2016 - 4.4.0 - Migrated to GitHub, Maven, rebuilt application.
+* 08/06/2005 - 4.3.1 - Initial public release. Prior (internal) releases include command-line only, proof-of-concept work, etc. *This is the only version that will still work with Java 1.5 or later.  This is the original package from 2005.

README.md

@@ -0,0 +1,17 @@
+> This is the historical ideas list, tweaked for markdown.
+
+# TODO
+* [x] Allow sorting compression results
+* [ ] View palette(s) after compression
+* [x] Highlight compressed image as red/green
+* [x] Save settings - last folder, max size
+* [x] Progress bar
+* [ ] Demo with Harry pictures for all modes - RLE
+* [ ] Add HGR, DHR?
+* [ ] Rotate original before conversion?
+* [x] Drop files into Original pane instead of loading.
+* [ ] Color fixing - bands (currently done), interlaced, closest colors
+* [ ] Add Floyd-Steinberg Dithering (and none)
+* [ ] Move convert options to popup dialog? (color fixing, aspect ratio)
+* [ ] Do something else with compression errors
+* [ ] Implement encoders as ServiceLoader modules

TODO.md

@@ -0,0 +1,55 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+	
+	<modelVersion>4.0.0</modelVersion>
+	<groupId>a2geek.apple2</groupId>
+	<artifactId>apple2-image-encoder</artifactId>
+	<version>4.4.0-FINAL</version>
+	<name>Apple II Image Encoder</name>
+	<description>A utility that got out of hand and became an application to move modern images to the Apple II platform.</description>
+	
+	<properties>
+		<maven.compiler.source>1.8</maven.compiler.source>
+		<maven.compiler.target>1.8</maven.compiler.target>
+		<maven.shade.version>2.4.3</maven.shade.version>
+		<junit.version>4.12</junit.version>
+	</properties>
+
+	<dependencies>
+		<dependency>
+			<groupId>junit</groupId>
+			<artifactId>junit</artifactId>
+			<version>${junit.version}</version>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-shade-plugin</artifactId>
+				<version>${maven.shade.version}</version>
+				<executions>
+					<execution>
+						<phase>package</phase>
+						<goals>
+							<goal>shade</goal>
+						</goals>
+						<configuration>
+							<transformers>
+								<transformer
+									implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
+									<manifestEntries>
+										<Main-Class>a2geek.apple2.image.encoder.ui.ImageEncoderApp</Main-Class>
+										<Implementation-Title>Apple II Image Encoder</Implementation-Title>
+										<Implementation-Version>${project.version}</Implementation-Version>
+									</manifestEntries>
+								</transformer>
+							</transformers>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+		</plugins>
+	</build></project>

doc/images/a2ie-compression.png

@@ -0,0 +1,17 @@
+package a2geek.apple2.image.encoder;
+import java.awt.image.BufferedImage;
+
+import a2geek.apple2.image.encoder.util.ProgressListener;
+
+/**
+ * Represents an Apple II double lores image.
+ * @author a2geek@users.noreply.github.com
+ */
+public class A2DoubleLoresImage extends A2LoresImage {
+	public A2DoubleLoresImage(BufferedImage image, boolean keepAspectRatio) {
+		this(image, keepAspectRatio, null);
+	}
+	public A2DoubleLoresImage(BufferedImage image, boolean keepAspectRatio, ProgressListener listener) {
+		super(image, 80, keepAspectRatio, listener);
+	}
+}

doc/images/a2ie-convert.png

@@ -0,0 +1,120 @@
+package a2geek.apple2.image.encoder;
+import java.awt.Graphics;
+import java.awt.image.BufferedImage;
+
+/**
+ * Represents an abstract Apple II image.
+ * @author a2geek@users.noreply.github.com
+ */
+public abstract class A2Image {
+	private BufferedImage image;
+	private int height;
+	private int width;
+	
+	public A2Image(BufferedImage originalImage, int physicalHeight, int physicalWidth, boolean keepAspectRatio) {
+		this.height = physicalHeight;
+		this.width = physicalWidth;
+
+		this.image = new BufferedImage(physicalWidth, physicalHeight, BufferedImage.TYPE_INT_RGB); 
+		int x = 0;
+		int y = 0;
+		if (keepAspectRatio) {
+			double aspectRatioH = (double)physicalHeight / (double)originalImage.getHeight();
+			double aspectRatioW = (double)physicalWidth / (double)originalImage.getWidth();
+			double aspectRatio = (aspectRatioH < aspectRatioW) ?
+					aspectRatioH : aspectRatioW;
+			height = (int)(originalImage.getHeight() * aspectRatio);
+			width =  (int)(originalImage.getWidth() * aspectRatio);
+			x = (physicalWidth - width) / 2;
+			y = (physicalHeight - height) / 2;
+		}
+		Graphics g = this.image.getGraphics();
+		g.drawImage(originalImage, x, y, width, height, null);
+		g.dispose();
+
+		this.height = physicalHeight;
+		this.width = physicalWidth;
+	}
+	
+	public int getHeight() {
+		return height;
+	}
+	public int getWidth() {
+		return width;
+	}
+	public int getTotalBytes() {
+		return getTotalPixels() / 2;
+	}
+	public int getTotalPixels() {
+		return height * width;
+	}
+	protected int getRGB(int x, int y) {
+		return image.getRGB(x,y);
+	}
+	protected void setRGB(int x, int y, int color) {
+		image.setRGB(x, y, color);
+	}
+	public BufferedImage getImage() {
+		return image;
+	}
+	/**
+	 * Get Apple II color at X, Y.
+	 */
+	public abstract int getColor(int x, int y);
+	/**
+	 * Get Apple II color treating the screen as an array of pixels.
+	 */
+	public int getColor(int pos) {
+		if (pos >= getTotalPixels()) return -1;
+    	int y = (pos / getWidth());
+    	int x = pos % getWidth();
+    	return getColor(x,y);
+	}
+	/**
+	 * Get a byte of memory as stored by the hardware.
+	 */
+	public abstract int getMemoryByte(int x, int y);
+	/**
+	 * Treat the screen as an array of bytes.
+	 */
+	public abstract int getMemoryByte(int pos);
+	/**
+	 * Test if, from a given coordinate, the rest of the row is a given color.
+	 */
+	public boolean checkRowColor(int y, int xStart, int color) {
+		for (int x=xStart; x<getWidth(); x++) {
+			if (getColor(x,y) != color) return false;
+		}
+		return true;
+	}
+	/**
+	 * Create a byte array of a physical memory dump for the image.
+	 */
+	public abstract byte[] getBytes();
+
+	/**
+	 * Setup the default Apple II 16 colors (lores, double lores, double hires colors).
+	 */
+	public static PaletteEntry[] getStandard12BitPalette() {
+		PaletteEntry[] standardPalette = new PaletteEntry[16];
+		standardPalette[0x0] = new PaletteEntry(0x000);	// black
+		standardPalette[0x1] = new PaletteEntry(0xf00);	// magenta
+		standardPalette[0x2] = new PaletteEntry(0x800);	// brown
+		standardPalette[0x3] = new PaletteEntry(0xf80);	// orange
+		standardPalette[0x4] = new PaletteEntry(0x080);	// dark green
+		standardPalette[0x5] = new PaletteEntry(0x888);	// grey1
+		standardPalette[0x6] = new PaletteEntry(0x0f0);	// green
+		standardPalette[0x7] = new PaletteEntry(0xff0);	// yellow
+		standardPalette[0x8] = new PaletteEntry(0x008);	// dark blue
+		standardPalette[0x9] = new PaletteEntry(0xf0f);	// violet
+		standardPalette[0xa] = new PaletteEntry(0xccc);	// grey2
+		standardPalette[0xb] = new PaletteEntry(0xf8c);	// pink
+		standardPalette[0xc] = new PaletteEntry(0x00c);	// medium blue
+		standardPalette[0xd] = new PaletteEntry(0x00f);	// light blue
+		standardPalette[0xe] = new PaletteEntry(0x0c8);	// aqua
+		standardPalette[0xf] = new PaletteEntry(0xfff);	// white
+		// Force each entry to be active
+		for (PaletteEntry paletteEntry : standardPalette) paletteEntry.setActive();
+		return standardPalette;
+	}
+}