Console

Introduction

The VEXcode AIM Console is displayed in the Console Tab within VEXcode. Console blocks can display text, numbers, and variable values while a project is running.

Below is a list of all available blocks:

• print on console — Displays text, numbers, or variable values in the Console.

• set cursor to next row on console — Moves the cursor to the next row in the Console.

• clear console — Clears all rows in the Console.

• ask and wait — Displays a message in the Console and pauses the project until a response is entered in the Console.

• answer — Reports the most recent response entered in the Console as text.

• set print precision on console — Sets how many decimal places are displayed when printing numbers.

• set font color on console — Sets the font color used for text printed in the Console.

print on console

The print on console stack block displays text, numbers, or variable values in the Console at the current row.

print on console stack block

    print [VEXcode] on console ▶

Parameters	Description
value	The text, number, or variable value to display in the Console.
expanding arrow	Expands the block to include and set cursor to next row, which moves the cursor to the next row after the value is printed. If this option is not used, the next printed value appears immediately after the previous value on the same row.

Example

When started, displays the message ‘Hello, robot!’ at the starting cursor position on the Console.

    when started
    [Display a message in the Console.]
    print [Hello, robot!] on console ▶

set cursor to next row on console

The set cursor to next row on console stack block moves the cursor to column 1 on the next row in the Console. The next value printed will appear on that row.

Use this block when you want the next printed value to start on a new row. If this block is not used, and the previous print on console block was not expanded to include and set cursor to next row, the next printed value will appear immediately after the previous value on the same row.

set cursor to next row on console stack block

    set cursor to next row on console

Parameters	Description
	This block has no parameters.

Example

When started, prints ‘Row 1’ on the Console, moves the cursor to the next row, and then prints ‘Row 2’.

    when started
    [Display two lines of text.]
    print [Row 1] on console ▶
    set cursor to next row on console
    print [Row 2] on console ▶

clear console

The clear console stack block clears all rows from the Console and moves the cursor back to the first row.

clear console stack block

    clear console

Parameters	Description
	This block has no parameters.

Example

    when started
    [Clear the Console after printing.]
    print [This will disappear...] on console ▶
    wait [2] seconds
    clear console

ask and wait & answer

The ask and wait stack block displays a message in the Console and pauses the project until a response is entered into the Console.

The answer reporter block returns the most recent response entered in the Console. The response is returned as text. To use the response as a number, use the convert reporter block to convert the answer to a number first.

The Ask and wait block.

    ask [What's your name?] and wait

Parameter	Description
prompt	The message to display in the Console.

The Answer block.

    answer

Parameters	Description
	This block has no parameters.

Example

  when started
  [Tell the robot your name.]
  ask [What's your name?] and wait
  print [Hello, ] on console ▶
  print (answer) on console ▶

set print precision on console

The set print precision on console stack block sets how many decimal places are displayed when numbers are printed in the Console. This setting applies to numbers printed after this block is used. At the start of a project, print precision is set to 1, so numbers print with no decimal places.

set print precision on console stack block

    set print precision to [0.1 v] on console

Parameters	Description
precision	The print precision to use: 1 0.1 0.01 0.001 All Digits

Example

When started, sets print precision to two decimal places and prints 1/3 as 0.33 on the Console.

    when started
    [Print 1/3 as 0.33.]
    set print precision to [0.01 v] on console
    print ([1] [math_division v] [3]) on console ▶

set font color on console

The set font color on console stack block sets the font color used for text printed in the Console. At the start of a project, the font color is set to blue.

The set font color on console stack block.

    set font color to [red v] on console

Parameter	Description
color	The font color to use for text printed in the Console: red green blue black white yellow orange purple cyan

Example

  when started :: hat events
  [Print text in different colors.]
  print [Default text color] on console ▶
  set cursor to next row on console
  set font color to [red v] on console
  print [Red text color] on console ▶