READ(1)

🌸 READ(1) — the read page, User Commands edition 🌸

okay bestie, welcome to read(1), the manual page for the chartread command 💅 this whole page is filed under User Commands, so you already know it's giving main character energy in your terminal.

🎀 NAME 🎀

Read — Read Target Test Chart. that's it, that's the name, and honestly? iconic. ✨

💖 DESCRIPTION 💖

Read Target Test Chart 🌈

yes bestie, that's genuinely the entire description. short. sweet. mysterious. it's giving "no notes". 🦋

✨ SYNOPSIS ✨

chartread [-options] outfile

so the whole vibe is: you run chartread, you hand it some options if you're feeling spicy, and you give it an outfile. periodt. 👑

🌟 OPTIONS 🌟

okay so here's the full menu, no skips, no cuts, every single one fr fr 🍓

• -v — Verbose mode. she talks more. we love a chatty queen 💬
• -c listno — Set the communication port from the following list. default is 1. and the list is... this:
  • ** No ports found **

💀 not a single port detected, bestie. that's literally what it prints. the list is empty, i don't make the rules.

• -t — Use transmission measurement mode. light goes through, slay ✨
• -d — Use display measurement mode, and the results are white Y relative. 🖥️
• -e — Emissive for transparency on a light box. 🪟
• -p — Measure patch by patch rather than strip. one at a time, she's thorough 🎯
• -x [lx] — Take external values, either L*a*b* (-xl) or XYZ (-xx). 🌈
• -n — Don't save spectral information. (heads up: the default does save spectral, so this is you actively opting out 🙈)
• -l — Save CIE as D50 L*a*b* rather than XYZ. 💛
• -L — Save CIE as D50 L*a*b* as well as XYZ. both. she said why not 💅
• -r — Resume reading a partly read chart. picking up where you left off, we love a comeback arc 🫶
• -I file.cal — Override calibration info from .ti2 in the resulting .ti3. 📁
• -F filter — Set filter configuration (if aplicable):
  • n — None
  • p — Polarising filter
  • 6 — D65
  • u — U.V. Cut
• -N — Disable initial calibration of the instrument, if possible. 🚫
• -B — Disable auto bi-directional strip recognition. 🔄🚫
• -H — Use high resolution spectrum mode, if available. 🔬✨
• -X file.ccmx — Apply Colorimeter Correction Matrix. 🧮
• -X file.ccss — Use Colorimeter Calibration Spectral Samples for calibration. 🧪
• -Q observ — Choose the CIE Observer for the CCSS instrument. your picks are: 1931_2 (the default, def), 1964_10, S&B 1955_2, shaw, J&V 1978_2. 👀
• -T ratio — Modify strip patch consistency tolerance by ratio. ⚖️
• -S — Suppress wrong strip & unexpected value warnings. (living dangerously, honestly, but do you 🫣)
• -W n|h|x — Override serial port flow control: n = none, h = HW, x = Xon/Xoff. 🔌
• -D [level] — Print debug diagnostics to stderr. 🐛
• outfile — Base name for the input[ti2] / output[ti3] file. 📝

🌈 little side note bestie: yes, -X shows up twice on purpose up there — once for the .ccmx matrix and once for the .ccss samples. two completely different jobs, same letter. she contains multitudes 💜

that's the whole page, you made it 🎉 this one's brought to you by chartread, dated September 2014, and it lives in the READ(1) corner of your manual. go read a chart, bestie, you got this 💖✨🎀