.ig >>
<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 import</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 import</h2></td>
  <td align=right>
  <small>
  <a href="../doc/welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
  Version 2.33 Jun'06
     </small><br><a href="../doc/scripthome.html">Scripts</a>
  <td></tr></table>
</td></tr>
<td>
<br>
<br>
.>>

.TH proc_import PL "02-JUN-2006   PL ploticus.sourceforge.net"


.LP
\fBproc import\fR reads an image file and integrates it with the ploticus result.  
The only types of images that will work are PNG and JPEG.  
Further, the image type must be the same type as your resulting
image.  
If your ploticus build does not support PNG or JPEG, you cannot
use this feature.
.LP
A Gallery example that imports a PNG file, and changes its size, is
.ig >>
<a href="../gallery/pngresize.htm">
.>>
\0pngresize
.ig >>
</a>
.>>

.ig >>
<br><br><br>
.>>

.SH Attributes
The \fCfile\fR and \fClocation\fR attributes \fBmust\fR be supplied.

.ig >>
<br><br>
.>>

.LP
\fBfile\fR 
.ig >>
&nbsp; &nbsp;
.>>
\fIname\fR
.IP \0
The name of the file to import.

.ig >>
<br><br>
.>>

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

.ig >>
<br><br>
.>>

.LP
\fBscale\fR  
.ig >>
&nbsp; &nbsp;
.>>
\fIs\fR
.IP \0
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.

.ig >>
<br><br>
.>>

.LP
\fBalign\fR  
.ig >>
&nbsp; &nbsp;
.>>
\fCcenter | topleft | bottomleft\fR
.IP \0
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.

.ig >>
<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 &nbsp; <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif"> 
</center>
</td></tr>
</table>
<br>
<center>
Ploticus is hosted at http://ploticus.sourceforge.net <br>
<img src="http://sourceforge.net/sflogo.php?group_id=38453" width="88" height="31" border="0" alt="SourceForge Logo">
</center>
.>>
