PIXBUSTUP(1)

📦
version 7.44.0 · 2 versions
, in nixpkgs unstable

💅 PIXBUSTUP 💅

ok so real talk, this is a BRL-CAD page and it's honestly such a useful little gremlin 🦋 like, it splits your giant blob of pix images into separate files and it does it flawlessly. periodt.

✨ NAME ✨

pixbustup — break up concatenated pix images into separate files 🎀

🌸 SYNOPSIS 🌸

pixbustup basename width [image_offset] [first_number] < input.pix

💖 DESCRIPTION 💖

okay so bestie, here's the vibe: pixbustup takes input that's literally just a concatenated collection of pix(5) format files all smooshed together, and breaks them up into separate files. so iconic of it. 👑

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 if you want to start counting somewhere else. iykyk 💅

the images must be square, and the width (and height) is given by width. like, that's not optional, it's a square situation only. 🔲

the program keeps reading these small files until end of file is reached. no cap, it just goes until there's nothing left. 🙈

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. super handy for like, skipping the boring part. ✨

ngl this program is mostly a holdover from the days when rt(1) wrote animations into one huge file, but it is still sometimes useful. lowkey a legacy icon but still ate. 🫶

🎀 EXAMPLES 🎀

Example 1. Split an animation into per-frame files

pixbustup frame 512 < anim.pix

break 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. literally one file per frame, so clean. ⭐

Example 2. Extract a numbered subset of frames

pixbustup frame 512 100 100 < anim.pix

skip 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. chef's kiss, the numbers line up 🧚 the resulting files can be converted for viewing with pix-png(1). 🔥

🌈 SEE ALSO 🌈

💜 AUTHOR 💜

BRL-CAD Team 👑

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 📧 don't be shy, they wanna hear it fr fr.

💀 reminder bestie: the images must be square. do not come crying to me when your non-square images act up. 💀

ok that's the whole page, tysm for coming to my ted talk 🎀 this was BRL-CAD, and the page is PIXBUSTUP(1) — mwah, go bust up some pix files, ily, bye! 💖✨

📦 where this page comes from