.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium
.\"
.\" 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,
.\" distribute, sublicense, and/or sell copies of the Software, and to
.\" permit persons to whom the Software is furnished to do so, subject to
.\" the following 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
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE X CONSORTIUM 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 Consortium 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 Consortium.
.\"
.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991 by
.\" Digital Equipment Corporation
.\"
.\" Portions Copyright \(co 1990, 1991 by
.\" Tektronix, Inc.
.\"
.\" Permission to use, copy, modify and distribute this documentation for
.\" any purpose and without fee is hereby granted, provided that the above
.\" copyright notice appears in all copies and that both that copyright notice
.\" and this permission notice appear in all copies, and that the names of
.\" Digital and Tektronix not be used in in advertising or publicity pertaining
.\" to this documentation without specific, written prior permission.
.\" Digital and Tektronix makes no representations about the suitability
.\" of this documentation for any purpose.
.\" It is provided ``as is'' without express or implied warranty.
.\" 
.\" Copyright (c) 1998, 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 Thu Oct 1 22:45:37 JST 1998
.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Corrected by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated Sun Sep 23 18:38:17 JST 2001 for XFree86 4.1.0
.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" WORD: 2-byte matrix fonts	2バイト行列形式のインデックスを持つフォント
.\"
.\" $XFree86: xc/doc/man/X11/XCreFCur.man,v 1.3 2001/02/07 22:35:20 tsi Exp $
.\"
.ds xT X Toolkit Intrinsics \- C Language Interface
.ds xW Athena X Widgets \- C Language X Toolkit Interface
.ds xL Xlib \- C Language X Interface
.ds xC Inter-Client Communication Conventions Manual
.na
.de Ds
.nf
.\\$1D \\$2 \\$1
.ft 1
.\".ps \\n(PS
.\".if \\n(VS>=40 .vs \\n(VSu
.\".if \\n(VS<=39 .vs \\n(VSp
..
.de De
.ce 0
.if \\n(BD .DF
.nr BD 0
.in \\n(OIu
.if \\n(TM .ls 2
.sp \\n(DDu
.fi
..
.de FD
.LP
.KS
.TA .5i 3i
.ta .5i 3i
.nf
..
.de FN
.fi
.KE
.LP
..
.de IN		\" send an index entry to the stderr
..
.de C{
.KS
.nf
.D
.\"
.\"	choose appropriate monospace font
.\"	the imagen conditional, 480,
.\"	may be changed to L if LB is too
.\"	heavy for your eyes...
.\"
.ie "\\*(.T"480" .ft L
.el .ie "\\*(.T"300" .ft L
.el .ie "\\*(.T"202" .ft PO
.el .ie "\\*(.T"aps" .ft CW
.el .ft R
.ps \\n(PS
.ie \\n(VS>40 .vs \\n(VSu
.el .vs \\n(VSp
..
.de C}
.DE
.R
..
.de Pn
.ie t \\$1\fB\^\\$2\^\fR\\$3
.el \\$1\fI\^\\$2\^\fP\\$3
..
.de ZN
.ie t \fB\^\\$1\^\fR\\$2
.el \fI\^\\$1\^\fP\\$2
..
.de hN
.ie t <\fB\\$1\fR>\\$2
.el <\fI\\$1\fP>\\$2
..
.de NT
.ne 7
.ds NO Note
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
.ie n .sp
.el .sp 10p
.TB
.ce
\\*(NO
.ie n .sp
.el .sp 5p
.if '\\$1'C' .ce 99
.if '\\$2'C' .ce 99
.in +5n
.ll -5n
.R
..
.		\" Note End -- doug kraft 3/85
.de NE
.ce 0
.in -5n
.ll +5n
.ie n .sp
.el .sp 10p
..
.ny0
.TH XCreateFontCursor 3X11 "Release 6.5" "X Version 11" "XLIB FUNCTIONS"
.SH 名前
.\"0 XCreateFontCursor, XCreatePixmapCursor, XCreateGlyphCursor \- create cursors
XCreateFontCursor, XCreatePixmapCursor, XCreateGlyphCursor \- カーソルの生成
.SH 書式
\&#include <X11/cursorfont.h>
.sp 6p
Cursor XCreateFontCursor\^(\^\fIdisplay\fP, \fIshape\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      unsigned int \fIshape\fP\^;
.LP
Cursor XCreatePixmapCursor\^(\^\fIdisplay\fP, \fIsource\fP\^, \fImask\fP\^, \fIforeground_color\fP\^, \fIbackground_color\fP\^, \fIx\fP\^, \fIy\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      Pixmap \fIsource\fP\^;
.br
      Pixmap \fImask\fP\^;
.br
      XColor *\fIforeground_color\fP\^;
.br
      XColor *\fIbackground_color\fP\^;
.br
      unsigned int \fIx\fP\^, \fIy\fP\^;
.LP
Cursor XCreateGlyphCursor\^(\^\fIdisplay\fP, \fIsource_font\fP\^, \fImask_font\fP\^, \fIsource_char\fP\^, \fImask_char\fP\^,
.br
                           \fIforeground_color\fP\^, \fIbackground_color\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      Font \fIsource_font\fP\^, \fImask_font\fP\^;
.br
      unsigned int \fIsource_char\fP\^, \fImask_char\fP\^;
.br
      XColor *\fIforeground_color\fP\^;
.br
      XColor *\fIbackground_color\fP\^;
.SH 引き数
.IP \fIbackground_color\fP 1i
.\"0 Specifies the RGB values for the background of the source.
ソースの背景色に対する RGB 値を指定。
.IP \fIdisplay\fP 1i
.\"0 Specifies the connection to the X server.
X サーバへの接続を指定。
.IP \fIforeground_color\fP 1i
.\"0 Specifies the RGB values for the foreground of the source. 
ソースの前景色に対する RGB 値を指定。
.IP \fImask\fP 1i
.\"0 Specifies the cursor's source bits to be displayed or
.\"0 .ZN None .
カーソルのソースのうち表示されるビット、あるいは
.ZN None
を指定。
.IP \fImask_char\fP 1i
.\"0 Specifies the glyph character for the mask. 
マスクのためのグリフ文字を指定。
.IP \fImask_font\fP 1i
.\"0 Specifies the font for the mask glyph or
.\"0 .ZN None .
マスクのグリフのためのフォントか
.ZN None
を指定。
.IP \fIshape\fP 1i
.\"0 Specifies the shape of the cursor.
カーソルの形状を指定。
.IP \fIsource\fP 1i
.\"0 Specifies the shape of the source cursor.
ソースカーソルの形状を指定。
.\"0 *** JIM: NEED TO CHECK THIS. ***
.IP \fIsource_char\fP 1i
.\"0 Specifies the character glyph for the source.
ソースに対する文字グリフを指定。
.IP \fIsource_font\fP 1i
so-Specifies the font for the source glyph.
ソースグリフのためのフォントを指定。
.\"0 .ds Xy , which indicate the hotspot relative to the source's origin
.ds Xy これはソースの原点からの相対座標でホットスポット(hotspot)を示す。
.IP \fIx\fP 1i
.br
.ns
.IP \fIy\fP 1i
.\"0 Specify the x and y coordinates\*(Xy.
x, y 座標を指定する。\*(Xy
.SH 説明
.\"0 X provides a set of standard cursor shapes in a special font named
.\"0 cursor.
X は標準的なカーソル形状のセットを特殊なフォントとして提供している。
これはカーソルと呼ばれている。
.\"0 Applications are encouraged to use this interface for their cursors
.\"0 because the font can be customized for the individual display type.
アプリケーションはインタフェースを使ってカーソルを用いるとよい。
なぜなら、フォントは個々のディスプレイの種類に応じてカスタマイズするこ
とができるからである。
.\"0 The shape argument specifies which glyph of the standard fonts
.\"0 to use.
引き数 shape では標準フォントのどのグリフを使うのかを指定する。
.LP
.\"0 The hotspot comes from the information stored in the cursor font.
ホットスポットはカーソルフォントに格納されている情報から得られる。
.\"0 The initial colors of a cursor are a black foreground and a white
.\"0 background (see
.\"0 .ZN XRecolorCursor ).
カーソルの初期状態の色は、前景色が黒で背景色が白である(
.ZN XRecolorCursor
を参照)。
.LP
.\"0 .ZN XCreateFontCursor
.\"0 can generate
.\"0 .ZN BadAlloc
.\"0 and
.\"0 .ZN BadValue 
.\"0 errors.
.ZN XCreateFontCursor
はエラー
.ZN BadAlloc ,
.ZN BadValue
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XCreatePixmapCursor
.\"0 function creates a cursor and returns the cursor ID associated with it.
関数
.ZN XCreatePixmapCursor
はカーソルを生成し、これに対応するカーソルIDを返す。
.\"0 The foreground and background RGB values must be specified using
.\"0 foreground_color and background_color,
.\"0 even if the X server only has a
.\"0 .ZN StaticGray
.\"0 or
.\"0 .ZN GrayScale
.\"0 screen.
X サーバが
.ZN StaticGray
や
.ZN GrayScale
のスクリーンしか持っていない場合であっても、前景色と背景色の RGB 値は
foreground_color と background_color を使って指定しなければならない。
.\"0 The foreground color is used for the pixels set to 1 in the
.\"0 source, and the background color is used for the pixels set to 0.
ソースピックスマップ内で1にセットされているピクセルに対しては前景色が
使用され、0にセットされているピクセルに対しては背景色が使用される。
.\"0 Both source and mask, if specified, must have depth one (or a 
.\"0 .ZN BadMatch
.\"0 error results) but can have any root.
指定する場合には、ソースとマスクの両者は深さ(depth)が1でなければならな
い(さもなくば
.ZN BadMatch
エラーとなる)が、ルートウィンドウは任意のものでよい。
.\"0 The mask argument defines the shape of the cursor.
引き数 mask はカーソルの形状を定義する。
.\"0 The pixels set to 1 in the mask define which source pixels are displayed,
.\"0 and the pixels set to 0 define which pixels are ignored.
マスク内で1にセットされているピクセルは、ソースのどのピクセルが表示さ
れるかを定義し、0にセットされているピクセルは無視されるピクセルを定義
する。
.\"0 If no mask is given, 
.\"0 all pixels of the source are displayed.
マスクが与えられない場合は、ソースの全てのピクセルが表示される。
.\"0 The mask, if present, must be the same size as the pixmap defined by the 
.\"0 source argument, or a
.\"0 .ZN BadMatch
.\"0 error results.
もしマスクを与えるならば、マスクは引き数 source で定義されるピックスマッ
プと同じ大きさでなければならず、そうでない場合にはエラー
.ZN BadMatch
となる。
.\"0 The hotspot must be a point within the source,
.\"0 or a
.\"0 .ZN BadMatch
.\"0 error results.
ホットスポットはソースの内部の点でなければならず、そうでない場合にはエ
ラー
.ZN BadMatch
となる。
.LP
.\"0 The components of the cursor can be transformed arbitrarily to meet
.\"0 display limitations.
ディスプレイの制限を満たすため、カーソルの構成要素に対して任意の変換が
行われるかもしれない。
.\"0 The pixmaps can be freed immediately if no further explicit references
.\"0 to them are to be made.
ピックスマップは明示的な参照がそれ以上されないことが分かった時点で、す
ぐに解放してよい。
.\"0 Subsequent drawing in the source or mask pixmap has an undefined effect on the
.\"0 cursor.
その後にソースやマスクのピックスマップへの描画を行った場合のカーソルへ
の影響は未定義である。
.\"0 The X server might or might not make a copy of the pixmap.
X サーバはピックスマップのコピーを作るかもしれないし、作らないかもしれ
ない。
.LP
.\"0 .ZN XCreatePixmapCursor
.\"0 can generate
.\"0 .ZN BadAlloc
.\"0 and
.\"0 .ZN BadPixmap 
.\"0 errors.
.ZN XCreatePixmapCursor
はエラー
.ZN BadAlloc ,
.ZN BadPixmap
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XCreateGlyphCursor
.\"0 function is similar to
.\"0 .ZN XCreatePixmapCursor
.\"0 except that the source and mask bitmaps are obtained from the specified 
.\"0 font glyphs.
関数
.ZN XCreateGlyphCursor
はソースとマスクのビットマップを指定したフォントグリフから得る点を除き、
.ZN XCreatePixmapCursor
と同様の関数である。
.\"0 The source_char must be a defined glyph in source_font, 
.\"0 or a
.\"0 .ZN BadValue
.\"0 error results.
source_char は source_font で定義されているグリフでなければならず、そ
うでなければエラー
.ZN BadValue
となる。
.\"0 If mask_font is given, 
.\"0 mask_char must be a defined glyph in mask_font,
.\"0 or a
.\"0 .ZN BadValue
.\"0 error results.
mask_font を与える場合は、mask_char は mask_font で定義されているグリ
フでなければならず、そうでなければエラー
.ZN BadValue
となる。
.\"0 The mask_font and character are optional.
mask_font と mask_char は指定しなくてもかまわない。
.\"0 The origins of the source_char and mask_char (if defined) glyphs are
.\"0 positioned coincidently and define the hotspot. 
source_char と(もし定義されているならば)mask_char のグリフの原点は、一
致するよう配置され、ホットスポットを定義する。
.\"0 The source_char and mask_char need not have the same bounding box metrics, 
.\"0 and there is no restriction on the placement of the hotspot relative to the bounding
.\"0 boxes. 
source_char と mask_char とでバウンディングボックスの寸法が同じである
必要は無く、バウンディングボックスに対してのホットスポットの配置の制限
は無い。
.\"0 If no mask_char is given, all pixels of the source are displayed.
mask_char が与えられない場合、ソースの全てのピックスマップが表示される。
.\"0 You can free the fonts immediately by calling
.\"0 .ZN XFreeFont
.\"0 if no further explicit references to them are to be made. 
フォントは明示的な参照がそれ以上されないことが分かった時点で、すぐに
.ZN XFreeFont
を呼び出して解放してよい。
.LP
.\"0 For 2-byte matrix fonts, 
.\"0 the 16-bit value should be formed with the byte1
.\"0 member in the most significant byte and the byte2 member in the 
.\"0 least significant byte.
2バイト行列形式のインデックスを持つフォントについては、16ビットの値は 
byte1 メンバが最上位バイトで byte2 が最下位ビットとなるようにしなけれ
ばならない。
.LP
.\"0 .ZN XCreateGlyphCursor
.\"0 can generate
.\"0 .ZN BadAlloc ,
.\"0 .ZN BadFont ,
.\"0 and
.\"0 .ZN BadValue 
.\"0 errors.
.ZN XCreateGlyphCursor
はエラー
.ZN BadAlloc ,
.ZN BadFont ,
.ZN BadValue 
を起こすことがある。
.SH 返り値
.TP 1i
.ZN BadAlloc
.\"0 The server failed to allocate the requested resource or server memory.
要求されたリソースやサーバメモリの割り当てにサーバが失敗した。
.TP 1i
.ZN BadFont
.\"0 A value for a Font or GContext argument does not name a defined Font.
引き数 Font や GC に対する値が定義された Font ではない。
.TP 1i
.ZN BadMatch
.\"0 Some argument or pair of arguments has the correct type and range but fails
.\"0 to match in some other way required by the request.
引き数や引き数の組は正しい型・範囲を持っているが、そのリクエストが要求する
他の条件に適合できなかった。
.TP 1i
.ZN BadPixmap
.\"0 A value for a Pixmap argument does not name a defined Pixmap.
引き数 Pixmap に対する値が定義されている Pixmap ではない。
.TP 1i
.ZN BadValue
.\"0 Some numeric value falls outside the range of values accepted by the request.
.\"0 Unless a specific range is specified for an argument, the full range defined
.\"0 by the argument's type is accepted.  Any argument defined as a set of
.\"0 alternatives can generate this error.
指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対
して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範
囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが
ある。
.SH 関連項目
XDefineCursor(3X11),
XLoadFont(3X11),
XRecolorCursor(3X11)
.br
\fI\*(xL\fP