Uploading Custom Images in VEXcode AIR – VEX Library

The VEX AIR Drone Controller allows for up to ten custom images to be used in a project. This article will walk you through where and how to upload and use custom images in VEXcode AIR.

Using the Control Panel to Upload Custom Images

A close-up screenshot of the upper right side of the VEXcode AIR Toolbar, highlighting the gear icon located beneath a green Controller icon and the Download button.

Select the Gear icon to open the Control Panel.

Vision Utility window with the Images tab selected.

Select the Images tab to view any previously uploaded images or load custom images.

Images tab. Slot 1 has the upload folder icon highlighted, indicating readiness to upload an image.

Select the Upload icon on the Image slot you want to use.

Image upload dialog displaying a single Upload Custom Image button in the center of the screen, with Cancel and Select File options grayed out

The Image Selector window will appear. Select the Upload Custom Image button to open a dialog box on your device. Choose any .png file that is smaller than 10 MB.

Images tab with the loaded image previewing in the the Image 1 location.

After the image is selected, it will appear in the Control Panel in the chosen slot. By default, images will be named IMAGE1 with the number matching the slot the image is uploaded to.

For more information on how to use a custom image in a project, refer to the VEXcode API Reference for Blocks or Python.

Renaming an Image File

Any image file can be renamed in the Control Panel.

Pencil icon to the right of the uploaded image and above the trash icon highlighted.

Select the edit icon to the right of the current image name.

Window showing the renamed image as My underscore image. A highlight is on the update button in the bottom right corner.

A window will appear. Type the new name for the image file into the text box, then select Update.

Image names can contain a maximum of 14 characters and cannot begin with a number or include spaces.

Image tab showing the uploaded image with the name my underscore image.

The updated image name will now appear in the Control Panel.

This update will also show in the parameter dropdown for the Show image file block or the autocomplete for the Python command depending on your coding method.

Deleting a Custom Image

Trash can icon beneath the image in slot one highlighted.

To delete an image from the Control Panel, select the Trash icon.

Bottom of the images tab in VEXcode with the delete all images button highlighted.

To delete all images, select the Delete All Images option at the bottom of the Images tab.