API: ML5 (r1)

This API is for P5 Worlds using ML5. It has no Ancient Brain framework. Anything written in P5 with ML5 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 ML5 machine learning library, release 0.6.1.
  • See ML5 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/ML5 code, with setup() and draw().
• Run header on RHS. Many P5 type 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: