Blocos#

A Referência da API de Blocos VEX CTE explica o que cada bloco VEXcode faz, como as suas entradas alteram o comportamento do braço de 6 eixos 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 Blocks. Os projetos em Python utilizam a secção de API baseada 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 em VEXcode.

  • Parâmetros - Lista as entradas do bloco e explica como cada entrada afeta o braço de 6 eixos 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 apresenta um valor, como um número ou texto. Os blocos de visualização 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#

deslocar o braço para a posição#

O bloco mover braço para a posição move o braço de 6 eixos para uma coordenada x, y e z especificada.

mover [braço v] para a posição x:[120] y:[0] z:[100] [mm v] ▶

Parâmetro

Descrição

x

A coordenada x da posição alvo.

y

A coordenada y da posição alvo.

z

A coordenada z da posição alvo.

unidade

Seleciona a unidade para as coordenadas:

  • mm — milímetros
  • polegadas

seta expansível

Por predefinição, este é um bloco de espera, pelo que o braço de 6 eixos terminará de se mover antes de executar o bloco seguinte. Para fazer com que o braço de 6 eixos comece a mover-se e execute imediatamente o bloco seguinte, expanda o bloco para e não espere.

Exemplo

quando iniciar
[Move the 6-Axis Arm to standard position at start of project.]
mover [braço v] para a posição x:(120) y:(120) z:(75) [mm v] ▶