.\" 
.\" Copyright (c) 1999, 2001 The X Japanese Documentation Project.
.\" 
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish, dis-
.\" tribute, sublicense, and/or sell copies of the Software, and to permit
.\" persons to whom the Software is furnished to do so, subject to the fol-
.\" lowing conditions:
.\" 
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
.\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT
.\" SHALL  THE X JAPANESE DOCUMENTATION PROJECT  BE  LIABLE  FOR  ANY CLAIM,
.\" DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,  TORT OR
.\" OTHERWISE,  ARISING FROM,  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\" 
.\" Except as contained in this notice, the name of The X Japanese
.\" Documentation Project shall not be used in advertising or otherwise to
.\" promote the sale, use or other dealings in this Software without prior
.\" written authorization from The X Japanese Documentation Project.
.\" 
.\" X Window System is a trademark of The Open Group.
.\" 
.\" Translated Sat Sep 04 20:29:56 JST 1999
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Sun Oct 14 16:17:46 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" 
.TH XvGetVideo 3X  "Version 4.1.0" "XFree86"
.\" $XFree86: xc/doc/man/Xv/XvGetVideo.man,v 1.5 2001/01/27 18:20:36 dawes Exp $
.\"0 .SH Name
.SH 名前
.\"0 XvGetVideo \- capture video from a drawable
XvGetVideo \- ドロウアブルから動画を取り込む
.\"
.\"0 .SH Syntax
.SH 書式
.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
.\"
.\"0 .SH Arguments
.SH 引き数
.\"
.IP \fIdpy\fR 15
.\"0 Specifies the display screen on which the
.\"0 Xv Server is to accept requests from Xv clients.  If the
.\"0 display option is not specified, Xv uses the display screen
.\"0 specified by your DISPLAY environment variable.  The display
.\"0 option has the format hostname:number.  Using two colons
.\"0 (::) instead of one (:) indicates that DECnet is to be used
.\"0 for transport.
Xv サーバが Xv クライアントからのリクエストを受け付けるディスプレイ画面
を指定する。ディスプレイを指定するオプションが指定されていなければ、Xv
は DISPLAY 環境変数で指定されているディスプレイを使う。ディスプレイ
指定オプションは「ホスト名:番号」という形式である。コロン 1 つ(:)でな
く、コロン 2 つ(::)を使った場合には、トランスポート層で DECnet を使う
ことが指定される。
.IP \fIport\fR 15
.\"0 Defines the port to which video output is sent.
ビデオ出力が送られるポートを定義する。
.IP \fId\fR 15
.\"0 Defines the drawable (window) from which video output is to be obtained.
ビデオ出力を取り込むドロウアブル(ウィンドウ)を定義する。
.IP \fIgc\fR 15
.\"0 Defines the graphical context.  GC components are: 
.\"0 .I subwindow-mode, 
.\"0 .I clip-x-origin, 
.\"0 .I clip-y-origin,
.\"0 and 
.\"0 .I clip-mask.
グラフィックスコンテクスト(GC)を定義する。GC の構成要素は
.I subwindow-mode, 
.I clip-x-origin, 
.I clip-y-origin,
.I clip-mask
である。
.IP \fIvx,vy,vw,vh\fR 15
.\"0 Define the location and size of the video region is to be written.  \fIvx\fP 
.\"0 and \fIvy\fP define the 
.\"0 .I x and
.\"0 .I y
.\"0 coordinates of the upper-left corner of the video region; 
書き込みが行われるビデオ領域の位置と大きさを定義する。
\fIvx\fP と \fIvy\fP はビデオ領域の左上隅の
.I x
座標と
.I y
座標を定義する。
.\"0 .I vw and
.\"0 .I vh
.\"0 define the width and height, in pixels, of the video region.
.I vw
と
.I vh
はビデオ領域の高さと幅をピクセル単位で定義する。
.IP \fIdx,dy,dw,dh\fR 15
.\"0 Define the location of the source drawable from which the
.\"0 video image is to be taken.  
ビデオイメージを取り込むドロウアブルの位置と大きさを定義する。
.\"0 .I dx and
.\"0 .I dy 
.\"0 define the 
.\"0 .I x and
.\"0 .I y 
.\"0 coordinates of the upper-left corner of the drawable region; 
.I dx
と
.I dy 
は、ドロウアブル領域の左上隅の
.I x
座標と
.I y 
座標を定義する。
.\"0 .I dw and 
.\"0 .I dh 
.\"0 define the width and height, in pixels, of the drawable region.
.I dw
と
.I dh 
は、ドロウアブル領域の幅と高さをピクセル単位で定義する。
.br
.\"0 .SH Description
.SH 説明
.\"0 .PN XvGetVideo
.\"0 outputs video from a drawable.  The position
.\"0 and size of the destination rectangle is specified by 
.\"0 .I vx,
.\"0 .I vy, 
.\"0 .I vw, 
.\"0 and 
.\"0 .I vh.  
.PN XvGetVideo
はドロウアブルから取り込んだ動画を出力する。出力先の矩形領域の位置と
大きさは \fIvx, vy, vw, vh\fR で指定する。
.\"0 The position and size of the source rectangle is specified by 
.\"0 .I dx, 
.\"0 .I dy, 
.\"0 .I dw, 
.\"0 and 
.\"0 .I dh.
入力先の矩形領域の位置と大きさは \fIdx, dy, dw dh\fR で指定する。
.PP
.\"0 Drawable data is clipped to the bounds of the drawable, scaled to the
.\"0 requested video region size (or the closest size supported) and
.\"0 clipped to the bounds of the video encoding.  The contents of any region
.\"0 not updated with drawable data is undefined.
ドロウアブルデータは、ドロウアブルの境界でクリップされ、
要求されたビデオ領域の大きさ(あるいは、サポートされているうちでこれに
最も近い大きさ)に拡大・縮小され、ビデオエンコーディングの境界でクリップされる。
ドロウアブルデータで更新しなかった領域の内容は未定義である。
.PP
.\"0 If video is successfully initiated, an XvVideoNotify event with
.\"0 detail XvStarted is generated for the drawable.  If the port is
.\"0 already in use, its video is preempted, and if the new drawable is
.\"0 different than the old, an XvVideoNotify event with detail XvPreempted
.\"0 is generated for the old drawable.  If the port is grabbed by another
.\"0 client, this request is ignored, and an XvVideoNotify event with detail
.\"0 XvBusy is generated for the drawable.
ビデオがうまく開始したら、詳細内容として XvStarted を持つ 
XvVideoNotify イベントがそのドロウアブルに対して生成される。ポートが既
に使用中ならば、そのビデオ処理は無効にされ、さらに新しいドロウアブル
が古いドロウアブルと異なる場合には、詳細内容として XvPreempted を持つ
XvVideoNotify イベントが古いドロウアブルに対して生成される。他の
クライアントがポートをグラブしていると、詳細内容として XvBusy を持つ
XvVideoNotify イベントがそのドロウアブルに対して生成される。
.\"
.br
.\"0 .SH Returned Values
.SH 返り値
.IP [Success] 8
.\"0 Returned if XvGetVideo(3X) completed successfully.
XvGetVideo(3X) が正常に終了すると返される。
.IP [XvBadExtension] 8
.\"0 Returned if the Xv extension is unavailable.
Xv 機能拡張が使えない場合に返される。
.IP [XvBadAlloc] 8
.\"0 Returned if XvGetVideo(3X) failed to allocate memory to process
.\"0 the request.
XvGetVideo(3X) がリクエストを処理するために使うメモリの割り当てに失敗
した場合に返される。
.\"0 .SH Diagnostics
.SH 診断
.IP [XvBadPort] 8
.\"0 Generated if the requested port does not exist.
要求されたポートが存在しない場合に生成される。
.IP [BadGC] 8
.\"0 Generated if the requested graphics context does not exist.
要求されたグラフィックスコンテクストが存在しない場合に生成される。
.IP [BadDrawable] 8
.\"0 Generated if the requested drawable does not exist.
要求されたドロウアブルが存在しない場合に生成される。
.IP [BadAlloc] 8
.\"0 Generated if there were insufficient resources to process the request.
リクエストを処理するための資源が不十分な場合に生成される。
.\"0 .SH See Also
.SH 関連項目
.br
.\"
XvGetStill(3X), XvPutVideo(3X), XvVideoNotify(3X)
.br