1XvGetVideo(3)              Library Functions Manual              XvGetVideo(3)
2
3
4

Name

6       XvGetVideo - capture video from a drawable
7

Syntax

9       include Xvlib.h
10
11       XvGetVideo(dpy, port, d, gc, vx, vy, vw, vh, dx, dy, dw, dh)
12
13       register Display *dpy;
14       XvPortID port;
15       Drawable d;
16       GC gc;
17       int vx, vy, dx, dy;
18       unsigned int vw, vh;
19       unsigned int dw, dh;
20
21

Arguments

23       dpy            Specifies the connection to the X server.
24
25       port           Defines the port to which video output is sent.
26
27       d              Defines the drawable (window) from which video output is
28                      to be obtained.
29
30       gc             Defines the graphical context.  GC components are:  sub‐
31                      window-mode,  clip-x-origin,  clip-y-origin,  and  clip-
32                      mask.
33
34       vx,vy,vw,vh    Define the location and size of the video region  is  to
35                      be written.  vx and vy define the x and y coordinates of
36                      the upper-left corner of the video  region;  vw  and  vh
37                      define  the  width  and  height, in pixels, of the video
38                      region.
39
40       dx,dy,dw,dh    Define the location of the source  drawable  from  which
41                      the  video image is to be taken.  dx and dy define the x
42                      and y coordinates of the upper-left corner of the  draw‐
43                      able  region;  dw and dh define the width and height, in
44                      pixels, of the drawable region.
45

Description

47       outputs video from a drawable.  The position and size of  the  destina‐
48       tion  rectangle  is  specified by vx, vy, vw, and vh.  The position and
49       size of the source rectangle is specified by dx, dy, dw, and dh.
50
51       Drawable data is clipped to the bounds of the drawable, scaled  to  the
52       requested video region size (or the closest size supported) and clipped
53       to the bounds of the video encoding.  The contents of  any  region  not
54       updated with drawable data is undefined.
55
56       If  video is successfully initiated, an XvVideoNotify event with detail
57       XvStarted is generated for the drawable.  If the  port  is  already  in
58       use,  its video is preempted, and if the new drawable is different than
59       the old, an XvVideoNotify event with detail  XvPreempted  is  generated
60       for  the  old drawable.  If the port is grabbed by another client, this
61       request is ignored, and an XvVideoNotify event with  detail  XvBusy  is
62       generated for the drawable.
63

Returned Values

65       [Success]
66               Returned if XvGetVideo(3) completed successfully.
67
68       [XvBadExtension]
69               Returned if the Xv extension is unavailable.
70
71       [XvBadAlloc]
72               Returned  if XvGetVideo(3) failed to allocate memory to process
73               the request.
74

Diagnostics

76       [XvBadPort]
77               Generated if the requested port does not exist.
78
79       [BadGC] Generated if the requested graphics context does not exist.
80
81       [BadDrawable]
82               Generated if the requested drawable does not exist.
83
84       [BadAlloc]
85               Generated if there were insufficient resources to  process  the
86               request.
87

See Also

89       XvGetStill(3), XvPutVideo(3), XvVideoNotify(3)
90
91
92
93X Version 11                      libXv 1.0.3                    XvGetVideo(3)
Impressum