---
name: "xosd_set_vertical_offset"
section: "3"
platform: "linux"
package: "xosd"
version: "2.2.14-12"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/xosd_set_vertical_offset"
---

# xosd\_set\_vertical\_offset(3)

Change the offset of the XOSD window

## NAME

xosd\_set\_vertical\_offset - Change the offset of the XOSD window

## SYNOPSIS

**#include \<xosd.h\>**

**int xosd\_set\_vertical\_offset (xosd\*** *osd***, int** *offset***);**

## DESCRIPTION

**xosd\_set\_vertical\_offset** changes the number of pixels the XOSD window is offset from the top or bottom of the screen. This is normally set to a value such as 48 to avoid desktop-panels, such as those provided by GNOME or KDE.

## ARGUMENTS

- *osd*

  The on-screen display object to act on.

- *offset*

  Offset from the top or bottom of the screen, in pixels.

## RETURN VALUE

On success, a zero is returned. On error, -1 is returned.

## SEE ALSO

**xosd\_init**(3), [**xosd\_set\_pos**(3)](/xosd_set_pos/3.md).
