# Stage

## Current Stage

![](/files/-MG86xBAmfEuDCUnO8tv)

Select which Stage to display in the Canvas.

## Stage Appearance

### Set Background Color&#x20;

![](/files/-MXlxr3MdYYj9Iz7DtkZ)

Sets the background color of the specified Stage.

### Get Background Color&#x20;

![](/files/-MXlxwSdNzICYSYPGD8g)

Returns the hexadecimal value of the background color for the specified Stage.

### Set Frame Color&#x20;

![](/files/-MXly0_TFSIMvISiIc8F)

Sets the color of the Frame for the specified Stage.

### Get Frame Color&#x20;

![](/files/-MXly5mGDG0SqNVSURjh)

Returns the hexadecimal value of the Frame Color for the specified Stage.

### Set Image Number to&#x20;

![](/files/-MARPheU_fAh37QUuKla)

Set the background image of the stage to the specified item in the list.

## Stage Gravity&#x20;

Please refer to the [Canvas docs](https://docs.thunkable.com/canvas#gravity) to see some animated examples of the gravity properties.

### Set Y Gravity&#x20;

![](/files/-MXlyE4mKSJd9s2kXxhx)

Sets the Stage gravity in the vertical direction.

### Get Y Gravity&#x20;

![](/files/-MXlyKHOFGyY8rMFgIp8)

Returns the value of the Stage gravity, in the vertical direction.&#x20;

### Set X Gravity

![](/files/-MXlyPXTyIDRJ-ZsOtHd)

Sets the Stage gravity in the horizontal direction.

### Get X Gravity

![](/files/-MXlyTzuYgivGWg4zZgg)

Returns the value of the Stage Gravity, in the horizontal direction.&#x20;

## Drawing

### Set Touch Drawing&#x20;

![](/files/-MXlyZCJPJauPswB2lav)

Enable drawing on the stage if set to `true`.&#x20;

Disable drawing on the stage if set to `false`.

### Get Touch Drawing&#x20;

![](/files/-MXlydQdzcoo-Wxyoifu)

Return true or false, depending on whether or not drawing is enabled on the Stage.&#x20;

### Set Drawing Color&#x20;

![](/files/-MXlypqb5VTnIBxhxOqG)

Set the Drawing Color, or Line Color, for the stage.

### Get Drawing Color&#x20;

![](/files/-MXlyvPXNIbhkd4cdqbH)

Returns the hexadecimal value of the Drawing Color for the specified Stage.

### Set Drawing Width&#x20;

![](/files/-MXlz0iqRmccZ_IjdNin)

Set the Drawing Width, or Line Width, for the stage.

### Get Drawing Width

![](/files/-MXlz68zp1Xy6D0zwsCc)

Returns the numeric value for line width on the Stage.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.thunkable.com/snap-to-place/stage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
