Controlador#

Introdução#

A classe controller representa um controlador VEX IQ ligado ao IQ Brain. Um objeto controller pode ser utilizado para aceder aos valores dos eixos do joystick, ler os estados dos botões, registar funções de callback (callbacks) de botões ou joystick e verificar se o controlador está ligado.

O módulo IQ (2ª geração) pode ser ligado a um controlador IQ (2ª geração) ou a um controlador IQ (1ª geração). Um controlador IQ (1ª geração) deve ter um Smart Radio azul instalado.

Quando um ou mais controladores são configurados na janela Dispositivos, o VEXcode IQ também fornece RemoteControlCodeEnabledEsta variável global ativa ou desativa as ações do controlador configuradas no menu Dispositivos.

Classes Derivadas#

A classe controladora controller classes derivadas:

  • Axis - Fornece acesso aos valores de entrada do eixo do joystick e aos eventos de mudança.

  • Button - Fornece acesso ao estado do botão e aos retornos de chamada de eventos do botão.

Construtores#

1 - Cria um controlador utilizando o tipo de controlador primário. Normalmente utilizado quando apenas um controlador está ligado.

controller();

2 - Cria um controlador para o tipo de controlador especificado. Utilizado quando dois controladores estão ligados.

controller(
    controllerType id );

Funções disponíveis

controller();

controller(controllerType id);

Parâmetro

Tipo

Descrição

id

controllerType

Opcional. O tipo de controlador a criar: primary para o controlador primário ligado ao cérebro ou partner para o segundo controlador ligado ao cérebro.

Notas

Num único projeto, é possível criar apenas um controlador primário primary e um controlador parceiro partner.

Exemplo

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

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

Destruidor#

~controlador#

~controller destrói o objecto controlador controller e liberta os recursos associados.

Função disponível

~controller();

Parâmetros#

Parâmetro

Tipo

Descrição

id

controllerType

Tipo de controlador que está a ser criado:

  • primary - O controlador primário ligado ao cérebro.
  • partner - O controlador parceiro (segundo) ligado ao cérebro.

Notas#

  • Only one primary and one partner controller may exist in a single project.

Exemplo#

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

Funções de membro#

A classe do controlador controller inclui a seguinte função membro:

  • installed - Verifica se o controlador está ligado ao cérebro.

instalado#

installed retorna se o controlador está ligado ao cérebro.

Função disponível

bool installed();

Parâmetros

Esta função não tem parâmetros.

Valor de Retorno

Retorna um valor booleano.

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

Variáveis ​​Globais#

Código de controlo remoto ativado#

RemoteControlCodeEnabled activa ou desactiva as acções do controlador configuradas no menu Dispositivos. As ações configuradas no controlador estão ativadas por defeito.

Usage:
RemoteControlCodeEnabled = state;

Valor

Descrição

true

Activa as ações configuradas pelo controlador.

false

Desativa as ações configuradas pelo controlador.

Values
  • true - Controller-configured actions are enabled.
  • false - Controller-configured actions are disabled.
Notes
  • As ações configuradas pelo controlador estão ativadas por defeito.

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

while (true) {
  if (Controller1.AxisA.position() > 0) {
    Drivetrain.drive(forward);
  }
  else if (Controller1.AxisA.position() < 0) {
    Drivetrain.drive(reverse);
  }
  // Press E Up to use controller configured actions again
  else if (Controller1.ButtonEUp.pressing()) {
    break;
  }
  else {
    Drivetrain.stop();
  }

  wait(20, msec);
}

RemoteControlCodeEnabled = true;