.\" 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 Mon Oct  8 22:57:56 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" $XFree86: xc/doc/man/X11/XSeLAttr.man,v 1.2 2001/01/27 18:20:04 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 XSetLineAttributes 3X11 "Release 6.5" "X Version 11" "XLIB FUNCTIONS"
.SH 名前
.\"0 XSetLineAttributes, XSetDashes \- GC convenience routines
XSetLineAttributes, XSetDashes \- GC 簡易関数
.SH 書式
XSetLineAttributes\^(\^\fIdisplay\fP, \fIgc\fP\^, \fIline_width\fP\^, \fIline_style\fP\^, \fIcap_style\fP\^, \fIjoin_style\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      GC \fIgc\fP\^;
.br
      unsigned int \fIline_width\fP\^;
.br
      int \fIline_style\fP\^;
.br
      int \fIcap_style\fP\^;
.br
      int \fIjoin_style\fP\^;
.LP
XSetDashes\^(\^\fIdisplay\fP, \fIgc\fP\^, \fIdash_offset\fP\^, \fIdash_list\fP\^, \fIn\fP\^)
.br
        Display *\fIdisplay\fP\^;
.br
        GC \fIgc\fP\^;
.br
        int \fIdash_offset\fP\^;
.br
        char \fIdash_list\fP[]\^;
.br
        int \fIn\fP\^;
.SH 引き数
.IP \fIcap_style\fP 1i
.\"0 Specifies the line-style and cap-style you want to set for the specified GC.
指定した GC に設定する線のスタイルと端点のスタイルを指定する。
.\"0 You can pass
.\"0 .ZN CapNotLast ,
.\"0 .ZN CapButt ,
.\"0 .ZN CapRound ,
.\"0 or
.\"0 .ZN CapProjecting .
.ZN CapNotLast ,
.ZN CapButt ,
.ZN CapRound ,
.ZN CapProjecting
のいずれかを指定する。
.IP \fIdash_list\fP 1i
.\"0 Specifies the dash-list for the dashed line-style
.\"0 you want to set for the specified GC. 
指定した GC に設定する点線のスタイルに対するダッシュ(点線の構成要素
である短い線)のリストを指定する。
.IP \fIdash_offset\fP 1i
.\"0 Specifies the phase of the pattern for the dashed line-style you want to set
.\"0 for the specified GC. 
指定した GC に設定する点線のスタイルのパターンの相を指定する。
.IP \fIdisplay\fP 1i
.\"0 Specifies the connection to the X server.
X サーバへの接続を指定する。
.IP \fIgc\fP 1i
.\"0 Specifies the GC.
GC を指定する。
.IP \fIjoin_style\fP 1i
.\"0 Specifies the line join-style you want to set for the specified GC.
指定した GC に設定する線の接続スタイルを指定する。
.\"0 You can pass
.\"0 .ZN JoinMiter ,
.\"0 .ZN JoinRound ,
.\"0 or
.\"0 .ZN JoinBevel .
.ZN JoinMiter ,
.ZN JoinRound ,
.ZN JoinBevel
のいずれかを指定する。
.IP \fIline_style\fP 1i
.\"0 Specifies the line-style you want to set for the specified GC.
指定した GC に設定する線のスタイルを指定する。
.\"0 You can pass
.\"0 .ZN LineSolid ,
.\"0 .ZN LineOnOffDash ,
.\"0 or
.\"0 .ZN LineDoubleDash .
.ZN LineSolid ,
.ZN LineOnOffDash ,
.ZN LineDoubleDash
のいずれかを指定する。
.IP \fIline_width\fP 1i
.\"0 Specifies the line-width you want to set for the specified GC.
指定した GC に設定する線の幅を指定する。
.IP \fIn\fP 1i
.\"0 Specifies the number of elements in dash_list. 
dash_list の要素数を指定する。
.SH 説明
.\"0 The
.\"0 .ZN XSetLineAttributes
.\"0 function sets the line drawing components in the specified GC.
関数
.ZN XSetLineAttributes
は指定した GC の線の描画のコンポーネントを設定する。
.LP
.\"0 .ZN XSetLineAttributes
.\"0 can generate
.\"0 .ZN BadAlloc ,
.\"0 .ZN BadGC ,
.\"0 and
.\"0 .ZN BadValue 
.\"0 errors.
.ZN XSetLineAttributes
はエラー
.ZN BadAlloc ,
.ZN BadGC ,
.ZN BadValue 
を起こすことがある。
.LP
.\"0 The
.\"0 .ZN XSetDashes
.\"0 function sets the dash-offset and dash-list attributes for dashed line styles
.\"0 in the specified GC.
関数
.ZN XSetDashes
は指定した GC の点線のスタイルの dash-offset 属性と dash-list 属性をセッ
トする。
.\"0 There must be at least one element in the specified dash_list,
.\"0 or a
.\"0 .ZN BadValue
.\"0 error results. 
指定した dash_list には最低1つの要素がなければならない。無い場合には
エラー
.ZN BadValue
となる。
.\"0 The initial and alternating elements (second, fourth, and so on) 
.\"0 of the dash_list are the even dashes, and
.\"0 the others are the odd dashes.
dash_list の最初の要素から交互の要素(2番目、4番目等)は偶数番目のダッシュ
であり、残りが奇数番目のダッシュである。
.\"0 Each element specifies a dash length in pixels.
.\"0 All of the elements must be nonzero,
.\"0 or a
.\"0 .ZN BadValue
.\"0 error results.
全ての要素は 0 であってはならず、そうでない場合はエラー
.ZN BadValue
となる。
.\"0 Specifying an odd-length list is equivalent to specifying the same list
.\"0 concatenated with itself to produce an even-length list.
奇数番目の長さのリストを指定することは、自分自身を繋げがる同じリストを
指定して偶数番目の長さのリストを作ることと等価である。
.LP
.\"0 The dash-offset defines the phase of the pattern,
.\"0 specifying how many pixels into the dash-list the pattern
.\"0 should actually begin in any single graphics request.
dash-offset はパターンの位相を定義する。
これは単独のグラフィックスリクエストで、dash-list 中のいくつのピクセル
でパターンを実際に始めるかを指定する。
.\"0 Dashing is continuous through path elements combined with a join-style
.\"0 but is reset to the dash-offset between each sequence of joined lines.
点線は join-style と繋がるまで軌跡上を続く。しかし、線を接続する場合に
は各シーケンス間で位相は dash-offset に再設定される。
.LP
.\"0 The unit of measure for dashes is the same for the ordinary coordinate system.
ダッシュの長さの単位は、通常の座標系と同じである。
.\"0 Ideally, a dash length is measured along the slope of the line, but implementations
.\"0 are only required to match this ideal for horizontal and vertical lines.
理想的にはダッシュの長さは線の勾配に沿って測るべきだが、実装に対して要
求されているのは水平な線と垂直な線の場合に理想的になっていることだけで
あ
る。
.\"0 Failing the ideal semantics, it is suggested that the length be measured along the
.\"0 major axis of the line.
理想的にできない場合のために、線の長軸に沿って長さを測る方法を示してお
く。
.\"0 The major axis is defined as the x axis for lines drawn at an angle of between
.\"0 \-45 and +45 degrees or between 135 and 225 degrees from the x axis.
x 軸となす各が\-45度から+45度、135度から225度である線に対しては、x 軸
が長軸であると定義される。
.\"0 For all other lines, the major axis is the y axis.
これ以外の場合には、長軸は y 軸である。
.LP
.\"0 .ZN XSetDashes
.\"0 can generate
.\"0 .ZN BadAlloc ,
.\"0 .ZN BadGC ,
.\"0 and
.\"0 .ZN BadValue 
.\"0 errors.
.ZN XSetDashes
はエラー
.ZN BadAlloc ,
.ZN BadGC ,
.ZN BadValue 
を起こすことがある。
.SH 返り値
.TP 1i
.ZN BadAlloc
.\"0 The server failed to allocate the requested resource or server memory.
要求されたリソースやサーバメモリの割り当てにサーバが失敗した。
.TP 1i
.ZN BadGC
.\"0 A value for a GContext argument does not name a defined GContext.
引き数 GContext の値が、定義されている GContext を指していない。
.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 関連項目
XCreateGC(3X11),
XQueryBestSize(3X11),
XSetArcMode(3X11),
XSetClipOrigin(3X11),
XSetFillStyle(3X11),
XSetFont(3X11),
XSetState(3X11),
XSetTile(3X11)
.br
\fI\*(xL\fP