---
name: "SDL_HINT_DISPLAY_USABLE_BOUNDS"
section: "3"
platform: "linux"
package: "libsdl3-doc"
version: "3.2.10+ds-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SDL_HINT_DISPLAY_USABLE_BOUNDS"
---

# SDL\_HINT\_DISPLAY\_USABLE\_BOUNDS(3)

Override for SDL\_GetDisplayUsableBounds ().

## NAME

SDL\_HINT\_DISPLAY\_USABLE\_BOUNDS - Override for  **SDL\_GetDisplayUsableBounds** ().

## HEADER FILE

Defined in SDL3/SDL\_hints.h

## SYNOPSIS

```
#include "SDL3/SDL.h"
```

**#define SDL\_HINT\_DISPLAY\_USABLE\_BOUNDS** *SDL\_DISPLAY\_USABLE\_BOUNDS"*

## DESCRIPTION

If set, this hint will override the expected results for

**SDL\_GetDisplayUsableBounds** () for display index 0. Generally you don't want to do this, but this allows an embedded system to request that some of the screen be reserved for other uses when paired with a well-behaved application.

The contents of this hint must be 4 comma-separated integers, the first is the bounds x, then y, width and height, in that order.

This hint can be set anytime.

## AVAILABILITY

This hint is available since SDL 3.2.0.