What is it ?

This librairy aims to provide simple widget to improve pygame applications like buttons, text, textboxes or math text widgets. There is also some goemetric shapes, like rectangle or bezier curves.

Dependancies

• pygame : This library is fully based on pygame, so you must have it installed.

(optionnal) * latex : you must avec latex install if you want to use the LaText widget (latex and dvipng accessible in path)

Installation

You can install it with pip and pypi easily by :

pip install -U PygameGUILib

or via git and pip :

pip install -U git+https://github.com/ddorn/GUI.git@release#egg=GUI

Widgets

Actually there is a fex widgets in the library. I’ll try to maintain this list, but I’m sure I’ll forget, so there is MORE than that.

• Texts :

  • SimpleText

  • LaText

  • InLineInputBox

  • InLinePassBox

• Buttons :

  • Button

  • IconButton

  • SlideBar

Around that, there is a lot of helping objects, like Font, colors, V2 and Separator (some vector things), FPSIndicator, FocusSelector…

Use

# define the action the button will perform when clicked
def callback():
    print('PRESSED !")

button = Button(callback, (100, 100), (100, 40), "Click Me !")

for e in pygame.events.get():
    if e.type == pygame.MOUSEBUTTONDOWN and e.button == 1:  # left click
        if pygame.mouse.get_pos() in button:
            button.press()  # you tell the button to call the callback if clicked

button.render(display)  # you draw the button on the display

Help and todo list

You’re welcome !

How can you help ?

Todos :

• A Text class to make texts that goes on more lines and with wrapping.

• A TextBox, to input multi line text

• A RichText to make text with differents inner colors/size/font/styles

• Something like lists

• Switch class : Nice looking ON/OFF button

• Some geometry function to draw curves, grids and manipulate line, polygons

This is absolutly not an ordered list, they will come as I have nice looking and useable classes !

Cool projects with this library

• **Crabes** : a simulation too for a TFJM² problem

• Your project !

Examples at the and of each file can also give you a lot of samples of how to use this library :) There is also a folder full of example that you will apreciate !