Metadata-Version: 2.4
Name: pixel-space-asset-toolkit
Version: 0.1.4
Summary: Deterministic pixel-art space asset utilities for starfields, asteroid tiles, sprite cleanup, galleries, and previews.
Author: Pixel Space Asset Toolkit contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/NonniGB/godot-production-toolkit/tree/main/pixel-space-asset-toolkit
Project-URL: Issues, https://github.com/NonniGB/godot-production-toolkit/issues
Keywords: pixel-art,procedural,godot,space,assets,gamedev
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Games/Entertainment
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Pillow>=10
Dynamic: license-file

# Pixel Space Asset Toolkit

Deterministic procedural tools for pixel-art sci-fi prototypes: starfields, hex asteroid tiles, transparent-background cleanup, preview sheets, and Godot import guidance.

This repo is intentionally more visual than the audit tools, but it still behaves like a production CLI: fixed seeds, manifests, tests, and repeatable outputs.

## Install

```powershell
python -m pip install -e .
```

When published:

```powershell
python -m pip install pixel-space-asset-toolkit
```

## Quick Start

```powershell
pixel-space-assets starfield --width 1080 --height 1920 --seed 42 --stars 900 --output generated\starfield.png --manifest generated\starfield.json
pixel-space-assets asteroid-hex --material ferric --count 32 --size 64 --seed 7 --output generated\ferric
pixel-space-assets strip-background input.png --output cleaned.png --tolerance 4
pixel-space-assets preview generated\ferric --columns 8 --cell-size 64 --output generated\ferric_preview.png
pixel-space-assets compare baseline.png current.png --diff-output generated\diff.png --format json
pixel-space-assets compare-dir baseline\ferric generated\ferric --diff-output-dir generated\ferric_diffs --format json
pixel-space-assets compare-manifest baseline\ferric\manifest.json generated\ferric\manifest.json --diff-output-dir generated\ferric_manifest_diffs --format json
pixel-space-assets starfield --width 1080 --height 1920 --seed 42 --stars 900 --output generated\starfield.png --format json
```

## Tools

- `starfield`: deterministic pixel starfield backgrounds.
- `asteroid-hex`: deterministic transparent hex asteroid tiles.
- `strip-background`: converts a flat corner-color background to alpha.
- `preview`: builds contact sheets for review.
- `compare`: compares two PNGs and writes a red-highlight diff image.
- `compare-dir`: compares PNG sets and writes matching diff images by relative path.
- `compare-manifest`: compares generated PNG sets through manifests and reports field drift.

## Sample Gallery

Generated from fixed seeds:

![Generated starfield](examples/gallery/starfield_64.png)

![Ferric asteroid preview](examples/gallery/ferric_preview.png)

Open `examples/gallery/index.html` for a simple static gallery view.

## Documentation

- [Starfields](docs/STARFIELDS.md)
- [Asteroids](docs/ASTEROIDS.md)
- [Background stripping](docs/BACKGROUND_STRIPPING.md)
- [Preview sheets](docs/PREVIEWS.md)
- [PNG comparison](docs/PREVIEWS.md#png-comparison)
- [Godot import guide](docs/GODOT_IMPORT.md)
- [CI usage](docs/CI.md)

## Development

```powershell
python -m pip install -e .
python -m unittest discover -s tests -v
pixel-space-assets starfield --width 64 --height 64 --seed 1 --stars 20 --output generated\starfield.png
```

Examples are generic and reproducible. Private project-specific art should stay outside the published repository unless intentionally released.
