API: P5 (AB) (r2)

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

This API is for P5 Worlds. It comes with an Ancient Brain framework to make writing Worlds easier. This would require changes to existing P5 worlds. So this is really for writing new P5 Worlds for this platform.

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.)
Automatically creates a canvas in a div in the run window.
The author can use P5 functions to create graphics on the canvas.
Creates canvas for 2D graphics.
The Ancient Brain framework ("newRun" and "nextStep") conflicts with the P5 way of doing things ("setup" and "draw"). So this is really for writing new P5 Worlds for this platform.
For run control, the author can use either P5 framework or Ancient Brain framework. See below.
No built-in user camera control.

Templates

ABWorld

This API defines a global variable "ABWorld" with functionality as follows.

 

 ABWorld;       // instance of class ABWorldClass - basic functionality for this API
  
  
 ABWorld.init ( color );             
  
   // create canvas with some background color	
   // this defines a setup() function and calls P5's createCanvas() function
  
	
 ABWorld.p5canvas;	
	
   // The object returned by P5's createCanvas() function


 ABWorld.canvas;		
	
   // The object corresponding to p5canvas.canvas

Do not define a setup() function

P5 uses global functions setup() and draw().
This API provides AB support. It defines its own setup() function internally to create the canvas.
Hence in your World:

Do not define a setup() function.
The World can define beforesetup() and aftersetup() functions for code it wants run just before canvas creation and just after canvas creation.

Also:

The draw() function is optional.
This API uses nextStep() or takeAction() to do the run loop, so you can put the code in there, or in a draw() function.