XvPutImage(3xv) libXv Functions XvPutImage(3xv)NAME
XvPutImage, XvShmPutImage - display an XvImage
SYNOPSIS
cc [ flag... ] file... -lXv [ library... ]
#include <X11/extensions/Xvlib.h>
int XvPutImage (Display *dpy, XvPortID port,
Drawable d, GC gc, XvImage *image,
int src_x, int src_y,
unsigned int src_w, unsigned int src_h,
int dest_x, int dest_y,
unsigned int dest_w, unsigned int dest_h);
int XvShmPutImage (Display *dpy, XvPortID port,
Drawable d, GC gc, XvImage *image,
int src_x, int src_y,
unsigned int src_w, unsigned int src_h,
int dest_x, int dest_y,
unsigned int dest_w, unsigned int dest_h,
Bool send_event);
ARGUMENTS
dpy Specifies the connection to the X server.
port The port id of a port on an XvImage capable adaptor.
d
gc the graphics context specifying the clip mask to use, if any.
image A pointer to the XvImage to be displayed.
src_? The portion of the XvImage to be displayed.
dest_? The portion of the destination drawable to be filled by the
image.
send_event
Indicates whether or not an XShmCompletionEvent should be sent.
If sent, the event's major_code and minor_code fields will
indicate the Xv extension's major code and XvShmPutImage's
minor code.
DESCRIPTIONXvPutImage(3xv) is similar to XPutImage(3xv). XvShmPutImage(3xv) is
similar to XShmPutImage(3xv). The library will allocate the XvImage
structure and fill out all fields except for data. Width and height
may be enlarged in some YUV formats. The size of the data buffer that
needs to be allocated will be given in the data_size field in the XvIm‐
age. Image data is not allocated by this function. The client may
pass a pointer to the preallocated memory as data or may allocate the
memory and fill in the XvImage structure's data field after the
data_size field has been filled out by the server. The XvImage struc‐
ture may be freed by XFree(3xv).
DIAGNOSTICS
[XvBadPort]
Generated if the requested port does not exist.
[XvBadAlloc]
Generated if the X server was unable to allocate resources
required to complete the operation.
[BadMatch]
Generated if incompatible arguments were supplied, such as a
port that isn't capable of displaying XvImages.
[BadShmSegCode]
Generated if an invalid shared memory segment is specified.
SEE ALSOXvListImageFormats(3xv), XvCreateImage(3xv), XvShmCreateImage(3xv)XPutImage(3xv), XShmPutImage(3xv)ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │x11/library/libxv │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Volatile │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │See XInitThreads(3X11) │
└─────────────────────────────┴─────────────────────────────┘
X Version 11 libXv 1.0.5 XvPutImage(3xv)