35 lines
1.0 KiB
Groff
35 lines
1.0 KiB
Groff
|
.TH IM_HISTORY 3 "22 April 1991"
|
||
|
|
.SH NAME
|
||
|
|
im_histlin, im_updatehist, im_history_get \- manage image history
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B #include <vips/vips.h>
|
||
|
|
|
||
|
|
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 );
|
||
|
|
|
||
|
|
.br
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.B im_histlin(3)
|
||
|
|
formats its arguments as printf(3), 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.
|
||
|
|
|
||
|
|
.B im_updatehist(3)
|
||
|
|
is given a standard argc/argv, formats them appropriately, and calls
|
||
|
|
im_histlin(3) for you. Note that the program name is passed separately.
|
||
|
|
|
||
|
|
.B im_history_get(3)
|
||
|
|
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.
|
||
|
|
|
||
|
|
.SH RETURN VALUE
|
||
|
|
The function returns 0 on success and -1 on error.
|
||
|
|
.SH SEE ALSO
|
||
|
|
im_cp_desc(3).
|
||
|
|
.SH COPYRIGHT
|
||
|
|
Imperial College, London, 2007.
|