> ## Documentation Index
> Fetch the complete documentation index at: https://docs.simular.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Screen

> A display of a [].

A display of a \[`Machine`].

Obtain via \[`Machine.screens`], \[`Machine.mainScreen`],
\[`Machine.screenFromMouse`], or \[`Window.screen`]. A handle pins work to
one display: two \[`Screen.screenshot`] calls on the same handle always
capture the same display, unlike re-resolving the cursor's screen
between captures.

## Constructor

```typescript
Screen(): Screen
```

### Returns

`Screen`

## Methods

### boundingBox()

```typescript
boundingBox(): BoundingBox
```

Live bounding box of the screen on the global desktop.

Top-left of the primary monitor is `(0, 0)`, in the canonical
coordinate space (OS-native units; see \[`Machine`]). Monitors
arranged to the left of or above the primary display contribute
**negative** `left` / `top`. `right` and `bottom` are exclusive
(Playwright / DOM convention), matching \[`Window.boundingBox`].

For just the size, read `right - left` and `bottom - top` on the
returned box.

#### Returns

`BoundingBox`

### screenshot()

```typescript
screenshot(hideCursor: boolean): Screenshot
```

Capture this screen's pixels.

On Android `hideCursor` is ignored — a phone has no cursor.

#### Parameters

<ResponseField name={"hideCursor"} type={"boolean"} required />

#### Returns

`Screenshot`