pixpy 0.1.2

Graphics library

PIX (pixpy)

A graphics library with a python interface. Designed for learning and 2D game development.

Install

pip install pixpy

For Linux pip builds from source so you need a few dependecies;

sudo apt install libxinerama-dev libxi-dev libxrandr-dev libxcursor-dev

The Basics

The following is a full program that opens a window and draws a circle;

import pixpy as pix
screen = pix.open_display(width=1280, height=720)
screen.circle(center=(640,360), radius=300)

NOTE: This simple example works because if you try to exit before doing anything besides drawing, pix will "swap" the screen automatically to display what you drawn, and then leave the window open until you try to quit.

Normally you create your own main loop and do this yourself;

import pixpy as pix

screen = pix.open_display(width=1280, height=720)

x = 0
while pix.run_loop():
    screen.clear()
    screen.circle(center=(x,360), radius=x/4)
    x += 1
    screen.swap()

To read the keyboard and/or mouse, you can use is_pressed() or was_pressed()

import pixpy as pix

screen = pix.open_display(width=1280, height=720)

x = 0
moving = True
while pix.run_loop():
    if pix.was_pressed(' '):
        moving = not moving
    if moving:
        x += 1
    screen.clear()
    screen.circle(center=(x,360), radius=100)
    screen.swap()

For more advanced needs you use events

import pixpy as pix

screen = pix.open_display(width=1280, height=720)

while pix.run_loop():
    for e in pix.all_events():
        if type(e) == pix.events.Click:
            screen.filled_circle(center=e.pos, radius=15)
    screen.swap()

NOTE: This will not produce the desired effect; since we are double buffering, the circles will be randomly drawn to either of the two buffers and appear to blink.

The Console

A major part of pix is the Console

In its simplest form, it can be used for text output

The console needs to be drawn to be visible, just like everything else.

con = pix.Console(cols=80, rows=50)
con.write('Hello\n')
con.render(screen)

console.read_line() can be used to read lines of text. The result will be posted as a TextEvent.

import pixpy as pix

screen = pix.open_display(width=1280, height=720)
con = pix.Console(cols=40, rows=25)
con.write('What is your name?\n')
con.read_line()
while pix.run_loop():
    match pix.get_event():
        case pix.event.Text(text):
            con.write("Hello " + text)
            con.read_line()

    con.render(screen)
    screen.swap()

The Core Objects

• A Vec2 is a 2D dimensional vector with an x and y field that are used to represent 2D coordinates and sizes.

• An Image is a reference to a rectangular array of pixels on the GPU, or in other words, a set of 4 UV coordinates (known to form a rectangle) and a texture reference.

• The Screen represents the window or display.

• A Context ties together rendering state with a rendering target. The Screen, and all Images, can be treated as context and can be drawn to.