pixbustup basename width [image_offset] [first_number] < input.pixPIXBUSTUP(1)
NAME
pixbustup - break up concatenated pix images into separate files
On this page
SYNOPSIS
DESCRIPTION
pixbustup takes input consisting of a concatenated collection of pix(5) format files and breaks them up into separate files. The output file names will be 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 will be made number " 0 ", but an alternate first_number can be given. The images must be square and the width (and height) is given by width. The program keeps reading these small files until end of file is reached. If one does not wish to extract from the beginning of the input file, an image_offset can be given which will skip that number of images before beginning.
This program is mostly a holdover from the days when rt(1) wrote animations into one huge file, but it is still sometimes useful.
EXAMPLES
Example 1. Split an animation into per-frame files
pixbustup frame 512 < anim.pixBreak a concatenated stream of 512x512 pix(5) images in anim.pix into individual files frame.0, frame.1, frame.2, and so on, one per frame.
Example 2. Extract a numbered subset of frames
pixbustup frame 512 100 100 < anim.pixSkip the first 100 images in anim.pix, then write the remaining 512x512 frames starting at frame.100 so the output file names match the original frame numbering. The resulting files can be converted for viewing with pix-png(1).
SEE ALSO
brlcad(1), rt(1), pix-png(1), pix(5)
AUTHOR
BRL-CAD Team
COPYRIGHT
This software is Copyright (c) 1989-2026 by the United States Government as represented by U.S. Army Research Laboratory.
BUG REPORTS
Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org