1
0
mirror of https://github.com/KrisKennaway/ii-pix.git synced 2025-03-06 04:30:11 +00:00

Move DHR examples to subdir in preparation for adding SHR examples

This commit is contained in:
kris 2022-07-18 23:11:23 +01:00
parent bce2153d97
commit b11b322c39
139 changed files with 29 additions and 29 deletions
README.md
docs
examples/dhr
autumn-iipix-ntsc-openemulator.pngautumn-iipix-ntsc-preview.pngautumn-iipix-ntsc.dhrautumn-iipix-openemulator-openemulator.pngautumn-iipix-openemulator-preview.pngautumn-iipix-openemulator.dhrautumn-iipix-virtualii-preview.pngautumn-iipix-virtualii.dhrautumn-original.pngblue-frog-iipix-ntsc-openemulator.pngblue-frog-iipix-ntsc-preview.pngblue-frog-iipix-ntsc.dhrblue-frog-iipix-openemulator-openemulator.pngblue-frog-iipix-openemulator-preview.pngblue-frog-iipix-openemulator.dhrblue-frog-iipix-virtualii-preview.pngblue-frog-iipix-virtualii.dhrblue-frog-original.pngexamples.pofish-iipix-ntsc-openemulator.pngfish-iipix-ntsc-preview.pngfish-iipix-ntsc.dhrfish-iipix-openemulator-openemulator.pngfish-iipix-openemulator-preview.pngfish-iipix-openemulator.dhrfish-iipix-virtualii-preview.pngfish-iipix-virtualii.dhrfish-original.pnggallery.mdgroundhog-bmp2dhr-openemulator.pnggroundhog-bmp2dhr-virtualii.pnggroundhog-iipix-ntsc-openemulator.pnggroundhog-iipix-ntsc-preview.pnggroundhog-iipix-ntsc.dhrgroundhog-iipix-openemulator-openemulator.pnggroundhog-iipix-openemulator-preview.pnggroundhog-iipix-openemulator.dhrgroundhog-iipix-virtualii-preview.pnggroundhog-iipix-virtualii.dhrgroundhog-iipix-virtualii.pnggroundhog-original.pnghorse-iipix-ntsc-openemulator.pnghorse-iipix-ntsc-preview.pnghorse-iipix-ntsc.dhrhorse-iipix-openemulator-openemulator.pnghorse-iipix-openemulator-preview.pnghorse-iipix-openemulator.dhrhorse-iipix-virtualii-preview.pnghorse-iipix-virtualii.dhrhorse-original.pngkris-iipix-openemulator.pngkris-preview.pngkris.dhrmacaque-iipix-ntsc-openemulator.pngmacaque-iipix-ntsc-preview.pngmacaque-iipix-ntsc.dhrmacaque-iipix-openemulator-openemulator.pngmacaque-iipix-openemulator-preview.pngmacaque-iipix-openemulator.dhrmacaque-iipix-virtualii-preview.pngmacaque-iipix-virtualii.dhrmacaque-original.pngmockingbird-iipix-ntsc-openemulator.pngmockingbird-iipix-ntsc-preview.pngmockingbird-iipix-ntsc.dhrmockingbird-iipix-openemulator-openemulator.pngmockingbird-iipix-openemulator-preview.pngmockingbird-iipix-openemulator.dhrmockingbird-iipix-virtualii-preview.pngmockingbird-iipix-virtualii.dhrmockingbird-original.pngnymphaea-iipix-ntsc-openemulator.pngnymphaea-iipix-ntsc-preview-openemulator.pngnymphaea-iipix-ntsc-preview.pngnymphaea-iipix-ntsc.dhrnymphaea-iipix-openemulator-openemulator.pngnymphaea-iipix-openemulator-preview.pngnymphaea-iipix-openemulator.dhrnymphaea-iipix-virtualii-preview.pngnymphaea-iipix-virtualii.dhrnymphaea-original.pngpaperclips-a2bestpix-openemulator.pngpaperclips-bmp2dhr-openemulator.pngpaperclips-iipix-ntsc-openemulator.pngpaperclips-iipix-ntsc-preview.pngpaperclips-iipix-ntsc.dhrpaperclips-iipix-openemulator-openemulator.pngpaperclips-iipix-openemulator-preview.pngpaperclips-iipix-openemulator.dhrpaperclips-iipix-virtualii-preview.pngpaperclips-iipix-virtualii.dhrpaperclips-original.pngparrots-iipix-ntsc-openemulator.pngparrots-iipix-ntsc-preview.pngparrots-iipix-ntsc.dhrparrots-iipix-openemulator-openemulator.pngparrots-iipix-openemulator-preview.pngparrots-iipix-openemulator.dhr

