Skip to main content

Creative coding in Python

Project description

---

p5

p5 is a Python library that provides high level drawing functionality to help you quickly create simulations and interactive art using Python. It combines the core ideas of Processing — learning to code in a visual context — with Python’s readability to make programming more accessible to beginners, educators, and artists.

Example

https://github.com/p5py/p5/blob/develop/docs/_static/readme.gif

p5 programs are called “sketches” and are run as any other Python program. The sketch above, for instance, draws a circle at the mouse location that gets a random reddish color when the mouse is pressed and is white otherwise; the size of the circle is chosen randomly. The Python code for the sketch looks like:

from p5 import *

def setup():
    size(640, 360)
    no_stroke()
    background(204)

def draw():
    if mouse_is_pressed:
        fill(random_uniform(255), random_uniform(127), random_uniform(51), 127)
    else:
        fill(255, 15)

    circle_size = random_uniform(low=10, high=80)

    circle((mouse_x, mouse_y), circle_size)

def key_pressed(event):
    background(204)

run()

Installation

p5 requires Python 3 to run. Once you have the correct version of Python installed, you can run:

$ pip install numpy
$ pip install p5 --user

to install p5.

Features Roadmap

Our end goal is to create a Processing-like API for Python. However, instead of being a strict port of the original Processing API, we will also try to extend it and use Python’s goodness whenever we can.

For now, though, we plan to focus on the following features:

  1. Support most 2D drawing primitives and related utility functions from the Processing API (as of the latest release, this is almost done).
  2. Support other parts of the Processing API: images, fonts, etc.
  3. Port relevant tutorials and reference material from Processing’s documentation.
  4. Support live coding of sketches in the Python REPL (here’s a screencast from an earlier prototype).

License

p5 is licensed under the GPLv3. See LICENSE for more details. p5 also includes the following components from other open source projects:

All licenses for these external components are available in the LICENSES folder.

---

Project details


Release history Release notifications

This version
History Node

0.3.0a2

History Node

0.3.0a1

History Node

0.1.0.dev4

History Node

0.1.0.dev3

History Node

0.1.0.dev2

History Node

0.1.0.dev1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
p5-0.3.0a2-py3.6.egg (205.3 kB) Copy SHA256 hash SHA256 Egg 3.6 Aug 29, 2017
p5-0.3.0a2-py3-none-any.whl (97.0 kB) Copy SHA256 hash SHA256 Wheel py3 Aug 29, 2017
p5-0.3.0a2.tar.gz (60.8 kB) Copy SHA256 hash SHA256 Source None Aug 29, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page