<!-- manual page source format generated by PolyglotMan v3.2, --> <!-- available at http://polyglotman.sourceforge.net/ --> <html> <head> <title>IM_HISTPLOT(3) manual page</title> </head> <body bgcolor='white'> <a href='#toc'>Table of Contents</a><p> <h2><a name='sect0' href='#toc0'>Name</a></h2> im_histplot - graph an image of one horizontal or vertical line <h2><a name='sect1' href='#toc1'>Synopsis</a></h2> #include <vips/vips.h> <p> int im_histplot(in, out) <br> IMAGE *in, *out; <p> <h2><a name='sect2' href='#toc2'>Description</a></h2> <a href='im_histplot.3.html'><b>im_histplot(3)</a> </b> plots a graph of a horizontal or vertical image file with one line. It is suitable for displaying the output of histogram functions such as <a href='im_histgr.3.html'>im_histgr(3)</a> and for displaying line profiles. <p> Note that if you try to directly plot the result of <a href='im_histgr.3.html'><b>im_histgr(3)</b></a> you will often get a very, very large image, since <a href='im_histplot.3.html'><b>im_histplot(3)</a> </b> will draw an image as high (or as wide) as the largest pixel value in the image (potentially huge). Use <a href='im_histnorm.3.html'><b>im_histnorm(3)</b></a> to normalise the histogram maximum before plotting. <p> The input image should be either one horizontal line (Ysize=1) or one vertical line (Xsize=1). If the image is FMTUCHAR, the graph is drawn as 256 by line-length pixels. For all other unsigned integer types, <a href='im_histplot.3.html'><b>im_histplot(3)</b></a> finds the image maximum, and draws the graph as max by line-length pixels. <p> For signed integer types, <a href='im_histplot.3.html'><b>im_histplot(3)</b></a> finds minimum and maximum, moves min up to zero, and draws the graph as min + max by line-lenth pixels. <p> For float types, <a href='im_histplot.3.html'><b>im_histplot(3)</b></a> finds minimum and maximum, and scales the image range so as to make the graph square. <p> <h2><a name='sect3' href='#toc3'>Returned Value</a></h2> The function returns 0 on success and -1 on error. <h2><a name='sect4' href='#toc4'>See Also</a></h2> <a href='im_histgr.3.html'>im_histgr(3)</a> , <a href='im_histnorm.3.html'>im_histnorm(3)</a> , <a href='im_extract.3.html'>im_extract(3)</a> . <h2><a name='sect5' href='#toc5'>Copyright</a></h2> National Gallery and Birkbeck College, 1995 <p> <hr><p> <a name='toc'><b>Table of Contents</b></a><p> <ul> <li><a name='toc0' href='#sect0'>Name</a></li> <li><a name='toc1' href='#sect1'>Synopsis</a></li> <li><a name='toc2' href='#sect2'>Description</a></li> <li><a name='toc3' href='#sect3'>Returned Value</a></li> <li><a name='toc4' href='#sect4'>See Also</a></li> <li><a name='toc5' href='#sect5'>Copyright</a></li> </ul> </body> </html>