# PyGame Python Examples

This folder contains simple examples of using PyGame in Python to create simple UI tools or "game like" programs.

## Prerequesits

* All of these projects require the PyGame module.
* In order to create stand alone executables the pyinstaller module is required.
* The pillow module may be used by pyinstaller, and is quite the handy image manipulation library.

Inside a terminal:
```bash
pip install pygame pyinstaller pillow
```

## PyInstaller

Any programs set up to be able to use PyInstaller can be built to an EXE file using the provided `.spec` file. **DO NOT** use pyinstaller on a `.py` file directly unless you are creating a new `.spec` file. Doing so will overwrite the existing file.

Syntax:
```bash
pyinstaller MyFile.spec
```

This will create two folders named `Build/` and `Dist/`. The `.EXE` file will be created inside the `Dist/` folder. The executable can be moved anywhere on the system and does not need Python to be installed in order to work.

**WARNING NOTE:** If an icon is to be used for the created executable it is HIGHLY recommended to use an icon converter to create a singular `.ico` file that contains all icon resolutions inside it. An online tool such as [ICOConvert](https://icoconvert.com/) or [RedKetchup IconConverter](https://redketchup.io/icon-converter) can be used to convert a higher resolution image into a multi-resolution `.ico` file.