1
1
mirror of https://github.com/wez/wezterm.git synced 2024-12-24 22:01:47 +03:00
wezterm/docs/examples/cmd-synopsis-wezterm-imgcat--help.txt
Wez Furlong 2e505ad869
imgcat: add --position, --no-move-cursor and --hold options
These allow additional control over image placement

refs: https://github.com/wez/wezterm/issues/3716
2023-07-15 16:27:52 -07:00

36 lines
1.6 KiB
Plaintext

Output an image to the terminal
Usage: wezterm imgcat [OPTIONS] [FILE_NAME]
Arguments:
[FILE_NAME] The name of the image file to be displayed. If omitted, will
attempt to read it from stdin
Options:
--width <WIDTH>
Specify the display width; defaults to "auto" which automatically
selects an appropriate size. You may also use an integer value `N` to
specify the number of cells, or `Npx` to specify the number of pixels,
or `N%` to size relative to the terminal width
--height <HEIGHT>
Specify the display height; defaults to "auto" which automatically
selects an appropriate size. You may also use an integer value `N` to
specify the number of cells, or `Npx` to specify the number of pixels,
or `N%` to size relative to the terminal height
--no-preserve-aspect-ratio
Do not respect the aspect ratio. The default is to respect the aspect
ratio
--position <POSITION>
Set the cursor position prior to displaying the image. The default is
to use the current cursor position. Coordinates are expressed in cells
with 0,0 being the top left cell position
--no-move-cursor
Do not move the cursor after displaying the image. Note that when used
like this from the shell, there is a very high chance that shell
prompt will overwrite the image; you may wish to also use `--hold` in
that case
--hold
Wait for enter to be pressed after displaying the image
-h, --help
Print help