.TH IMPORT PL "Ploticus data display engine"

.ig >>
<center>
<b>Ploticus data display engine</b> <small><a href="Copyright.html">Copyright Steve Grubb</a><br></small><br>
<a href="../doc/Welcome.html"><img src="../gallery/btn/welcome.gif"></a>
<a href="../gallery/index.html"><img src="../gallery/btn/gallery.gif"></a>
<a href="../doc/Contents.html"><img src="../gallery/btn/handbook.gif"></a>
<br><h1>Proc Import</h1>
</center>
.>>
 
.SH NAME
proc import


.SH DESCRIPTION
\fBproc import\fR reads a graphics file and integrates
it with the ploticus result.  
PNG files may be imported when running in -png mode.

.SH EXAMPLE
A Gallery example that imports a PNG file, and changes its size, is
.ig >>
<a href="../gallery/pngresize.htm">
.>>
pngresize 
.ig >>
</a>
.>>

.SH ATTRIBUTES

.LP
\fBfile\fR \fIname\fR
.IP
The name of the file to import.

.LP
\fBlocation\fR  
.ig >>
<a href="attributetypes.html#xy">
.>>
\fI x y \fR
.ig >>
</a>
.>>
.IP
Where the imported image should be placed.
May be in absolute or scaled units.



.LP
\fBscale\fR  \fIs\fR
.IP
Scale factor to apply when rendering the image.  \fC1.0\fR
results in the original size; smaller values reduce the size;
larger values increase the size.

.LP
\fBalign\fR  \fCcenter\fR | \fCtopleft\fR | \fCbottomleft\fR
.IP
Alignment of image relative to the specified \fClocation\fR.
\fCcenter\fR causes the image to be centered about the \fIx, y\fR
location; 
\fCtopleft\fR causes the image to be placed so that its top left is at \fIx, y\fR;
\fCbottomleft\fR causes the image to be placed so that its bottom left is at \fIx, y\fR.
