Ecrã

Introdução

Os blocos de ecrã controlam o ecrã táctil do V5 Brain, permitindo que o seu robô exiba texto, números e gráficos, bem como responda a comandos por toque.

Por defeito, o tipo de letra para impressão no Brain é monospaced small, que tem 12 linhas e 48 colunas.

Para desenho, a resolução do cérebro é de 480 x 240 pixéis.

Segue abaixo a lista dos blocos disponíveis:

Impressão com cursor – Apresenta o texto e gere o cursor de impressão.

• imprimir no ecrã – Imprime texto, números ou valores de variáveis ​​no ecrã do Brain.

• set cursor to row column on screen – Move o cursor para uma linha e coluna específicas.

• set cursor to next row on screen – Move o cursor para a coluna 1 da linha seguinte.

• limpar linha no ecrã – Limpa uma linha de texto especificada.

• coluna do cursor do ecrã – Reporta o número da coluna onde o texto será impresso.

• linha do cursor do ecrã – Reporta o número da linha onde o texto será impresso.

Definições – Alterar o aspeto do texto e dos gráficos.

• limpar ecrã – Apaga todo o texto e desenhos do ecrã.

• definir tipo de letra no ecrã – Altera o tipo e o tamanho do tipo de letra para a apresentação do texto.

• definir precisão de impressão no ecrã – Define quantas casas decimais serão apresentadas ao imprimir números.

• definir largura da caneta no ecrã – Define a espessura das linhas desenhadas e dos contornos das formas.

• definir cor da caneta/tipo de letra no ecrã – Define a cor do texto, os pixéis, as linhas e os contornos das formas.

• definir cor de preenchimento no ecrã – Define a cor de preenchimento para as formas desenhadas.

Desenhar – Crie formas, linhas e gráficos no ecrã do Brain.

• desenhar pixel no ecrã – Desenha um único pixel numa coordenada.

• desenhar linha no ecrã – Desenha uma linha entre dois pontos.

• desenhar retângulo no ecrã – Desenha um retângulo utilizando dois pontos de canto.

• desenhar círculo no ecrã – Desenha um círculo com centro e raio definidos.

Toque – Detetar entrada por toque no ecrã do cérebro.

• ecrã pressionado – Reporta se o ecrã está a ser tocado no momento.

• posição do ecrã – Reporta a coordenada x ou y selecionada da última pressão no ecrã.

• when screen – Executa os blocos anexados quando o ecrã é pressionado ou libertado.

Impressão do cursor

Imprimir no ecrã

O bloco de pilha imprimir no ecrã imprime texto, números ou valores de variáveis ​​no ecrã do Brain na posição e tipo de letra atuais do cursor.

Exibir texto no ecrã do cérebro

quando iniciar
imprimir [VEXcode] na tela ▶

Parâmetros	Descrição
valor	O texto, número ou valor da variável a ser apresentado no ecrã.
e posicione o cursor na linha seguinte.	Selecione a seta ( ▶ ) para expandir o bloco e apresentar e posicionar o cursor na linha seguinte, de modo a que o cursor se mova para a coluna 1 da linha seguinte após a impressão.

Exemplo

Ao ser iniciado, apresenta a mensagem ‘Olá, Robot!’ na posição inicial do cursor no ecrã.

quando iniciar
[Display a message at the starting cursor position.]
imprimir [Hello, Robot!] na tela ▶

Coloque o cursor na linha ou coluna do ecrã.

O bloco de pilha definir cursor para linha e coluna no ecrã move o cursor para uma linha e coluna específicas no ecrã Brain. O próximo bloco imprimir no ecrã começará a imprimir nesse local. A quantidade de linhas e colunas que podem ser apresentadas confortavelmente depende da fonte selecionada. Com a fonte monoespaçada média padrão, podem ser apresentadas até 8 linhas e 13 colunas com clareza. Os textos posicionados para além deste limite podem ser cortados ou tornar-se difíceis de ler.

As fontes monoespaçadas têm caracteres com a mesma largura, o que garante consistência no posicionamento do texto. Já as fontes proporcionais variam na largura dos caracteres, fazendo com que algumas letras ocupem mais espaço do que outras. No entanto, independentemente do tipo de fonte utilizado, o bloco de pilha set cursor to row column on screen posiciona o cursor com base no tamanho da linha e da coluna, e não no estilo da fonte. O tamanho da letra pode ser ajustado utilizando o bloco de pilha set font on screen.

Definir bloco de pilha de cursores

definir cursor para linha [1] coluna [1] na tela

Parâmetros	Descrição
linha	A linha para a qual mover o cursor.
coluna	A coluna para a qual deve mover o cursor.

Exemplo

