Basic Usage
Search and Connect to toio™Core Cube
First, call P5tCube.connectNewP5tCube()
and receive P5tCube
instance in Promise shown as below.
caution
This library depends on Web Bluetooth
so that this API must be called in a user-action function like mouseClicked()
or keyPressed()
etc.
const gCubes = [];
function mouseClicked() {
P5tCube.connectNewP5tCube().then( cube => {
// 'cube' is an instance of connected toio™Core Cube.
// Now you can call any API!
gCubes.push( cube );
} );
}
Then, we can fully access to any API of p5.toio
.
Use a P5tCube API
Basically, please refer to the P5tCube
API reference Page. Here is a simple example.
Example: Turn the light on
// Turn the light on with white
cube?.turnLightOn( 'white' );
OK. Super simple. You can confirm the result by OpenProcessing.
OpenProcessing Sample: Turn Light On
Use a P5tId API
For P5tId
class, refer to the P5tId
API reference Page. And here is another sample.
Example: Is on the tile mat
if (P5tId.ColorTileMat.isOnMat(cube?.x, cube?.y)) {
background('red');
} else if (P5tId.SimpleTileMat.isOnMat(cube?.x, cube?.y)) {
// Partially, this mat overlaps with Ring Mat.
background('blue');
} else{
background('white');
}
Also, you can play immediately from the following link.
OpenProcessing Sample: Is on Tile Mat