<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/11/09 12:56:16. -->
<!-- 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 image</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 image</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_image(PL)</title>
</head>
<body>
<p>
<b>proc image</b> integrates an external PNG/GIF/JPG image file (containing a logo for example) into the ploticus result.
This proc was formerly called proc import, and the old name will continue to map to this proc.<tt> </tt>
<p>
<center><a href="../gallery/logoimages.htm"><img src="../gallery/logoimages.gif"></a></center>
<p>
<br><br>
<b>If you are producing PNG/GIF/JPG output</b>, the image is imported by ploticus and integrated into the output result as
it is generated. Ploticus does not convert image types... the import image type <b>must</b> be the same as your result image type
(ploticus does not check image file types of file name extensions to enforce this).<tt> </tt>
<br><br>
<b>If you are producing SVG</b>, ploticus simply adds an <image> tag to the svg output (which contains an xlink to the filename),
and the image will be loaded when the SVG is viewed. Presumably, images of any type (PNG/GIF/JPG) can be viewed this way.
The <tt>width</tt> and <tt>height</tt> of the image should be specified so that alignment can be executed correctly.
<br><br>
If you're producing other output formats, a gray placeholder box will be drawn to show the image placement location, but
the image will not be displayed.<tt> </tt>
<br><br>
<h2>Attributes</h2>
The <tt>file</tt> and <tt>location</tt> attributes <b>must</b> be supplied.
The <tt>width</tt> and <tt>height</tt> attributes should always be specified.<tt> </tt>
<br><br>
<p>
<b>file</b>
<i>pathname</i>
<dl>
<dt> <dd>
The pathname of the image to import.<tt> </tt>
With PNG/GIF/JPG this filename should be specified relative to the working directory that ploticus is running in.<tt> </tt>
With SVG, the image file will be loaded when the svg is viewed and should be relative to the .svg file.<tt> </tt>
<br><br>
</dl>
<p>
<b>location</b>
<a href="attributetypes.html#xy">
x y
</a>
<dl>
<dt> <dd>
Determines where the imported image should be placed (see also <tt>align</tt> below).<tt> </tt>
<br><br>
</dl>
<p>
<b>align</b>
<tt>topcenter | center | topleft | bottomleft</tt>
<dl>
<dt> <dd>
Alignment of image relative to <tt>location</tt>.<tt> </tt>
Default is <tt>topleft</tt>.<tt> </tt>
<dt><dd><p>
<tt>topleft</tt> positions the image with its top left at <i>x, y</i>;
<br>
<tt>topcenter</tt> positions the imported image with its top-center at <i>x, y</i>
<br>
<tt>center</tt> centers the image around <i>x, y</i> horizontally and vertically;
<br>
<tt>bottomleft</tt> positions the image with its bottom left at <i>x, y</i>.<tt> </tt>
<br><br>
</dl>
<p>
<b>width</b>
npixels
<br>
<b>height</b>
npixels
<dl>
<dt> <dd>
The imported image will be rendered at this width and height. These values are in PNG/GIF/JPG pixels, which
are 100 per inch. Best practice is to always specify
(but does not need to be specified when rendering PNG/GIF/JPG and clickmap is not being done).<tt> </tt>
<br><br>
</dl>
<p>
<b>scale</b>
<i>s</i>
<dl>
<dt> <dd>
Scale factor to apply when rendering the image.
<b>As of 2.40 this attribute is no longer supported</b>... use width and height (above) to control the size.<tt> </tt>
<br><br>
</dl>
<p>
<b>clickmapurl</b> <i>url</i>
<dl>
<dt> <dd>
If generating a
<a href="clickmap.html">
clickmap,
</a>
this specifies the url that users will go to when they click on the image.<tt> </tt>
<br><br>
</dl>
<p>
<b>clickmaplabel</b> <i>label</i>
<dl>
<dt><dd><p>
If generating a
<a href="clickmap.html">
client-side clickmap,
</a>
this specifies a mouseover text labels that the user will see when they hover their mouse over the image.<tt> </tt>
<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
>
47
