Skip to main content

32Blit asset preparation and upload tools

Project description

32blit Tools

Build Status Coverage Status PyPi Package Python Versions

This tool is intended for use with the 32Blit console to prepare assets and upload games.

WORK IN PROGRESS

You should install from source using:

git clone https://github.com/pimoroni/32blit-tools
cd src/
python3 setup.py develop

Running

32blit --help

Packing Image Assets

All image assets are handled by Pillow so most image formats will work, be careful with lossy formats since they may add unwanted colours to your palette and leave you with oversized assets.

Supported formats:

  • 8bit PNG .png
  • 24bit PNG .png

Options:

  • palette - Image or palette file (Adobe .act, Pro Motion NG .pal, GIMP .gpl) containing the asset colour palette
  • transparent - Transparent colour (if palette isn't an RGBA image), should be either hex (FFFFFF) or R,G,B (255,255,255)
  • packed - (Defaults to true) will pack the output asset into bits depending on the palette size. A 16-colour palette would use 4-bits-per-pixel.
  • strict - Only allow colours that are present in the palette image/file

Packing Map Assets

Supported formats:

Packing Raw Assets

Supported formats:

  • CSV .csv
  • Binary .bin, .raw

Changelog

0.0.7

  • Add metadata tool - tags binary with metadata from a .yml file
  • Fix relative paths for packer palette files
  • Add support for subdirectories to 32blit flash save

0.0.6

  • Font tool (thanks @Daft-Freak)
  • Flash command with multi-target function (thanks @Daft-Freak)
  • Bugfixes to palette handling (thanks @Daft-Freak)
  • Bugfixes to package recognition (seemed to affect Python 3.8 on Windows)
  • Friendly (ish) error message when a .tmx tilemap with 0-index tiles is used (tmx is 1-indexed for valid tiles)

0.0.5

  • Output data length symbols (thanks @Daft-Freak)
  • Fix --packed to be default, again (packed can be disabled with --packed no)
  • Various other tweaks
  • Start of 32blit file upload support

0.0.4

  • Default images to packed (packed arg now takes a bool)
  • Fix bug in sprite payload size (thanks @Daft-Freak)

0.0.3

  • Fix packaging mishap so tool actually works

0.0.2

  • Real initial release
  • Pack, cmake and asset commands working
  • Very beta!

0.0.1

  • Initial Release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

32blit-0.0.7.tar.gz (16.5 kB view details)

Uploaded Source

Built Distribution

32blit-0.0.7-py3-none-any.whl (22.0 kB view details)

Uploaded Python 3

File details

Details for the file 32blit-0.0.7.tar.gz.

File metadata

  • Download URL: 32blit-0.0.7.tar.gz
  • Upload date:
  • Size: 16.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.6.9

File hashes

Hashes for 32blit-0.0.7.tar.gz
Algorithm Hash digest
SHA256 67dd7f4192f5e5b8104d3ced048273fe2788e5220be88d0b35d82c3f08a9bafc
MD5 05d63ce7b491dea36cb9fa7a40d19c38
BLAKE2b-256 5cdcb81878086a289eeb85420bcc8c83fb4e916f06293c382e462c9df5276b00

See more details on using hashes here.

File details

Details for the file 32blit-0.0.7-py3-none-any.whl.

File metadata

  • Download URL: 32blit-0.0.7-py3-none-any.whl
  • Upload date:
  • Size: 22.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.6.9

File hashes

Hashes for 32blit-0.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 0a20ab2de6d86214cd8931e1f313ac2f1e29ef002e77513219122dbb797d228f
MD5 7667aa003241878d859e64080affef40
BLAKE2b-256 50e269c97ca1d9195bc7b21b8ae13e719f7ec066c3de60f851554da9681f5d4a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page