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] ▶