Blocks#

This guide provides detailed information on how to use the Blocks in VEXcode IQ (2nd gen). Here, you will learn how to read and understand each block, with comprehensive descriptions, parameters, and usage examples.

Understanding the Block Entries#

Each block entry in the API Reference includes the following components:

  • Block Name and Image: This is the name of the block and an image of the block.

  • Description: A brief explanation of what the block does.

  • Blocking/Non-Blocking: Indicates whether the block waits for completion before moving to the next block.

  • Parameters: Screenshots showing all the available parameters for that block with expanded drop-downs.

  • Returns: Describes what the block returns, if applicable.

  • Example: Provides an image demonstrating how to use the block in VEXcode.

spin for#

The spin for block spins a selected motor or motor group for a specific amount of rotation using the current motor velocity, measured in degrees or turns.

    spin [Motor1 v] [forward v] for (90) [degrees v] ▶

Parameters

Description

motor

The motor or motor group to spin, configured in the Devices window.

direction

The direction to spin, configured in the Devices window. By default this is:

  • counterclockwise (forward)
  • clockwise (reverse)

distance

The rotation amount, as an integer or decimal.

unit

The measurement unit, which can be one of the following:

  • degrees
  • turns

expanding arrow

By default, this is a waiting block, so the drivetrain will finish moving before running the next block. To make the drivetrain start moving and immediately run the next block right away, expand the block to say and don’t wait.

Example

    when started :: hat events
    spin [Motor1 v] [forward v] for (1) [turns v] ▶

Blocks in Subsections#

Some blocks are found in specific subsections that pertain to their particular sensor or functionality. For example, blocks related to timers, sensors, or motors will be grouped accordingly. Refer to these subsections for detailed information on those blocks.