Straight from the landing page of the p5.js website.

…make coding accessible for artists, designers, educators and beginners…

p5.js is the result of hard-work of the Processing Foundation, a group focused on spreading computer and visual literacy. It distills their Processing language into a JavaScript library that makes creating graphics easy and accessible whilst providing an ideal platform to springboard people’s careers in computer graphics. It should be mentioned now that a lot of inspiration has been taken from Daniel Shiffman’s p5 projects (from the classic snake game, to a double pendulum). I can’t urge you enough to follow these projects to really improve your understanding of coding concepts and the p5 library.

Some prerequisites:

Before jumping into the p5 code I first want to make clear that there is assumed knowledge of HTML5 and JavaScript including arrays, functions, variables etc. in the rest of this article. If you have a good grasp of JavaScript then skip to the p5 code below, otherwise here are few resources to get you up to scratch.

HaC Intro to Programming — A workshop that is being run by Hackers at Cambridge to help anyone start learning to program (which uses JavaScript).

Codecademy — a great resource for learning how to code with instant feedback in your browser.

MDN — a great resource for learning about all aspects of web development.

Codepen — a brilliant online text-editor for creating cool projects in HTML, CSS and JavaScript. Equally good for getting inspiration from a lot of talented users. Another possible solution would be JSFiddle.

What follows is a series of steps that will introduce you to p5 concepts. With code examples and explanations I hope to give you enough information to understand the ideas, but to fully grasp the concepts you will have to dive into the code, experiment with it, break it and learn from it. So without further ado, let’s get coding.

Step 1: The Setup

p5 is really simple to setup once you know what to do. There are two files shown above — an index.html and a template.js. The index.html file gets the libraries for us and the template.js is the barebones structure of a p5 project and at the moment it does nothing! Within this we have two functions:

setup() — a function for creating what we will need for our graphic or project. Like creating a canvas, initialising some objects or arrays etc.

— a function for creating what we will need for our graphic or project. Like creating a canvas, initialising some objects or arrays etc. draw() — a function which will be called periodically like a loop. This is where will call draw functions and update functions to make graphics and animations.

Make sure to play with the variables and commented-out sections — what happens if you remove the background function and uncomment the rotate function?

Let’s first look at the setup function. We used the p5 function createCanvas(width, height) which created and initialised a canvas with arguments width and height. Now within our setup() and createCanvas() functions we can reference the variables width and height without ever instantiating them!

Next comes the meaty, draw function. I have purposefully put extra code in here so we can learn more about what p5 has to offer. Firstly always remember that draw() is a loop that runs from top to bottom. Initially, we set the background (of our canvas) to white with background(255) which is the same as background(255, 255, 255) (maximising the red, green and blue values to give white). This may seem simple, but implicitly we are also clearing our canvas every loop… in one line of code! This will be useful for animations later as we want to redraw objects in a new location rather than have the build-up on the same canvas (click to see it go spectacularly wrong). Next is a translate(width/2, height/2) which moves our current drawing location to the centre of our canvas. We then declare the fill colour of our triangle with fill(255, 0, 0) (making it red).

We want to create an equilateral triangle with side length s . The triangle itself is a function that takes the vertex coordinates as arguments — triangle(x1, y1, x2, y2, x3, y3) and in this example starting from the centre we have one vertex at (-s/2, 0) another at (s/2, 0) giving a bottom length of s . Now comes the trickier part. A very important aspect of most computer graphics is that the coordinate system starts in the top left corner (or wherever your origin is) and x increases left to right, whilst y increases top to bottom. To move of the screen we need a negative y value. Our last coordinate is given as (0, -sin(PI/3)) (if you’re stuck, think about cutting the triangle in two and using trigonometry).

Step 2: Get Creative

We’ve learnt how to set up our canvas and start drawing. Armed with the p5 reference page and our creativity, we can make some truly stunning graphics. How about a bouncing ball animation?

Let’s look at the interesting p5 aspects that we didn’t know before:

frameRate(20) — This enables us to specify the frame rate of our drawing loop, that is, how many times per second it redraws everything for us.

— This enables us to specify the frame rate of our drawing loop, that is, how many times per second it redraws everything for us. gravity = createVector(0, 9) — p5 allows us to create vector objects with which we can perform vector operations like addition, multiplication, dot-product and cross-product. This is useful when we want to simulate physics like forces.