Quando é iniciado, move o cursor para a linha 3, coluna 2 no ecrã e imprime ‘Linha 3, Coluna 2’.

quando iniciar
[Display text starting at Row 3 Column 12.]
definir cursor para linha [3] coluna [12] na tela
imprimir [Row 3, Column 12] na tela ▶

Posicione o cursor na linha seguinte do ecrã.

O bloco de pilha set cursor to next row on screen move o cursor para a coluna 1 na linha seguinte do ecrã Brain.

posicionar o cursor na linha seguinte do bloco de pilha

mover cursor para a próxima linha na tela

Parâmetros	Descrição
	Este bloco não possui parâmetros.

Exemplo

Quando é iniciado, imprime ‘Linha 1’ no ecrã, move o cursor para a linha seguinte e, em seguida, imprime ‘Linha 2’.

quando iniciar
[Display two lines of text.]
imprimir [Line 1] na tela ▶
mover cursor para a próxima linha na tela
imprimir [Line 2] na tela ▶

limpar linha no ecrã

O bloco de pilha limpar linha no ecrã limpa uma única linha de texto no ecrã do Brain.

Limpar bloco de pilha de linhas

limpar linha [1] na tela

Parâmetros	Descrição
linha	O número da linha a limpar.

Exemplo

Quando é iniciado, imprime o texto em duas linhas. A primeira linha permanece visível, enquanto a segunda desaparece ao fim de 3 segundos.

quando iniciar
[Only keep the text on row 1.]
imprimir [This text stays] na tela ▶
mover cursor para a próxima linha na tela
imprimir [This text disappears] na tela ▶
aguardar [3] segundos
limpar linha [2] na tela

coluna do cursor do ecrã

O bloco de relatório da coluna cursor de ecrã informa o número da coluna onde o texto será impresso, em formato inteiro.

bloco de relatório de coluna do cursor do ecrã

(coluna do cursor na tela)

Parâmetros	Descrição
	Este bloco não possui parâmetros.

Exemplo

Quando é iniciado, move o cursor para a linha 3, coluna 2 no ecrã e imprime o número da coluna em que o cursor se encontra atualmente.

