> For the complete documentation index, see [llms.txt](https://docs.thunkable.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thunkable.com/gaming/gaming-blocks/stage.md).

# Stage

## Current Stage

![](/files/-MG86xBAmfEuDCUnO8tv)

Select which Stage to display in the Canvas.

## Stage Appearance

### Background Color

#### Set Background Color 

![](/files/-MXlxr3MdYYj9Iz7DtkZ)

Sets the background color of the specified Stage.

#### Get Background Color 

![](/files/-MXlxwSdNzICYSYPGD8g)

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

### Frame Color

#### Set Frame Color 

![](/files/-MXly0_TFSIMvISiIc8F)

Sets the color of the Frame for the specified Stage.

#### Get Frame Color 

![](/files/-MXly5mGDG0SqNVSURjh)

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

### Image Number

#### Set Image Number to 

![](/files/-MARPheU_fAh37QUuKla)

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

### Height

#### Set Height

![](/files/rAIQZRjgWpG0cndT9YLG)

Set the Stage's height in pixels

#### Get Height

![](/files/XEsPEGlEgV390LyL7AFR)

Returns the Stage's height in pixels

### Width

#### Set Width

![](/files/gqb4Esq8BJdcYkpzNNs8)

Set the Stage's width in pixels

#### Get Width

![](/files/MZuZdJVKPOdk66aMbFMv)

Returns the Stage's width in pixels

## Stage Gravity 

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

### Y Gravity

#### Set Y Gravity 

![](/files/-MXlyE4mKSJd9s2kXxhx)

Sets the Stage gravity in the vertical direction.

#### Get Y Gravity 

![](/files/-MXlyKHOFGyY8rMFgIp8)

Returns the value of the Stage gravity, in the vertical direction. 

### X Gravity

#### 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. 

## Drawing

### Touch Drawing

#### Set Touch Drawing 

![](/files/-MXlyZCJPJauPswB2lav)

Enable drawing on the stage if set to `true`. 

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

#### Get Touch Drawing 

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

Return true or false, depending on whether or not drawing is enabled on the Stage. 

### Drawing Color

#### Set Drawing Color 

![](/files/-MXlypqb5VTnIBxhxOqG)

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

#### Get Drawing Color 

![](/files/-MXlyvPXNIbhkd4cdqbH)

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

### Drawing Width

#### Set Drawing Width 

![](/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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.thunkable.com/gaming/gaming-blocks/stage.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.