Skip to main content

Lição 3: Colorização de código no VEXcode VR Python

Três comandos VEXcode VR Python para ilustrar o conceito de colorização de código.

Agora você sabe o básico sobre como começar a usar o VEXcode VR Python. Você provavelmente notou que as linhas de código no VEXcode VR Python ficam coloridas quando são adicionadas ao Workspace. Esta colorização é uma ferramenta visual útil que você pode usar durante a programação.

Saber como o código VEXcode VR Python é colorido pode ajudá-lo a identificar rapidamente erros na sintaxe do projeto ou erros de ortografia, o que pode impedir que seu projeto seja executado como pretendido. Compreender as cores do código e seu significado será valioso à medida que você começa a criar projetos VEXcode VR Python.

Resultados de Aprendizagem

  • Identifique e descreva a colorização do código no VEXcode VR Python.
  • Identifique como recuar comandos no espaço de trabalho e a importância de fazê-lo em um projeto.

Colorização de código em VEXcode VR Python

Ao criar projetos de texto, a sintaxe, o espaçamento, o recuo e a ortografia do código são muito importantes para garantir que o projeto seja executado como pretendido. O código de cores presente no espaço de trabalho no VEXcode VR Python é uma sugestão visual extra de que você inseriu o código no seu projeto corretamente.

A colorização do código segue as seguintes convenções, conforme tabela abaixo, ou neste artigo da Biblioteca VEX:

Cor Tipo Exemplo de VEXcode VR Python
Azul

Aulas

o dispositivo individual ao qual o comando pertence 

(ou seja, sistema de transmissão, caneta, cérebro)

Um exemplo de um comando de acionamento com a parte azul do sistema de transmissão destacada em uma caixa vermelha para ilustrar a classe.
Parda

Comandos 

o comportamento dentro do comando 

(ou seja, dirigir, virar)

Um comando de unidade com a parte 'unidade' destacada em uma caixa vermelha para indicar o 'comando'.
Laranja

Parâmetros 

informações sobre como o comportamento é executado

(ou seja, direção, distância)

Um comando de acionamento com o parâmetro orang de forward destacado para indicar essa parte do comando.
Azul Royal

Estruturas 

controlar o fluxo do projeto

(ou seja, loops condicionais)

Um comando lê se o pára-choque esquerdo for pressionado, e o azul royal se estiver destacado em uma caixa vermelha indicando a parte da estrutura do comando.
Verde

Valores 

parâmetro numérico atribuído ao comportamento

(ou seja, número de graus de uma volta)

Uma volta para o comando com o parâmetro 90 verde destacado em uma caixa vermelha para indicar a parte do valor do comando.
Preto

Utilizador criado 

variáveis e comandos criados pelo utilizador

Dois comandos com variáveis criadas pelo usuário são mostrados, o primeiro lê o valor no intervalo 10 e a parte do valor é destacada em uma caixa vermelha. O segundo lê se o pára-choques esquerdo for pressionado () : com os parênteses e os dois pontos destacados, ilustrando as partes criadas pelo usuário desses comandos.

 

Os comentários em um projeto também são coloridos de verde, mas são precedidos por um símbolo de libra (#). Um exemplo de um Comentário verde num projeto que lê # Comentários num projeto.

Ao digitar comandos no Workspace, se houver um componente irreconhecível, ele permanecerá preto (como a categoria criada pelo usuário). Este pode ser um indicador útil enquanto trabalha, para evitar frustrações ou resolução de problemas adicionais mais tarde.

Use o cursor e o teclado para corrigir erros. À medida que os componentes são reconhecidos, eles serão coloridos corretamente. No videoclipe abaixo, é introduzido no projeto um comando turn_for com dois componentes mal escritos que aparecem a preto. À medida que cada erro é corrigido, a cor dessa parte do comando muda.

Ficheiro de vídeo

A importância da indentação

No VEXcode VR Python, a indentação é MUITO importante. A maneira como os comandos são alinhados dentro de um projeto contribui para o fluxo de um projeto. O recuo inadequado pode resultar em um projeto não ser executado como pretendido ou não ser executado. Os comandos que estão alinhados uns com os outros serão executados como uma sequência. Comandos que são recuados dentro de outros comandos (como os comandos dentro de um loop) serão executados dentro dessa estrutura. Você aprenderá mais sobre a indentação ao longo deste curso. Um exemplo de um projeto recuado corretamente com setas vermelhas indicando os diferentes níveis de recuo. O loop for é recuado dentro da função def main e os comandos do sistema de transmissão dentro do loop for são recuados ainda mais.

Como a colorização do código, existem dicas visuais para o recuo adequado no VEXcode VR Python. As linhas cinzentas no lado esquerdo do projeto mostram como o projeto irá fluir. Deve existir uma linha contígua da função principal ao longo de todo o projeto, como indicado pela seta nesta imagem. Um exemplo de um projeto recuado corretamente, onde a linha indicadora da função principal à esquerda, abaixo do comando def main, é sólida ao lado dos comandos no projeto.

Quaisquer loops ou estruturas de controle subsequentes também terão suas próprias linhas indicadoras, mostrando o início e o fim da estrutura. Neste exemplo, a linha indicadora do loop para é realçada pela seta. Um projeto corretamente recuado no qual a linha indicadora do loop for é mostrada se estendendo do loop for solidamente para a esquerda dos comandos do trem de força repetidos dentro.

Comandos de Recuo 

À medida que o seu projeto VEXcode VR Python se torna mais complexo, a indentação desempenhará um papel importante na forma como os seus projetos são construídos. 

  • Ao adicionar comandos a um projeto, use o botão 'Tab' no teclado para recuar as linhas do projeto adequadamente. Coloque o cursor no início do comando e pressione 'Tab' até que o comando seja recuado para o local necessário.
    • Para recuar vários comandos da mesma maneira, selecione os comandos que deseja recuar e, em seguida, use o botão 'Tab' no teclado para movê-los todos ao mesmo tempo.
  • No videoclipe abaixo, existem três comandos que devem ser indentados dentro do ciclo for. O primeiro é individualmente tabulado quando o cursor é colocado no início da linha. Em seguida, os dois restantes são destacados e colocados em abas para alinhar, para que o projeto seja executado corretamente.
    • Observe que a linha indicadora para o loop for aparece quando os comandos são recuados corretamente.   
Ficheiro de vídeo