quando iniciar
[Display the cursor's current column.]
definir cursor para linha [3] coluna [15] na tela
imprimir (coluna do cursor na tela) na tela ▶

linha do cursor do ecrã

O bloco de relatório linha do cursor no ecrã informa o número da linha onde o texto será impresso, em formato inteiro.

bloco de relatório de linha do cursor do ecrã

(linha do cursor na tela)

Parâmetros	Descrição
	Este bloco não possui parâmetros.

Exemplo

Quando é iniciado, move o cursor para a linha 6, coluna 2 no ecrã e imprime o número da linha em que o cursor está posicionado.

quando iniciar
[Display the cursor's current row.]
definir cursor para linha [3] coluna [2] na tela
imprimir (linha do cursor na tela) na tela ▶

Configurações

tela limpa

O bloco de pilha limpar ecrã remove todos os desenhos e textos do ecrã do Brain.

limpar bloco de pilha de ecrã

limpar tela

Parâmetros	Descrição
	Este bloco não possui parâmetros.

Exemplo

Quando é iniciado, desenha um círculo com o centro em (120,120) e um raio de 40 pixéis. Após 2 segundos, o ecrã é limpo.

quando iniciar
[Draw a circle, and clear it after 2 seconds.]
desenhar círculo [120] [120] [40] na tela
aguardar [2] segundos
limpar tela

Definir fonte no ecrã

O bloco de pilha definir tipo de letra no ecrã define o tipo de letra e o tamanho utilizados para exibir o texto no ecrã do Brain. Esta fonte será aplicada a todo o texto impresso posteriormente.

definir bloco de pilha de fontes

definir fonte para [monoespaçada v] [médio v] na tela

Parâmetros	Descrição
estilo	O estilo da fonte: monoespaçada ou proporcional
tamanho	Tamanho da letra (exemplos abaixo): extra pequeno pequeno médio grande extra grande super grande Nota: Os tamanhos extra pequeno e pequeno não estão disponíveis para tipos de letra proporcionais.

monospaced extra small	monospaced small	monoespaçado médio
monospaced large	monoespaçado extra grande	monoespaçado super grande
proporcional médio	proporcional grande	proporcional extra grande
proporcional super grande

Exemplo

Quando é iniciado, define a fonte como ‘monoespaçada extra grande’ e imprime ‘VEX’ no ecrã.

quando iniciar
[Display text using a larger font]
definir fonte para [monoespaçada v] [extra grande v] na tela
imprimir [VEX] na tela ▶

Defina a precisão de impressão no ecrã.

O bloco de pilha definir precisão de impressão no ecrã define quantas casas decimais serão apresentadas ao imprimir números no ecrã Brain. Esta precisão de impressão será aplicada a todos os números impressos posteriormente.

definir bloco de pilha de precisão de impressão

definir precisão de impressão para [0.1 v] na tela

Parâmetros	Descrição
precisão	Precisão de impressão a utilizar: 1 0,1 0,01 0,001 Todos os dígitos

Exemplo

Quando é iniciado, define a precisão de impressão para duas casas decimais e imprime 1/3 como 0,33 no ecrã.

quando iniciar
[Print 1/3 as 0.33.]
definir precisão de impressão para [0.01 v] na tela
imprimir ([1] [math_division v] [3]) na tela ▶

Defina a largura da caneta no ecrã.

O bloco de pilha definir largura da caneta no ecrã define a espessura das linhas desenhadas e dos contornos das formas.

definir largura da caneta empilhar bloco

definir largura da caneta para [10] na tela

Parâmetros	Descrição
largura	A largura da caneta, em pixéis, varia de 0 a 32.

Exemplo

Quando é iniciado, define a largura da caneta para 10 pixels e desenha um retângulo com o canto superior esquerdo em (50,50), largura de 130 pixels e altura de 60 pixels.

quando iniciar
[Draw a rectangle with a pen width of 10.]
definir largura da caneta para [10] na tela
desenhar retângulo [50] [50] [130] [60] na tela

Defina a cor da caneta/tipo de letra no ecrã.

O bloco de pilha definir cor da caneta/tipo de letra no ecrã define a cor do texto, dos pixéis, das linhas e dos contornos das formas.

definir bloco de pilha de cores caneta/tipo de letra

definir cor da caneta / fonte para [vermelho v] na tela

Parâmetros	Descrição
cor	Cor da caneta e da fonte a utilizar: vermelho verde azul preto branco amarelo laranja roxo ciano transparente

Exemplo

Quando é iniciado, define a cor da caneta para laranja e desenha um retângulo com o canto superior esquerdo em (50, 50), largura de 130 pixels e altura de 60 pixels.

quando iniciar
[Draw a rectangle with orange borders.]
definir cor da caneta / fonte para [laranja v] na tela
desenhar retângulo [50] [50] [130] [60] na tela

Defina a cor de preenchimento no ecrã.

O bloco de pilha definir cor de preenchimento no ecrã define a cor de preenchimento utilizada quando as formas são desenhadas.

definir bloco de pilha de cor de preenchimento

definir cor de preenchimento para [vermelho v] na tela

Parâmetros	Descrição
cor	As cores de preenchimento a utilizar são: vermelho verde azul preto branco amarelo laranja roxo ciano transparente

Exemplos

Quando é iniciado, define a cor de preenchimento para roxo e desenha um retângulo. Está em (50, 130) com 100 pixels de largura e 60 pixels de altura.

quando iniciar
[Draw a purple rectangle.]
definir cor de preenchimento para [roxo v] na tela
desenhar retângulo [50] [130] [100] [60] na tela

Desenhar

Desenhar pixel no ecrã

O bloco de pilha desenhar pixel no ecrã desenha um pixel na coordenada x e y selecionada utilizando a cor da caneta atual.

bloco de pilha de pixéis para desenho

desenhar pixel [0] [0] na tela

Parâmetros	Descrição
x	A coordenada x para desenhar o pixel varia de 0 a 479.
y	A coordenada y para desenhar o pixel varia de 0 a 239.

Exemplo

Quando é iniciado, desenha quatro pixéis que marcam os cantos de um pequeno quadrado.

quando iniciar
[Draw the pixels marking the corners of a square.]
desenhar pixel [250] [100] na tela
desenhar pixel [275] [100] na tela
desenhar pixel [250] [125] na tela
desenhar pixel [275] [125] na tela

Desenhe uma linha no ecrã

O bloco de pilha desenhar linha no ecrã desenha uma linha da primeira coordenada do ecrã (x1, y1) para a segunda coordenada do ecrã (x2, y2) utilizando a largura da caneta e a cor da caneta atuais.

desenhar linha empilhar bloco

desenhar linha [0] [0] [10] [10] na tela

Parâmetros	Descrição
x1	A coordenada x em pixéis do início da linha, variando de 0 a 479.
y1	A coordenada y, em pixéis, do início da linha, variando de 0 a 239.
x2	A coordenada x, em pixéis, da extremidade da linha, variando de 0 a 479.
y2	A coordenada y, em pixéis, da extremidade da linha, variando de 0 a 239.

Exemplo

Quando iniciado, desenha uma linha diagonal do canto superior esquerdo (0, 0) para o canto inferior direito (479, 239) do ecrã.

quando iniciar
[Draw a line from the top left to bottom right of the screen.]
desenhar linha [0] [0] [479] [239] na tela

Desenhe um retângulo no ecrã.

O bloco de pilha desenhar retângulo no ecrã desenha um retângulo utilizando a largura da caneta, cor da caneta e cor de preenchimento atuais.

desenhar bloco de pilha retangular

desenhar retângulo [0] [0] [10] [10] na tela

Parâmetros	Descrição
x	A coordenada x, em pixéis, do canto superior esquerdo do retângulo, variando de 0 a 479.
y	A coordenada y, em pixéis, do canto superior esquerdo do retângulo varia de 0 a 239.
largura	A largura do retângulo em pixéis.
altura	A altura do retângulo em pixéis.

Exemplo

Quando é iniciado, desenha um retângulo no ecrã com o canto superior esquerdo a (50,50), largura de 130 pixéis e altura de 60 pixéis.

quando iniciar
[Draw a rectangle on the screen.]
desenhar retângulo [50] [50] [130] [60] na tela

Desenhe um círculo no ecrã

O bloco de pilha desenhar círculo no ecrã desenha um círculo utilizando a largura da caneta, cor da caneta e cor de preenchimento atuais.

desenhar bloco de pilha de círculo

desenhar círculo [0] [0] [10] na tela

Parâmetros	Descrição
x	A coordenada x, em pixéis, do centro do círculo varia de 0 a 479.
y	A coordenada y, em pixéis, do centro do círculo varia de 0 a 239.
raio	O raio do círculo em pixéis.

Exemplo

Quando é iniciado, desenha um círculo no ecrã com o centro em (120, 120) e um raio de 40 pixéis.

quando iniciar
[Draw a circle on the screen.]
desenhar círculo [120] [120] [40] na tela

Toque

ecrã pressionada

O bloco booleano ecrã pressionado indica se o ecrã táctil do Brain está a ser pressionado no momento.

• Verdadeiro – O ecrã está a ser pressionado.

• Falso – O ecrã não está a ser pressionado.

bloco booleano pressionado no ecrã

<tela pressionada?>

Parâmetros	Descrição
	Este bloco não possui parâmetros.

Ao ser iniciado, altera a cor do ecrã após o pressionamento do botão.

quando iniciar
[Change the screen's color after it's pressed.]
aguardar até <tela pressionada?>
definir cor de preenchimento para [verde v] na tela
desenhar retângulo [0] [0] [479] [239] na tela

Ao pressionar o ecrã, a primeira mensagem é apresentada. O código aguarda então até que o ecrã seja libertado e só continua após o ecrã ser pressionado novamente para exibir a segunda mensagem.

quando iniciar
[Display different messages after the screen is pressed.]
aguardar até <tela pressionada?>
imprimir [First message!] na tela ▶
mover cursor para a próxima linha na tela
[Lift finger to press the screen again.]
aguardar até <não <tela pressionada?>>
aguardar até <tela pressionada?>
imprimir [Second message!] na tela ▶

posição da tela

O bloco de relatório de posição do ecrã informa a coordenada selecionada na última interação com o ecrã. A coordenada x varia de 0 (esquerda) a 479 (direita). A coordenada y varia de 0 (topo) a 239 (base).

bloco de repórter de posição de ecrã

(posição [x v] da tela)

Parâmetros	Descrição
eixo	As coordenadas da última interação com o ecrã a ser reportada: x – Posição horizontal ou y – Posição vertical

Ao pressionar o ecrã do cérebro, é desenhado um círculo no local onde a pressão foi aplicada.

quando iniciar
[Display a circle where the screen is pressed.]
aguardar até <tela pressionada?>
definir cor de preenchimento para [branco v] na tela
desenhar círculo (posição [x v] da tela) (posição [y v] da tela) [20] na tela

quando o ecrã

O bloco de chapéu when screen executa a pilha de blocos anexada quando o ecrã do cérebro é pressionado ou libertado.

quando o chapéu de tela bloqueia

quando tela do Brain [pressionado v] :: hat events

Parâmetros	Descrição
estado	Quando executar a pilha de blocos anexada: pressionado é executado quando o ecrã é pressionado e libertado é executado quando o ecrã é libertado.

Ao pressionar o ecrã do cérebro, é desenhado um círculo no local onde a pressão foi aplicada.

quando tela do Brain [pressionado v] :: hat events
[Color the screen with polka dots by pressing it repeatedly.]
definir cor de preenchimento para [vermelho v] na tela
desenhar círculo (posição [x v] da tela) (posição [y v] da tela) [20] na tela