API: P5 (r2)

API	Uses canvas	Graphics libraries	AB framework	Worlds using this API	Starter Worlds
P5 (r2)	Yes	P5	No	590 Worlds	None

This API is for P5 Worlds. It has no Ancient Brain framework. Anything written in P5 should run using this API without change.

This API has the following features:

Includes P5 graphics library, release 1.3.1.
- Includes P5 sound, release 0.3.12.
- See P5 docs.
Includes jQuery 3.6.0.
Loads up lots of CSS - all the CSS used on the AB login pages. At the risk of conflict with user CSS. (Later APIs load up minimal CSS.)
No Ancient Brain framework.
World has to do everything. It has to create its own canvas. It has to do its own camera control.
World author writes normal P5 code, with setup() and draw().
Run header on RHS. Many P5 worlds use fixed small dimension canvas, which will go in top LHS. So this API puts run header on RHS.
If World uses Minds, World author must call the Mind themselves inside the draw function:
```
 AB.mind.getAction ( state );  
```
If you turn canvas off ("noCanvas") the API uses the html2canvas library to build a screenshot of your page.
If you are using "noCanvas", note the html2canvas library has some limitations and may not be able to accurately screenshot your page.

Templates

ABWorld

This API does not have AB support.
It defines a global variable called "ABWorld" with not much in it:

 

 ABWorld;                 // instance of class ABWorldClass  
 

 ABWorld.canvas;          // a variable to point to the canvas   		
  
 
 ABWorld.fullwidth();     // return full width of window on desktop / screen on mobile 
 ABWorld.fullheight();    // return full height of window on desktop / screen on mobile

Creating canvas

For making screenshots, Ancient Brain needs to find the canvas.
Normally with P5 you createCanvas() and carry on:

 
	  createCanvas ( ... );

If the canvas does not display, or if the AB system fails to find the canvas for screenshots, help it out by telling it where the canvas is:

 

	var canvas = createCanvas ( ... );		 

	ABWorld.setCanvas ( canvas );