Brain

In VEX IQ (2nd 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.

• SDcard — This class enables reading from and writing to the Brain’s SD card for file storage, data logging, and loading external resources.

Class Constructors

brain();

Parámetros

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 — Play a preset sound from the Brain.

• 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

Parámetros	Type	Descripción
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 — Drives at the specified velocity.

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

Parameters

Parámetros	Type	Descripción
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.