set terminal sixelgd {{no}enhanced} {{no}truecolor} {{no}transparent} {rounded|butt} {linewidth <lw>} {dashlength <dl>} {tiny | small | medium | large | giant} {font "<face> {,<pointsize>}"} {fontscale <scale>} {size <x>,<y>} {{no}crop} {animate} {background <rgb_color>}
The sixel output format was originally used by DEC terminals and printers. This driver produces a sixel output stream by converting a PNG image created internally using the gd library. The sixel output stream can be viewed in the terminal as it is created or it can be written to a file so that it can be replayed later by echoing the file to the terminal.
The animate option resets the cursor position to the terminal top left at the start of every plot so that successive plots overwrite the same area on the screen rather than having earlier plots scroll off the top. This may be desirable in order to create an in-place animation.
transparent instructs the driver to make the background color transparent. Default is notransparent.
The linewidth and dashlength options are scaling factors that affect all lines drawn, i.e. they are multiplied by values requested in various drawing commands.
By default the sixel output uses 16 indexed colors. The truecolor option instead creates a TrueColor png image that is mapped down onto 256 colors in the output sixel image. Transparent fill styles require the truecolor option. See fillstyle (p. ). A transparent background is possible in either indexed or TrueColor images.
butt instructs the driver to use a line drawing method that does not overshoot the desired end point of a line. This setting is only applicable for line widths greater than 1. This setting is most useful when drawing horizontal or vertical lines. Default is rounded.
The details of font selection are complicated. For more information please see fonts (p. ).
The output plot size 4#4x,y5#5 is given in pixels — it defaults to 640x480. Please see additional information under canvas (p. ) and set size (p. ). Blank space at the edges of the finished plot may be trimmed using the crop option, resulting in a smaller final image size. Default is nocrop. The terminal has been successfully tested with the xterm, mlterm and mintty terminals. The later two support the truecolor mode using 256 sixel colors out of box. Distributed copies of xterm may or may not have been configured to support sixel graphics and may be limited to 16 colors.