pyxreser is a small Python library designed to simplify the creation of Pyxel images by converting 256x256 pixel 15-color PNG or JPG images into .pyxres files.
Project description
Pyxreser
Pyxreser is a small Python library designed to simplify the creation of Pyxel image by converting 256x256 pixel 16-color PNG or JPG images into .pyxres files.
Why?
This library was born out of frustration with the inconvenient use of Pyxel's built-in editor and aims to provide a simpler alternative for generating custom images for your games. It's mainly a personal desire to easily create a tile map using image software such as Microsoft Paint or pixel-editing software such as PyxelEdit, PixelEditor which makes my life a lot easier when creating games. If you're on this page, you're probably looking for a solution to do just that, and I think pyxreser is it.
Features
- Converts 16-color 256-pixel PNG or JPG images into Pyxel image.
Installation
pip install pyxreser
Usage
To use Pyxreser, you can run the following command in your terminal:
pyxreser image [-h | --help] [TYPE] [N | -n N] [IMAGE | -i IMAGE | --image IMAGE] [OUTPUT | -o OUTPUT | --output OUTPUT] [-v | --version]
Optional options :
-h, --help Displays this help message and quits
-v, --version Displays Pyxreser version
OUTPUT: Pyxres output path and .pyxres file name (default: input image name without extension)
Arguments :
TYPE, there is only the "image" type for the moment. (future versions will include "tilemap", "sound", "music")
N, image number (1-3) (default: 1)
IMAGE, Image input path,
It's important to note that the provided image must adhere to the following criteria:
- It must contain exactly 16 different colors.
- Its size must be 256x256 pixels.
If a .pyxres file already exists at the specified location, Pyxreser will modify it by replacing the existing image with the new one.
If your image does not contain the same default colors on Pyxel, Pyxreser will automatically generate or replace a .pyxpal file in addition to your .pyxres file.
Example
pyxreser image 0 picture.png resource.pyxres
Future Features Checklist
- Image Conversion: Convert tilemap files into Pyxel-compatible tilemap.
- Sound Conversion from MP3: Convert MP3 audio files for integration into games.
- Music Conversion from MP3: Convert MP3 music files into Pyxel-compatible audio formats.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file pyxreser-1.0.0.tar.gz
.
File metadata
- Download URL: pyxreser-1.0.0.tar.gz
- Upload date:
- Size: 5.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.10.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 88cff4d5424b1b8489300d32fd9ec48d1c31564cd35d352c9925b046d44b15a8 |
|
MD5 | b52948a08a72bea7eba9d397c39c8f7e |
|
BLAKE2b-256 | 132b33531337858ec8ccb8accd4be2f08d02acfdcac02e1520f96d6be073deb5 |