# Pixel Art

Pixel Art turns a TV, monitor, projector, or browser into a fullscreen gallery of colourful pixel-art scenes.

![Pixel Art icon](pwa-512x512.png "Pixel Art icon")

## Getting started

1. Open `/pixelart/` on the screen where you want to show the artwork.
2. Scan the QR code with a phone, or open `/pixelart-c/` in the same RCWeb room.
3. Choose a gallery from the phone controller.
4. Let the slideshow play automatically, or use the controls to pause and browse at your own pace.

## Key features

- Fullscreen, distraction-free pixel-art presentation.
- Themed collections including travel, science fiction, and other curated scenes.
- Automatic playback, with a new image shown every 12 seconds.
- Previous, next, pause, play, gallery, and individual image controls from a phone.
- Direct touch or mouse controls on the display itself.
- Automatic state sharing, so a newly opened controller shows the current gallery, image, and playback status.
- Layouts designed to remain clear on landscape and portrait screens.

## Controlling the display directly

Tap or click the left third of the screen for the previous image, the centre to pause or play, and the right third for the next image. Control hints appear while you interact and fade away after five seconds.

## Using more than one controller

Multiple phones can open Pixel Art Controls in the same RCWeb room. Each controller follows the state owned by the display, so everyone sees which gallery and image are currently selected.

## Companion app

Use this display with **Pixel Art Controls** (`/pixelart-c/`).

## Artwork assets

Request new artwork from the image generator at exactly 1920x1080. If the generator cannot produce that size or returns different dimensions, keep the returned image at its native pixel dimensions. Do not crop, upscale, downscale, stretch, or pad it to force 1920x1080.

Convert accepted artwork to JPEG quality 85 with `convert-image.ps1`; the converter verifies that the JPEG dimensions exactly match the source dimensions and fails visibly if they do not.