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)