API: ML5 (AB) (r1)

This API is for P5 Worlds using ML5. It comes with an Ancient Brain framework to make writing Worlds easier. This would require changes to existing ML5 worlds. So this is really for writing new ML5 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 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.

• 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 by default. To do 3D graphics see below.
• 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/ML5 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

• World with no Mind

• World with Mind
• Mind

ABWorld

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

 

 ABWorld;       // instance of class ABWorldClass - basic functionality for this API
  
  
 ABWorld.webgl = false;   
 
   // define graphics mode (2D or 3D)
   // 2D is default
   // for 3D set this to true   

  
 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.

Examples

Examples of Worlds that use this API: