Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
xcb_shm_get_image(3)		  XCB Requests		    xcb_shm_get_image(3)

NAME
     xcb_shm_get_image	-  Copies data from the specified drawable to the shared
     memory segment.

SYNOPSIS
     #include <xcb/shm.h>

   Request function
     xcb_shm_get_image_cookie_t        xcb_shm_get_image(xcb_connection_t *conn,
	    xcb_drawable_t drawable,   int16_t x,   int16_t y,	 uint16_t width,
	    uint16_t height,	    uint32_t plane_mask,	 uint8_t format,
	    xcb_shm_seg_t shmseg, uint32_t offset);

   Reply datastructure
     typedef struct xcb_shm_get_image_reply_t {
	 uint8_t	response_type;
	 uint8_t	depth;
	 uint16_t	sequence;
	 uint32_t	length;
	 xcb_visualid_t visual;
	 uint32_t	size;
     } xcb_shm_get_image_reply_t;

   Reply function
     xcb_shm_get_image_reply_t	*xcb_shm_get_image_reply(xcb_connection_t *conn,
	    xcb_shm_get_image_cookie_t cookie, xcb_generic_error_t **e);

REQUEST ARGUMENTS
     conn      The XCB connection to X11.

     drawable  The drawable to copy the image out of.

     x	       The X coordinate in the drawable to begin copying at.

     y	       The Y coordinate in the drawable to begin copying at.

     width     The width of the image to copy.

     height    The height of the image to copy.

     plane_maskA mask that determines which planes are used.

     format    The format to use for the copy (???).

     shmseg    The destination shared memory segment.

     offset    The offset in the shared memory segment to copy data to.

REPLY FIELDS
     response_type
	       The type of this reply,	in  this  case	XCB_SHM_GET_IMAGE.  This
	       field  is also present in the xcb_generic_reply_t and can be used
	       to tell replies apart from each other.

     sequence  The sequence number of the last	request  processed  by	the  X11
	       server.

     length    The length of the reply, in words (a word is 4 bytes).

     depth     The depth of the source drawable.

     visual    The visual ID of the source drawable.

     size      The number of bytes copied.

DESCRIPTION
     Copy  data  from  the specified drawable to the shared memory segment.  The
     amount of bytes written to the destination image is  always  equal  to  the
     number of bytes read from the shared memory segment.

RETURN VALUE
     Returns an xcb_shm_get_image_cookie_t. Errors have to be handled when call-
     ing the reply function xcb_shm_get_image_reply.

     If you want to handle errors in the event loop instead, use xcb_shm_get_im-
     age_unchecked. See xcb-requests(3) for details.

ERRORS
     This request does never generate any errors.

SEE ALSO
     xcb-requests(3)

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

X Version 11			  libxcb 1.17.0 	    xcb_shm_get_image(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xcb_shm_get_image&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help