From 355f676a4ff26d8fcdfdbe64e791e60bc579e339 Mon Sep 17 00:00:00 2001 From: Kaleb Keithley Date: Fri, 14 Nov 2003 16:48:49 +0000 Subject: Initial revision --- man/Xv.man | 69 +++++++++++++++++++++++ man/XvFreeAdaptorInfo.man | 24 ++++++++ man/XvFreeEncodingInfo.man | 24 ++++++++ man/XvGetPortAttribute.man | 99 +++++++++++++++++++++++++++++++++ man/XvGetStill.man | 128 ++++++++++++++++++++++++++++++++++++++++++ man/XvGetVideo.man | 133 ++++++++++++++++++++++++++++++++++++++++++++ man/XvGrabPort.man | 70 +++++++++++++++++++++++ man/XvPortNotify.man | 58 +++++++++++++++++++ man/XvPutStill.man | 108 +++++++++++++++++++++++++++++++++++ man/XvPutVideo.man | 119 +++++++++++++++++++++++++++++++++++++++ man/XvQueryAdaptors.man | 100 +++++++++++++++++++++++++++++++++ man/XvQueryBestSize.man | 68 ++++++++++++++++++++++ man/XvQueryEncodings.man | 94 +++++++++++++++++++++++++++++++ man/XvQueryExtension.man | 51 +++++++++++++++++ man/XvSelectPortNotify.man | 53 ++++++++++++++++++ man/XvSelectVideoNotify.man | 49 ++++++++++++++++ man/XvSetPortAttribute.man | 100 +++++++++++++++++++++++++++++++++ man/XvStopVideo.man | 56 +++++++++++++++++++ man/XvUngrabPort.man | 51 +++++++++++++++++ man/XvVideoNotify.man | 58 +++++++++++++++++++ 20 files changed, 1512 insertions(+) create mode 100644 man/Xv.man create mode 100644 man/XvFreeAdaptorInfo.man create mode 100644 man/XvFreeEncodingInfo.man create mode 100644 man/XvGetPortAttribute.man create mode 100644 man/XvGetStill.man create mode 100644 man/XvGetVideo.man create mode 100644 man/XvGrabPort.man create mode 100644 man/XvPortNotify.man create mode 100644 man/XvPutStill.man create mode 100644 man/XvPutVideo.man create mode 100644 man/XvQueryAdaptors.man create mode 100644 man/XvQueryBestSize.man create mode 100644 man/XvQueryEncodings.man create mode 100644 man/XvQueryExtension.man create mode 100644 man/XvSelectPortNotify.man create mode 100644 man/XvSelectVideoNotify.man create mode 100644 man/XvSetPortAttribute.man create mode 100644 man/XvStopVideo.man create mode 100644 man/XvUngrabPort.man create mode 100644 man/XvVideoNotify.man (limited to 'man') diff --git a/man/Xv.man b/man/Xv.man new file mode 100644 index 0000000..eaf5861 --- /dev/null +++ b/man/Xv.man @@ -0,0 +1,69 @@ +.TH Xv 3X __vendorversion__ +.\" +.\" $XFree86: xc/doc/man/Xv/Xv.man,v 1.6 2001/01/27 18:20:35 dawes Exp $ +.SH Name +Xv \- X Window System video extension +.SH Description +The Xv extension provides support for video adaptors attached to an X +display. It takes the approach that a display may have one or more +video adaptors, each of which has one or more ports through which +independent video streams pass. +.PP +An adaptor may be able to display video in a drawable, capture video +from a drawable, or both. It translates between video encoding (NTSC, +PAL, SECAM, etc...) and drawable format (depth and visual-id pair). An +adaptor may support multiple video encodings and/or multiple drawable +formats. +.PP +Clients use Xv(3X) to gain access and manage sharing of a display's +video resources. Typically, a client will use XvQueryExtension(3X) to +determine the status of the extension, XvQueryAdaptors(3X) to get a +description of what video adaptors exist, and XvQueryEncodings(3X) to +get a description of what video encodings an adaptor supports. +.PP +Once a client has determined what video resources are available, it is +free to put video into a drawable or get video from a drawable, +according the capabilities supported. Clients can select to receive +events when video activity changes in a drawable and when port +attributes have changed. +.SH Summary of Library Functions +The following is a summary of Xv library functions: +.sp 1l +XvGetPortAttribute(3X) \- return current port attribute value +.sp 1l +XvGetStill(3X) \- capture a single frame of video from a drawable +.sp 1l +XvGetVideo(3X) \- capture video from a drawable +.sp 1l +XvGrabPort(3X) \- lock port for exclusive use by client +.sp 1l +XvPortNotify(3X) \- event generated when port attributes change +.sp 1l +XvPutStill(3X) \- write a single frame of video to a drawable +.sp 1l +XvPutVideo(3X) \- write video into a drawable +.sp 1l +XvQueryAdaptors(3X) \- return adaptor information for a screen +.sp 1l +XvQueryBestSize(3X) \- determine the optimum drawable region size +.sp 1l +XvQueryEncodings(3X) \- return list of encodings for an adaptor +.sp 1l +XvQueryExtension(3X) \- return version and revision of extension +.sp 1l +XvSelectPortNotify(3X) \- enable or disable XvPortNotify events +.sp 1l +XvSelectVideoNotify(3X) \- enable or disable XvVideoNotify events +.sp 1l +XvSetPortAttribute(3X) \- set an attribute for a port +.sp 1l +XvStopVideo(3X) \- stop active video +.sp 1l +XvUngrabPort(3X) \- release a grabbed port +.sp 1l +XvVideoNotify(3X) \- event generated for video processing +.sp 1l +.PP +Each of these functions is described in its own Xv man page. +.br + diff --git a/man/XvFreeAdaptorInfo.man b/man/XvFreeAdaptorInfo.man new file mode 100644 index 0000000..8a557c5 --- /dev/null +++ b/man/XvFreeAdaptorInfo.man @@ -0,0 +1,24 @@ +.TH XvFreeAdaptorInfo 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvFreeAdaptorInfo.man,v 1.5 2001/01/27 18:20:35 dawes Exp $ +.SH Name +XvFreeAdaptorInfo \- free adaptor information +.\" +.SH Syntax +\fBXvFreeAdaptorInfo(\fIp_adaptor_info\fR) +.sp 1l +\fBXvAdaptorInfo \fI*p_adaptor_info\fR; +.SH Arguments +.\" +.IP \fIp_adaptor_info\fR 8 +Pointer to where the adaptor information is located. +.\" +.SH Description +.\" +XvFreeAdaptorInfo(3X) frees adaptor information that +was returned by XvQueryAdaptors(3X). The data structure +used for adaptor information is defined in the +reference page for XvQueryAdaptors(3X). +.SH See Also +.\" +XvQueryAdaptors(3X), XvFreeEncodingInfo(3X) +.br diff --git a/man/XvFreeEncodingInfo.man b/man/XvFreeEncodingInfo.man new file mode 100644 index 0000000..d7f609c --- /dev/null +++ b/man/XvFreeEncodingInfo.man @@ -0,0 +1,24 @@ +.TH XvFreeEncodingInfo 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvFreeEncodingInfo.man,v 1.5 2001/01/27 18:20:35 dawes Exp $ +.SH Name +XvFreeEncodingInfo \- free encoding information +.\" +.SH Syntax +\fBXvFreeEncodingInfo(\fIp_encoding_info\fR) +.sp 1l +\fBXvEncodingInfo \fI*p_encoding_info\fR; +.SH Arguments +.\" +.IP \fIp_encoding_info\fR 8 +Pointer to where the encoding information is located. +.\" +.SH Description +.\" +XvFreeEncodingInfo(3X) frees encoding information that +was returned by XvQueryEncodings(3X). The data structure +used for encoding information is defined in the +reference page for XvQueryEncodings(3X). +.SH See Also +.\" +XvQueryEncodings(3X) +.br diff --git a/man/XvGetPortAttribute.man b/man/XvGetPortAttribute.man new file mode 100644 index 0000000..de1c21f --- /dev/null +++ b/man/XvGetPortAttribute.man @@ -0,0 +1,99 @@ +.TH XvGetPortAttribute 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvGetPortAttribute.man,v 1.6 2001/01/27 18:20:35 dawes Exp $ +.SH Name +XvGetPortAttribute \- return current port attribute value +.\" +.SH Syntax +.B #include +.sp 1l +.B XvGetPortAttribute(\fIdpy, port, attribute, p_value\fR) +.sp 1l +\fBDisplay \fI*dpy\fR; +.br +\fBXvPortID \fIport\fR; +.br +\fBAtom \fIattribute\fR; +.br +\fBint \fI*p_vlaue\fR; +.sp 1l +.\" +.SH Arguments +.\" +.IP \fIdpy\fR 8 +Specifies the display screen on which the +X Server is to accept requests from X clients. If the +display option is not specified, X uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 8 +Specifies the port, associated with the given display, for +which the attribute values are to be returned. +.IP \fIattribute\fR 8 +An atom that identifies the attribute to be queried by this +request. Control atoms are obtained using the XInternAtom +request with a string from the following table. +.IP \fIp_value\fR 8 +Pointer to the location where the attribute value is written on +return. +.\" +.SH Description +.\" +.PP +XvGetPortAttribute(3X) returns the current value of the requested +port attribute in the integer pointed to by \fIp_value\fR. +The attribute is identified using an Atom that equates to the attribute name. +The XInternAtom request can be used with one of the strings +below to return a matching Atom. +.bp +.PP +.\" .TS +.\" tab(@); +.\" lfHB lfHB lfHB +.\" lfR lfR lfR . +.\" _ +.\" .PP +.\" .sp 4p +.\" Attribute String@Type@Default +.\" .sp 6p +.\" _ +.\" .sp 6p +.\" "XV_ENCODING"@XvEncodingID@Server dependent +.\" "XV_HUE"@[-1000...1000]@0 +.\" "XV_SATURATION"@[-1000...1000]@0 +.\" "XV_BRIGHTNESS"@[-1000...1000]@0 +.\" "XV_CONTRAST"@[-1000...1000]@0 +.\" .sp 6p +.\" .TE +.nf +Attribute String Type Default + +"XV_ENCODING" XvEncodingID Server dependent +"XV_HUE" [-1000...1000] 0 +"XV_SATURATION" [-1000...1000] 0 +"XV_BRIGHTNESS" [-1000...1000] 0 +"XV_CONTRAST" [-1000...1000] 0 +.fi +.SH Returned Values +.IP [Success] 8 +Returned if XvGetPortAttribute(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvGetPortAttribute(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [XvBadPort] 8 +Generated if the requested port does not exist. +.IP [BadMatch] 8 +Generated if the requested attribute atom does not specify an attribute +supported by the adaptor. +.SH See Also +.\" +XvSetPortAttribute(3X), XvPortNotify(3X) +.br + + + + diff --git a/man/XvGetStill.man b/man/XvGetStill.man new file mode 100644 index 0000000..af3ec6d --- /dev/null +++ b/man/XvGetStill.man @@ -0,0 +1,128 @@ +.TH XvGetStill 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvGetStill.man,v 1.5 2001/01/27 18:20:36 dawes Exp $ +.SH Name +XvGetStill \- capture a single frame of video from a drawable +.\" +.SH Syntax +.B include "Xvlib.h" +.sp 1l +.B XvGetStill(\fIdpy, port, d, gc, vx, vy, vw, vh, dx, dy, dw, dh\fP) +.sp 1l +.B register +.I Display +.I *dpy; +.br +.B XvPortID +.I port; +.br +.B Drawable +.I d; +.br +.B GC +.I gc; +.br +.B int +.I vx, +.I vy, +.I dx, +.I dy; +.br +.B unsigned int +.I vw, +.I vh; +.br +.B unsigned int +.I dw, +.I dh; +.sp 1l +.\" +.SH Arguments +.\" +.IP \fIdpy\fR 15 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 15 +Defines the port to which the still is outputed. +.IP \fId\fR 15 +Defines the drawable from which the still is to be captured. +Pixmaps are currently not supported. +.IP \fIgc\fR 15 +Defines the graphical context. GC components are: +.I subwindow-mode, +.I clip-x-origin, +.I clip-y-origin, +and +.I clip-mask. +.IP \fIvx,vy,vw,vh\fR 15 +Define the location and size of the destination video region +into which the still is to be written. \fIvx\fP and \fIvy\fP define the +.I x and +.I y +coordinates of the upper-left corner of the video region; +.I vw and +.I vh +define the width and height, in pixels, of the video region. +.IP \fIdx,dy,dw,dh\fR 15 +Define the location and size of the source drawable from which the +still image is to be captured. +.I dx and +.I dy +define the +.I x and +.I y +coordinates of the upper-left corner of the drawable region; +.I dw and +.I dh +define the width and height, in pixels, of the drawable region. +.\" +.SH Description +.\" +.PN XvGetStill +captures a single frame of video from a drawable. The +position and size of the destination (video) rectangle is specified by \fIvx, +vy, vw\fR, and \fIvh\fR. The position and size of the +source (drawable) rectangle is +specified by \fIdx, dy, dw\fR, and \fIdh\fR. +.PP +Drawable data is clipped to the bounds of the drawable, scaled to the +requested video region size (or the closest size supported) and +clipped to the bounds of the video encoding. The contents of any region +not updated with drawable data is undefined. +.PP +./" If the still is successfully captured an XvVideoNotify event with +./" detail XvStill is generated for the drawable. +./" [mhs]: Not in this universe +If the port is grabbed +by another client, this request is ignored, and an XvVideoNotify event +with detail XvBusy is generated for the drawable. +.SH Returned Values +.IP [Success] 8 +Returned if XvGetStill(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvGetStill(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [XvBadPort] 8 +Generated if the requested port does not exist. +.IP [BadDrawable] 8 +Generated if the requested drawable does not exist. +.IP [BadGC] 8 +Generated if the requested graphics context does not exist. +.IP [BadAlloc] 8 +Generated if there were insufficient resources to process the request. +.\" +.SH See Also +.\" +XvPutStill(3X), XvGetVideo(3X), XvPutVideo(3X), XvVideoNotify(3X) +.br + + + + diff --git a/man/XvGetVideo.man b/man/XvGetVideo.man new file mode 100644 index 0000000..1b64710 --- /dev/null +++ b/man/XvGetVideo.man @@ -0,0 +1,133 @@ +.TH XvGetVideo 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvGetVideo.man,v 1.5 2001/01/27 18:20:36 dawes Exp $ +.SH Name +XvGetVideo \- capture video from a drawable +.\" +.SH Syntax +.B include "Xvlib.h" +.sp 1l +.B XvGetVideo(dpy, port, d, gc, vx, vy, vw, vh, dx, dy, dw, dh) +.sp 1l +.B register +.I Display +.I *dpy; +.br +.B XvPortID +.I port; +.br +.B Drawable +.I d; +.br +.B GC +.I gc; +.br +.B int +.I vx, +.I vy, +.I dx, +.I dy; +.br +unsigned int +.I vw, +.I vh; +.br +unsigned int +.I dw, +.I dh; +.sp 1l +.\" +.SH Arguments +.\" +.IP \fIdpy\fR 15 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 15 +Defines the port to which video output is sent. +.IP \fId\fR 15 +Defines the drawable (window) from which video output is to be obtained. +.IP \fIgc\fR 15 +Defines the graphical context. GC components are: +.I subwindow-mode, +.I clip-x-origin, +.I clip-y-origin, +and +.I clip-mask. +.IP \fIvx,vy,vw,vh\fR 15 +Define the location and size of the video region is to be written. \fIvx\fP +and \fIvy\fP define the +.I x and +.I y +coordinates of the upper-left corner of the video region; +.I vw and +.I vh +define the width and height, in pixels, of the video region. +.IP \fIdx,dy,dw,dh\fR 15 +Define the location of the source drawable from which the +video image is to be taken. +.I dx and +.I dy +define the +.I x and +.I y +coordinates of the upper-left corner of the drawable region; +.I dw and +.I dh +define the width and height, in pixels, of the drawable region. +.br +.SH Description +.PN XvGetVideo +outputs video from a drawable. The position +and size of the destination rectangle is specified by +.I vx, +.I vy, +.I vw, +and +.I vh. +The position and size of the source rectangle is specified by +.I dx, +.I dy, +.I dw, +and +.I dh. +.PP +Drawable data is clipped to the bounds of the drawable, scaled to the +requested video region size (or the closest size supported) and +clipped to the bounds of the video encoding. The contents of any region +not updated with drawable data is undefined. +.PP +If video is successfully initiated, an XvVideoNotify event with +detail XvStarted is generated for the drawable. If the port is +already in use, its video is preempted, and if the new drawable is +different than the old, an XvVideoNotify event with detail XvPreempted +is generated for the old drawable. If the port is grabbed by another +client, this request is ignored, and an XvVideoNotify event with detail +XvBusy is generated for the drawable. +.\" +.br +.SH Returned Values +.IP [Success] 8 +Returned if XvGetVideo(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvGetVideo(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [XvBadPort] 8 +Generated if the requested port does not exist. +.IP [BadGC] 8 +Generated if the requested graphics context does not exist. +.IP [BadDrawable] 8 +Generated if the requested drawable does not exist. +.IP [BadAlloc] 8 +Generated if there were insufficient resources to process the request. +.SH See Also +.br +.\" +XvGetStill(3X), XvPutVideo(3X), XvVideoNotify(3X) +.br diff --git a/man/XvGrabPort.man b/man/XvGrabPort.man new file mode 100644 index 0000000..8f5cb19 --- /dev/null +++ b/man/XvGrabPort.man @@ -0,0 +1,70 @@ +.TH XvGrabPort 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvGrabPort.man,v 1.5 2001/01/27 18:20:36 dawes Exp $ +.SH Name +XvGrabPort \- lock port for exclusive use by client +.\" +.SH Syntax +.B #include +.sp 1l +.B XvGrabPort(\fIdpy, port, time)\fR +.sp 1l +.B Display \fI*dpy;\fR +.br +.B XvPortID +.I port; +.br +.B Time +.I time; +.\" +.SH Arguments +.\" +.IP \fIdpy\fR 8 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 8 +Defines the port to be grabbed. +.IP \fItime\fR 8 +Specifies the request timestamp. +.\" +.SH Description +.\" +XvGrabPort(3X) grabs a port. Once a client grabs a port, +only that client can make video requests +to that port. +.PP +If the time is before the current port time, the XvGrabPort request is +ignored and XvInvalidTime is returned. If the port is already grabbed by +another client, XvAlreadyGrabbed is returned. Otherwise it returns a +status of \fISuccess\fR. The port time is updated when the following +requests are processed: XvGrabPort(3X), XvUngrabPort(3X), +XvPutVideo(3X), XvPutStill(3X), XvGetVideo(3X), XvGetStill(3X). +.PP +If the port is actively processing video for another client, the +video is preempted, and an XvVideoNotify event with detail XvPreempted +is generated for its drawable. +.\" +.SH Returned Values +.IP [Success] 8 +Returned if XvGrabPort(3X) completed successfully. +.IP [XvInvalidTime] 8 +Returned if requested time is older than the current port time. +.IP [XvAlreadyGrabbed] 8 +Returned if the port is already grabbed by another client. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvGrabPort(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [XvBadPort] 15 +Generated if the requested port does not exist. +.\" +.SH See Also +.\" +XvUngrabPort(3X) XvVideoNotify(3X) +.br diff --git a/man/XvPortNotify.man b/man/XvPortNotify.man new file mode 100644 index 0000000..acccf85 --- /dev/null +++ b/man/XvPortNotify.man @@ -0,0 +1,58 @@ +.TH XvPortNotify 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvPortNotify.man,v 1.5 2001/01/27 18:20:36 dawes Exp $ +.SH Name +XvPortNotify \- event generated when port attributes change +.\" +.SH Syntax +.B #include +.br +.sp 1l +.EX + + typedef union { + int type; + XvVideoNotifyEvent xvvideo; + XvPortNotifyEvent xvport; + long pad[24]; + } XvEvent; + + typedef struct { + int type; + unsigned long serial; + Bool send_event; + Display *display; + XvPortID port_id; + Time time; + Atom attribute; + long value; + } XvPortNotifyEvent; + +.EE +.\" +.IP \fItype\fR 8 +Specifies the type of event: XvPortNotify. +.IP \fIserial\fR 8 +Number of the last request processed by the server. +.IP \fIsend_event\fR 8 +True if the event was generated by a SendEvent request. +.IP \fIdisplay\fR 8 +A pointer to the display the event was read from. +.IP \fIport_id\fR 8 +The port whose attribute has changed. +.IP \fIattribute\fR 8 +An atom specifying the attribute that changed. +.IP \fIvalue\fR 8 +The new value of the attribute. +.\" +.SH Description +.\" +XvPortNotify events are generated when a port attribute is set using +the XvSetPortAttribute(3X) function. +.\" +.SH See Also +XvSetPortAttribute(3X), XvGetPortAttribute(3X), XvSelectPortNotify(3X) +.\" + + + + diff --git a/man/XvPutStill.man b/man/XvPutStill.man new file mode 100644 index 0000000..0d8c7c6 --- /dev/null +++ b/man/XvPutStill.man @@ -0,0 +1,108 @@ +.TH XvPutStill 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvPutStill.man,v 1.5 2001/01/27 18:20:36 dawes Exp $ +.SH Name +XvPutStill \- write a single frame of video to a drawable +.\" +.SH Syntax +.B #include +.sp 1l +\fBXvPutStill(\fIdpy, port, d, gc, vx, vy, vw, vh, dx, dy, dw, dh\fR) +.sp 1l +.B Display +.I *dpy; +.br +.B XvPortID +.I port; +.br +.B Drawable +.I d; +.br +.B GC +.I gc; +.br +.B int +.I vx, +.I vy, +.I dx, +.I dy; +.br +.B unsigned int +.I vw, +.I vh; +.br +.B unsigned int +.I dw, +.I dh; +.sp 1l +.\" +.SH Arguments +.\" +.IP \fIdpy\fR 15 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 15 +Defines the port from which to get the still. +.IP \fId\fR 15 +Defines the drawable into which the still is to be written. +Pixmaps are currently not supported. +.IP \fIgc\fR 15 +Defines the graphical context. +GC components are: +.I subwindow-mode, +.I clip-x-origin, +.I clip-y-origin, +and +.I clip-mask. +.IP \fIvx,vy,vw,vh\fR 15 +Define the location and size of the video region +to be written. \fIvx\fP and \fIvy\fP define the +upper-left pixel of the region. \fIvw\fP and \fIvh\fP +define the width and height, in pixels, of the region. +.IP \fIdx,dy,dw,dh\fR 15 +Define the location and size of the destination region into which the +still image is written. \fIdx\fP and \fIdy\fP define the upper-left +corner of the region. \fIdw\fP and \fIdh\fP +define the width and height, in pixels, of the region. +.\" +.SH Description +.\" +XvPutStill(3X) writes a single frame of video to a drawable. +The position and size of the source (video) rectangle is specified by \fIvx, +vy, vw\fR, and \fIvh\fR. The position and size of the destination (drawable) +rectangle is specified by \fIdx, dy, dw\fR, and \fIdh\fR. +.PP +Video data is clipped to the bounds of the video encoding, scaled to the +requested drawable region size (or the closest size supported) and +clipped to the bounds of the drawable. +.PP +If the port is grabbed by another client, this request is ignored, and +an XvVideoNotify event with detail XvBusy is generated for the +drawable. If the port is not receiving a valid video signal a +VideoNotify event with detail XvHardError is generated for the drawable. +.\" +.SH Returned Values +.IP [Success] 8 +Returned if XvPutStill(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvGetStill(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [XvBadPort] 8 +Generated if the requested port does not exist. +.IP [BadDrawable] 8 +Generated if the requested drawable does not exist. +.IP [BadGC] 8 +Generated if the requested graphics context does not exist. +.IP [BadAlloc] 8 +Generated if there were insufficient resources to process the request. +.SH See Also +.\" +XvPutVideo(3X), XvGetStill(3X), XvVideoNotify(3X) +.br diff --git a/man/XvPutVideo.man b/man/XvPutVideo.man new file mode 100644 index 0000000..22e09ad --- /dev/null +++ b/man/XvPutVideo.man @@ -0,0 +1,119 @@ +.TH XvPutVideo 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvPutVideo.man,v 1.5 2001/01/27 18:20:36 dawes Exp $ +.SH Name +XvPutVideo \- write video into a drawable +.\" +.SH Syntax +.B #include +.sp 1l +\fBXvPutVideo(\fIdpy, port, d, gc, vx, vy, vw, vh, dx, dy, dw, dh\fR) +.sp 1l +.B Display +.I *dpy; +.br +.B XvPortID +.I port; +.br +.B Drawable +.I d; +.br +.B GC +.I gc; +.br +.B int +.I vx, +.I vy, +.I dx, +.I dy; +.br +.B unsigned int +.I vw, +.I vh; +.br +.B unsigned int +.I dw, +.I dh; +.sp 1l +.\" +.SH Arguments +.\" +.IP \fIdpy\fR 15 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 15 +Defines the port from which to get video. +.IP \fId\fR 15 +Defines the drawable (window) into which video is to be written. +.IP \fIgc\fR 15 +Defines the graphical context. +GC components are: +.I subwindow-mode, +.I clip-x-origin, +.I clip-y-origin, +and +.I clip-mask. +.IP \fIvx,vy,vw,vh\fR 15 +Define the size and location of the source (video) region +to be written. \fIvx\fP and \fIvy\fP define the +upper-left pixel of the region. \fIvw\fP and \fIvh\fP +define the width and height, in pixels, of the region. +.IP \fIdx,dy,dw,dh\fR 15 +Define the location and size of the destination (drawable) region +into which the video image is written. +.I dx +and +.I dy +define the upper-left pixel of the region. +.I dw +and +.I dh +define the width and height, in pixels, of the region. +.\" +.SH Description +.\" +XvPutVideo writes video into a drawable. +The position and size of the source (video) +rectangle is specified by \fIvx, vy, vw\fR, and \fIvh\fR. +The position and size of the destination (drawable) +rectangle is specified by \fIdx, dy, dw\fR, and \fIdh\fR. +.PP +Video data is clipped to the bounds of the video encoding, scaled to the +requested drawable region size (or the closest size supported) and +clipped to the bounds of the drawable. +.PP +If video is successfully initiated, an XvVideoNotify event with detail +XvStarted is generated for the drawable. If the port is already in +use, its video is preempted, and if the new drawable is different than +the old, an XvVideoNotify event with detail XvPreempted is generated +for the old drawable. If the port is grabbed by another client, this +request is ignored, and an XvVideoNotify event with detail XvBusy is +generated for the drawable. If the port is not receiving a valid video +signal or if the video signal is interrupted while video is active a +VideoNotify event with detail XvHardError is generated for the drawable. +.\" +.SH Returned Values +.IP [Success] 8 +Returned if XvPutVideo(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if there were insufficient resources to process the request. +.SH Diagnostics +.IP [XvBadPort] 8 +Generated if the requested port does not exist. +.IP [BadDrawable] 8 +Generated if the requested drawable does not exist. +.IP [BadGC] 8 +Generated if the requested graphics context does not exist. +.IP [BadAlloc] 8 +Generated if there were insufficient resources to process the request. +.\" +.SH See Also +.\" +XvPutStill(3X), XvGetVideo(3X), XvVideoNotify(3X) +.br diff --git a/man/XvQueryAdaptors.man b/man/XvQueryAdaptors.man new file mode 100644 index 0000000..5f060df --- /dev/null +++ b/man/XvQueryAdaptors.man @@ -0,0 +1,100 @@ +.TH XvQueryAdaptors 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvQueryAdaptors.man,v 1.6 2001/08/17 13:27:50 dawes Exp $ +.SH Name +XvQueryAdaptors \- return adaptor information for a screen +.\" +.SH Syntax +.B #include +.br +.sp 1l +.B XvQueryAdaptors(\fIdpy, win, p_num_adaptors, pp_adaptor_info\fR) +.sp 1l +\fBDisplay \fI*dpy;\fR +.br +\fBDrawable \fI draw;\fR +.br +\fBint \fI*p_num_adaptors\fR; +.br +\fBXvAdaptorInfo \fI**pp_adaptor_info\fR; +.br +.\" +.SH Arguments +.\" +.IP \fIdpy\fR 8 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIdraw\fR 8 +Specifies a drawable of the screen for which the adaptor +information is desired. +.IP \fIp_num_adaptors\fR 8 +A pointer to where the numer of adaptors for the specified screen +is returned. +.IP \fIpp_adaptor_info\fR 8 +A pointer to where the list of returned adaptor information is +returned. +.\" +.SH Description +.\" +XvQueryAdaptors(3X) returns an video adaptor information for +the screen of the specified drawable. The XvAdaptorInfo structure +has the following organization: +.EX + + typedef struct { + XvPortID base_id; + unsigned long num_ports; + char type; + char *name; + unsigned long num_formats; + XvFormat *formats; + unsigned long num_adaptors; + } XvAdaptorInfo; + +.EE +.IP \fIbase_id\fR 8 +The resource ID of the first adaptor port. +.IP \fInum_ports\fR 8 +The number of ports supported by the adaptor. +.IP \fItype\fR 8 +A bit mask with the value XvInputMask asserted if the adaptor supports video +input, and value XvOutputMask asserted if the adaptor supports video output. +.IP \fIname\fR 8 +A vendor specific name that identifies the adaptor. +.IP \fInum_formats\fR 8 +The number of depth/visual id formats supported by the adaptor. +.IP \fIformats\fR 8 +A pointer to an array of XvFormat structures. +.PP +The XvFormat structure has the following organization: +.EX + + typedef struct { + char depth; + unsigned long visual_id; + } XvFormat; + +.EE +.IP \fIdepth\fR 8 +A drawable depth supported by the adaptor. +.IP \fIvisual_id\fR 8 +A visual-id supported for the given depth by the adaptor. +.\" +.SH Returned Values +.IP [Success] 8 +Returned if XvQueryAdaptors(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvQueryAdaptors(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [Drawable] 8 +Returned if the requested drawable does not exist. +.SH See Also +XvFreeAdaptorInfo(3X) +.\" diff --git a/man/XvQueryBestSize.man b/man/XvQueryBestSize.man new file mode 100644 index 0000000..031c094 --- /dev/null +++ b/man/XvQueryBestSize.man @@ -0,0 +1,68 @@ +.TH XvQueryBestSize 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvQueryBestSize.man,v 1.5 2001/01/27 18:20:36 dawes Exp $ +.SH Name +XvQueryBestSize \- determine the optimum drawable region size +.\" +.SH Syntax +.B #include +.sp 1l +\fBXvQueryBestSize\fP(\fIdpy, port, motion, vw, vh, dw, dh, p_dw, p_dh\fR) +.sp 1l +.B Display \fI*dpy\fR; +.br +.B XvPortID \fIport\fR; +.br +.B Bool \fImotion\fR; +.br +.B unsigned +.B int \fIvw, vh\fR; +.br +\fBunsigned int \fIdw, dh;\fR +.br +\fBunsigned int \fI*p_dw, *p_dh;\fR +.\" +.SH Arguments +.\" +.IP \fIdpy\fR 15 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 15 +Defines the port associated with the display and adaptor for which +the optimum size is to be calculated. +.IP \fImotion\fR 15 +Specifies \fITrue\fP if the destination size needs to support +full motion, and \fIFalse\fP if the destination size need only +support still images. +.IP \fIvw,vh\fR 15 +Specifies the size of the source video region desired. +.IP \fIdw,dh\fR 15 +Specifies the size of the destination drawable region desired. +.IP \fIp_dw,p_dh\fR 15 +Pointers to where the closest destination sizes supported by the server are +returned. +.\" +.SH Description +.\" +Some ports may be able to scale incoming or outgoing video. +XvQueryBestSize(3X) returns the size of the closest destination +region that is supported by the adaptor. The returned size is +guaranteed to be smaller than the requested size if a smaller +size is supported. +.\" +.SH Returned Values +.IP [Success] 8 +Returned if XvQueryBestSize(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvQueryBestSize(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [XvBadPort] 8 +Generated if the requested port does not exist. +.br diff --git a/man/XvQueryEncodings.man b/man/XvQueryEncodings.man new file mode 100644 index 0000000..42af2c6 --- /dev/null +++ b/man/XvQueryEncodings.man @@ -0,0 +1,94 @@ +.TH XvQueryEncodings 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvQueryEncodings.man,v 1.6 2001/01/27 18:20:36 dawes Exp $ +.SH Name +XvQueryEncodings \- return list of encodings for an adaptor +.\" +.SH Syntax +.B #include +.sp 1l +\fBXvQueryEncodings(\fIdpy, port, p_num_encodings, pp_encoding_info)\fR +.sp 1l +\fBregister Display \fI*dpy\fR; +.br +\fBXvPortID \fIport\fR; +.br +\fBunsigned long \fI*p_num_encodings\fR; +.br +\fBXvEncodingInfo \fI**pp_encoding_info\fR; +.\" +.SH Arguments +.IP \fI*dpy\fR 15 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 15 +Specifies the port whose adaptor is to be queried for its +list of encodings. +.IP \fIp_num_encodings\fR 15 +A pointer to where the number of encodings supported +by the adaptor is written. +.IP \fIpp_encoding_info\fR 15 +A pointer to where the list of returned +encoding information is returned. +XvEncodingInfo has the following structure: +.EX + + typedef struct { + XvEncodingID encoding_id; + char *name; + unsigned long width; + unsigned long height; + XvRational rate; + unsigned long num_encodings; + } XvEncodingInfo; + +.EE +.IP \fIencoding_id\fR 15 +Specifies the encoding-id of the encoding. The encoding-id is used to +identify an encoding when a port's encoding attribute is changed. +.IP \fIname\fR 15 +A pointer to a formatted string that identifies the encoding. The string +has the format "\fItiming-signaltype\fR". For example "ntsc-composite". +.IP \fIwidth,height\fR 15 +The width and height, in pixels, of the decoded video image. +.IP \fIrate\fR 15 +The field rate of the decoded video. +.PP +The XvRational structure is used to specify a fractional number. +It has the following structure: +.EX + + typedef struct { + int numerator; + int denominator; + } XvRational; + +.EE +The \fInumerator\fP and \fIdenominator\fP fields specify the +appropriate parts of a fractional number. +.\" +.SH Description +XvQueryEncodings(3X) returns encoding information about an adaptor. Each +encoding is described by the XvEncodingInfo structure described above. The +encodings are identified by an encoding-id, which can be used to set or get +the encoding attribute of a port. +.SH Returned Values +.IP [Success] 8 +Returned if XvQueryEncodings(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvQueryEncodings(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [XvBadPort] 8 +Generated if the requested port does not exist. +.\" +.SH See Also +.\" +XvFreeEncodingInfo(3X) +.br diff --git a/man/XvQueryExtension.man b/man/XvQueryExtension.man new file mode 100644 index 0000000..3549f96 --- /dev/null +++ b/man/XvQueryExtension.man @@ -0,0 +1,51 @@ +.TH XvQueryExtension 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvQueryExtension.man,v 1.6 2001/08/17 13:27:50 dawes Exp $ +.SH Name +XvQueryExtension \- return version and release of extension +.\" +.SH Syntax +.B #include +.sp 1l +\fBXvQueryExtension(\fIdpy, p_version, p_release, +.br + p_request_base, p_event_base, p_error_base\fR) +.sp 1l +\fBDisplay \fI*dpy\fR; +.br +\fBunsigned int \fI*p_version, *p_release\fR; +.br +\fBunsigned int \fI*p_request_base, *p_event_base, *p_error_base\fR; +.\" +.SH Arguments +.\" +.IP \fIp_version\fR 15 +Pointer to where the current version number of the \fIXv\fP video extension +is written. +.IP \fIp_release\fR 15 +Pointer to where the release number of the \fIXv\fP video extension +is written. +.IP \fIp_request_base\fR 15 +Pointer to where the extension major request number is returned +.IP \fIp_event_base\fR 15 +Pointer to where the extension event base is returned +.IP \fIp_error_base\fR 15 +Pointer to where the extension error base is returned +.\" +.SH Description +.\" +.PP +XvQueryExtension(3X) returns the version and release +numbers for the Xv video extension currently loaded +on the system. The extension major request number, event base, and error +base are also returned. +.\" +.SH Returned Values +.IP [Success] 8 +Returned if XvQueryExtension(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv video extension is not available for +the named display. +.IP [XvBadAlloc] 8 +Returned if XvQueryExtension(3X) failed to allocate memory to process +the request. +.br diff --git a/man/XvSelectPortNotify.man b/man/XvSelectPortNotify.man new file mode 100644 index 0000000..8e0eb89 --- /dev/null +++ b/man/XvSelectPortNotify.man @@ -0,0 +1,53 @@ +.TH XvSelectPortNotify 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvSelectPortNotify.man,v 1.6 2001/08/17 13:27:50 dawes Exp $ +.SH Name +XvSelectPortNotify \- enable or disable XvPortNotify(3X) events +.\" +.SH Syntax +.B #include +.sp 1l +\fBXvSelectPortNotify(\fIdpy, port, onoff\fR) +.sp 1l +\fBDisplay \fI*dpy\fR; +.br +\fBXvPortID \fIport\fR; +.br +\fBBool \fIonoff\fR; +.\" +.SH Arguments +.\" +.IP \fIdpy\fR 8 +Specifies the display screen on which the +X Server is to accept requests from X clients. If the +display option is not specified, X uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 8 +Specifies the port for which PortNotify events are to be generated +when its attributes are changed using XvSetPortAttribute(3X). +.IP \fIonoff\fR 8 +Specifies whether notification is to be enabled or disabled. +.\" +.SH Description +.\" +XvSelectPortNotify(3X) enables or disables PortNotify event +delivery to the requesting client. XvPortNotify(3X) events are +generated when port attributes are changed using XvSetPortAttribute(3X). +.\" +.SH Returned Values +.IP [Success] 8 +Returned if XvSelectPortNotify(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvSelectPortNotify(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [XvBadPort] 8 +Generated if the requested port does not exist. +.SH See Also +.\" +XvSetPortNotify(3X), XvSetPortAttribute(3X), XvPortNotify(3X) +.br diff --git a/man/XvSelectVideoNotify.man b/man/XvSelectVideoNotify.man new file mode 100644 index 0000000..26645bf --- /dev/null +++ b/man/XvSelectVideoNotify.man @@ -0,0 +1,49 @@ +.TH XvSelectVideoNotify 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvSelectVideoNotify.man,v 1.6 2001/08/17 13:27:50 dawes Exp $ +.SH Name +XvSelectVideoNotify \- enable or disable VideoNotify events +.\" +.SH Syntax +\fB#include\fI \fR +.sp 1l +\fBXvSelectVideoNotify(\fIdpy, drawable, onoff\fR) +.sp 1l +\fBregister Display \fI*dpy\fR; +.br +\fBDrawable \fIdrawable\fR; +.br +\fBBool \fIonoff\fR; +.SH Arguments +.\" +.IP \fIdpy\fR 15 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIdrawable\fR 15 +Defines the drawable in which video activity is to be reported. +.IP \fIonoff\fR 15 +Selects whether video notification is enabled or disabled. +.\" +.SH Description +XvSelectVideoNotify(3X) enables or disables events to be reported for +video activity in a drawable. +.\" +.SH Returned Values +.IP [Success] 8 +Returned if XvSelectVideoNotify(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvSelectVideoNotify(3X) failed to allocate memory to process +the request. +.Diagnostics +.IP [BadDrawable] 8 +Generated if the requested drawable does not exist. +.SH See Also +.\" +XvVideoNotify +.br diff --git a/man/XvSetPortAttribute.man b/man/XvSetPortAttribute.man new file mode 100644 index 0000000..f61d682 --- /dev/null +++ b/man/XvSetPortAttribute.man @@ -0,0 +1,100 @@ +.TH XvSetPortAttribute 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvSetPortAttribute.man,v 1.7 2001/08/17 13:27:50 dawes Exp $ +.SH Name +XvSetPortAttribute \- sets an attribute of a video port +.\" +.SH Syntax +\fB#include \fR +.sp 1l +\fBXvSetPortAttribute(\fIdpy, port, attribute, value\fR) +.sp 1l +\fBDisplay \fI*dpy\fR; +.br +\fBXvPortID \fIport\fR; +.br +\fBAtom \fIattribute\fR; +.br +\fBint \fIvalue\fR; +.SH Arguments +.\" +.IP \fIdpy\fR 15 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 15 +Specifies the port for which the attribute is to be used. +.IP \fIattribute\fR 15 +Identifies the port attribute to be set by this request. +Can be one of the table entries under the column "String," below. +.IP \fIvalue\fR 15 +Identifies the value to which \fIattribute\fP is to be set. +Can be one of the table entries under the column "Type," below. +.\" +.SH Description +XvSetPortAttribute(3X) permits a client to set the port attribute +to specified values. This request supports the following values: +.bp +.PP +.\" .TS +.\" tab(@); +.\" lfHB lfHB lfHB +.\" lfR lfR lfR . +.\" _ +.\" .PP +.\" .sp 4p +.\" Attribute String@Type@Default +.\" .sp 6p +.\" _ +.\" .sp 6p +.\" "XV_ENCODING"@XvEncodingID@Server dependent +.\" "XV_HUE"@[-1000...1000]@0 +.\" "XV_SATURATION"@[-1000...1000]@0 +.\" "XV_BRIGHTNESS"@[-1000...1000]@0 +.\" "XV_CONTRAST"@[-1000...1000]@0 +.\" .sp 6p +.\" .TE +.nf +Attribute String Type Default + +"XV_ENCODING" XvEncodingID Server dependent +"XV_HUE" [-1000...1000] 0 +"XV_SATURATION" [-1000...1000] 0 +"XV_BRIGHTNESS" [-1000...1000] 0 +"XV_CONTRAST" [-1000...1000] 0 +.fi +.PP +The supplied encoding must be one of the encodings listed for the +adaptor, otherwise an Encoding error results. +.PP +If the adaptor does not support the exact hue, saturation, +brightness, and contrast levels supplied, the closest levels +supported are assumed. Use XvGetPortAttribute(3X) +to query the resulting levels. +.PP +When an XvSetPortAttribute(3X) request is processed, a +PortControlNotify(3X) event is generated for all clients +that have requested for port changes using XvSelectPortNotify(3X). +.SH Returned Values +.IP [Success] 8 +Returned if XvSetPortAttribute(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvSelectVideoNotify(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [XvBadPort] 8 +Generated if the requested port does not exist. +.IP [XvBadEncoding] 8 +Generated if an encoding is specified that does not exist. +.IP [BadMatch] 8 +Generated if the requested attribute atom does not specify an attribute +supported by the adaptor. +.SH See Also +.\" +XvGetPortAttribute(3X), XvSelectPortNotify(3X), XvPortNotify(3X) +.br diff --git a/man/XvStopVideo.man b/man/XvStopVideo.man new file mode 100644 index 0000000..c5e188b --- /dev/null +++ b/man/XvStopVideo.man @@ -0,0 +1,56 @@ +.TH XvStopVideo 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvStopVideo.man,v 1.6 2001/08/17 13:27:50 dawes Exp $ +.SH Name +XvStopVideo \- stop active video +.\" +.SH Syntax +\fB#include +.sp 1l +\fBXvStopVideo(\fIdpy, port, draw\fR) +.sp 1l +\fBDisplay \fI*dpy\fR; +.br +\fBXvPortID \fIport\fR; +.br +\fBDrawable \fIdraw\fR; +.\" +.SH Arguments +.\" +.\" +.IP \fIdpy\fR 15 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 15 +Specifies the port for which video is to be stopped. +.IP \fIdraw\fR 15 +Specifies the drawable associated with the named port. +.SH Description +.\" +XvStopVideo(3X) stops active video for the specified port and +drawable. If the port is not processing video, or if it is processing +video in a different drawable, the request is ignored. When video is +stopped a XvVideoNotify(3X) event with detail XvStopped is generated +for the associated drawable. +.\" +.SH Returned Values +.IP [Success] 8 +Returned if XvStopVideo(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvStopVideo(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [XvBadPort] 8 +Generated if the requested port does not exist. +.IP [BadDrawable] 8 +Generated if the requested drawable does not exist. +.\" +.SH See Also +XvGetVideo(3X), XvPutVideo(3X), XvVideoNotifyEvent(3X) +.br diff --git a/man/XvUngrabPort.man b/man/XvUngrabPort.man new file mode 100644 index 0000000..3e6cdb1 --- /dev/null +++ b/man/XvUngrabPort.man @@ -0,0 +1,51 @@ +.TH XvUngrabPort 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvUngrabPort.man,v 1.6 2001/08/17 13:27:50 dawes Exp $ +.SH Name +XvUngrabPort \- release port grabbed for video operation +.\" +.SH Syntax +\fB#include +.sp 1l +XvUngrabPort(\fIdpy, port, time\fR) +.sp 1l +\fBDisplay \fI*dpy\fR; +.br +\fBXvPortID \fIport\fR; +.br +\fBTime \fItime\fR; +.SH Arguments +.\" +.IP \fIdpy\fR 15 +Specifies the display screen on which the +Xv Server is to accept requests from Xv clients. If the +display option is not specified, Xv uses the display screen +specified by your DISPLAY environment variable. The display +option has the format hostname:number. Using two colons +(::) instead of one (:) indicates that DECnet is to be used +for transport. +.IP \fIport\fR 15 +Specifies the port to be released. If the port had not been +previously grabbed, the request is ignored. +.IP \fItime\fR 15 +Specifies the request timestamp. +.\" +.SH Description +XvUngrabPort(3X) releases a grabbed port. If \fItime\fR specifies a +time before the last XvGrabPort(3X) was executed, the +request is ignored. +.\" +.SH Returned Values +.IP [Success] 8 +Returned if XvUngrabPort(3X) completed successfully. +.IP [XvBadExtension] 8 +Returned if the Xv extension is unavailable. +.IP [XvBadAlloc] 8 +Returned if XvUngrabPort(3X) failed to allocate memory to process +the request. +.SH Diagnostics +.IP [XvBadPort] 8 +Generated if the requested port does not exist. +.SH See Also +.\" +XvGrabPort(3X) +.br diff --git a/man/XvVideoNotify.man b/man/XvVideoNotify.man new file mode 100644 index 0000000..8a50b08 --- /dev/null +++ b/man/XvVideoNotify.man @@ -0,0 +1,58 @@ +.TH XvVideoNotify 3X __vendorversion__ +.\" $XFree86: xc/doc/man/Xv/XvVideoNotify.man,v 1.5 2001/01/27 18:20:36 dawes Exp $ +.SH Name +XvVideoNotify \- event generated for video processing +.\" +.SH Syntax +.B #include +.br +.sp 1l +.EX + + typedef union { + int type; + XvVideoNotifyEvent xvvideo; + XvPortNotifyEvent xvport; + long pad[24]; + } XvEvent; + + typedef struct { + int type; + unsigned long serial; + Bool send_event; + Display *display; + Drawable drawable; + unsigned long reason; + XvPortID port_id; + Time time; + } XvVideoNotifyEvent; + +.EE +.\" +.IP \fItype\fR 8 +Specifies the type of event: XvVideoNotify(3X). +.IP \fIserial\fR 8 +Number of the last request processed by the server. +.IP \fIsend_event\fR 8 +True if the event was generated by a SendEvent request. +.IP \fIdisplay\fR 8 +A pointer to the display the event was read from. +.IP \fIdrawable\fR 8 +The drawable for which the event was generated. +.IP \fIreason\fR 8 +The reason the event was generated: \fBXvStarted\fR, \fBXvStopped\fR, +\fBXvPreempted\fR, \fBXvBusy\fR, \fBXvHardError\fR. +.IP \fIport_id\fR 8 +The port processing the video for which the event was generated. +.\" +.SH Description +.\" +XvVideoNotify(3X) events are generated when video +is started, stopped, preempted by another video +request, ignored because the port is grabbed by another client, or interruped +because of a hard transmission or reception error. +.\" +.SH See Also +XvPutVideo(3X), XvPutStill(3X), XvGetVideo(3X), XvGetStill(3X), +XvStopVideo(3X), XvSelectVideoNotify(3X) +.\" -- cgit v1.2.1