Apple-2-Tools/Rgb2Hires
1
0
Fork 0
mirror of https://github.com/Pixinn/Rgb2Hires.git synced 2024-06-11 05:29:29 +00:00
Code Issues Projects Releases Wiki Activity
Converts an RGB image (.png, .jpeg) into a binary file compliant with the Apple II's HIRES format.
12 Commits 2 Branches 0 Tags 437 KiB
C++ 82.4%
Makefile 11.1%
C 3.8%
CMake 1.3%
Assembly 0.6%
Other 0.8%
d2799ed3c9
Go to file
Christophe Meneboeuf d2799ed3c9 Update Readme
2020-11-13 01:03:50 +01:00
Loader_Apple2 Refactoring 2020-11-12 00:08:30 +01:00
Rgb2Hires_PC Can choose a tile from the screen-sized tilesheet 2020-11-13 00:18:23 +01:00
.gitignore Add the Tile program 2020-11-12 00:34:39 +01:00
COPYING INITIAL 2016-11-29 23:06:37 +01:00
Readme.md Update Readme 2020-11-13 01:03:50 +01:00

Readme.md

Rgb2Hires

This repository contains three windows projects:

  • libRgb2Hires: a library to convert RGB image to the Apple II's HIRES format
  • Picture: a program to convert a RGB png to a binary or an ASM that can be loaded to the HIRES memory pages of an Apple II.
    • Source image must be 140x192. Pixels are anamorphic: twice wider than tall.
    • Source image must contains six colors : BLACK, WHITE, ORANGE, GREEN, BLUE and PURPLE. The color may be approximation of the Apple II 6 colors. Please refer to the provided pic.
  • Tile: given a RGB png tile sheet that statifies the same requirement as above, it extracts a 14x16 tile and converts it to ASM data. This data is not interleaved.

And one Apple II project:

  • Loader: a program that will load and display a picture generated by the Picture program. A bash scripts is provided as an exemple to load the picture and the loader on an image disk. AppleCommander is required to do so.

For more information about the "Hires" format and its limitations, you can refer to my website.

Note:

The Windows project should compile as is on other plateforms.

Dependencies

Windows / Linux projects (libHires, Picture, Tile)

  • Magick++
    • On Windows, you have provide an environment variable called MAGICK_HOME and pointing to the ImageMagick folder.
    • On Linux, install libmagick++-dev
    • Only ImageMagick 6 is supported

Apple II project (Loader)

Dependencies

  • CC65
    • The crosscompiler suit. Please provide an environment variable, CC65_HOME pointing to your CC65 folder.

Running

A correct source image, test.png, is provided as an example. Convert it using Picture, then copy it on a dsk image along with the Apple II loader. You can use or refer to the provided script.