.\" 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 Tue Oct 27 00:00:00 JST 1998
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Tue Oct  9 01:08:09 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" $XFree86: xc/doc/man/X11/XcmsSClr.man,v 1.2 2001/01/27 18:20:07 dawes 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 XcmsStoreColor 3X11 "Release 6.5" "X Version 11" "XLIB FUNCTIONS"
.SH 名前
.\"0 XcmsStoreColor, XcmsStoreColors \- set colors
XcmsStoreColor, XcmsStoreColors \- 色を設定する
.SH 書式
Status XcmsStoreColor\^(\^\fIdisplay\fP, \fIcolormap\fP\^, \fIcolor\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      Colormap \fIcolormap\fP\^;
.br
      XcmsColor *\fIcolor\fP\^;
.LP
Status XcmsStoreColors\^(\^\fIdisplay\fP, \fIcolormap\fP\^, \fIcolors\fP\^, \fIncolors\fP\^, \fIcompression_flags_return\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      Colormap \fIcolormap\fP\^;
.br
      XcmsColor \fIcolors\fP\^[\^]\^;
.br
      int \fIncolors\fP\^;
.br
      Bool \fIcompression_flags_return\fP\^[\^]\^;
.SH 引き数
.IP \fIdisplay\fP 1i
.\"0 Specifies the connection to the X server.
X サーバへの接続を指定する。
.IP \fIcolor\fP 1i
.\"0 Specifies the color cell and the color to store.
格納するカラーセルと色を指定する。
.\"0 Values specified in this
.\"0 .ZN XcmsColor
.\"0 structure remain unchanged on return.
この
.ZN XcmsColor
構造体で指定される値は、返される時にも変更されていない。
.IP \fIcolors\fP 1i
.\"0 Specifies the color specification array of
.\"0 .ZN XcmsColor
.\"0 structures, each specifying a color cell and the color to store in that
.\"0 cell.
表色である
.ZN XcmsColor
構造体の配列を指定。配列のそれぞれの要素は、カラーセルとそのセルに格納
される色を指定する。
.\"0 Values specified in the array remain unchanged upon return.
配列で指定した値は、返される時にも変更されない。
.IP \fIcolormap\fP 1i
.\"0 Specifies the colormap.
カラーマップを指定する。
.IP \fIcompression_flags_return\fP 1i
.\"0 Returns an array of Boolean values indicating compression status.
圧縮の状態を示す Boolean 値の配列が返される。
.\"0 If a non-NULL pointer is supplied,
.\"0 each element of the array is set to
.\"0 .ZN True
.\"0 if the corresponding color was compressed and
.\"0 .ZN False
.\"0 otherwise.
NULL でない値が与えられた場合、対応する色が圧縮されていれば配列の各要
素には
.ZN True
が設定され、そうでなければ
.ZN False
が設定される。
.\"0 Pass NULL if the compression status is not useful.
圧縮の状態が不要であれば、NULL を指定すること。
.IP \fIncolors\fP 1i
.\"0 Specifies the number of 
.\"0 .ZN XcmsColor
.\"0 structures in the color-specification array.
表色の配列内の
.ZN XcmsColor
構造体の数を指定する。
.SH 説明
.\"0 The
.\"0 .ZN XcmsStoreColor
.\"0 function converts the color specified in the
.\"0 .ZN XcmsColor
.\"0 structure into RGB values.
関数
.ZN XcmsStoreColor
は、
.ZN XcmsColor
構造体で指定された色を RGB 値に変換する。
.\"0 It then uses this RGB specification in an
.\"0 .ZN XColor
.\"0 structure, whose three flags 
.\"0 .Pn ( DoRed , 
.\"0 .ZN DoGreen ,
.\"0 and
.\"0 .ZN DoBlue )
.\"0 are set, in a call to
.\"0 .ZN XStoreColor
.\"0 to change the color cell specified by the pixel member of the
.\"0 .ZN XcmsColor
.\"0 structure.
その後、この関数は3つのフラグ
.Pn ( DoRed , 
.ZN DoGreen ,
.ZN DoBlue )
が設定されている
.ZN XColor
構造体の RGB 表色を用いて
.ZN XStoreColor
を呼び出し、
.ZN XcmsColor
構造体の pixel メンバで指定されたカラーセルを変更する。
.\"0 This pixel value must be a valid index for the specified colormap,
.\"0 and the color cell specified by the pixel value must be a read/write cell.
このピクセル値は指定したカラーマップに対する有効なインデックスでなけれ
ばならない。また、ピクセル値によって指定されるカラーセルは読み書き可能
なセルでなければならない。
.\"0 If the pixel value is not a valid index, a
.\"0 .ZN BadValue
.\"0 error results.
ピクセル値が有効なインデックスでない場合は、エラー
.ZN BadValue
となる。
.\"0 If the color cell is unallocated or is allocated read-only, a
.\"0 .ZN BadAccess
.\"0 error results.
カラーセルが割り当てられていないか、読み取り専用で割り当てられて
いる場合は、エラー
.ZN BadAccess
となる。
.\"0 If the colormap is an installed map for its screen, 
.\"0 the changes are visible immediately.
カラーマップがそのスクリーンにインストールされていれば、変更は即座に画
面表示に反映される。
.LP
.\"0 Note that 
.\"0 .ZN XStoreColor
.\"0 has no return value; therefore, an
.\"0 .ZN XcmsSuccess
.\"0 return value from this function indicates that the conversion 
.\"0 to RGB succeeded and the call to
.\"0 .ZN XStoreColor
.\"0 was made.
.ZN XStoreColor
は返り値を持たないことに注意せよ。したがって、この関数が返す
.ZN XcmsSuccess
は、RGB 値への変換が成功し、
.ZN XStoreColor
の呼び出した行われたことだけを示す。
.\"0 To obtain the actual color stored, use
.\"0 .ZN XcmsQueryColor .
実際に格納された色を取得するには、
.ZN XcmsQueryColor
を使用すること。
.\"0 Because of the screen's hardware limitations or gamut compression,
.\"0 the color stored in the colormap may not be identical
.\"0 to the color specified.
スクリーンのハードウェアの制限やガモット圧縮のため、カラーマップに格納
された色は指定した色と異なることがある。
.LP
.\"0 .ZN XcmsStoreColor
.\"0 can generate
.\"0 .ZN BadAccess ,
.\"0 .ZN BadColor ,
.\"0 and
.\"0 .ZN BadValue
.\"0 errors.
.ZN XcmsStoreColor
は、エラー
.ZN BadAccess ,
.ZN BadColor ,
.ZN BadValue
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XcmsStoreColors
.\"0 function converts the colors specified in the array of
.\"0 .ZN XcmsColor
.\"0 structures into RGB values and then uses these RGB specifications in
.\"0 .ZN XColor
.\"0 structures, whose three flags 
.\"0 .Pn ( DoRed , 
.\"0 .ZN DoGreen ,
.\"0 and
.\"0 .ZN DoBlue )
.\"0 are set, in a call to
.\"0 .ZN XStoreColors
.\"0 to change the color cells specified by the pixel member of the corresponding
.\"0 .ZN XcmsColor
.\"0 structure.
関数
.ZN XcmsStoreColors
は、
.ZN XcmsColor
構造体の配列で指定された色を RGB 値に変換する。
その後、この関数は3つのフラグ
.Pn ( DoRed , 
.ZN DoGreen ,
.ZN DoBlue )
が設定されている
.ZN XColor
構造体の RGB 表色を用いて
.ZN XStoreColors
を呼び出し、対応する
.ZN XcmsColor
構造体の pixel メンバで指定されたカラーセルを変更する。
.\"0 Each pixel value must be a valid index for the specified colormap,
.\"0 and the color cell specified by each pixel value must be a read/write cell.
このピクセル値は指定したカラーマップに対する有効なインデックスでなけれ
ばならない。また、ピクセル値によって指定されるカラーセルは読み書き可能
なセルでなければならない。
.\"0 If a pixel value is not a valid index, a
.\"0 .ZN BadValue
.\"0 error results.
ピクセル値が有効なインデックスでない場合は、エラー
.ZN BadValue
となる。
.\"0 If a color cell is unallocated or is allocated read-only, a
.\"0 .ZN BadAccess
.\"0 error results.
カラーセルが割り当てられていないか、読み取り専用で割り当てられている
場合は、エラー
.ZN BadAccess
となる。
.\"0 If more than one pixel is in error,
.\"0 the one that gets reported is arbitrary.
1つ以上のピクセルでエラーになった場合1つのピクセルに対してエラーが通知
されるが、どのピクセルになるかはわからない。
.\"0 If the colormap is an installed map for its screen, 
.\"0 the changes are visible immediately.
カラーマップがそのスクリーンにインストールされていれば、変更は即座に画
面表示に反映される。
.LP
.\"0 Note that 
.\"0 .ZN XStoreColors
.\"0 has no return value; therefore, an
.\"0 .ZN XcmsSuccess
.\"0 return value from this function indicates that conversions 
.\"0 to RGB succeeded and the call to
.\"0 .ZN XStoreColors
.\"0 was made.
.ZN XStoreColors
は返り値を持たないことに注意せよ。したがって、この関数が返す
.ZN XcmsSuccess
は、RGB 値への変換が成功し、
.ZN XStoreColors
の呼び出した行われたことだけを示す。
.\"0 To obtain the actual colors stored, use
.\"0 .ZN XcmsQueryColors .
実際に格納された色を取得するには、
.ZN XcmsQueryColors
を使用すること。
.\"0 Because of the screen's hardware limitations or gamut compression,
.\"0 the colors stored in the colormap may not be identical
.\"0 to the colors specified.
スクリーンのハードウェアの制限やガモット圧縮のため、カラーマップに格納
された色は指定した色と異なることがある。
.LP
.LP
.\"0 .ZN XcmsStoreColors
.\"0 can generate
.\"0 .ZN BadAccess ,
.\"0 .ZN BadColor ,
.\"0 and
.\"0 .ZN BadValue
.\"0 errors.
.ZN XcmsStoreColors
は、エラー
.ZN BadAccess ,
.ZN BadColor ,
.ZN BadValue
を起こすことがある。
.SH 返り値
.TP 1i
.ZN BadAccess
.\"0 A client attempted
.\"0 to free a color map entry that it did not already allocate.
割り当てられていないエントリーをクライアントが解放しようとした。
.TP 1i
.ZN BadAccess
.\"0 A client attempted
.\"0 to store into a read-only color map entry.
読み取り専用のカラーマップのエントリーにクライアントがセルを格納しよう
とした。
.TP 1i
.ZN BadColor
.\"0 A value for a Colormap argument does not name a defined Colormap.
引き数 Colormap  の値が、定義されている Colormap を指していない。
.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 関連項目
XcmsAllocColor(3X11),
XcmsQueryColor(3X11)
.br
\fI\*(xL\fP