.\" .\" 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:35:33 JST 1999 .\" by FUJIWARA Teruyoshi .\" Updated Sun Oct 14 16:24:22 JST 2001 for XFree86 4.1.0 .\" by FUJIWARA Teruyoshi .\" .TH XvPutVideo 3X "Version 4.1.0" "XFree86" .\" $XFree86: xc/doc/man/Xv/XvPutVideo.man,v 1.5 2001/01/27 18:20:36 dawes Exp $ .\"0 .SH Name .SH 名前 .\"0 XvPutVideo \- write video into a drawable XvPutVideo \- 動画をドロウアブルに書き込む .\" .\"0 .SH Syntax .SH 書式 .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 .\" .\"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 from which to get video. 動画を取得するポートを定義する。 .IP \fId\fR 15 .\"0 Defines the drawable (window) into which video is to be written. 動画が書き込まれるドロウアブル(ウィンドウ)を定義する。 .IP \fIgc\fR 15 .\"0 Defines the graphical context. グラフィックスコンテクスト(GC)を定義する。 .\"0 GC components are: .\"0 .I subwindow-mode, .\"0 .I clip-x-origin, .\"0 .I clip-y-origin, .\"0 and .\"0 .I clip-mask. 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 size and location of the source (video) region .\"0 to be written. \fIvx\fP and \fIvy\fP define the .\"0 upper-left pixel of the region. \fIvw\fP and \fIvh\fP .\"0 define the width and height, in pixels, of the region. 書き込みが行われる入力先(ビデオ)領域の位置と大きさを定義する。 \fIvx\fP と \fIvy\fP は、この領域の左上のピクセルを定義する。 \fIvw\fP と \fIvh\fP は、この領域の幅と高さをピクセル単位で指定する。 .IP \fIdx,dy,dw,dh\fR 15 .\"0 Define the location and size of the destination (drawable) region .\"0 into which the video image is written. 動画イメージが書き込まれる出力先(ドロウアブル)領域の位置と大きさを定義 する。 .\"0 .I dx .\"0 and .\"0 .I dy .\"0 define the upper-left pixel of the region. .I dx と .I dy は、この領域の左上のピクセルを定義する。 .\"0 .I dw .\"0 and .\"0 .I dh .\"0 define the width and height, in pixels, of the region. .I dw と .I dh は、この領域の幅と高さをピクセル単位で指定する。 .\" .\"0 .SH Description .SH 説明 .\" .\"0 XvPutVideo writes video into a drawable. XvPutVideo は動画をドロウアブルに書き込む。 .\"0 The position and size of the source (video) .\"0 rectangle is specified by \fIvx, vy, vw\fR, and \fIvh\fR. 入力先(ビデオ)の矩形領域の位置と大きさは \fIvx, vy, vw, vh\fR によって 指定する。 .\"0 The position and size of the destination (drawable) .\"0 rectangle is specified by \fIdx, dy, dw\fR, and \fIdh\fR. 出力先(ドロウアブル)の矩形領域の位置と大きさは \fIdx, dy, dw, dh\fR によって指定する。 .PP .\"0 Video data is clipped to the bounds of the video encoding, scaled to the .\"0 requested drawable region size (or the closest size supported) and .\"0 clipped to the bounds of the drawable. ビデオデータはビデオエンコーディングの境界でクリップされ、リクエストさ れたドロウアブル領域の大きさ(あるいはサポートされている大きさでこれに 最も近いもの)に拡大・縮小され、ドロウアブルの境界でクリップされる。 .PP .\"0 If video is successfully initiated, an XvVideoNotify event with detail .\"0 XvStarted is generated for the drawable. If the port is already in .\"0 use, its video is preempted, and if the new drawable is different than .\"0 the old, an XvVideoNotify event with detail XvPreempted is generated .\"0 for the old drawable. If the port is grabbed by another client, this .\"0 request is ignored, and an XvVideoNotify event with detail XvBusy is .\"0 generated for the drawable. If the port is not receiving a valid video .\"0 signal or if the video signal is interrupted while video is active a .\"0 VideoNotify event with detail XvHardError is generated for the drawable. ビデオがうまく開始したら、詳細内容として XvStarted を持つ XvVideoNotify イベントがそのドロウアブルに対して生成される。ポートが既 に使用中ならば、そのビデオ処理は無効にされ、さらに新しいドロウアブル が古いドロウアブルと異なる場合には、詳細内容として XvPreempted を持つ XvVideoNotify イベントが古いドロウアブルに対して生成される。他の クライアントがポートをグラブしていると、詳細内容として XvBusy を持つ XvVideoNotify イベントがそのドロウアブルに対して生成される。ポートが 正しいビデオ信号を受け取っていない場合や、ビデオがアクティブな間に ビデオ信号に割り込みがかかった場合には、詳細内容として XvHardError を 持つ VideoNotify イベントがそのドロウアブルに対して生成される。 .\" .\"0 .SH Returned Values .SH 返り値 .IP [Success] 8 .\"0 Returned if XvPutVideo(3X) completed successfully. XvPutVideo(3X) が正常に終了した場合に返される。 .IP [XvBadExtension] 8 .\"0 Returned if the Xv extension is unavailable. Xv 機能拡張が使えない場合に返される。 .IP [XvBadAlloc] 8 .\"0 Returned if there were insufficient resources to process the request. リクエストを処理するための資源が不十分な場合に返される。 .\"0 .SH Diagnostics .SH 診断 .IP [XvBadPort] 8 .\"0 Generated if the requested port does not exist. 要求されたポートが存在しない場合に生成される。 .IP [BadDrawable] 8 .\"0 Generated if the requested drawable does not exist. 要求されたドロウアブルが存在しない場合に生成される。 .IP [BadGC] 8 .\"0 Generated if the requested graphics context does not exist. 要求されたグラフィックスコンテクストが存在しない場合に生成される。 .IP [BadAlloc] 8 .\"0 Generated if there were insufficient resources to process the request. リクエストを処理するための資源が不十分な場合に生成される。 .\" .\"0 .SH See Also .SH 関連項目 .\" XvPutStill(3X), XvGetVideo(3X), XvVideoNotify(3X) .br