# Stage

## Current Stage

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MG868o13Klq0Lr4nQVp%2F-MG86xBAmfEuDCUnO8tv%2Fcurrentstage.png?alt=media\&token=3240e327-78e5-4982-a56e-e2183261f11c)

Select which Stage to display in the Canvas.

## Stage Appearance

### Set Background Color 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlxr3MdYYj9Iz7DtkZ%2FScreen%20Shot%202021-04-08%20at%203.50.26%20PM%20copy.jpg?alt=media\&token=77e58467-e056-4df8-a08f-8d835e4387f4)

Sets the background color of the specified Stage.

### Get Background Color 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlxwSdNzICYSYPGD8g%2FScreen%20Shot%202021-04-08%20at%203.50.26%20PM%20copy.jpg?alt=media\&token=a62e1b15-13b9-48b2-a83c-17f085cc2b35)

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

### Set Frame Color 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXly0_TFSIMvISiIc8F%2FScreen%20Shot%202021-04-08%20at%203.50.26%20PM%20copy.jpg?alt=media\&token=84ce6734-c910-4f09-8085-a21283ca378d)

Sets the color of the Frame for the specified Stage.

### Get Frame Color 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXly5mGDG0SqNVSURjh%2FScreen%20Shot%202021-04-08%20at%203.50.26%20PM%20copy.jpg?alt=media\&token=8b88d2cf-797d-4c05-91ca-4ba144f8adc7)

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

### Set Image Number to 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MARMrckU5hDAFB0aegY%2F-MARPheU_fAh37QUuKla%2Fset_image_number.png?alt=media\&token=e94be65a-addf-48b0-9a71-ac7cb252ff12)

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

## Stage Gravity 

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

### Set Y Gravity 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlyE4mKSJd9s2kXxhx%2FScreen%20Shot%202021-04-08%20at%203.50.26%20PM%20copy.jpg?alt=media\&token=a1a3af7d-5fae-4d1b-9b3c-f05f2ddbad83)

Sets the Stage gravity in the vertical direction.

### Get Y Gravity 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlyKHOFGyY8rMFgIp8%2FScreen%20Shot%202021-04-08%20at%203.50.26%20PM%20copy.jpg?alt=media\&token=d23f6800-923b-4130-9eb3-de6ec7cf6ad5)

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

### Set X Gravity

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlyPXTyIDRJ-ZsOtHd%2FScreen%20Shot%202021-04-08%20at%203.50.26%20PM%20copy.jpg?alt=media\&token=6238ffb4-8905-4204-a30d-54d84098d696)

Sets the Stage gravity in the horizontal direction.

### Get X Gravity

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlyTzuYgivGWg4zZgg%2FScreen%20Shot%202021-04-08%20at%203.50.26%20PM%20copy.jpg?alt=media\&token=7b7c427b-bead-4910-bed9-67bc6c8e0c8b)

Returns the value of the Stage Gravity, in the horizontal direction. 

## Drawing

### Set Touch Drawing 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlyZCJPJauPswB2lav%2FScreen%20Shot%202021-04-08%20at%203.50.26%20PM%20copy.jpg?alt=media\&token=66f9bb66-80e2-47bd-a3d4-6339dac166fa)

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

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

### Get Touch Drawing 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlydQdzcoo-Wxyoifu%2FScreen%20Shot%202021-04-08%20at%203.50.26%20PM%20copy.jpg?alt=media\&token=82de3586-dbe6-4bfd-b124-795e17fef176)

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

### Set Drawing Color 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlypqb5VTnIBxhxOqG%2FScreen%20Shot%202021-04-08%20at%203.55.06%20PM%20copy.jpg?alt=media\&token=f8a14e34-c028-4ecd-afde-ddeb76d05e33)

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

### Get Drawing Color 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlyvPXNIbhkd4cdqbH%2FScreen%20Shot%202021-04-08%20at%203.55.06%20PM%20copy.jpg?alt=media\&token=5c49f26c-2be6-4e60-9004-d5ec4cee79a7)

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

### Set Drawing Width 

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlz0iqRmccZ_IjdNin%2FScreen%20Shot%202021-04-08%20at%203.55.06%20PM%20copy.jpg?alt=media\&token=dfbe91c1-7cb2-4842-8003-a41dbb435831)

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

### Get Drawing Width

![](https://689802330-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LAn5scXl2uqUJUOqkJo%2F-MXlxFtEtj_updspK4xG%2F-MXlz68zp1Xy6D0zwsCc%2FScreen%20Shot%202021-04-08%20at%203.55.06%20PM.png?alt=media\&token=279ccf2a-4c9d-4e7b-9e2d-66fd863bd05c)

Returns the numeric value for line width on the Stage.