ref: ffb97abccf0d8a01cf7db41c495103585d810699
dir: /picker.man/
.TH PICKER 1 .SH NAME picker \- a color picker .SH SYNOPSIS .B picker [ .I -e ] [ .I -slr ] [ .I FILE ] .SH DESCRIPTION .I Picker is a tool designed to mainly be used by other programs in order to change a color palette dynamically, showing changes in real time. Colors are supplied through a file, each line is encoded as .I RGB or .I RGBA in hex form, i.e. .I ff0000 for red in .I RGB mode, or .I ff0000ff in .I RGBA mode. .PP If the filename wasn't specified, .I picker expects data to be supplied on its standard input. The format in both cases is the same: .I id of the color first, then hex value of the color as the second column. .I Id is used for color updates written to stdout. .PP Different color spaces are accessible through right button menu, or as command line arguments: .TP .B -s HSLuv. .TP .B -l HPLuv. .TP .B -r RGB. .PP Switching between colors in the palette can be done by either a mouse click, or left/right arrows on the keyboard. With the middle button click you can enter color as .I RGB(A) manually. .PP For each change of a color, picker writes to stdout its .I id and the new color value, separated by a single space. Pass .I -e option if you want .I picker to print all the colors only once you exit the program. .SH PLUMBING Themes can be loaded into a running .I picker through plumber rule. The following assumes themes have .I ".theme" as its extension. .EX type is text data matches '[a-zA-Z¡-0-9_\-.,/]+' data matches '([a-zA-Z¡-0-9_\-.,/]+)\.theme' arg isfile $0 data set $file plumb to picker plumb start window picker -e $file .EE .PP .SH SOURCE https://git.sr.ht/~ft/picker