<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/11/09 12:56:17. -->
<!-- Do not edit! -->
<STYLE TYPE="text/css">
<!--
A:link{text-decoration:none}
A:visited{text-decoration:none}
A:active{text-decoration:none}
OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }
H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>ploticus: proc line</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550><tr>
<td>
<table cellpadding=2 width=550><tr>
<td><br><h2>proc line</h2></td>
<td align=right>
<small>
<a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
Version 2.41 Mar2009
</small><br><a href="../doc/scripthome.html">Scripts</a>
<td></tr></table>
</td></tr>
<td>
<br>
<br>
<title>Manual page for proc_line(PL)</title>
</head>
<body>
<center>
<img src="../gallery/line0.gif">
</center>
<p>
<b>proc line</b> may be used to draw arbitrary lines in scaled space or absolute space.<tt> </tt>
It is typically used for annotations, etc.<tt> </tt>
To plot a line or curve from data, see
<a href="lineplot.html">
proc lineplot.<tt> </tt>
</a>
See also
<a href="drawcommands.html">
proc drawcommands.<tt> </tt>
</a>
<br><br><br>
<h2>Attributes</h2>
The <tt>points</tt> attribute <b>must</b> be specified.<tt> </tt>
<br><br>
<p>
<b>points</b>
<a href="attributetypes.html#text">
multiline-text
</a>
<dl>
<dt> <dd>
A list of points. One or more lines. Ends at first empty (blank) line.
Each line may have one coordinate pair or two. If <b>two</b>, the
first point is the beginning of a line, and the second point is the end
of a line. If <b>one</b>, the point is taken as a continuation of line
from previous point.<tt> </tt>
<br>
Example 1:
<pre>
points: 1.0 3.0 1.0 4.5
3.0 4.5
3.0 3.0
</pre>
Example 2:
With <tt>locval</tt> notation (the default), you can do things like this:
<pre>
points: min 0(s) max 0(s)
</pre>
<a href="attributetypes.html#locvalue">
More info on locval notation
</a>
<br><br>
</dl>
<p>
<b>notation</b>
<tt>absolute | scaled | locval</tt>
<dl>
<dt> <dd>
Specifies whether points are to be taken as locations in absolute
space, scaled space, or
<a href="attributetypes.html#locvalue">
location values.<tt> </tt>
</a>
Default is <tt>locval</tt>.<tt> </tt>
<br>
Example: <tt>notation: scaled</tt>
<br><br>
</dl>
<p>
<b>linedetails</b>
<a href="linedetails.html">
linedetails
</a>
<dl>
<dt> <dd>
Details controlling the rendering of the line.
<br>
Example: <tt>linedetails: width=3 color=green</tt>
<br><br>
</dl>
<p>
<b>anchor</b>
x y
<dl>
<dt> <dd>
If specified, the <tt>points</tt> still specifies how the lines are to be drawn, but
lines are drawn relative to <i>x, y</i>.
<i>x</i> and <i>y</i> should be in absolute space.<tt> </tt>
Does not work for values in scaled space, so <tt>notation</tt> should be <tt>absolute</tt>
or <tt>locval</tt> with no <tt>(s)</tt> values.<tt> </tt>
This can be used to specify elaborate sets of <tt>points</tt> once, then render the figure
multiple times in different locations. Versions 2.31+
<dt> <dd>
The following example draws a 1" square in two locations:
<pre>
#proc line
#saveas D1
anchor: 2 3
points: 0 0 0 1
1 1
1 0
0 0
#proc line
#clone D1
anchor: 4 4
</pre>
<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
<br>
<center>
<table><tr><td>
Ploticus is hosted at http://ploticus.sourceforge.net</td><td> </td><td>
<a href="http://sourceforge.net/projects/ploticus"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=38453&type=12"
width="120" height="30" border="0"
alt="Get ploticus data display engine at SourceForge.net. Fast, secure and Free Open Source software downloads" /></a>
</td></tr></table>
</center>
</dl>
<p><hr>
Markup created by <em>unroff</em> 1.0, <tt> </tt> <tt> </tt>March 11, 2009.
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
ed05dc5f357c49fdded780f52b150dce
>
files
>
53
