diff options
| author | Lukasz Kasprzak <lukasz@arcofasiagroup.com> | 2026-08-21 10:23:52 +0200 |
|---|---|---|
| committer | Lukasz Kasprzak <lukasz@arcofasiagroup.com> | 2026-08-21 10:23:52 +0200 |
| commit | 5d1abc9111a2a448f05462e6140fadb7448218e6 (patch) | |
| tree | 6eefaf104d40241b27f9afc2cf686e3c62337f7b /README.md | |
| parent | 69add3767988d0dfc6ecac37405cfb10abe8dbb7 (diff) | |
| download | colitur-x-5d1abc9111a2a448f05462e6140fadb7448218e6.tar.gz colitur-x-5d1abc9111a2a448f05462e6140fadb7448218e6.zip | |
split: colitur-mu moves to colitur-experiments
This repo now holds one finished program rather than a finished one and a
sketch. The microui front-end, its Xlib backend and the vendored microui
went to ../colitur-experiments with their history intact.
Makefile, config.h and README trimmed to match.
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 39 |
1 files changed, 5 insertions, 34 deletions
@@ -69,41 +69,12 @@ how it is painted. - A tiling window manager will ignore the size hints and give the grid its own tile; the layout handles that, the empty space is the WM's choice. -## colitur-mu — the microui variant +## The microui variant -`colitur-mu` is the same idea with an *editable* surface: year, language, -book-name form and numbering tradition are buttons, and changing any of them -re-runs colitur and reloads. It reimplements no calendar logic — every value -on screen came out of `colitur emit --format csv`, and the exact command is -shown in the status line. - - make colitur-mu && ./colitur-mu - -microui (MIT, rxi) is **vendored** in `vendor/`, 1504 lines. That is the point: -a copied-in dependency cannot rot. `mu_x11.c` is the Xlib/Xft backend, ~150 -lines — microui emits a command list and asks two font-metric questions; this -answers them. - -### One bug worth recording - -microui resets its scissor by emitting an "unclipped" rectangle of -`0x1000000` × `0x1000000`. `XRectangle`'s width and height are **unsigned -short**, so that truncates to **0** — turning "clip nothing" into "clip -everything". The symptom is that a scrolling panel draws its first screenful -and everything after it silently disappears, which looks like a layout or -buffer-overflow bug and is neither. `set_clip()` clamps to the buffer bounds -before converting. - -### Verifying a frame without a screenshot - - MUX_DUMP=/tmp/frame.ppm ./colitur-mu # writes one frame, then exits - convert /tmp/frame.ppm /tmp/frame.png - -This reads back the off-screen PIXMAP, not the window. A window's contents -are not retained while it is obscured or sitting on an unfocused tag, so -`import`/`xwd` against one can return solid black while the program is -drawing perfectly -- which cost real time to work out once. A pixmap is -always there. +An editable front-end -- where year, language, book-name form and numbering +tradition are buttons that re-run colitur -- lives in +[colitur-experiments](../colitur-experiments) rather than here, so this repo +holds one finished program instead of a finished one and a sketch. ### Which to use |
