Apple-2-Tools
/
Rgb2Hires
mirror of https://github.com/Pixinn/Rgb2Hires.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Converts an RGB image (.png, .jpeg) into a binary file compliant with the Apple II's HIRES format.
16 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%
Go to file
Christophe Meneboeuf 6d5e1d53c1 Windows project generated by cmake 2021-02-02 18:24:36 +01:00
Loader_Apple2 Windows project generated by cmake 2021-02-02 18:24:36 +01:00
Rgb2Hires_PC Windows project generated by cmake 2021-02-02 18:24:36 +01:00
.gitignore Windows project generated by cmake 2021-02-02 18:24:36 +01:00
COPYING INITIAL 2016-11-29 23:06:37 +01:00
Readme.md Windows project generated by cmake 2021-02-02 18:24:36 +01:00

Readme.md

Rgb2Hires

This repository contains three "PC" 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 excerpt, that can be loaded to the HIRES memory pages of an Apple II.
    • Source image must be 140x192. Pixels are anamorphic: they will be displayed 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 satisfies the same requirements 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. Once in ProDOS, just type -DISPLAY.

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

Windows / Linux projects (libHires, Picture, Tile)

Dependencies

  • Magick++, from ImageMagick 6
    • On Windows
      • Download ImageMagick 6 from the official website
      • Compile it in Dynamic Multithreaded
      • Provide an environment variable called MAGICK_HOME and pointing to the root ImageMagick folder.
      • Copy ImageMagick-config from the script/ folder to MAGICK_HOME
    • On Linux, install libmagick++-dev for version 6

      sudo apt install libmagick++-6.q16-dev

How to build

  • Linux a CMakeList is provided:

    mkdir build && cd build

    cmake ..

    cmake --build . --config release

  • Windows a VisualStudio solution is provided

Apple II project (Loader)

Dependencies

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

Build

make

Test

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 in the Loader_Apple2 folder.