.\" 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 Wed Sep 30 22:40:41 JST 1998
.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Corrected by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\" Updated Mon Sep 24 23:12:41 JST 2001 for XFree86 4.1.0
.\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" $XFree86: xc/doc/man/X11/XDrLine.man,v 1.2 2001/01/27 18:19:58 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 XDrawLine 3X11 "Release 6.5" "X Version 11" "XLIB FUNCTIONS"
.SH 名前
.\"0 XDrawLine, XDrawLines, XDrawSegments, XSegment \- draw lines, polygons, and line structure
XDrawLine, XDrawLines, XDrawSegments, XSegment \- 線と多角形の描画、線を表す構造体
.SH 書式
XDrawLine\^(\^\fIdisplay\fP, \fId\fP\^, \fIgc\fP\^, \fIx1\fP\^, \fIy1\fP\^, \fIx2\fP\^, \fIy2\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      Drawable \fId\fP\^;
.br
      GC \fIgc\fP\^;
.br
      int \fIx1\fP\^, \fIy1\fP\^, \fIx2\fP\^, \fIy2\fP\^;
.LP
XDrawLines\^(\^\fIdisplay\fP, \fId\fP\^, \fIgc\fP\^, \fIpoints\fP\^, \fInpoints\fP\^, \fImode\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      Drawable \fId\fP\^;
.br
      GC \fIgc\fP\^;
.br
      XPoint *\fIpoints\fP\^;
.br
      int \fInpoints\fP\^;
.br
      int \fImode\fP\^; 
.LP
XDrawSegments\^(\^\fIdisplay\fP, \fId\fP\^, \fIgc\fP\^, \fIsegments\fP\^, \fInsegments\fP\^)
.br
      Display *\fIdisplay\fP\^;
.br
      Drawable \fId\fP\^;
.br
      GC \fIgc\fP\^;
.br
      XSegment *\fIsegments\fP\^;
.br
      int \fInsegments\fP\^;
.SH 引き数
.IP \fId\fP 1i
.\"0 Specifies the drawable. 
ドロウアブル(drawable)を指定。
.IP \fIdisplay\fP 1i
.\"0 Specifies the connection to the X server.
X サーバへの接続を指定。
.IP \fIgc\fP 1i
.\"0 Specifies the GC.
GC を指定。
.IP \fImode\fP 1i
.\"0 Specifies the coordinate mode. 
座標モードを指定。
.\"0 You can pass
.\"0 .ZN CoordModeOrigin
.\"0 or
.\"0 .ZN CoordModePrevious .
.ZN CoordModeOrigin
か
.ZN CoordModePrevious
のいずれかを指定する。
.IP \fInpoints\fP 1i
.\"0 Specifies the number of points in the array.
配列中の点の数を指定。
.IP \fInsegments\fP 1i
.\"0 Specifies the number of segments in the array.
配列中の線分の数を指定。
.IP \fIpoints\fP 1i
.\"0 Specifies an array of points.
点の配列を指定。
.IP \fIsegments\fP 1i
.\"0 Specifies an array of segments.
線分の配列を指定。
.IP \fIx1\fP 1i
.br
.ns
.IP \fIy1\fP 1i
.br
.ns
.IP \fIx2\fP 1i
.br
.ns
.IP \fIy2\fP 1i
.\"0 Specify the points (x1, y1) and (x2, y2) to be connected.
線で結ばれる点 (x1, y1) と (x2, y2) を指定。
.SH 説明
.\"0 The
.\"0 .ZN XDrawLine
.\"0 function uses the components of the specified GC to
.\"0 draw a line between the specified set of points (x1, y1) and (x2, y2).
関数
.ZN XDrawLine
は指定された GC のコンポーネントを使い、指定された点の組 (x1, y1) と 
(x2, y2) を結ぶ線を描画する。
.\"0 It does not perform joining at coincident endpoints.
この関数は一致する端点の接続は行わない。
.\"0 For any given line, 
.\"0 .ZN XDrawLine 
.\"0 does not draw a pixel more than once.
与えられた任意の線に対して、
.ZN XDrawLine 
は1度だけしか描画を行わない。
.\"0 If lines intersect, the intersecting pixels are drawn multiple times.  
線が交差した場合、交点のピクセルは複数回描画される。
.LP
.\"0 The
.\"0 .ZN XDrawLines
.\"0 function uses the components of the specified GC to draw 
.\"0 npoints\-1 lines between each pair of points (point[i], point[i+1]) 
.\"0 in the array of
.\"0 .ZN XPoint
.\"0 structures.
関数
.ZN XDrawLines
は、指定した GC のコンポーネントを使い、
.ZN XPoint
構造体の配列が示す点の組 (point[i], point[i+1]) を結ぶ npoints\-1 個の
線を描く。
.\"0 It draws the lines in the order listed in the array.
この関数は配列に入っている順に線を描画する。
.\"0 The lines join correctly at all intermediate points, and if the first and last
.\"0 points coincide, the first and last lines also join correctly.
中間の点全てにおいて線分は正しく接続され、最初の点と最後の点が一致して
いれば最初と最後の点も正しく接続される。
.\"0 For any given line, 
.\"0 .ZN XDrawLines
.\"0 does not draw a pixel more than once.
与えられた任意の線について、
.ZN XDrawLines
は1つのピクセルを2度以上描画しない。
.\"0 If thin (zero line-width) lines intersect, 
.\"0 the intersecting pixels are drawn multiple times.
細い(line-width が 0 の)線が交差している場合、交差している点は複数回
描画される。
.\"0 If wide lines intersect, the intersecting pixels are drawn only once, as though
.\"0 the entire 
.\"0 .ZN PolyLine 
.\"0 protocol request were a single, filled shape.
幅を持つ線が交差している場合は、交差しているピクセルは1度だけ描画される。
つまり、あたかも全体の
.ZN PolyLine 
プロトコルリクエストが単一の、塗りつぶしに対するものであるかのように処
理される。
.\"0 .ZN CoordModeOrigin
.\"0 treats all coordinates as relative to the origin,
.\"0 and
.\"0 .ZN CoordModePrevious
.\"0 treats all coordinates after the first as relative to the previous point.
.ZN CoordModeOrigin
の場合は全ての座標値は原点からの相対座標となり、
.ZN CoordModePrevious
の場合には、最初の点より後の座標は全て前の点からの相対座標となる。
.LP
.\"0 The
.\"0 .ZN XDrawSegments 
.\"0 function draws multiple, unconnected lines. 
.ZN XDrawSegments 
関数は複数の、接続されていない線を描画する。
.\"0 For each segment, 
.\"0 .ZN XDrawSegments 
.\"0 draws a
.\"0 line between (x1, y1) and (x2, y2).
各線分に対して、
.ZN XDrawSegments
は点 (x1, y1) と (x2, y2) を結ぶ線を描く。
.\"0 It draws the lines in the order listed in the array of
.\"0 .ZN XSegment
.\"0 structures and does not perform joining at coincident endpoints.
この関数は
.ZN XSegment
構造体の配列に入っている順に線を描画する。一致する端点の接続は行わない。
.\"0 For any given line, 
.\"0 .ZN XDrawSegments
.\"0 does not draw a pixel more than once.  
ある線について、
.ZN XDrawSegments
は1つのピクセルを1度しか描画しない。
.\"0 If lines intersect, the intersecting pixels are drawn multiple times.  
線が交差している場合は、交差しているピクセルは複数回描画される。
.LP
.\"0 All three functions use these GC components:
これら3つの関数が使う GC コンポーネントは以下である。
.\"0 function, plane-mask, line-width,
.\"0 line-style, cap-style, fill-style, subwindow-mode,
.\"0 clip-x-origin, clip-y-origin, and clip-mask.
function, plane-mask, line-width,
line-style, cap-style, fill-style, subwindow-mode,
clip-x-origin, clip-y-origin, clip-mask.
.\"0 The
.\"0 .ZN XDrawLines
.\"0 function also uses the join-style GC component.
関数
.ZN XDrawLines
は、GC の join-style コンポーネントも使用する。
.\"0 All three functions also use these GC mode-dependent components:
.\"0 foreground, background, tile, stipple, tile-stipple-x-origin, 
.\"0 tile-stipple-y-origin, dash-offset, and dash-list.
これら3つの関数は、以下の GC モード依存のコンポーネントも使用する。
foreground, background, tile, stipple, tile-stipple-x-origin, 
tile-stipple-y-origin, dash-offset, dash-list.
.LP
.\"0 .ZN XDrawLine ,
.\"0 .ZN XDrawLines ,
.\"0 and
.\"0 .ZN XDrawSegments
.\"0 can generate
.\"0 .ZN BadDrawable ,
.\"0 .ZN BadGC ,
.\"0 and
.\"0 .ZN BadMatch 
.\"0 errors.
.ZN XDrawLine ,
.ZN XDrawLines ,
.ZN XDrawSegments
はエラー
.ZN BadDrawable ,
.ZN BadGC ,
.ZN BadMatch 
を起こすことがある。
.\"0 .ZN XDrawLines
.\"0 can also generate a
.\"0 .ZN BadValue 
.\"0 error.
.ZN XDrawLines
はさらに
.ZN BadValue 
も起こすことがある。
.SH 構造体
.\"0 The
.\"0 .ZN XSegment
.\"0 structure contains:
.ZN XSegment
構造体の内容を示す。
.LP
.Ds 0
.TA .5i
.ta .5i
typedef struct {
	short x1, y1, x2, y2;
} XSegment;
.De
.LP
.\"0 All x and y members are signed integers.
全ての x, y メンバは符号付き整数である。
.\"0 The width and height members are 16-bit unsigned integers.
width, height メンバは16ビットの符号無し整数である。
.\"0 You should be careful not to generate coordinates and sizes
.\"0 out of the 16-bit ranges, because the protocol only has 16-bit fields
.\"0 for these values.
プロトコルではこれらの値は16ビットのフィールドしか持たないので、16ビッ
トの範囲を越える座標やサイズを生成しないよう注意しなければならない。
.SH 返り値
.TP 1i
.ZN BadDrawable
.\"0 A value for a Drawable argument does not name a defined Window or Pixmap.
引き数 Drawable の値が、定義されている Window や Pixmap を指していない。
.TP 1i
.ZN BadGC
.\"0 A value for a GContext argument does not name a defined GContext.
引き数 GContext の値が、定義されている GContext を指していない。
.TP 1i
.ZN BadMatch
.\"0 An
.\"0 .ZN InputOnly
.\"0 window is used as a Drawable.
.ZN InputOnly
のウィンドウがドロウアブルとして指定された。
.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.
引き数や引き数の組は正しい型・範囲を持っているが、そのリクエストが要求する
他の条件に適合できなかった。
.\"0 .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 関連項目
XDrawArc(3X11),
XDrawPoint(3X11),
XDrawRectangle(3X11)
.br
\fI\*(xL\fP