---
name: "xcb_put_image"
section: "3"
platform: "linux"
package: "libxcb"
version: "1.17.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/xcb_put_image"
---

# xcb\_put\_image(3)

## NAME

xcb\_put\_image -

## SYNOPSIS

**#include \<xcb/xproto.h\>**

### Request function

xcb\_void\_cookie\_t **xcb\_put\_image**(xcb\_connection\_t \**conn*, uint8\_t *format*, xcb\_drawable\_t *drawable*, xcb\_gcontext\_t *gc*, uint16\_t *width*, uint16\_t *height*, int16\_t *dst\_x*, int16\_t *dst\_y*, uint8\_t *left\_pad*, uint8\_t *depth*, uint32\_t *data\_len*, const uint8\_t \**data*);\

## REQUEST ARGUMENTS

- *conn*

  The XCB connection to X11.

- *format*

  One of the following values:

  - *XCB\_IMAGE\_FORMAT\_XY\_BITMAP*

    TODO: NOT YET DOCUMENTED.

  - *XCB\_IMAGE\_FORMAT\_XY\_PIXMAP*

    TODO: NOT YET DOCUMENTED.

  - *XCB\_IMAGE\_FORMAT\_Z\_PIXMAP*

    TODO: NOT YET DOCUMENTED.

  TODO: NOT YET DOCUMENTED.

- *drawable*

  TODO: NOT YET DOCUMENTED.

- *gc*

  TODO: NOT YET DOCUMENTED.

- *width*

  TODO: NOT YET DOCUMENTED.

- *height*

  TODO: NOT YET DOCUMENTED.

- *dst\_x*

  TODO: NOT YET DOCUMENTED.

- *dst\_y*

  TODO: NOT YET DOCUMENTED.

- *left\_pad*

  TODO: NOT YET DOCUMENTED.

- *depth*

  TODO: NOT YET DOCUMENTED.

- *data\_len*

  TODO: NOT YET DOCUMENTED.

- *data*

  TODO: NOT YET DOCUMENTED.

## DESCRIPTION

## RETURN VALUE

Returns an *xcb\_void\_cookie\_t*. Errors (if any) have to be handled in the event loop.

If you want to handle errors directly with *xcb\_request\_check* instead, use *xcb\_put\_image\_checked*. See **[xcb-requests(3)](/xcb-requests/3.md)** for details.

## ERRORS

This request does never generate any errors.

## SEE ALSO

## AUTHOR

Generated from xproto.xml. Contact xcb@lists.freedesktop.org for corrections and improvements.