1 '\" te 2 .\" Copyright (C) 2003, Sun Microsystems, Inc. All Rights Reserved 3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. 4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. 5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] 6 .TH plot 4B "18 Feb 2003" "SunOS 5.11" "SunOS/BSD Compatibility Package File Formats" 7 .SH NAME 8 plot \- graphics interface 9 .SH DESCRIPTION 10 .sp 11 .LP 12 Files of this format are interpreted for various devices by commands described 13 in \fBplot\fR(1B). A graphics file is a stream of plotting instructions. Each 14 instruction consists of an \fBASCII\fR letter usually followed by bytes of 15 binary information. The instructions are executed in order. A point is 16 designated by four bytes representing the \fIx\fR and \fIy\fR values; each 17 value is a signed integer. The last designated point in an \fBl\fR, \fBm\fR, 18 \fBn\fR, or \fBp\fR instruction becomes the ``current point'' for the next 19 instruction. 20 .sp 21 .ne 2 22 .mk 23 .na 24 \fB\fBm\fR \fR 25 .ad 26 .RS 6n 27 .rt 28 Move: the next four bytes give a new current point. 29 .RE 30 31 .sp 32 .ne 2 33 .mk 34 .na 35 \fB\fBn\fR \fR 36 .ad 37 .RS 6n 38 .rt 39 Cont: draw a line from the current point to the point given by the next four 40 bytes. See \fBplot\fR(1B). 41 .RE 42 43 .sp 44 .ne 2 45 .mk 46 .na 47 \fB\fBp\fR \fR 48 .ad 49 .RS 6n 50 .rt 51 Point: plot the point given by the next four bytes. 52 .RE 53 54 .sp 55 .ne 2 56 .mk 57 .na 58 \fB\fBl\fR \fR 59 .ad 60 .RS 6n 61 .rt 62 Line: draw a line from the point given by the next four bytes to the point 63 given by the following four bytes. 64 .RE 65 66 .sp 67 .ne 2 68 .mk 69 .na 70 \fB\fBt\fR \fR 71 .ad 72 .RS 6n 73 .rt 74 Label: place the following \fBASCII\fR string so that its first character falls 75 on the current point. The string is terminated by a \fBNEWLINE.\fR 76 .RE 77 78 .sp 79 .ne 2 80 .mk 81 .na 82 \fB\fBa\fR \fR 83 .ad 84 .RS 6n 85 .rt 86 Arc: the first four bytes give the center, the next four give the starting 87 point, and the last four give the end point of a circular arc. The least 88 significant coordinate of the end point is used only to determine the quadrant. 89 The arc is drawn counter-clockwise. 90 .RE 91 92 .sp 93 .ne 2 94 .mk 95 .na 96 \fB\fBc\fR \fR 97 .ad 98 .RS 6n 99 .rt 100 Circle: the first four bytes give the center of the circle, the next two the 101 radius. 102 .RE 103 104 .sp 105 .ne 2 106 .mk 107 .na 108 \fB\fBe\fR \fR 109 .ad 110 .RS 6n 111 .rt 112 Erase: start another frame of output. 113 .RE 114 115 .sp 116 .ne 2 117 .mk 118 .na 119 \fB\fBf\fR \fR 120 .ad 121 .RS 6n 122 .rt 123 Linemod: take the following string, up to a \fBNEWLINE,\fR as the style for 124 drawing further lines. The styles are ``dotted,'' ``solid,'' ``longdashed,'' 125 ``shortdashed,'' and ``dotdashed.'' Effective only in \fBplot\fR \fB4014\fR and 126 \fBplot ver\fR. 127 .RE 128 129 .sp 130 .ne 2 131 .mk 132 .na 133 \fB\fBs\fR \fR 134 .ad 135 .RS 6n 136 .rt 137 Space: the next four bytes give the lower left corner of the plotting area; the 138 following four give the upper right corner. The plot will be magnified or 139 reduced to fit the device as closely as possible. 140 .sp 141 Space settings that exactly fill the plotting area with unity scaling appear 142 below for devices supported by the filters of \fBplot\fR(1B). The upper limit 143 is just outside the plotting area. 144 .RE 145 146 .sp 147 .LP 148 In every case the plotting area is taken to be square; points outside may be 149 displayable on devices whose face is not square. 150 .sp 151 .ne 2 152 .mk 153 .na 154 \fB\fB4014\fR \fR 155 .ad 156 .RS 14n 157 .rt 158 \fBspace(0,\fR \fB0,\fR \fB3120,\fR \fB3120);\fR 159 .RE 160 161 .sp 162 .ne 2 163 .mk 164 .na 165 \fB\fBver\fR \fR 166 .ad 167 .RS 14n 168 .rt 169 \fBspace(0,\fR \fB0,\fR \fB2048,\fR \fB2048);\fR 170 .RE 171 172 .sp 173 .ne 2 174 .mk 175 .na 176 \fB\fB300\fR,\fB 300s\fR \fR 177 .ad 178 .RS 14n 179 .rt 180 \fBspace(0,\fR \fB0,\fR \fB4096,\fR \fB4096);\fR 181 .RE 182 183 .sp 184 .ne 2 185 .mk 186 .na 187 \fB\fB450\fR \fR 188 .ad 189 .RS 14n 190 .rt 191 \fBspace(0,\fR \fB0,\fR \fB4096,\fR \fB4096);\fR 192 .RE 193 194 .SH SEE ALSO 195 .sp 196 .LP 197 \fBgraph\fR(1), \fBplot\fR(1B)