Rgb2Hires/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 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 satifies 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](https://applecommander.github.io/) is required to do so.

For more information about the "Hires" format and its limitations, you can refer to my [website](https://www.xtof.info/blog/?p=768).

__Note:__

## Windows / Linux projects (libHires, Picture, Tile)
### Dependencies

* Magick++
    * On Windows, you have provide an environment variable called *MAGICK_HOME* and pointing to the ImageMagick folder.
    * 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](https://cc65.github.io/cc65/)
    * The crosscompiler suit. Please provide an environment variable, *CC65_HOME* pointing to your CC65 folder.
	
### Build

Use the makefile

# 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.
Update Readme 2020-11-13 00:03:50 +00:00			`# Rgb2Hires`
Adding the source of a Loader for Apple II 2016-12-07 23:53:00 +00:00
Compilation on Linux 2021-01-25 23:21:52 +00:00			`This repository contains three "PC" projects:`
Update Readme 2020-11-13 00:03:50 +00:00			`* 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.`
Compilation on Linux 2021-01-25 23:21:52 +00:00			`* Tile: given a RGB png tile sheet that satifies the same requirements as above, it extracts a 14x16 tile and converts it to ASM data. This data is not interleaved.`
Adding the source of a Loader for Apple II 2016-12-07 23:53:00 +00:00
Update Readme 2020-11-13 00:03:50 +00:00			`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](https://applecommander.github.io/) is required to do so.`
Adding the source of a Loader for Apple II 2016-12-07 23:53:00 +00:00
Update Readme 2020-11-13 00:03:50 +00:00			`For more information about the "Hires" format and its limitations, you can refer to my [website](https://www.xtof.info/blog/?p=768).`
Minor: better doc 2018-10-06 22:37:44 +00:00
Update Readme 2020-11-13 00:03:50 +00:00			`__Note:__`
Adding the source of a Loader for Apple II 2016-12-07 23:53:00 +00:00
Compilation on Linux 2021-01-25 23:21:52 +00:00			`## Windows / Linux projects (libHires, Picture, Tile)`
			`### Dependencies`
Adding the source of a Loader for Apple II 2016-12-07 23:53:00 +00:00
Minor: better doc 2018-10-06 22:37:44 +00:00			`* Magick++`
			`* On Windows, you have provide an environment variable called MAGICK_HOME and pointing to the ImageMagick folder.`
Compilation on Linux 2021-01-25 23:21:52 +00:00			`* 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 ..`
Adding the source of a Loader for Apple II 2016-12-07 23:53:00 +00:00
Compilation on Linux 2021-01-25 23:21:52 +00:00			`> cmake --build . --config release`

			`* Windows a VisualStudio solution is provided`

			`## Apple II project (Loader)`
Minor: better doc 2018-10-06 22:37:44 +00:00
Update Readme 2020-11-13 00:03:50 +00:00			`### Dependencies`
			`* [CC65](https://cc65.github.io/cc65/)`
			`* The crosscompiler suit. Please provide an environment variable, CC65_HOME pointing to your CC65 folder.`
Compilation on Linux 2021-01-25 23:21:52 +00:00
			`### Build`

			`Use the makefile`
Adding the source of a Loader for Apple II 2016-12-07 23:53:00 +00:00
			`# Running`
Update Readme 2020-11-13 00:03:50 +00:00			`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.`