.\" .\" 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:37:34 JST 1999 .\" by FUJIWARA Teruyoshi .\" Updated Sun Oct 14 16:27:22 JST 2001 for XFree86 4.1.0 .\" by FUJIWARA Teruyoshi .\" .TH XvQueryEncodings 3X "Version 4.1.0" "XFree86" .\" $XFree86: xc/doc/man/Xv/XvQueryEncodings.man,v 1.6 2001/01/27 18:20:36 dawes Exp $ .\"0 .SH Name .SH 名前 .\"0 XvQueryEncodings \- return list of encodings for an adaptor XvQueryEncodings \- アダプタが対応しているエンコーディングのリストを返す .\" .\"0 .SH Syntax .SH 書式 .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; .\" .\"0 .SH Arguments .SH 引き数 .IP \fI*dpy\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 Specifies the port whose adaptor is to be queried for its .\"0 list of encodings. エンコーディングのリストを問い合わせるアダプタを持つポートを指定する。 .IP \fIp_num_encodings\fR 15 .\"0 A pointer to where the number of encodings supported .\"0 by the adaptor is written. アダプタがサポートしているエンコーディングの数へのポインタが書き込まれ る。 .IP \fIpp_encoding_info\fR 15 .\"0 A pointer to where the list of returned .\"0 encoding information is returned. 返されるエンコーディング情報のリストへのポインタが返される。 .\"0 XvEncodingInfo has the following structure: XvEncodingInfo は、以下の内容を持つ構造体である: .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 .\"0 Specifies the encoding-id of the encoding. The encoding-id is used to .\"0 identify an encoding when a port's encoding attribute is changed. エンコーディングの ID を指定する。エンコーディング ID は、ポートの エンコーディング属性が変化した時にエンコーディングを識別するために使わ れる。 .IP \fIname\fR 15 .\"0 A pointer to a formatted string that identifies the encoding. The string .\"0 has the format "\fItiming-signaltype\fR". For example "ntsc-composite". エンコーディングを識別するための整形された文字列へのポインタ。この文字 列は "\fIタイミング-シグナルの種類\fR" という形式である。例えば "ntsc-composite" などである。 .IP \fIwidth,height\fR 15 .\"0 The width and height, in pixels, of the decoded video image. デコードされるビデオイメージの幅と高さ(ピクセル単位)。 .IP \fIrate\fR 15 .\"0 The field rate of the decoded video. デコードされるビデオのフィールドレート。 .PP .\"0 The XvRational structure is used to specify a fractional number. XvRational 構造体は、分数を指定するために用いる。 .\"0 It has the following structure: これは以下のような構造体である: .EX typedef struct { int numerator; int denominator; } XvRational; .EE .\"0 The \fInumerator\fP and \fIdenominator\fP fields specify the .\"0 appropriate parts of a fractional number. \fInumerator\fP は分子を表し、\fIdenominator\fP は分母を表す。 .\" .\"0 .SH Description .SH 説明 .\"0 XvQueryEncodings(3X) returns encoding information about an adaptor. Each .\"0 encoding is described by the XvEncodingInfo structure described above. The .\"0 encodings are identified by an encoding-id, which can be used to set or get .\"0 the encoding attribute of a port. XvQueryEncodings(3X) はアダプタについてのエンコーディング情報を返す。 それぞれのエンコーディングは、前述の XvEncodingInfo 構造体によって記述 される。エンコーディングはエンコーディング ID によって識別される。この 値を使うとポートのエンコーディング属性の設定や取得を行うことができる。 .\"0 .SH Returned Values .SH 返り値 .IP [Success] 8 .\"0 Returned if XvQueryEncodings(3X) completed successfully. XvQueryEncodings(3X) が正常に終了した場合に返される。 .IP [XvBadExtension] 8 .\"0 Returned if the Xv extension is unavailable. Xv 機能拡張が使用できない場合に返される。 .IP [XvBadAlloc] 8 .\"0 Returned if XvQueryEncodings(3X) failed to allocate memory to process .\"0 the request. XvQueryEncodings(3X) がリクエストを処理するためのメモリの割り当てに失 敗した場合に返される。 .\"0 .SH Diagnostics .SH 診断 .IP [XvBadPort] 8 .\"0 Generated if the requested port does not exist. 要求されたポートが存在しない場合に生成される。 .\" .\"0 .SH See Also .SH 関連項目 .\" XvFreeEncodingInfo(3X) .br