OCIOCONVERT(1)

📦
version 2.5.1 · 4 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 OCIOCONVERT(1) 💖

okay bestie, gather round, because this is ocioconvert from the User Commands manual section, and it's literally the glow-up your images have been waiting for ✨

🌸 NAME 🌸

ocioconvert — apply colorspace transform to an image 💅

🦋 DESCRIPTION 🦋

ocioconvert — apply colorspace transform to an image. no cap, that's the whole vibe: you feed it a picture, you tell it what colorspace it's in, you tell it where it's going, and it comes out the other side looking correct 🎀

here's the usage, and I need you to look at it carefully because there are like three whole modes and they are NOT the same:

usage: ocioconvert [options]  inputimage inputcolorspace outputimage
outputcolorspace

       or: ocioconvert [options] --lut lutfile inputimage outputimage
       or: ocioconvert [options] --view inputimage inputcolorspace
       outputimage displayname viewname

so like, mode one: straight colorspace to colorspace conversion. mode two: you're going through a LUT instead. mode three: you're converting to a (display, view) pair instead of an output colorspace. pick your fighter 🫶

✨ OPTIONS ✨

  • --lut — convert using a LUT rather than a config file 🔥
  • --view — convert to a (display,view) pair rather than to an output color space 👀
  • --gpu — use GPU color processing instead of CPU. and yes, CPU is the default, so if you want the GPU you have to actually ask for it 💅
  • --gpulegacy — use the legacy (i.e. baked) GPU color processing instead of the CPU one. heads up: --gpu is ignored when you use this one 🙈
  • --gpuinfo — output the OCIO shader program 👑
  • --help — print help message 🎀
  • -v — display general information 🌈

🌟 OpenImageIO options: 🌟

  • --float-attribute %L — "name=float" pair defining OIIO float attribute for outputimage ✨
  • --int-attribute %L — "name=int" pair defining OIIO int attribute for outputimage ✨
  • --string-attribute %L — "name=string" pair defining OIIO string attribute for outputimage ✨
  • --croptofull — crop or pad to make pixel data region match the "full" region 🖼️
  • --ch %s — select channels (e.g., "2,3,4") 🎚️
ngl bestie, if you're reaching for --gpulegacy just know that --gpu is not gonna do anything for you there. they said what they said. 💀

and that's the whole page, fr fr 💜 this one's ocioconvert -- apply colorspac..., August 2023 edition — go forth and convert, you absolute main character 🧚‍♀️👑

📦 where this page comes from