https://github.com/tlsa/nonogif
Command line Nonogram solver that outputs an animated GIF of the solution
https://github.com/tlsa/nonogif
animation cli gif nonogram picross pixel puzzle solver
Last synced: about 1 year ago
JSON representation
Command line Nonogram solver that outputs an animated GIF of the solution
- Host: GitHub
- URL: https://github.com/tlsa/nonogif
- Owner: tlsa
- License: isc
- Created: 2022-12-30T11:31:19.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-01-05T19:33:03.000Z (over 3 years ago)
- Last Synced: 2025-02-03T21:44:54.196Z (over 1 year ago)
- Topics: animation, cli, gif, nonogram, picross, pixel, puzzle, solver
- Language: C
- Homepage:
- Size: 72.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
NonoGIF: Render Nonogram solutions to GIFs
==========================================
This command line program renders [Nonogram](https://en.wikipedia.org/wiki/Nonogram)
puzzles to GIF files. It provides a range of options to control the look of the
output animation.
Nonograms (also known as Paint by Numbers, Picross, and Pixel Puzzles, amongst
others) are a form of puzzle where the object is to use clues to fill in the
cells in a grid to reveal a picture. The clues are provided as a series of
numbers for each row and column, indicating the length of groups of contiguous
cells along that line that may be filled in.
## Why
This is not a clever or efficient solver. It simply tries every possible
option for every line until the puzzle is complete.
I made it because I was given a Nonogram in a Christmas card and I thought it
would be fun to write a program to solve it, and send my friend a GIF of the
solution. The above animation was generated by solving the
[nonogif.yaml](test/data/nonogif.yaml) puzzle with the following command:
```bash
nonogif \
--delay 20 \
--style detail \
--final-delay 1000 \
--output docs/nonogif.gif \
test/data/nonogif.yaml
```
## Features
* Basic Nonogram solver.
* Reads YAML format input file.
* Command line interface.
* Configurable GIF output.
- Options to animate line by line, pass by pass or simply render the final
result to a non-animated GIF.
- Options to control animation behaviour, e.g. inter frame delays.
- Options to control appearance, e.g. grid size, border thickness and colours.
## Dependencies
* [libcgif](https://github.com/dloebl/cgif): GIF encoding.
* [libcyaml](https://github.com/tlsa/libcyaml): YAML loading.
On a Debian or Ubuntu system, install them with:
```bash
sudo apt-get install libcgif-dev libcyaml-dev
```
## Building
Simply run
```bash
make
```
By default a `release` build is built. To build a `debug` or `sanitizer`
variant, set `VARIANT` accordingly:
```bash
make VARIANT=debug
make VARIANT=sanitizer
```