Controller

Invoering

De klasse controller vertegenwoordigt een VEX V5-controller die is verbonden met de V5 Brain. Een object controller kan worden gebruikt om toegang te krijgen tot joystick-aswaarden, knopstatussen uit te lezen, callbacks voor knoppen of joysticks te registreren, de controller te laten trillen, naar het controllerscherm te schrijven en te controleren of de controller is verbonden.

VEX V5 is compatibel met de EXP Controller. Zie de EXP Controller API voor meer informatie.

Wanneer een of meer controllers zijn geconfigureerd in het venster Apparaten, biedt VEXcode V5 ook de globale variabele RemoteControlCodeEnabledDeze variabele maakt het mogelijk om controlleracties die in het menu Apparaten zijn geconfigureerd, in of uit te schakelen.

Afgeleide klassen

De controllerklasse controller bieden de volgende afgeleide klassen:

• Axis - Biedt toegang tot de invoerwaarden en wijzigingsgebeurtenissen van de joystickassen.

• Button - Biedt toegang tot de knopstatus en callbacks voor knopgebeurtenissen.

• Screen - Biedt functies voor het schrijven van tekst naar het controllerscherm.

Constructeurs

1 - Hiermee wordt een controller gemaakt met behulp van het primaire controllertype. Dit wordt doorgaans gebruikt wanneer er slechts één controller is aangesloten.

controller();

2 - Maakt een controller aan voor het opgegeven controllertype. Wordt gebruikt wanneer twee controllers zijn verbonden.

controller(
    controllerType id );

Beschikbare functies

controller();

controller(controllerType id);

Parameter	Type	Beschrijving
id	controllerType	Optioneel. Het type controller dat moet worden aangemaakt: primary voor de primaire controller die is verbonden met de Brain of partner voor de tweede controller die is verbonden met de Brain.

Opmerkingen

Only one primary Controller and one partner Controller can be created in a single project.

Voorbeeld

// Create the primary Controller
controller Controller1 = controller();

// Create a partner Controller
controller Controller2 = controller(partner);

Vernietiger

~controller

~controller vernietigt het controller object en geeft de bijbehorende resources vrij.

Beschikbare functie

~controller();

Parameters

Parameter	Type	Beschrijving
id	controllerType	Het type controller dat wordt aangemaakt: primary - De primaire controller die met de hersenen is verbonden. partner - De partner (tweede) controller die met de hersenen is verbonden.

Notities

• In een enkel project mogen slechts één primaire controller primary en één partnercontroller ( partner aanwezig zijn.

Voorbeeld

// Create a V5 controller instance
controller Controller = controller();

Lidfuncties

De klasse controller bevat de volgende lidfuncties:

• rumble - Laat de controller trillen volgens een patroon.

• installed - Controleert of de controller is verbonden met de hersenen.

gerommel

rumble zorgt ervoor dat de controller trilt volgens een bepaald patroon. In het patroon zijn stippen korte trillingen, streepjes lange trillingen en spaties pauzes.

Beschikbare functie

void rumble(const char *str);

Parameter	Type	Beschrijving
str	const char *	Een reeks stippen, streepjes en spaties die het rumble-patroon weergeven.

Retourwaarde

Deze functie retourneert geen waarde.

Voorbeeld

// Rumble with a short-short-long pattern
Controller1.rumble("..-");

Getter

geïnstalleerd

installed geeft aan of de controller is verbonden met de Brain.

Beschikbare functie

bool installed();

Parameters

Deze functie heeft geen parameters.

Retourwaarde

Retourneert een Booleaanse waarde.

• true - The controller is installed/connected.
• false - The controller is not installed/connected.

Globale variabelen

RemoteControlCodeEnabled

RemoteControlCodeEnabled schakelt de in het menu Apparaten geconfigureerde controlleracties in of uit. De in het menu Apparaten geconfigureerde controlleracties zijn standaard ingeschakeld.

Usage:
RemoteControlCodeEnabled = state;

Waarde	Beschrijving
true	Schakelt de door de controller geconfigureerde acties in.
false	Schakelt de door de controller geconfigureerde acties uit.

Values

• true - Controller-configured actions are enabled.
• false - Controller-configured actions are disabled.

Notes

• Door de controller geconfigureerde acties zijn standaard ingeschakeld.

Examples

// Drive forward or backward using the left joystick
RemoteControlCodeEnabled = false;

while (true) {
  if (Controller1.Axis3.position() > 0) {
    Drivetrain.drive(forward);
  }
  else if (Controller1.Axis3.position() < 0) {
    Drivetrain.drive(reverse);
  }
  // Press A to use Controller configured actions again
  else if (Controller1.ButtonA.pressing()) {
    break;
  }
  else {
    Drivetrain.stop();
  }

  wait(20, msec);
}

RemoteControlCodeEnabled = true;