# Java Desktop Image-to-ASCII Converter, Containerised

Apps & experiments · Creator, sole engineer · shipped

An image-to-ASCII converter where the engineering is in the responsiveness and the output quality.

Code: https://github.com/vasu-devs/PixelForge

## The detail

Rendering runs multi-threaded in the background so the interface never blocks, and the quality slider is debounced so a single render fires when you stop dragging rather than dozens as you move.

Full-colour mode samples the original image's pixel colours and applies them per character, recreating the image through typography. Export triggers a separate high-resolution render pass at the source image's original dimensions - so a 4K input produces a 4K ASCII image rather than an upscaled screenshot of the preview.

The deployment side was the harder problem: packaging a desktop GUI application into a container with a multi-stage build so it can run from a browser tab.

Java 17, JavaFX, Maven, Docker, Docker Compose.

## What I did

- Built a multi-threaded rendering engine so the interface never blocks during conversion
- Implemented slider debouncing so one render fires when the user stops dragging rather than per pixel of movement
- Built a full-colour mode sampling original pixel colours per character
- Added a dedicated high-resolution export pass at the source image's original dimensions
- Containerised a desktop GUI application with a multi-stage build so it runs from a browser tab

## Stack

Java, JavaFX, Maven, Docker, Multithreading, Image Processing, CI/CD

Case study: https://www.siddhvasudev.com/projects/java-desktop-image-to-ascii-converter
