# ascii-scenery-assembler
A tool that helps with putting ascii sprites over each other.

## Guide

### Requirements
1. Python (3.10-ish or more recent recommended)
2. pip for easy installation
3. git for alternative installation

If you're not sure whether you have Python on your machine, type `python --version` in the terminal. If you get something like "no such command", go to https://python.org and get it from there.

### Installation
Type `pip install asciiasm` in the terminal.
With git:
Type `git clone https://github.com/aal337/ascii-scenery-assembler.git` in the terminal, then `cd ascii-scenery-assembler`, then `pip install .` .

### Usage
1. Type `asciiasm` in the terminal.
2. Available commands:
    - `load sprite path/to/sprite.txt`
      where path/to/sprite.txt is the path to your sprite, which will be used as its name.
      Sprites currently have to be perfectly rectangular, including whitespace.
    - `place sprite layer row column`
      where layer is the number of the layer you want to put the sprite into, row the number of the row where the top left corner of the sprite should be, and column the number of the column. Rows/columns start at 0 and are counted from top to bottom/left to right.
      Layers start at 0, the higher the number, the further your sprite is 
    - save canvas path
      where path is the path at which you want to save your canvas.
3. End application:
    - CTRL + C
    - Type `exit tool`

The app will crash if you do something like opening a nonexistent file or placing a nonexisting sprite.
### Features
Currently, you may want to use something else with more QoL and customisation options. Analysing sprites to determine which whitespace fills a shape and which whitespace is outside of a shape to make the latter transparent is the main feature of this tool.
See also: https://summer.hackclub.com/projects/6906

## Disclaimer
I am not absolutely sure if everything works properly. Just take a look at the contents of the tests folder.
Your terminal could behave weirdly after usage.

## Contribution
If you've got feedback, send an email or open an issue.