Support HSL, HSV, CMYK, short options, minor I/O fix, and add a manual page (#12)
* use getopt_long(3) and support short options
Now instead of `--format`, `--no-fancy`, and `--help` you can also use
`-f`, `-n`, and `-h`. Additionally instead of just being able to do
`--format <fmt>` you can now do the standard `--format=<fmt>`.
* remove initial space when m_bFancyOutput is true
* add the HSL format
* add the HSV format
* add a manual page
* silence compiler warning
* make all the default target, and add install rule
* add the CMYK format
* add new formats to the README
2022-11-19 18:02:11 +01:00
|
|
|
.Dd $Mdocdate: November 14 2022 $
|
|
|
|
|
.Dt HYPRPICKER 1
|
|
|
|
|
.Os Linux
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm hyprpicker
|
|
|
|
|
.Nd wlroots-compatible wayland color picker
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm
|
2022-11-20 11:37:39 +01:00
|
|
|
.Op Fl anh
|
Support HSL, HSV, CMYK, short options, minor I/O fix, and add a manual page (#12)
* use getopt_long(3) and support short options
Now instead of `--format`, `--no-fancy`, and `--help` you can also use
`-f`, `-n`, and `-h`. Additionally instead of just being able to do
`--format <fmt>` you can now do the standard `--format=<fmt>`.
* remove initial space when m_bFancyOutput is true
* add the HSL format
* add the HSV format
* add a manual page
* silence compiler warning
* make all the default target, and add install rule
* add the CMYK format
* add new formats to the README
2022-11-19 18:02:11 +01:00
|
|
|
.Op Fl f Ar fmt
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
utility is a color-picker with support for various output formats.
|
|
|
|
|
When
|
|
|
|
|
.Nm
|
|
|
|
|
is invoked the cursor is transformed into a magnifying lens, and clicking on any
|
|
|
|
|
pixel of the screen will print out that pixels color to the standard output.
|
|
|
|
|
The default output format is hexadecimal, but that can be configured with the
|
|
|
|
|
.Fl f
|
|
|
|
|
option.
|
|
|
|
|
.Pp
|
|
|
|
|
The options are as follows:
|
|
|
|
|
.Bl -tag -width Ds
|
2022-11-20 11:37:39 +01:00
|
|
|
.It Fl a , Fl Fl autocopy
|
|
|
|
|
Automatically copy the output of
|
|
|
|
|
.Nm
|
|
|
|
|
to the clipboard.
|
|
|
|
|
This option requires that the
|
|
|
|
|
.Xr wl-copy 1
|
|
|
|
|
command is installed on system.
|
|
|
|
|
.It Fl f Ar fmt , Fl Fl format Ns = Ns Ar fmt
|
Support HSL, HSV, CMYK, short options, minor I/O fix, and add a manual page (#12)
* use getopt_long(3) and support short options
Now instead of `--format`, `--no-fancy`, and `--help` you can also use
`-f`, `-n`, and `-h`. Additionally instead of just being able to do
`--format <fmt>` you can now do the standard `--format=<fmt>`.
* remove initial space when m_bFancyOutput is true
* add the HSL format
* add the HSV format
* add a manual page
* silence compiler warning
* make all the default target, and add install rule
* add the CMYK format
* add new formats to the README
2022-11-19 18:02:11 +01:00
|
|
|
Select the format to output the selected pixels color in.
|
|
|
|
|
The argument
|
|
|
|
|
.Ar fmt
|
|
|
|
|
is case-insensitive.
|
|
|
|
|
The available options are:
|
|
|
|
|
.Pp
|
|
|
|
|
.Bl -hang -compact
|
|
|
|
|
.It Ar cmyk
|
|
|
|
|
.Pq Dq C% M% Y% K%
|
|
|
|
|
.It Ar hex
|
|
|
|
|
.Pq Dq #RRGGBB
|
|
|
|
|
.It Ar rgb
|
|
|
|
|
.Pq Dq R G B
|
|
|
|
|
.It Ar hsl
|
|
|
|
|
.Pq Dq H S% L%
|
|
|
|
|
.It Ar hsv
|
|
|
|
|
.Pq Dq H S% V%
|
|
|
|
|
.El
|
|
|
|
|
.Pp
|
|
|
|
|
The default format is
|
|
|
|
|
.Ar hex .
|
2022-11-20 11:37:39 +01:00
|
|
|
.It Fl n , Fl Fl no-fancy
|
Support HSL, HSV, CMYK, short options, minor I/O fix, and add a manual page (#12)
* use getopt_long(3) and support short options
Now instead of `--format`, `--no-fancy`, and `--help` you can also use
`-f`, `-n`, and `-h`. Additionally instead of just being able to do
`--format <fmt>` you can now do the standard `--format=<fmt>`.
* remove initial space when m_bFancyOutput is true
* add the HSL format
* add the HSV format
* add a manual page
* silence compiler warning
* make all the default target, and add install rule
* add the CMYK format
* add new formats to the README
2022-11-19 18:02:11 +01:00
|
|
|
Disable colored output.
|
|
|
|
|
Default behavior is to color the output in the same color as the selected pixel.
|
2022-11-20 11:37:39 +01:00
|
|
|
.It Fl h , Fl Fl help
|
Support HSL, HSV, CMYK, short options, minor I/O fix, and add a manual page (#12)
* use getopt_long(3) and support short options
Now instead of `--format`, `--no-fancy`, and `--help` you can also use
`-f`, `-n`, and `-h`. Additionally instead of just being able to do
`--format <fmt>` you can now do the standard `--format=<fmt>`.
* remove initial space when m_bFancyOutput is true
* add the HSL format
* add the HSV format
* add a manual page
* silence compiler warning
* make all the default target, and add install rule
* add the CMYK format
* add new formats to the README
2022-11-19 18:02:11 +01:00
|
|
|
Display a help message and exit successfully from the program.
|
|
|
|
|
.El
|
|
|
|
|
.Sh ENVIRONMENT
|
|
|
|
|
.Bl -tag -width NO_COLOR
|
|
|
|
|
.It Ev NO_COLOR
|
|
|
|
|
If set, disables colored output.
|
|
|
|
|
.El
|
|
|
|
|
.Sh EXIT STATUS
|
|
|
|
|
.Ex -std
|
|
|
|
|
.Sh EXAMPLES
|
|
|
|
|
Get a pixels color:
|
|
|
|
|
.Pp
|
|
|
|
|
.Dl $ hyprpicker
|
|
|
|
|
.Pp
|
|
|
|
|
Get a pixels color in HSL, wrapped in a CSS
|
|
|
|
|
.Fn hsl
|
|
|
|
|
function:
|
|
|
|
|
.Pp
|
|
|
|
|
.Dl $ hyprpicker -f hsl | sed 's/^/rgb(/; s/$/)/; y/ /,/'
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr hyprctl 1 ,
|
|
|
|
|
.Xr hyprland 1 ,
|
2022-11-20 11:37:39 +01:00
|
|
|
.Xr sed 1 ,
|
|
|
|
|
.Xr wl-copy 1
|
Support HSL, HSV, CMYK, short options, minor I/O fix, and add a manual page (#12)
* use getopt_long(3) and support short options
Now instead of `--format`, `--no-fancy`, and `--help` you can also use
`-f`, `-n`, and `-h`. Additionally instead of just being able to do
`--format <fmt>` you can now do the standard `--format=<fmt>`.
* remove initial space when m_bFancyOutput is true
* add the HSL format
* add the HSV format
* add a manual page
* silence compiler warning
* make all the default target, and add install rule
* add the CMYK format
* add new formats to the README
2022-11-19 18:02:11 +01:00
|
|
|
.Pp
|
|
|
|
|
.Lk https://github.com/hyprwm/hyprpicker "The Hyprpicker Sources"
|
|
|
|
|
.Sh AUTHORS
|
|
|
|
|
.An -nosplit
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
|
|
|
|
utility was originally written by
|
|
|
|
|
.An Vaxerski Aq Lk https://github.com/vaxerski
|
|
|
|
|
and the manual page by
|
|
|
|
|
.An Thomas Voss Aq Mt mail@thomasvoss.com .
|
|
|
|
|
.Sh BUGS
|
|
|
|
|
.Lk https://github.com/hyprwm/hyprpicker/issues "The Hyprpicker Bug Tracker"
|
