Blocos#

O Guia de Referência da API de Blocos VEX IQ (2ª geração) explica o que cada bloco VEXcode faz, como as suas entradas alteram o comportamento do robô e como o bloco pode ser utilizado num projeto.

Utilize esta referência quando pretende compreender um bloco antes de o adicionar a um projeto, verificar o que um bloco reporta ou comparar blocos semelhantes numa categoria.

Os blocos são utilizados em projetos VEXcode IQ Blocks. Os projetos em Python e C++ utilizam as secções da API baseadas em texto.

Como ler uma entrada de bloco#

A maioria das entradas de bloco inclui as seguintes partes:

  • Descrição do bloco - Explica o que o bloco faz e quando é útil.

  • Imagem do bloco - Mostra o aspeto do bloco no VEXcode IQ.

  • Parâmetros - Lista as entradas do bloco e explica como cada entrada afeta o robô ou o projeto.

  • Valor de retorno - Explica o que um bloco Booleano ou Reporter reporta.

  • Exemplo - Mostra uma forma de utilizar o bloco num projeto.

Tipos de blocos comuns#

Blocos de diferentes formatos têm funções diferentes num projeto.

Tipo de bloco

O que significa

Monte

Um bloco que executa uma ação. Os blocos empilhados ligam-se acima e abaixo de outros blocos numa pilha.

Chapéu

Um bloco que inicia uma pilha de blocos quando algo acontece, como quando o projeto é iniciado ou quando ocorre um evento.

Booleano

Um bloco que retorna Verdadeiro ou Falso. Os blocos booleanos são frequentemente utilizados dentro de condições, como blocos se então ou espere até.

Repórter

Um bloco que reporta um valor, como um número ou texto. Os blocos de reporte são frequentemente utilizados dentro de outros blocos.

Bloco C

Um bloco que envolve outros blocos e controla quando ou como são executados, como blocos repetitivos ou blocos se então.

Exemplo de entrada em bloco#

motor de rotação para#

O bloco motor de rotação para pilha faz rodar um motor ou um grupo de motores por uma distância específica. A rotação é relativa à posição atual do motor ou grupo de motores. O projeto aguardará até que o motor ou o grupo de motores termine de rodar antes de ser executado o próximo bloco da pilha.

girar [Motor1 v] [frente v] por (90) [graus v] ▶

Parâmetros

Descrição

motor

O motor ou grupo de motores a accionar. Selecione entre os motores configurados na janela Dispositivos.

direção

O sentido de rotação do motor ou do grupo de motores. Por defeito, as opções são para a frente e para trás. As opções de direção podem mudar dependendo da configuração do motor.

distância

A distância a que o motor ou grupo de motores roda. Graus são valores inteiros. As voltas podem ser valores inteiros ou decimais.

unidade

A unidade de distância: graus ou voltas.

e não espere

Selecione a seta ( ▶ ) para expandir o bloco e apresentar e não esperar, para que o próximo bloco da pilha seja executado imediatamente.

Exemplo

quando iniciar
[Spin the motor forward once, then reset.]
girar [Motor1 v] [frente v] por (90) [graus v] ▶
girar [Motor1 v] [inverso v] por (90) [graus v] ▶