@ -90,11 +90,11 @@ TODO: link to KansasFest 2022 talk slides/video for more details
## Double Hi-Res
See [here](examples/gallery.md) for more sample Double Hi-Res image conversions.
See [here](examples/dhr/gallery.md) for more sample Double Hi-Res image conversions.
### Original
![Two colourful parrots sitting on a branch](examples/parrots-original.png)
![Two colourful parrots sitting on a branch](examples/dhr/parrots-original.png)
(Source: [Shreygadgil](https://commons.wikimedia.org/wiki/File:Vibrant_Wings.jpg), [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0), via Wikimedia Commons)
@ -103,18 +103,18 @@ See [here](examples/gallery.md) for more sample Double Hi-Res image conversions.
This image was generated using
```buildoutcfg
python convert.py --lookahead 8 --palette openemulator examples/parrots-original.png examples/parrots-iipix-openemulator.dhr
python convert.py --lookahead 8 --palette openemulator examples/dhr/parrots-original.png examples/dhr/parrots-iipix-openemulator.dhr
```
The resulting ][-pix preview PNG image is shown here.
![Two colourful parrots sitting on a branch](examples/parrots-iipix-openemulator-preview.png)
![Two colourful parrots sitting on a branch](examples/dhr/parrots-iipix-openemulator-preview.png)
### OpenEmulator screenshot
This is a screenshot taken from OpenEmulator when viewing the Double Hi-res image.
![Two colourful parrots sitting on a branch](examples/parrots-iipix-openemulator-openemulator.png)
![Two colourful parrots sitting on a branch](examples/dhr/parrots-iipix-openemulator-openemulator.png)
Some difference in colour tone is visible due to blending of colours across pixels (e.g. brown blending into grey, in the background). This is due to the fact that OpenEmulator simulates the reduced chroma bandwidth of the NTSC signal.
@ -122,7 +122,7 @@ Some difference in colour tone is visible due to blending of colours across pixe
This is an OpenEmulator screenshot of the same image converted with `--palette=ntsc` instead of `--palette=openemulator`. Colour match to the original is substantially improved, and more colour detail is visible, e.g. in the shading of the background.
![Two colourful parrots sitting on a branch](examples/parrots-iipix-ntsc-openemulator.png)
![Two colourful parrots sitting on a branch](examples/dhr/parrots-iipix-ntsc-openemulator.png)
## Super Hi-Res
@ -157,4 +157,4 @@ TODO: add example images
Initial release
![me](examples/kris-iipix-openemulator.png)
![me](examples/dhr/kris-iipix-openemulator.png)

@ -67,19 +67,19 @@ By contrast, OpenEmulator uses a more complex (and realistic) band-pass filterin
(Source: [Reinhold Möller](https://commons.wikimedia.org/wiki/File:Nymphaea_caerulea-20091014-RM-115245.jpg), [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0), via Wikimedia Commons)
![Nymphaea](../examples/nymphaea-original.png)
![Nymphaea](../examples/dhr/nymphaea-original.png)
OpenEmulator screenshot of image produced with `--palette=openemulator --lookahead=8`. The distorted background colour compared to the original is particularly noticeable.
![Nymphaea](../examples/nymphaea-iipix-openemulator-openemulator.png)
![Nymphaea](../examples/dhr/nymphaea-iipix-openemulator-openemulator.png)
OpenEmulator screenshot of image produced with `--palette=ntsc --lookahead=8`. Not only is the background colour a much better match, the image shading and detail is markedly improved.
![Nymphaea](../examples/nymphaea-iipix-ntsc-openemulator.png)
![Nymphaea](../examples/dhr/nymphaea-iipix-ntsc-openemulator.png)
Rendering the same .dhr image with 4-pixel colour shows the reason for the difference. For example the background shading is due to pixel sequences that appear (with this simpler and less hardware-accurate rendering scheme) as sequences of grey and dark green, with a lot of blue and red sprinkled in. In NTSC these pixel sequences combine to produce various shades of green.
![Nymphaea](../examples/nymphaea-iipix-ntsc-preview-openemulator.png)
![Nymphaea](../examples/dhr/nymphaea-iipix-ntsc-preview-openemulator.png)
# Dithering and Double Hi-Res
@ -188,7 +188,7 @@ The mapping from RGB colour space to CAM16-UCS is quite complex, so to avoid thi
These three images were converted using the same target (openemulator) palette, using ][-pix, bmp2dhr and a2bestpix (since this is supported by all three), and are shown as screenshots from openemulator.
### Original
![original source image](../examples/paperclips-original.png)
![original source image](../examples/dhr/paperclips-original.png)
(Source: [Purple Sherbet Photography from Worldwide!](https://commons.wikimedia.org/wiki/File:Colourful_assortment_of_paper_clips_(10421946796).jpg), [CC BY 2.0](https://creativecommons.org/licenses/by/2.0), via Wikimedia Commons)
@ -198,24 +198,24 @@ The following images were all generated with a palette approximating OpenEmulato
Preview image and OpenEmulator screenshot
![ii-pix preview](../examples/paperclips-iipix-openemulator-preview.png)
![ii-pix screenshot](../examples/paperclips-iipix-openemulator-openemulator.png)
![ii-pix preview](../examples/dhr/paperclips-iipix-openemulator-preview.png)
![ii-pix screenshot](../examples/dhr/paperclips-iipix-openemulator-openemulator.png)
### ][-pix NTSC 8-pixel colour (Preview image)
Preview image and OpenEmulator screenshot
![ii-pix preview](../examples/paperclips-iipix-ntsc-preview.png)
![ii-pix screenshot](../examples/paperclips-iipix-ntsc-openemulator.png)
![ii-pix preview](../examples/dhr/paperclips-iipix-ntsc-preview.png)
![ii-pix screenshot](../examples/dhr/paperclips-iipix-ntsc-openemulator.png)
### bmp2dhr (OpenEmulator screenshot)
![bmp2dhr screenshot](../examples/paperclips-bmp2dhr-openemulator.png)
![bmp2dhr screenshot](../examples/dhr/paperclips-bmp2dhr-openemulator.png)
Comparing bmp2dhr under openemulator is the scenario most favourable to it, since the 140px resolution and non-treatment of fringing is masked by the chroma blending. Colours are similar to ][-pix, but the 140px dithering and lack of gamma correction results in less detail, e.g. in hilights/shadows.
### a2bestpix (OpenEmulator screenshot)
![a2bestpix screenshot](../examples/paperclips-a2bestpix-openemulator.png)
![a2bestpix screenshot](../examples/dhr/paperclips-a2bestpix-openemulator.png)
This a2bestpix image is actually atypical in quality, and shows some severe colour errors relating to the pixels that should be close to the orange/brown colours. These may be due to errors/omissions in the set of "colour blocks". The effects of not gamma-correcting the source image can also be seen.
@ -225,7 +225,7 @@ The difference in treatment of NTSC artifacts is much more visible when using an
### Original
![original source image](../examples/groundhog-original.png)
![original source image](../examples/dhr/groundhog-original.png)
(Source: [Cephas](https://commons.wikimedia.org/wiki/File:Marmota_monax_UL_04.jpg), [CC BY-SA 3.0](https://creativecommons.org/licenses/by-sa/3.0), via Wikimedia Commons)
@ -233,34 +233,34 @@ The following images were generated with a palette matching the one used by Virt
### ][-pix
![original source image](../examples/groundhog-original.png)
![ii-pix preview](../examples/groundhog-iipix-virtualii-preview.png)
![original source image](../examples/dhr/groundhog-original.png)
![ii-pix preview](../examples/dhr/groundhog-iipix-virtualii-preview.png)
### bmp2dhr
![original source image](../examples/groundhog-original.png)
![ii-pix screenshot](../examples/groundhog-bmp2dhr-virtualii.png)
![original source image](../examples/dhr/groundhog-original.png)
![ii-pix screenshot](../examples/dhr/groundhog-bmp2dhr-virtualii.png)
The image is heavily impacted by colour fringing, which bmp2dhr does not account for at all. The difference in brightness of the groundhog's flank is also because bmp2dhr does not gamma-correct the image, so shadows/highlights tend to get blown out.
### bmp2dhr (OpenEmulator)
![original source image](../examples/groundhog-original.png)
![ii-pix screenshot](../examples/groundhog-bmp2dhr-openemulator.png)
![original source image](../examples/dhr/groundhog-original.png)
![ii-pix screenshot](../examples/dhr/groundhog-bmp2dhr-openemulator.png)
This bmp2dhr image was generated using a palette approximating OpenEmulator's colours (`--palette=openemulator` for ][-pix), i.e. not the same image files as above.
On OpenEmulator, which simulates NTSC chroma sub-sampling, the fringing is not pronounced but changes the colour balance of the image, e.g. creates a greenish tinge.
### ][-pix, 4-pixel colour (OpenEmulator)
![original source image](../examples/groundhog-original.png)
![ii-pix screenshot](../examples/groundhog-iipix-openemulator-openemulator.png)
![original source image](../examples/dhr/groundhog-original.png)
![ii-pix screenshot](../examples/dhr/groundhog-iipix-openemulator-openemulator.png)
Colour balance here is also slightly distorted due to not fully accounting for chroma blending.
### ][-pix, NTSC 8-pixel colour (OpenEmulator)
![original source image](../examples/groundhog-original.png)
![ii-pix screenshot](../examples/groundhog-iipix-ntsc-openemulator.png)
![original source image](../examples/dhr/groundhog-original.png)
![ii-pix screenshot](../examples/dhr/groundhog-iipix-ntsc-openemulator.png)
Detail and colour balance is much improved.

Before

(image error) Size: 456 KiB

After

(image error) Size: 456 KiB

Before

(image error) Size: 584 KiB

After

(image error) Size: 584 KiB

Before

(image error) Size: 566 KiB

After

(image error) Size: 566 KiB

Before

(image error) Size: 437 KiB

After

(image error) Size: 437 KiB

Before

(image error) Size: 494 KiB

After

(image error) Size: 494 KiB

Before

(image error) Size: 644 KiB

After

(image error) Size: 644 KiB

Before

(image error) Size: 579 KiB

After

(image error) Size: 579 KiB

Before

(image error) Size: 499 KiB

After

(image error) Size: 499 KiB

Before

(image error) Size: 505 KiB

After

(image error) Size: 505 KiB

Before

(image error) Size: 481 KiB

After

(image error) Size: 481 KiB

Before

(image error) Size: 582 KiB

After

(image error) Size: 582 KiB

Before

(image error) Size: 532 KiB

After

(image error) Size: 532 KiB

Before

(image error) Size: 496 KiB

After

(image error) Size: 496 KiB

Before

(image error) Size: 357 KiB

After

(image error) Size: 357 KiB

Before

(image error) Size: 473 KiB

After

(image error) Size: 473 KiB

Before

(image error) Size: 487 KiB

After

(image error) Size: 487 KiB

Before

(image error) Size: 403 KiB

After

(image error) Size: 403 KiB

Before

(image error) Size: 522 KiB

After

(image error) Size: 522 KiB

Before

(image error) Size: 502 KiB

After

(image error) Size: 502 KiB

Some files were not shown because too many files have changed in this diff Show More