 |
index.md - sites - public wiki contents of suckless.org |
 |
git clone git://git.suckless.org/sites |
 |
Log |
|
Files |
|
Refs |
|
--- |
|
index.md (2589B) |
|
--- |
|
1 Kitty Graphics Protocol |
|
2 ======================= |
|
3 |
|
4 [](st-kitty-graphics.png) |
|
5 |
|
6 Description |
|
7 ----------- |
|
8 This patch implements a subset of the [kitty graphics |
|
9 protocol](https://sw.kovidgoyal.net/kitty/graphics-protocol) |
|
10 in st. For more details, refer to the [st-graphics |
|
11 repository](https://github.com/sergei-grechanik/st-graphics). |
|
12 |
|
13 Notes |
|
14 ----- |
|
15 * Additional dependencies: imlib2, zlib |
|
16 * You can configure various limits, such as the maximum image size and c… |
|
17 size, in `config.h`. |
|
18 * There are several additional shortcuts: |
|
19 - `Ctrl+Shift+RightClick` to preview the clicked image in feh. |
|
20 - `Ctrl+Shift+MiddleClick` to view debug information (image id, placem… |
|
21 etc). |
|
22 - `Ctrl+Shift+F1` to toggle graphics debug mode. It has three states: … |
|
23 debugging; 2) show general info and print logs to stderr; 3) print l… |
|
24 show bounding boxes. |
|
25 - `Ctrl+Shift+F6` to dump the state of all images to stderr. |
|
26 - `Ctrl+Shift+F7` to unload all images from RAM (the cache in `/tmp` w… |
|
27 preserved). |
|
28 - `Ctrl+Shift+F8` to toggle image display. |
|
29 * This patch includes support for some XTWINOPS control sequences to que… |
|
30 information that is sometimes required for image display. |
|
31 * This patch includes support for underline colors and styles. It also |
|
32 changes the behavior of underlines by increasing their thickness with … |
|
33 size. If you don't like it, apply the following diff: |
|
34 |
|
35 diff --git a/x.c b/x.c |
|
36 index e0925c4..cd86fdf 100644 |
|
37 --- a/x.c |
|
38 +++ b/x.c |
|
39 @@ -1691,3 +1691,3 @@ xdrawglyphfontspecs(const XftGlyphFontSpec… |
|
40 /* Integer thickness in pixels. Must not be 0. */ |
|
41 - int thick = MAX(1, roundf(fthick)); |
|
42 + int thick = 1; |
|
43 /* The default gap between the baseline and a single und… |
|
44 |
|
45 Patch Compatibility |
|
46 ------------------- |
|
47 * This patch already includes the anysize patch. If you prefer the expec… |
|
48 behavior, set `anysize_halign` and `anysize_valign` to 0 in `config.h`. |
|
49 * This patch already supports underline colors and styles, so it is inco… |
|
50 with the undercurl patch. |
|
51 * It should be compatible with the boxdraw, scrollback, alpha, and backg… |
|
52 image patches, with minor conflict resolution. Ligatures also seem to … |
|
53 after some hacking. For more details, see |
|
54 [here](https://github.com/sergei-grechanik/st-graphics?tab=readme-ov-f… |
|
55 |
|
56 Download |
|
57 -------- |
|
58 * [st-kitty-graphics-20240922-a0274bc.diff](st-kitty-graphics-20240922-a… |
|
59 |
|
60 Author |
|
61 ------ |
|
62 * Sergei Grechanik <[email protected]> |
