https://github.com/raphnet/gbcam2png
Game Boy Camera save RAM photo to PNG
https://github.com/raphnet/gbcam2png
Last synced: about 1 month ago
JSON representation
Game Boy Camera save RAM photo to PNG
- Host: GitHub
- URL: https://github.com/raphnet/gbcam2png
- Owner: raphnet
- Created: 2018-10-31T16:33:28.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-04-26T02:42:51.000Z (almost 4 years ago)
- Last Synced: 2023-08-18T08:26:37.377Z (over 1 year ago)
- Language: C
- Size: 8.79 KB
- Stars: 19
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-game-boy-camera-and-game-boy-printer-projects - Game Boy Camera save RAM photo to PNG
README
# Game Boy Camera save RAM photo to PNG
This is a command-line tool for extracting
Game Boy Camera photos from a save ram (.sav) file
and writing them in the PNG format.
Features:
* Extract "large" photos (128x112) to .PNG
* Extract "small" (thumbnail) photos to PNG
* Extract the "Game Faces" photo to a .PNG
* Recover deleted photos
* Single photo or batch (all photos) extraction
* List photos
The project homepage is located at: https://www.raphnet.net/programmation/gbcam2png/index_en.php
** A version for your browser **
A limited version (currently only shows "large" photos) written in Javascript/HTML5 is also
also included. It renders photos in Canvas elements which can then be saved by right-clicking
and choosing "Save as...". This version should run on any OS where a modern browser is available,
without using the command-line and without compiling anything.
[Try it right here!][https://www.raphnet.net/programmation/gbcam2png/gbcamtool.html]
## Use
### Help (-h)
```
Options:
-h Display this help text
-i index Source image index (first image is 0). Default: 0
-g Use gameface as source photo
-o output.png Export a single photo to a .png file
-b basename Export all photos to png files, using the specified basename
-d Display selected photo (see -i) to the terminal
-l List photos in save file
-a Also export deleted photos
-s Export/display small photos (32x32) intead of large photos (128x112)
-v Be verbose
```
### Examples
#### Listing photos (shows which one are active and deleted) ####
```./gbcam2png source.sav -l```
#### Exporting a single photo (index 0) to a .png file ####
```./gbcam2png source.sav -i 0 -o output.png```
#### Exporting all active photos ####
```./gbcam2png source.sav -b test```
For each active photo, a file named testXX.png (where XX corresponds
to the photo index, starting at 00) will be created.
#### Exporting all photos, including deleted ones ####
```./gbcam2png source.sav -b test -a```
## Compilation
### Linux
Install the libpng development package beforehand, and make sure pkg-config is in your
path. Then type ```make```.
## License
Public Domain
## Authors
* **Raphael Assenat**
## Acknowledgments
* Jeff F : For the "GB Camera Tech Info" (gbcam.txt) document