im_csv(3)
NAME
im_csv2vips, im_vips2csv - read and write CSV (comma separated values)
files
SYNOPSIS
#include <vips/vips.h> int im_csv2vips( const char *filename, IMAGE *out ) int im_csv2vips_header( const char *filename, IMAGE *out ); int im_vips2csv( IMAGE *in, const char *filename )
DESCRIPTION
im_csv2vips(3) reads the CSV (comma separated values) data in filename,
and writes the image out in VIPS format. The output image is always 1
band (monochrome), IM_BANDFMT_DOUBLE.
The reader is deliberately rather fussy: it will fail if there are any
short lines, or if the file is too short. It will ignore lines that are
too long.
- Read options can be embedded in the filename. The options can be given
in any order and are:
- skip:lines-to-skip
- The number of lines to skip at the start of the file. Default zero.
whi:whitespace-characters- The skippable whitespace characters. Default <space> and double quotes ("). Whitespace characters are always run together.
sep:separator-characters- The characters that separate fields. Default ;,<tab>. Separators are never run together.
line:lines-to-read- The number of lines to read from the file. Default -1, meaning read to end of file.
- im_csv2vips_header(3) works exactly as im_csv2vips(3) but only sets the header of the output image. It is rather slow, since it has to read the whole input file.
- im_vips2csv(3) writes the VIPS image to the file as ascii text, one line of text per scanline. Complex numbers are written as "(real,imaginary)" and will need extra parsing I guess.
- Write options can be embedded in the filename. The options can be given in any order and are:
sep:separator-string- The string to use to separate numbers in the output. The default is "\t" (tab).
EXAMPLES
- im_csv2vips( "fred.csv:skip:58,sep:,line:3", out );
- Will read three lines starting at line 59, with space, comma and tab as the allowed separators. Note that the ',' has to be escaped with a backslash.
im_vips2csv fred.jpg fred.csv:sep:- Convert a jpeg to CSV, separating numbers with tab characters.
SEE ALSO
im_read_dmask(3), im_ppm2vips(3)
COPYRIGHT
- Hey, you want this? You have it!