Brain

In VEX IQ (1st gen) C++, the Brain is represented by the brain class. You create (or use the default project-provided) Brain object and then access Brain features through its member objects.

Derived Classes

The brain class serves as a base class for the following derived classes:

• Screen — This class provides access to the Brain’s built-in color touchscreen, allowing programs to display text, graphics, and receive touch input.

• Timer — This class provides high-resolution timing utilities for measuring elapsed time and controlling time-based behavior in programs.

• Battery — This class allows programs to monitor the Brain’s battery status, including voltage, current, capacity, and temperature.

• Button — This class provides access to the Brain’s buttons.

Class Constructors

brain();

Parameters

The brain constructor uses no parameters.

Notes

• Only one brain object should be created in a project.

Example

// Create the Brain
brain Brain = brain();

Member Functions

The brain class includes the following member functions:

• playSound — Plays one of the Brain’s built-in sound effects.

• playNote — Play a musical note from the Brain.

Before calling any brain member functions, a brain instance must be created, as shown below:

// Create the Brain
brain Brain = brain();

playSound

Plays one of the Brain’s built-in sounds.

Available Functions

void playSound( 
    soundtype sound );

Parameters

Parameters	Type	Description
sound	soundtype	The specified sound to play from the Brain.

Sound Name	Play Sound
alarm	Play
alarm2	Play
doorClose	Play
fillup	Play
headlightsOff	Play
headlightsOn	Play
powerDown	Play
ratchet	Play
ratchet2	Play
siren	Play
siren2	Play
tada	Play
tollBooth	Play
wrench	Play
wrongWay	Play
wrongWaySlow	Play

Return Values

This function does not return a value.

playNote

Plays a musical note from the Brain.

Available Functions

void playNote( 
    soundtype sound );

1 — Play a musical note.

void playNote(
    int32_t octave
    int32_t note );

2 — Play a musical note for a specific duration.

void playNote(
    int32_t octave,
    int32_t note,
    int32_t duration );

Parameters

Parameters	Type	Description
octave	int32_t	The integer that represents the octave the note is played in: 1 to 3 – low octave 4 to 7 – high octave
note	int32_t	The note to play: 0 – C 1 – D 2 – E 3 – F 4 – G 5 – A 6 – B
duration	int32_t	Optional. The duration in milliseconds to play the note for, up to a max of 500 milliseconds. If no duration is provided, the default duration is 500 milliseconds.

Return Values

This function does not return a value.