.\" .\" 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 Mon Aug 30 23:24:02 JST 1999 .\" by FUJIWARA Teruyoshi .\" Updated Fri Oct 12 01:07:24 JST 2001 for XFree86 4.1.0 .\" by FUJIWARA Teruyoshi .\" .TH Xv 3X "Version 4.1.0" "XFree86" .\" .\" $XFree86: xc/doc/man/Xv/Xv.man,v 1.6 2001/01/27 18:20:35 dawes Exp $ .\"0 .SH Name .SH 名前 .\"0 Xv --- X Window System video extension Xv --- X ウィンドウシステムの動画機能拡張 .\"0 .SH Description .SH 説明 .\"0 The Xv extension provides support for video adaptors attached to an X .\"0 display. It takes the approach that a display may have one or more .\"0 video adaptors, each of which has one or more ports through which .\"0 independent video streams pass. Xv 機能拡張は、X のディスプレイに接続するビデオアダプタをサポートでき るようにする。この機能拡張が取っているアプローチにおいては、ディスプレ イは 1 つあるいは複数のビデオアダプタを持つことができ、そのそれぞれが 1 つあるいは複数のポートを持ち、これを経由して独立したビデオストリーム を流すことができる。 .PP .\"0 An adaptor may be able to display video in a drawable, capture video .\"0 from a drawable, or both. It translates between video encoding (NTSC, .\"0 PAL, SECAM, etc...) and drawable format (depth and visual-id pair). An .\"0 adaptor may support multiple video encodings and/or multiple drawable .\"0 formats. アダプタによっては、ドロウアブル上で動画を表示することができるかもしれ ないし、ドロウアブルから動画を取り込むことができるかもしれない。 あるいはその両方が可能かもしれない。この機能拡張は動画のエンコーディン グ(NTSC, PAL, SECAM 等)とドロウアブルのフォーマット(深さとビジュアル ID のペア)を相互に変換する。アダプタによっては、複数の動画エンコーディングや 複数のドロウアブルフォーマットを扱えるかもしれない。 .PP .\"0 Clients use Xv(3X) to gain access and manage sharing of a display's .\"0 video resources. Typically, a client will use XvQueryExtension(3X) to .\"0 determine the status of the extension, XvQueryAdaptors(3X) to get a .\"0 description of what video adaptors exist, and XvQueryEncodings(3X) to .\"0 get a description of what video encodings an adaptor supports. クライアントは Xv(3X) を用いてディスプレイのビデオ資源の使用権を取得し、 共有を管理する。クライアントは普通、XvQueryExtension(3X) を用いて機能 拡張の状態を調べ、XvQueryAdaptors(3X) を用いて存在しているビデオアダプタ を調べ、XvQueryEncodings(3X) を用いてアダプタがサポートしている動画 エンコーディングを調べる。 .PP .\"0 Once a client has determined what video resources are available, it is .\"0 free to put video into a drawable or get video from a drawable, .\"0 according the capabilities supported. Clients can select to receive .\"0 events when video activity changes in a drawable and when port .\"0 attributes have changed. クライアントは利用可能なビデオ資源を一度調べれば、サポートされている機 能に従って、自由に動画をドロウアブルに張り付けたり、ドロウアブルから 動画を取り込んでよい。クライアントは、ビデオの動作が変化した時や、 ポートの属性が変化した時のイベントを選択して受け取ることができる。 .\"0 .SH Summary of Library Functions .SH ライブラリ関数の概略 .\"0 The following is a summary of Xv library functions: Xv ライブラリ関数の概略を以下に示す: .sp 1l .\"0 XvGetPortAttribute(3X) \- return current port attribute value XvGetPortAttribute(3X) \- 現在のポートの属性値を返す .sp 1l .\"0 XvGetStill(3X) \- capture a single frame of video from a drawable XvGetStill(3X) \- ドロウアブルから動画を 1 フレーム取り込む .sp 1l .\"0 XvGetVideo(3X) \- capture video from a drawable XvGetVideo(3X) \- ドロウアブルから動画を取り込む .sp 1l .\"0 XvGrabPort(3X) \- lock port for exclusive use by client XvGrabPort(3X) \- クライアントによる排他使用のためにポートをロックする .sp 1l .\"0 XvPortNotify(3X) \- event generated when port attributes change XvPortNotify(3X) \- ポートの属性が変化した時にイベントを生成する .sp 1l .\"0 XvPutStill(3X) \- write a single frame of video to a drawable XvPutStill(3X) \- ドロウアブルに動画を 1 フレーム書き込む .sp 1l .\"0 XvPutVideo(3X) \- write video into a drawable XvPutVideo(3X) \- ドロウアブルに動画を書き込む .sp 1l .\"0 XvQueryAdaptors(3X) \- return adaptor information for a screen XvQueryAdaptors(3X) \- 画面に対応するアダプタの情報を返す .sp 1l .\"0 XvQueryBestSize(3X) \- determine the optimum drawable region size XvQueryBestSize(3X) \- 最適なドロウアブル領域の大きさを決める .sp 1l .\"0 XvQueryEncodings(3X) \- return list of encodings for an adaptor XvQueryEncodings(3X) \- アダプタがサポートしているエンコーディングの一覧を返す .sp 1l .\"0 XvQueryExtension(3X) \- return version and revision of extension XvQueryExtension(3X) \- 機能拡張のバージョンとリビジョンを返す .sp 1l .\"0 XvSelectPortNotify(3X) \- enable or disable XvPortNotify events XvSelectPortNotify(3X) \- XvPortNotify イベントを有効あるいは無効にする .sp 1l .\"0 XvSelectVideoNotify(3X) \- enable or disable XvVideoNotify events XvSelectVideoNotify(3X) \- XvVideoNotify イベントを有効あるいは無効にする .sp 1l .\"0 XvSetPortAttribute(3X) \- set an attribute for a port XvSetPortAttribute(3X) \- ポートの属性を設定する .sp 1l .\"0 XvStopVideo(3X) \- stop active video XvStopVideo(3X) \- 再生中の動画を止める .sp 1l .\"0 XvUngrabPort(3X) \- release a grabbed port XvUngrabPort(3X) \- グラブしているポートを解放する .sp 1l .\"0 XvVideoNotify(3X) \- event generated for video processing XvVideoNotify(3X) \- 動画処理のために生成されるイベント .sp 1l .PP .\"0 Each of these functions is described in its own Xv man page. 以上の関数はそれぞれ、Xv のオンラインマニュアルで解説されている。 .br