READ(1)

✨ READ(1) — ok bestie, come get your display read ✨

so this is READ(1), and it lives in the User Commands section of the manual, which is basically the main character section if we're being honest. it's giving "short page, big energy." let's go. 💖

🌸 NAME 🌸

Read — Read a Display.

yeah. that's the whole thing. she said what she said. 💅

🦋 DESCRIPTION 🦋

Read a Display.

ngl the original is out here with minimalism as a personality trait, and honestly? respect. that's the entire description. no notes. ✨

🎀 SYNOPSIS 🎀

dispread [options] outfile

okay so it's dispread, you feed her some options, and you give her an outfile. and here's everything she'll take from you — all of it, no skips, no skimming, we are NOT leaving anything out because every single one of these matters. 🫶

👑 OPTIONS 👑

• -v — verbose mode. she's gonna talk. a lot. let her. 💬
• -display displayname — pick your X11 display name, bestie. that's the whole job. 🌈
• -d n[,m] — choose the display n from the list below (default is 1). optionally you can choose a different display m for VideoLUT access, because sometimes you want a second opinion from a whole other display.

the list, as it stands right now, is literally just:

1 = 'Screen 1, Output DVI-I-1 at 0, 0, width 1920, height 1080'

one entry. she's an only child. 🦋

• -dweb[:port] — display via a web server at port (default 8080). going remote, we love a girl who works from anywhere. 🌐
• -c listno — set the communication port from the list below (default 1). and the list below is… this:

** No ports found **

bestie. there are no ports. there are ZERO ports. it's giving "empty group chat." 💀

• -p — use telephoto mode (ie. for a projector) — but only if available. check first, don't assume. 🔭
• -k file.cal — load a calibration file into the display while reading. multitasking queen. 🎀
• -K file.cal — apply a calibration file to the test values while reading. yes, that's different from -k. no, we are not merging them. they are two separate icons. 👑
• -s — save spectral information. default is don't save it, so if you want the spectra, you gotta say so. 🍓
• -P ho,vo,ss[,vs] — position the test window and scale it: ho,vi: 0.0 = left/top, 0.5 = center, 1.0 = right/bottom etc. and ss: 0.5 = half, 1.0 = normal, 2.0 = double etc. yes that's the exact wording, yes I'm keeping it, don't look at me. ✨
• -F — fill the whole screen with a black background. dramatic. moody. aesthetic. 🖤
• -n — don't set override redirect on the test window. just… don't. 🚫
• -E — encode the test values for video range 16..235/255. ✨
• -J — run instrument calibration first. the page says it's used rarely, so like, don't make it your whole personality. 💅
• -N — disable initial calibration of the instrument, if possible. she said "if possible," so don't come for me if she can't. 😭
• -H — use high resolution spectrum mode — again, if available. 🔥
• -w — disable normalisation of white to Y = 100. raw. unfiltered. no cap. 🌸
• -X file.ccmx — apply a Colorimeter Correction Matrix. 🧚
• -X file.ccss — use Colorimeter Calibration Spectral Samples for calibration. same flag letter, different file extension, different job — she contains multitudes. 💜
• -Q observ — choose the CIE Observer for spectrometer or CCSS colorimeter data. your options are: 1931_2 (that's the def, the default, the main character), 1964_10, S&B 1955_2, shaw, J&V 1978_2, and 1964_10c. pick one, pick wisely. 🔭
• -I b|w — drift compensation. Black is -Ib, White is -Iw, Both is -Ibw. yes, both is just the two letters holding hands. 🫶
• -Y R:rate — override the measured refresh rate with rate Hz. ⭐
• -Y A — use non-adaptive integration time mode, if available. 🌈
• -Y p — don't wait for the instrument to be placed on the display. she trusts you. 🙈
• -C "command" — invoke the shell "command" each and every time a color is set. every single time. 😤
• -M "command" — invoke the shell "command" each and every time a color is measured. (this is the measuring twin of -C, and yes they are different, keep up bestie) 💖
• -W n|h|x — override serial port flow control: n = none, h = HW, x = Xon/Xoff. three little letters, three little destinies. ✨
• -D [level] — print debug diagnostics to stderr. the level is optional, the diagnostics are not. 🔍
• outfile — the base name for the input[ti1]/output[ti3] file. this is the one thing in the synopsis that isn't a flag, so like, don't forget her. 🥺

💌 ok that's the whole page, bye bestie 💌

this little masterpiece was brought to you by dispread, dated September 2014, and it answers to the name READ(1). go read a display. you got this. 👑✨🦋