From 5d1abc9111a2a448f05462e6140fadb7448218e6 Mon Sep 17 00:00:00 2001 From: Lukasz Kasprzak Date: Fri, 21 Aug 2026 10:23:52 +0200 Subject: 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. --- README.md | 39 +++++---------------------------------- 1 file changed, 5 insertions(+), 34 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 476a818..033aa46 100644 --- a/README.md +++ b/README.md @@ -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 -- cgit v1.3