1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
.\"##
.\" $XConsortium: p243,v 5.1 91/02/16 09:41:27 rws Exp $
.\"##
.\"##
$XMCOPY
.\"## Copyright (c) 1990, 1991 by Sun Microsystems, Inc.
.\"##
.\"## All Rights Reserved
.\"##
.\"## Permission to use, copy, modify, and distribute this software and its
.\"## documentation for any purpose and without fee is hereby granted,
.\"## provided that the above copyright notice appear in all copies and that
.\"## both that copyright notice and this permission notice appear in
.\"## supporting documentation, and that the name of Sun Microsystems,
.\"## not be used in advertising or publicity
.\"## pertaining to distribution of the software without specific, written
.\"## prior permission.
.\"##
.\"## SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
.\"## INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\"## EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\"## CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\"## USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\"## OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\"## PERFORMANCE OF THIS SOFTWARE.
.TH "POLYLINE" 3P "29 February 1991"
.SH NAME
POLYLINE \- create structure element specifying \s-2\&2D\s+2 polyline
.IX "Primitives, Line Primitives" "POLYLINE"
.IX "Line Primitives" "POLYLINE"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
ppolyline ( point_list )
Ppoint_list *point_list; \fIlist of points\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
The
\s-2POLYLINE\s+2
function places a structure element containing
the full specification of a \s-2\&2D\s+2 polyline into the currently open structure,
according to the current edit mode.
A \s-2\&2D\s+2 polyline primitive is a set of connected straight lines in two dimensions,
\fIx\fP and \fIy\fP.
The \fIz\fP coordinate is assumed to be 0. The polyline is defined
by a series of points in Modelling Coordinates (\s-2MC\s+2). A polyline may be closed
or self-intersecting.
.SS C Input Parameters
.IP \fIpoint_list\fP
A pointer to a Ppoint_list structure containing a list of Ppoint structures,
which contain the \fIx\fP and \fIy\fP coordinates for each point.
At least two points must be specified; a polyline structure element that has
fewer than two points will be treated in a workstation-dependent fashion.
.IP
The Ppoint_list structure is defined in phigs.h as follows:
.sp .4
.ta .5i +\w'Ppoint 'u +\w'num_points; 'u
.nf
typedef struct {
.sp .2
Pint num_points; /* number of Ppoints in the list */
Ppoint *points; /* list of points */
.sp .2
} Ppoint_list;
.sp .4
.fi
The \fInum_points\fR component specifies the number of elements in the list.
The \fIpoints\fR component is a pointer to a list of Ppoints \fInum_points\fR long.
The Ppoint structure is defined in phigs.h as follows:
.sp .4
.ta .5i +\w'Pfloat 'u +\w'x; 'u
.nf
typedef struct {
.sp .2
Pfloat x; /* x coordinate */
Pfloat y; /* y coordinate */
.sp .2
} Ppoint;
.fi
.SS Execution
.LP
If the current edit mode is \s-2INSERT\s+2, the \s-2POLYLINE\s+2 element
is inserted into the open structure after the element pointed to by the
element pointer. If the edit mode is \s-2REPLACE\s+2, the \s-2POLYLINE\s+2
element replaces the element pointed to by the element pointer. In either
case, the element pointer is updated to point to the new \s-2POLYLINE\s+2
element.
.LP
When the structure is traversed, the polyline element draws straight
lines between the points specified, beginning with the first point
and ending with the last. The current values of the attributes listed
below will be applied to the polyline when it is drawn.
.LP
The coordinates used to specify the polyline primitive are \s-2MC\s+2.
These may be any coordinate units that are convenient to the
application. At traversal, these coordinate values are transformed by
the current local and global modelling transformations,
the view representation selected by the \fIcurrent view index\fP,
and the workstation transformation current on the
workstation to which the structure is posted.
.SS Attributes Applied
The attributes listed below are used to display the
\s-2POLYLINE\s+2 primitive when the structure is traversed. The Aspect Source
Flags (\s-2ASF\s+2s) tell where to access the output display attributes.
These attributes can come directly from the traversal state list,
or they can be accessed indirectly, using the appropriate index
in the traversal state list and the corresponding bundled
representation in the PHIGS workstation state list.
.RS
.nf
.ta .5i +\w'back interior reflectance equation 'u
.sp
polyline colour polyline colour index \s-2ASF\s+2
linewidth scale factor linewidth scale factor \s-2ASF\s+2
linetype linetype \s-2ASF\s+2
polyline shading method polyline shading method \s-2ASF\s+2
polyline index
depth cue index
name set
.fi
.RE
.sp .2
.SH ERRORS
.IP 005
Ignoring function, function requires state (\s-2PHOP, *, STOP, *\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "INQUIRE POLYLINE FACILITIES (3P)"
.SM "POLYLINE 3 (3P)"
.SM "POLYLINE SET 3 WITH DATA (3P+)"
.fi
|
