vo_chafa: initial commit

vo_chafa: get term_info during preinit

vo_chafa: set cell geometry on chafa canvas to fix sixel pixel mode

vo_chafa: get terminfo using default term_db

vo_chafa: change dither-mode option to dither for consitency

vo_chafa: add support for more image formats

vo_chafa: fix comments

vo_chafa: use mp_tprintf for pos_buf instead of snprintf

vo_chafa: remove header for libswscale

DOCS/main/vo.rst: remove explicit mentions of terminals in the `vo_chafa` docs

vo_chafa: use chafa_calc_canvas_geometry to get width and height in cells of chafa canvas

Author: StratusFearMe21

DOCS/man/vo.rst

@@ -578,6 +578,108 @@ Available video output drivers are:
         in some terminals (``xterm``). The default (-1) will choose a palette
         on every frame and will have better quality.
 
+``chafa``
+    Graphical output for the terminal, using chafa.
+
+    Note: the image output is not synchronized with other terminal
+    output from mpv, which can lead to broken images.
+    The option ``--really-quiet`` can help with that, and is recommended.
+
+    You may need to use ``--profile=sw-fast`` to get decent performance.
+
+    When the pixel mode is set to ``sixels``, chafa has the same caveats that the
+    ``sixel`` VO has. See those.
+
+    Sixel size and alignment options:
+
+    ``--vo-chafa-cols=<columns>``, ``--vo-chafa-rows=<rows>`` (default: 0)
+        Specify the terminal size in character cells, otherwise (0) read it
+        from the terminal, or fall back to 80x25. Note that mpv doesn't use the
+        the last row with chafa because this seems to result in scrolling.
+
+    ``--vo-chafa-width=<width>``, ``--vo-chafa-height=<height>`` (default: 0)
+        Specify the available size in pixels, otherwise (0) read it from the
+        terminal, or fall back to 320x240. Other than excluding the last line,
+        the height is also further rounded down to a multiple of 6 (chafa unit
+        height) to avoid overflowing below the designated size.
+
+    ``--vo-chafa-left=<col>``, ``--vo-chafa-top=<row>`` (default: 0)
+        Specify the position in character cells where the image starts (1 is
+        the first column or row). If 0 (default) then try to automatically
+        determine it according to the other values and the image aspect ratio
+        and zoom.
+
+    ``--vo-chafa-pad-x=<pad_x>``, ``--vo-chafa-pad-y=<pad_y>`` (default: -1)
+        Used only when mpv reads the size in pixels from the terminal.
+        Specify the number of padding pixels (on one side) which are included
+        at the size which the terminal reports. If -1 (default) then the number
+        of pixels is rounded down to a multiple of number of cells (per axis),
+        to take into account padding at the report - this only works correctly
+        when the overall padding per axis is smaller than the number of cells.
+
+    ``--vo-chafa-config-clear=<yes|no>`` (default: yes)
+        Whether or not to clear the terminal whenever the output is
+        reconfigured (e.g. when video size changes).
+
+    ``--vo-chafa-alt-screen=<yes|no>`` (default: yes)
+        Whether or not to use the alternate screen buffer and return the
+        terminal to its previous state on exit. When set to no, the last
+        chafa image stays on screen after quit, with the cursor following it.
+
+    ``--vo-chafa-pixel-mode=<pixel_mode>``
+        Selects the graphics protocol that chafa will render graphics with.
+        Can be one of the below list
+
+        symbols (Default)
+            Writes unicode characters to the terminal
+        sixels
+            Uses the sixel protocol to render graphics.
+        kitty
+            Uses the kitty image protocol to render graphics.
+        iterm2
+            Uses the iterm2 image protocol to render graphics.
+
+    ``--vo-chafa-canvas-mode=<canvas_mode>`` (default: truecolor)
+        Selects the colorspace that chafa will render graphics with.
+        Can be one of the below list as per chafa's documentation.
+
+        truecolor (Default)
+            Truecolor (sRGB)
+        256
+            256 colors.
+        240
+            256 colors, but avoid using the lower 16 whose values vary between
+            terminal environments.
+        16
+            16 colors using the aixterm ANSI extension.
+        fgbg-bgfg
+            Default foreground and background colors, plus inversion.
+        fgbg
+            Default foreground and background colors. No ANSI codes will be used.
+        8
+            8 colors, compatible with original ANSI X3.64.
+        16-8
+            16 FG colors (8 of which enabled with bold/bright) and 8 BG colors.
+
+
+    chafa image quality options as per chafa's documentation:
+
+    ``--vo-chafa-dither=<algo>``
+        Selects the dither algorithm which chafa should apply.
+        Can be one of the below list.
+
+        none (Default)
+            Don't diffuse
+        ordered
+            Ordered dithering (Bayer or similar).
+        diffusion
+            Error diffusion dithering (Floyd-Steinberg or similar).
+        noise
+            Error diffusion dithering (Floyd-Steinberg or similar).
+
+    ``--vo-chafa-work-factor=<work_factor>`` (default: 50)
+        Sets the work/quality tradeoff factor. A higher value means more time and memory will be spent towards a higher quality output.
+
 ``image``
     Output each frame into an image file in the current directory. Each file
     takes the frame number padded with leading zeros as name.

meson.build

@@ -1020,6 +1020,13 @@ if features['sixel']
     sources += files('video/out/vo_sixel.c')
 endif
 
+chafa = dependency('chafa', version: '>= 1.18', required: get_option('chafa'))
+features += {'chafa': chafa.found()}
+if features['chafa']
+    dependencies += chafa
+    sources += files('video/out/vo_chafa.c')
+endif
+
 features += {'posix-shm': false}
 if features['posix']
     features += {'posix-shm': cc.has_function('shm_open', prefix: '#include <sys/mman.h>')}

meson.options

@@ -60,6 +60,7 @@ option('wasapi', type: 'feature', value: 'auto', description: 'WASAPI audio outp
 option('amf', type: 'feature', value: 'auto', description: 'AMD AMF')
 option('caca', type: 'feature', value: 'auto', description: 'CACA')
 option('cocoa', type: 'feature', value: 'auto', description: 'Cocoa')
+option('chafa', type: 'feature', value: 'auto', description: 'Chafa')
 option('d3d11', type: 'feature', value: 'auto', description: 'Direct3D 11 video output')
 option('direct3d', type: 'feature', value: 'auto', description: 'Direct3D support')
 option('dmabuf-wayland', type: 'feature', value: 'auto', description: 'dmabuf-wayland video output')

video/out/vo.c

@@ -65,6 +65,7 @@ extern const struct vo_driver video_out_dmabuf_wayland;
 extern const struct vo_driver video_out_wlshm;
 extern const struct vo_driver video_out_tct;
 extern const struct vo_driver video_out_sixel;
+extern const struct vo_driver video_out_chafa;
 extern const struct vo_driver video_out_kitty;
 
 static const struct vo_driver *const video_out_drivers[] =
@@ -114,6 +115,9 @@ static const struct vo_driver *const video_out_drivers[] =
 #endif
 #if HAVE_SIXEL
     &video_out_sixel,
+#endif
+#if HAVE_CHAFA
+    &video_out_chafa,
 #endif
     &video_out_kitty,
     &video_out_lavc,