OIIO_LOADER(1)

🌸 NAME 🌸

okay so bestie, welcome to OIIO_LOADER(1) 💖 this whole page is the manual for oiio_loader — yes, literally the manual page for oiio_loader version 1.39.5, no cap ✨

🎀 DESCRIPTION 🎀

so like. here's the thing. this command is giving "the script did not want to be a script today" 💀 let's start with what it actually prints, because the vibes are immaculate and chaotic:

/builddir/build/BUILD/materialx-1.39.5-build/BUILDROOT/usr/bin/oiio_loader: line 24: Sample MaterialX ImageLoader implementation using OpenImageIO package.

iconic. moving on 🫶

This module provides a MaterialX-compatible ImageLoader implementation using OpenImageIO (OIIO). The test will test loading an image, save it out, and optionally previewing it. (yes girl, the test tests. we love a self-aware queen 👑)

✨ Steps ✨

1. Create an OIIOLoader which is derived from the ImageLoader interface class. 🦋
2. Create a new ImageHandler and register the loader with it.
3. Request to acquire an image using the ImageHandler. An EXR image is requested.
4. OIIOLoader will return supported extensions and match the requested image format.
5. As such the OIIOLoader will be requested to load in the EXR image, convert the data and return a MaterialX Image. ✨
6. Try to acquire the image again. This should returnt the cached MaterialX Image. (yes, "returnt" — that's the original spelling and I am not touching it, that's a heritage typo 💅)
7. Save the image back to disk in the original format.

The image can optionally be previewed after load before save. 👀

💜 Python Dependencies 💜

• OpenImageIO (version 3.0.6.1) — the main character fr fr
• API Docs can be found here: https://openimageio.readthedocs.io/en/v3.0.6.1/) 📚 (yes the closing paren is part of it, we respect the URL's choices)
• numpy : For numerical operations on image data
• matplotlib : If image preview is desired.

💀 and then... the shell found out 💀

lowkey not me showing you the exact chaos that happens when this thing runs, but here it is, character for character, because accuracy is the vibe:

: File name too long
/builddir/build/BUILD/materialx-1.39.5-build/BUILDROOT/usr/bin/oiio_loader: line 25: import: command not found
/builddir/build/BUILD/materialx-1.39.5-build/BUILDROOT/usr/bin/oiio_loader: line 26: import: command not found
/builddir/build/BUILD/materialx-1.39.5-build/BUILDROOT/usr/bin/oiio_loader: line 27: import: command not found
/builddir/build/BUILD/materialx-1.39.5-build/BUILDROOT/usr/bin/oiio_loader: line 29: import: command not found
/builddir/build/BUILD/materialx-1.39.5-build/BUILDROOT/usr/bin/oiio_loader: line 30: syntax error near unexpected token `level=logging.INFO'
/builddir/build/BUILD/materialx-1.39.5-build/BUILDROOT/usr/bin/oiio_loader: line 30: `logging.basicConfig(level=logging.INFO)'

🫶 bestie note: those import and logging.basicConfig(...) lines are Python, and the shell is trying to read them as shell commands. The shell is not having it. That's the whole gag. The errors are real, the path is real, the line numbers are real — do not "fix" them, just be aware that's what comes out. 🙈

and that's the page, periodt 💅 this was oiio_loader version 1.39.5, dated June 2026, shipped under the OIIO_LOADER(1) manual name — slay, stay hydrated, and always quote your shell arguments 🎀✨🌈