# Screen object

The following objects are directly related to the `screen` API.

### Screen

The screen object has the following properties.

|Property|Type|Description|
|--------|----|-----------|
|screenid|string|*(readonly)* ID of the screen.|
|**name**<br>(required)|string|Name of the screen.|
|hsize|integer|Width of the screen.<br><br>Default: 1|
|vsize|integer|Height of the screen.<br><br>Default: 1|
|userid|string|Screen owner user ID.|
|private|integer|Type of screen sharing.<br><br>Possible values:<br>0 - public screen;<br>1 - *(default)* private screen.|

### Screen user

List of screen permissions based on users. It has the following
properties:

|Property|Type|Description|
|--------|----|-----------|
|screenuserid|string|*(readonly)* ID of the screen user.|
|**userid**<br>(required)|string|User ID.|
|**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;|

### Screen user group

List of screen permissions based on user groups. It has the following
properties:

|Property|Type|Description|
|--------|----|-----------|
|screenusrgrpid|string|*(readonly)* ID of the screen user group.|
|**usrgrpid**<br>(required)|string|User group ID.|
|**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;|