---
name: "DMXGetDesktopAttributes"
section: "3"
platform: "linux"
package: "libdmx-dev"
version: "1:1.1.4-2"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/DMXGetDesktopAttributes"
---

# DMXGetDesktopAttributes(3)

determine global bounding box

## NAME

DMXGetDesktopAttributes - determine global bounding box

## SYNOPSIS

**#include \<X11/extensions/dmxext.h\>**

```
Bool DMXGetDesktopAttributes(Display *dpy,
                             DMXDesktopAttributes *attr);
```

## DESCRIPTION

**DMXGetDesktopAttributes()** returns information about the desktop in **DMXDesktopAttributes**:

```
typedef struct {
    unsigned int width;
    unsigned int height;
    int          shiftX;
    int          shiftY;
} DMXDesktopAttributes;
```

The size of the global bounding box is given in *width*, and *height*. The *shiftX* and *shiftY* values will always be 0.  The global bounding box is computed whether or not Xinerama is active, but it is only useful when using Xinerama.

The global bounding box used by [**Xdmx**(1)](/Xdmx/1.md) may be larger than the Xinerama screen size because of information in the configuration file.

## RETURN VALUE

**DMXGetDesktopAttributes()** returns **True** unless there is a protocol error.

## SEE ALSO

[**DMXChangeDesktopAttributes**(3)](/DMXChangeDesktopAttributes/3.md), [**DMX**(3)](/DMX/3.md), [**Xdmx**(1)](/Xdmx/1.md)