PIX-SPM(1)

📦 version 7.44.0, in nixpkgs unstable

💖 NAME 💖

pix-spm — convert a pix image into sphere map data. okay so this is the PIX-SPM(1) page from BRL-CAD, and it's literally the glow-up machine for turning a flat pix image into sphere-map data. no cap, bestie, it's giving "environment map main character energy" 🦋✨

🌸 SYNOPSIS 🌸

pix-spm file.pix size > file.spm

✨ DESCRIPTION ✨

pix-spm reads a pix(5) image and resamples it into a sphere map — an equal-area spherical sampling as produced and consumed by the libbn bn_spm routines. obsessed with the specificity, honestly 💅

The required file.pix argument names the input image, and the required size argument is the number of sample points around the equator used to build the map. it must be a positive integer — like, actually positive, bestie, no zero, no negatives, periodt. The map holds size/2 latitude bins.

The image is loaded as a size by size pixel source, and the resulting sphere map is written to standard output, so the output is normally redirected to a .spm file. it's giving "pipe it and forget it" energy 🫶

The companion tool spm-fb(1) displays the resulting sphere map on a framebuffer. iconic teamwork, fr fr 🌈

🎀 EXAMPLES 🎀

🌟 Example 1. Build a sphere map from an environment image and display it 🌟

pix-spm world.pix 512 > world.spm
spm-fb -s -S 512 512 world.spm

Convert a 512x512 pix(5) image into a 512-bin sphere map with pix-spm, then resample and display that map on a 512x512 framebuffer with spm-fb(1). This is the typical workflow for turning a flat environment image into spherical environment-map data. literally the whole pipeline, slay 💖

🦋 SEE ALSO 🦋

👑 AUTHOR 👑

BRL-CAD Team — kings, honestly 👑

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. do not be shy, bestie — if it's broken, tell the devs 💌

and that's the whole PIX-SPM(1) page from BRL-CAD — footer has BRL-CAD and PIX-SPM(1), no date listed, so that's the sign-off vibe. byeee 💅💖

📦 where this page comes from