PIX-PS(1)

📦
version 7.44.0 · 2 versions
, in nixpkgs unstable

✨ pix-ps 💅 — convert a color pix file to PostScript ✨

Okay bestie, welcome to the pix-ps page, straight out of the BRL-CAD manual (section 1, iykyk). This is the glow-up where your raw pix pixels get a whole PostScript moment. 🎀

🌸 SYNOPSIS 🌸

pix-ps [-e] [-c|-l] [-L] [-s _input_squaresize_] [-w _input_width_] [-n _input_height_] [-S _inches_square_] [-W _inches_width_] [-N _inches_height_] [_input.pix_] > _output.ps_

🦋 DESCRIPTION 🦋

So here's the vibe: pix-ps reads a color pix(5) format image and writes a 24-bit color PostScript image out to standard output. Literally that's it, that's the whole personality. 💖

Your input can be named on the command line, or you can just pipe it in on standard input — dealer's choice, no judgement. 🫶

The -w and -n options set the input width and the number of scan lines, both measured in pixels. And -s? It sets both at once, because why text twice when you can text once. If you give no input size at all, it just assumes defaults of 512. Slay, sensible defaults. ✨

Now for the output side: by default you get a 6.75 inch square centered on an 8.5 x 11 inch page. The -S, -W, and -N options change the output size in inches, which is exactly analogous to how the input options work in pixels. Very "same energy, different units." 💅

The -l option drops the image in the lower-left corner instead of centering it, and -L gives you landscape orientation. And if you're making an Encapsulated PostScript file — sized in pixels rather than inches — that's the -e option, bestie. 🧚

🔥 OPTIONS 🔥

  • -e — Produce an Encapsulated PostScript (EPS) file. The bounding box gets sized in pixels, and the page placement options (-c, -l, -L) are ignored. Not like "oops ignored", like genuinely not consulted. 🙈
  • -c — Center the image on an 8.5 x 11 inch page. This is the default, so you're already doing it, icon behavior. 👑
  • -l — Place the image in the lower-left corner of the page rather than centering it. Corner gremlin mode. 🍓
  • -L — Landscape orientation; rotate the output image ninety degrees. Turn it, flip it, make it art. 🌀
  • -s input_squaresize — Set both the input width and height to input_squaresize pixels. Two for one. 💖
  • -w input_width — Set the input width to input_width pixels (default 512).
  • -n input_height — Set the number of input scan lines to input_height pixels (default 512).
  • -S inches_square — Set both the output width and height to inches_square inches.
  • -W inches_width — Set the output width to inches_width inches (default 6.75).
  • -N inches_height — Set the output height to inches_height inches (default 6.75).

🎀 EXAMPLES 🎀

Example 1. Center a default image on a page

pix-ps image.pix > image.ps

Produces a 6.75 inch PostScript image from a 512x512 input and centers it on an 8.5 x 11 inch page — ready to send straight to a PostScript printer. Zero drama, maximum icon. ⭐

Example 2. Render a region of geometry directly to PostScript

rt -s 1024 -o /dev/stdout share/db/moss.g all.g | pix-ps -w 1024 -n 1024 -L -S 7 > moss.ps

Ray traces the moss.g model at 1024x1024, pipes the resulting pix(5) data into pix-ps, and writes a 7 inch square landscape PostScript image. The pipeline is the moment, honestly. 🔥

Example 3. Generate an Encapsulated PostScript figure

pix-ps -e -w 800 -n 600 plot.pix > plot.eps

Creates an Encapsulated PostScript version of an 800x600 image, suitable for inclusion as a figure in a larger document. Figure-ified. 🌈

💜 SEE ALSO 💜

brlcad(1), bw-ps(1), rt(1), pix(5) — go read these too, they're all part of the fam. 🫶

🌸 AUTHOR 🌸

BRL-CAD Team — collectively the main characters here. 👑

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 — please actually tell them, don't just suffer in silence, ngl. 😭

Okay that's the whole page, bestie. No cap, every flag is in there. 💖

Laterz! This was pix-ps(1) from the BRL-CAD manual set — version tag PIX-PS(1), brought to you by the BRL-CAD crew. 🦋 Go convert something pretty. ✨

📦 where this page comes from