mirror of https://github.com/a2geek/apple2-image-encoder.git synced 2024-12-21 20:29:18 +00:00

Convert a modern image into a format usable by an Apple II

Go to file

A2 Geek 61315596a1 Merge pull request #1 from a2geek/dependabot/maven/junit-junit-4.13.1 Bump junit from 4.12 to 4.13.1		2020-11-17 23:00:17 -06:00
doc/images	Initial migration to Maven and Git.	2016-09-12 22:21:41 -05:00
src	Tweak to pull in Apache Commons Codec.	2017-07-09 16:07:08 -05:00
.gitignore	Adding bin.	2017-07-03 18:42:55 -05:00
LICENSE	Initial migration to Maven and Git.	2016-09-12 22:21:41 -05:00
pom.xml	Bump junit from 4.12 to 4.13.1	2020-11-17 13:34:23 +00:00
README.md	Removing version history as that is now in the Github releases tab.	2019-03-05 22:23:58 -06:00
TODO.md	Initial migration to Maven and Git.	2016-09-12 22:21:41 -05:00

README.md

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 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.

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.

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.

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.