— p5 allows us to create vector objects with which we can perform vector operations like addition, multiplication, dot-product and cross-product. This is useful when we want to simulate physics like forces. floor(random(50)) — Here we’re using p5 math functions. floor() takes a real number and rounds it down to the nearest integer. random(arg) produces a random number as small as 0 or up to 49. In this example, we are giving it to the ellipse(x, y, w) function to create randomly sized balls by setting the width to a random number. If we gave another argument it would set the ellipse’s height, but here it infers that we want a circle.

— Here we’re using p5 math functions. takes a real number and rounds it down to the nearest integer. produces a random number as small as 0 or up to 49. In this example, we are giving it to the function to create randomly sized balls by setting the width to a random number. If we gave another argument it would set the ellipse’s height, but here it infers that we want a circle. stroke(0) — This function sets the colour of our shape’s outline. If you don’t want any border you can add noStroke() .

All you need now is to add some physics to these ideas and you have yourself a bouncing ball animation.

Step 3: Experiment with p5

Hopefully now you have a good understanding of the p5 fundamentals, but we’ve barely scratched the surface. This last example will use two extra features of p5: interactivity and Perlin Noise. Keep reading to find out more on these two concepts.

In this CodePen I have created a relatively simple flame model using squares and Perlin Noise. First of all, how do we get user input? Lucky for us p5 has some functions that can help.

A simple sketch in p5 to draw a square where your mouse is pressed

At the top of the code we have declared a boolean “flag” as to whether or not our mouse is being pressed — this allows us to do things if the mouse is being held down. The touchStarted() and touchEnded() are p5 functions that are executed whenever the mouse is pressed or released or the screen is touched and released. Lastly, in our rect() function we have the variables mouseX and mouseY which are p5 variables corresponding to the mouse’s current position. Oddly, these also refer to your “touch” coordinates. With all these variables and functions predefined for us we can focus on making visually stunning graphics, whilst not being hampered by having to code extra functions unrelated to the graphic we’re producing.

Now for the Perlin Noise. In 1983, tired with the artificial look of computer graphics, Ken Perlin developed a type of gradient noise. The basic idea being you create a big grid of gradients randomly and then use the dot product to interpolate between them. In short, we get random values based on the coordinate system we’re drawing on. Great! For each of our squares we can start them at a random position near our mouse, and generate a random upward vector using their position and Perlin Noise. Let’s look at the code:

Some key things to notice:

noise(this.pos.x) — The Perlin Noise function that gets a random number based on the square’s current x position. It returns a value between 0 and 1.

— The Perlin Noise function that gets a random number based on the square’s current x position. It returns a value between 0 and 1. fill(this.r, this.g, this.b, this.alpha) — Here we have extended fill’s ability by including an alpha value for the objects transparency, by decreasing alpha in the update() function we get a nice fade out like a flame.

— Here we have extended fill’s ability by including an alpha value for the objects transparency, by decreasing alpha in the function we get a nice fade out like a flame. dead() — This function allows us to keep track of which particles have disappeared as their alpha is now less than zero. We can then splice() them out of our array to ensure we’re not drawing an unbounded number of particles over time which would cause performance issues.

As a challenge, you can also use blendMode() to make it seem even more realistic — check this alteration to see it in action.

With only a few concepts and the p5 library, it is incredibly straightforward to start building anything you want. Be sure to checkout what else is possible with the library. Here are few cool ideas to get you started: 3D graphics, sliders and images.

Conclusion

As computers and technology become ubiquitous in our daily lives and an increasing number of professions are now relying on computer literacy, p5.js is a beautiful example of how we can ensure as many people as possible have an entry-point to the wonderful world of computer programming. It also acts as a reminder to some more experienced programmers that creativity and imagination are vital in producing meaningful code and ultimately making the tech world a better place.

Hopefully this intro to p5 has convinced you of its usefulness and has encouraged you to start taking your first steps into the world of graphics programming. Here are my recommendations for where to go next:

The Coding Train — A brilliant YouTube channel by Daniel Shiffman where he teaches JavaScript and p5.js amongst many other incredible things!

p5js.org — The examples page on this website is full of inspiring projects which you could recreate and extend further.

Sratchapixel — If you feel ready to delve into the deeper concepts and implementations of computer graphics then this website is an incredible resource for you to use.

A special thanks to Tom Read Cutting for editing this article and Christian Silver for helping get it off the ground.