mirror of
https://codeberg.org/vlw/pysheeter.git
synced 2025-09-13 19:23:41 +02:00
Update README
Added basic usage information. TODO: Add advanced usage with `self.sprites` etc.
This commit is contained in:
parent
b5fa5913f1
commit
025a0e5fe0
1 changed files with 89 additions and 2 deletions
91
README.md
91
README.md
|
@ -1,2 +1,89 @@
|
|||
# pysheeter
|
||||
Lightweight Python-script to create sprite sheets from PNGs
|
||||
# PySheeter
|
||||
Lightweight Pillow Python-script to create and scale sprite sheets from PNGs in folders or individually
|
||||
|
||||
## Get started / Basic usage
|
||||
1. Download and install [Python 3](https://www.python.org/downloads/) for your architecture
|
||||
2. Download and install [Pillow](https://pypi.org/project/Pillow/) for Python 3 with `pip3`
|
||||
```bash
|
||||
$ pip3 install Pillow
|
||||
```
|
||||
### Sprite sheet from folder
|
||||
1. Import `Sheet` from `pysheeter`
|
||||
```python
|
||||
from pysheeter import Sheet
|
||||
```
|
||||
2. Initialize the class with a path to your PNG-folder
|
||||
```python
|
||||
spritesheet = pysheeter.Sheet("example/")
|
||||
```
|
||||
3. Create a sprite sheet with `put()`
|
||||
```python
|
||||
spritesheet.put("example_v1616.png",(16,16))
|
||||
# Creates a vertical spritesheet named 'example_v1616.png' with the dimensions 16x16px (scaled automatically)
|
||||
```
|
||||
|
||||
__Example usage:__
|
||||
```python
|
||||
# from 'example.py'
|
||||
from pysheeter import PySheeter
|
||||
|
||||
# Load sprites from 'example/'
|
||||
spritesheet = PySheeter.Sheet("example")
|
||||
|
||||
# Create a vertical spritesheet with the dimensions 16x16
|
||||
spritesheet.put("example_v1616.png",(16,16))
|
||||
|
||||
# Create a horizontal spritesheet with the dimensions 16x32
|
||||
spritesheet.put("example_h1632.png",(16,32),False)
|
||||
```
|
||||

|
||||

|
||||
### Sprite sheet from individual PNG-images
|
||||
1. Import `Sheet` from `pysheeter`
|
||||
```python
|
||||
from pysheeter import Sheet
|
||||
```
|
||||
2. Initialize the class without any arguments
|
||||
```python
|
||||
spritesheet = pysheeter.Sheet()
|
||||
```
|
||||
3. Add PNG-images with `add()`
|
||||
```python
|
||||
spritesheet.add("example/1.png")
|
||||
spritesheet.add("example/2.png")
|
||||
spritesheet.add("example/3.png")
|
||||
...
|
||||
```
|
||||
4. Remove PNG-images with `remove()`
|
||||
```python
|
||||
spritesheet.remove("example/2.png")
|
||||
```
|
||||
5. Create a sprite sheet with `put()`
|
||||
```python
|
||||
spritesheet.put("example_v1616.png",(16,16))
|
||||
# Creates a vertical spritesheet named 'example_v1616.png' with the dimensions 16x16px (scaled automatically)
|
||||
```
|
||||
|
||||
__Example usage:__
|
||||
```python
|
||||
from pysheeter import PySheeter
|
||||
|
||||
# Load sprites from 'example/'
|
||||
spritesheet = PySheeter.Sheet()
|
||||
|
||||
# Add PNG-images
|
||||
spritesheet.add("example/1.png")
|
||||
spritesheet.add("example/2.png")
|
||||
spritesheet.add("example/3.png")
|
||||
spritesheet.add("example/7.png")
|
||||
spritesheet.add("example/5.png")
|
||||
spritesheet.add("example/9.png")
|
||||
|
||||
# Create a vertical spritesheet with the dimensions 16x16
|
||||
spritesheet.put("example_v1616.png",(16,16))
|
||||
|
||||
# Create a horizontal spritesheet with the dimensions 16x32
|
||||
spritesheet.put("example_h1632.png",(16,32),False)
|
||||
```
|
||||

|
||||

|
||||
|
|
Loading…
Add table
Reference in a new issue