gameart 0.0.13

Create printable art from your mouse movement.

GameArt

Create printable art with the movement of your mouse.
Explore the source code »

View Readme · Report Bug · Request Feature

Table of Contents

1. Getting Started
   • Prerequisites
   • Installation
2. Usage
3. Enhancement
4. Contributing
5. License
6. Contact

Getting Started

GameArt is still work in progress. Currently it is possible to create a png-file with matplotlib from the recorded mouse movement using pynput. The "Art" aspect is currently missing, but I will work on that.

There are 3 package versions available:

• gameart: This version contains only the possibility to draw a png based on csv input. Also there is no CLI.
• gameart[full]: This version contains additionally the possibility to record your mouse movement and save it as a csv. Also it has a CLI.
• gameart[dev]: Same as [full] but with additional dev packages to be able to contribute to this project.

Prerequisites

• Supported python versions: Python 3.10, 3.11, 3.12
• Upgrade pip

  pip install --upgrade pip
  

• It is recommended to use the package inside a virtual environment.
  • Create virtual environment

  python -m venv env
  

  • Activate virtual environment - Linux

  source env/bin/activate
  

  • Activate virtual environment - Windows

  env/Scripts/activate
  

Installation

1. From GitHub:
   1. Clone the repo

   git clone https://github.com/AndManGames/GameArt.git
   

   2. Install gameart packages from git root path

   pip install .[full]
   

2. From PyPi:

pip install gameart[full]

(back to top)

Usage

• Start recording your mouse movement:

  gameart record
  

• Stop the recording by pressing the Right Mouse Button

• Generate image from your mouse recording:

  gameart draw --csv_file_path path/to/csv/file
  

  • If no output folder is specified the image will be saved to the current_dir/gameart_images.
  • Optionally you can specify an output folder (absolute path) by using the argument --output_folder.

  gameart draw --csv_file_path path/to/csv/file --output_folder path/to/output/folder
  

(back to top)

Enhancement

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue. Don't forget to give the project a star! Thanks again!

For contributing please use the dev setup of this package:

pip install .[dev]

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

Andreas Schneider - [e-mail]

Project Link: https://github.com/AndManGames/GameArt

(back to top)