Metadata-Version: 2.1
Name: pygbuttons
Version: 0.9.4
Summary: Adds basic UI elements for pygame
Home-page: https://github.com/Jarno-de-Wit/PygButtons
Author: Jarno de Wit
Project-URL: Bug Tracker, https://github.com/Jarno-de-Wit/PygButtons/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# PygButtons
A module made to help create a UI in pygame by simplifying the creation and handling of basic UI objects (such as Buttons).

## Contents
- [Installation](#Installation)
- [Dependencies](#Dependencies)
- [Usage](#Usage)
- [Support](#Support)

## Installation
To install, run: `pip install pygbuttons`

## Dependencies
- Python => 3.8
- Pygame => 2.0.1

## Usage
To use the Buttons in a program, it is recommended to perform the following steps:
- Setup
  1. Import the module / the contents of the module.
  2. Set the settings for the Buttons module (framerate, scroll factor, scaling limits) where appropriate
  3. Create the required Buttons
- While running
  1. Pass all (relevant) Pygame.Events to the active Buttons in the input loop
  2. Draw the Buttons to the active screen
  3. Repeat

Getting an output from a Button can be done either by binding a function to the Button (which is then automatically executed when a certain action takes place), or by polling the Buttons value / status.

For a practical implementation, see the [example.py](https://github.com/Jarno-de-Wit/PygButtons/blob/main/Example.py) file.

## Support
For support / issues, please visit the issue tracker on [GitHub](https://github.com/Jarno-de-Wit/PygButtons/issues).

Source code available at: https://github.com/Jarno-de-Wit/PygButtons
