domterm imgcat - print image to domterm terminal

Synopsis

domterm imgcat [-n] [--attrname=attrvalue]…​ filename

domterm image [-n] [--attrname=attrvalue]…​ filename

Description

The imgcat or image commands do the same thing: They "print" the concats of an image file to a DomTerm terminal, so the image becomes part of the terminal output.

The image file is "copied" rather than linked (using a data: url). The file must be readable by the domterm command, but need not be readable by the browser. If the terminal output is saved "As HTML" the image is saved as part of the html file.

The filename must be a file that can be displayed by an HTML <img> element, most commonly a png or jpg file.

Options

-n

If no -n is specified), the image has a display: block style (so it is automatically on a 'line' by itself), and gets a horizontal scroll bar if and only if it is too wide to fit. If -n is specified, then only a plain <img> element is written, hence you can write multiple images and other HTML on the same 'line'

--attrname=attrvalue

specify the given attribute; for example: --height=200 . Valid attrnames are the following, which are defined by the HTML specification: alt, longdesc, height, width, border, hspace, vspace, class.

For example: --width=600 scales the image width to be the given number of pixels (in the CSS meaning). (The height is scaled proportionally, unless you also specify the --height option.)