<!-- manual page source format generated by PolyglotMan v3.2, --> <!-- available at http://polyglotman.sourceforge.net/ --> <html> <head> <title>IM_HISTORY(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_histlin, im_updatehist, im_history_get - manage image history <h2><a name='sect1' href='#toc1'>Synopsis</a></h2> <b>#include <vips/vips.h></b> <p> int im_histlin( IMAGE *im, const char *fmt, ... ); <br> int im_updatehist( IMAGE *out, const char *name, int argc, char *argv[] ); <br> const char *im_history_get( IMAGE *im ); <p> <br> <h2><a name='sect2' href='#toc2'>Description</a></h2> <a href='im_histlin.3.html'><b>im_histlin(3)</b></a> formats its arguments as <a href='printf.3.html'>printf(3)</a> , appends " # time-and-date", and appends the whole line of text to the image history. The string is typically the command-line action that would be required to do whatever it is that you’ve just done to the image. <p> <a href='im_updatehist.3.html'><b>im_updatehist(3)</b></a> is given a standard argc/argv, formats them appropriately, and calls <a href='im_histlin.3.html'>im_histlin(3)</a> for you. Note that the program name is passed separately. <p> <a href='im_history_get.3.html'><b>im_history_get(3)</b></a> returns the entire history of an image as a single C string, one action per line. No need to free, but you mustn’t modify either. <p> <h2><a name='sect3' href='#toc3'>Return 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_cp_desc.3.html'>im_cp_desc(3)</a> . <h2><a name='sect5' href='#toc5'>Copyright</a></h2> Imperial College, London, 2007. <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'>Return 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>