pixuntile — break image up into separate files
pixuntile [-s squareinsize] [-w in_width] [-n in_height] [-S squareoutsize] [-W out_width] [-N out_height] [-o startframe] basename < file.pix
pixuntile [-s squareinsize] [-w in_width] [-n in_height] [-S squareoutsize] [-W out_width] [-N out_height] file1 file2... fileN < file.pix
pixuntile performs the inverse operation of pixtile(1). It takes a large image composed of a collection of small images and places each of them in a separate file. The input and output files are assumed to be in pix(5) format. By default, the input file is assumed to be 512x512 pixels in size.
The output files have a default width of 64 pixels
and are usually square, i.e. have the same height as width.
Specifying the
-S
flag changes the default size to
squareoutsize
pixels in width and height. (The -W and -N flags
are used for width and height, respectively. For the input file, these functions
are available through the -s, -w, and
-n flags.)
The files being produced as output will have names of the form
basename.num,
where
basename
is given on the command line, and
num
is a consecutive series of integers. By default the first image
is assumed to be number " 0 ", but an alternate
startframe
can be given by using the
-o startframe
flag and specifying the starting output frame number, where
startframe
is substituted for
num
in
basename.num.
Alternatively, if more than one basename (filename) argument is supplied on the command line, the names of the files are used as the output file names.
pixuntile -s 1024 -S 128 out < in.pix
will read the 1024x1024 file
in.pix
and place the 128x128 chunks of that file from
lower left to upper right in the files
out.0
through
out.63.