https://github.com/aftersol/n64_qoi_demo

QOI Viewer that runs on N64
https://github.com/aftersol/n64_qoi_demo

c homebrew libdragon n64 qoi

Last synced: over 1 year ago
JSON representation

QOI Viewer that runs on N64

• Host: GitHub
• URL: https://github.com/aftersol/n64_qoi_demo
• Owner: Aftersol
• Created: 2025-01-20T06:11:16.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-02T21:49:15.000Z (over 1 year ago)
• Last Synced: 2025-03-02T22:19:26.387Z (over 1 year ago)
• Topics: c, homebrew, libdragon, n64, qoi
• Language: C
• Homepage: https://aftersol.github.io/n64_qoi_demo/
• Size: 692 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# N64 QOI Viewer

An image viewer that loads QOI images on N64

![An fuzzy image of a parrot](assets/demo_images/qoi_demo_image0.jpg)

![An fuzzy image of four dice. The red die is in front. Blue, green, and yellow in the back in a triangle clockwise formation](assets/demo_images/qoi_demo_image1.jpg)

## How to View Images on N64 QOI Viewer

The maximum supported width is 320px and the maximum supported height is 240px.

This step assumes you have FFMPEG installed.

1. Encode your image into QOI using the following commands. The ones in <> are changeable

```bash

ffmpeg -i  -pix_fmt  -s x .qoi

```

For pixel art, the flags will scale the image using the nearest neighbor flag: `-sws_flags neighbor`

This is useful for scaling up pixel art images

2. Place the encoded QOI images into the filesystem folder. make will include these images in the filesystem folder into built ROM.

## How to Build N64 QOI Viewer

This tutorial assumes you have your N64 Toolchain set up including GCC for MIPS.

Make sure you are on the preview branch of libdragon.

Clone this repository with `--recurse-submodules` or if you haven't run:

```bash

git submodule update --init

```

---

Initialize libdragon:

```bash

libdragon init

```

Then run make to build this project:

```bash

libdragon make

```

---

## Licenses

Everything in the src folder is licensed under MIT License

In the filesystem folder the following images are in the public domain:

- zz_qrcode.qoi

- z_smpte_color_bars.qoi

- z_ebu_colour_bars.qoi

The rest of the images in the filesystem folder are under their respective licenses