brain

Initializing the brain Class

The Brain is created by using the following constructor:

The brain constructor uses no parameters.

// Create a new object "Brain" with the brain class.
brain Brain;

This Brain object will be used in all subsequent examples throughout this API documentation when referring to brain class methods and attributes.

The brain class comes with six pre-defined attributes:

• Battery - Provides information about the IQ (1st gen) Brain’s battery, including capacity, voltage, and current.

• Button - Allows you to detect button presses and assign functions to button events on the IQ (1st gen) Brain.

• Timer - Provides functionality to measure elapsed time and assign functions to time-based events on the IQ (1st gen) Brain.

• Screen - Enables you to display text and draw images on the IQ (1st gen) Brain’s screen.

Attributes

• Battery
• Button
• Timer
• Screen

Class Methods

In addition to its attributes, the Brain class provides several methods that can be used directly.

playSound()

The playSound(sound) method plays a sound on the Brain.

Parameters	Description
sound	A valid SoundType.

Returns: None.

// Play a sound of type TADA.
Brain.playSound(tada);

playNote()

This method can be called in the following ways:

The playNote(octave, note) method plays a note in the given octave on the Brain.

Parameters	Description
octave	The octave to use.
note	The note to play.

// Play a note on the Brain.
Brain.playNote(1, 4);

The playNote(octave, note, duration) method plays a note in the given octave on the Brain and waits for the given time before returning.

Parameters	Description
octave	The octave to use.
note	The note to play.
duration	The duration in milliseconds to play the note for.

// Play a note on the Brain.
Brain.playNote(1, 4, 200);

soundOff()

The Brain.soundOff() method stops any sound that is playing.

Returns: None.