API: P5 (r3)

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 minimal CSS that should not conflict with user 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

• World with no Mind

• World with Mind
• Mind

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 );            

Examples

Examples of Worlds that use this API: