summaryrefslogtreecommitdiffstats
path: root/_site/log/matrix-digital-rain
diff options
context:
space:
mode:
authorSadeep Madurange <sadeep@asciimx.com>2025-12-24 18:02:45 +0800
committerSadeep Madurange <sadeep@asciimx.com>2025-12-24 18:02:45 +0800
commitc2268acff30886e2a0ee70d826293168a6d0068a (patch)
tree949eef86d2d1779bd00f0d7f2d23ae4346ce90b9 /_site/log/matrix-digital-rain
parent1b991a54cc834e8ef9ccc8bb15dce7ff70cdf8a3 (diff)
downloadwww-c2268acff30886e2a0ee70d826293168a6d0068a.tar.gz
Matrix
Diffstat (limited to '_site/log/matrix-digital-rain')
-rw-r--r--_site/log/matrix-digital-rain/index.html62
1 files changed, 46 insertions, 16 deletions
diff --git a/_site/log/matrix-digital-rain/index.html b/_site/log/matrix-digital-rain/index.html
index 4a23d29..16b96be 100644
--- a/_site/log/matrix-digital-rain/index.html
+++ b/_site/log/matrix-digital-rain/index.html
@@ -45,14 +45,15 @@
<h6 class="center">21 DECEMBER 2025</h5>
<br>
<div class="twocol justify"><p>My 2022 implementation of the Matrix rain had too many loose ends. Unicode
-support was inflexible: the charset had to be a single contiguous block with no
-way to mix ASCII with something like Katakana; Phosphor decay level was stored
-in a dedicated array–still don’t understand why I did that when I had already
-used bit-packing for the RGB channels; The algorithm was difficult to decipher.
-The 2022 version worked, but that’s not the same thing as being correct.</p>
+support was inflexible: the character set had to be a single contiguous block
+with no way to mix ASCII with something like Katakana; Phosphor decay level was
+stored in a dedicated array–still don’t understand why I did that when I had
+already used bit-packing for the RGB channels; The algorithm was difficult to
+decipher. The 2022 version worked, but that’s not the same thing as correct.</p>
<p>I began by placing the decay factor in the LSB of the 4-byte RGB value. Let’s
-call that RGB-PD. PD plays a somewhat analogous role to an alpha channel; I
+call that RGB-PD. PD plays a somewhat analogous role to an alpha channel in
+that both influence transparency. However, they work very differently. So, I
avoided labelling it A so as not to cause confusion:</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>enum {
@@ -70,12 +71,12 @@ typedef union color_tag {
<p>The decision to use union over more portable bit twiddling was made three years
ago, as I recall, for readability. Seeing as all my systems are little-endian,
-this is unlikely to cause me trouble. Besides, if union is never to be used,
+this is unlikely to cause any trouble. Besides, if union is never to be used,
why is it in the language anyway?</p>
<p>The blend() function, which emulates the dim afterglow of Phosphor by eroding
-the RGB channels towards the background, remains as elegant as it did three
-years ago:</p>
+the RGB channels towards the background, with minor refactoring, remains as
+elegant as it did three years ago:</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>#define DECAY_MPLIER 2
@@ -91,13 +92,13 @@ static inline void blend(matrix *mat,
}
</code></pre></div></div>
-<p>While the memory inefficiency of Phosphor decay tracking was a technical
-oversight I hadn’t noticed, the limitation around mixing nonadjacent Unicode
-blocks was a nagging concern even three years ago. So, a fix was long overdue.</p>
+<p>While the memory inefficiency of Phosphor decay was a technical oversight I
+hadn’t noticed, the limitation around mixing nonadjacent Unicode blocks was a
+nagging concern even three years ago. So, a fix was long overdue.</p>
-<p>In the new version, I introduced a glyphs array that enables a user to add as
+<p>In the new version, I introduced an array that enables a user to add as
many Unicode blocks as they want. The insert_code() function picks a block
-from the array at random, and then picks a character from that block at random:</p>
+from it at random, and then picks a character from that block at random:</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>#define UNICODE(min, max) (((uint64_t)max &lt;&lt; 32) | min)
@@ -131,8 +132,37 @@ are trivial and idiomatic, and the UNICODE() macro simplifies the management of
charsets. The insert_code() function is now ready to take its rightful place
next to blend().</p>
-<p>The result is a digital rain that captures the original Matrix aesthetic with
-high visual fidelity:</p>
+<p>The init_term() function is the arbiter of this zero-dependency software. It
+prepares the graphical environment so that I can interact with it via ANSI
+escape codes instead of unnecessary layers of abstraction:</p>
+
+<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>static inline int init_term(const struct winsize *ws)
+{
+ struct termios ta;
+
+ if (tcgetattr(STDIN_FILENO, &amp;ta) == 0) {
+ ta.c_lflag &amp;= ~ECHO;
+ if (tcsetattr(STDIN_FILENO, TCSANOW, &amp;ta) == 0) {
+ wprintf(L"\x1b[48;2;%d;%d;%dm",
+ RGB_BG_RED, RGB_BG_GRN, RGB_BG_BLU);
+ wprintf(L"%s", ANSI_FONT_BOLD);
+ wprintf(L"%s", ANSI_CRSR_HIDE);
+ wprintf(L"%s", ANSI_CRSR_RESET);
+ wprintf(L"%s", ANSI_SCRN_CLEAR);
+ setvbuf(stdout, 0, _IOFBF, 0);
+ ioctl(STDOUT_FILENO, TIOCGWINSZ, ws);
+ return 1;
+ }
+ }
+ return 0;
+}
+</code></pre></div></div>
+
+<p>All credit for the terminal control function belongs to Domsson, whose <a href="https://github.com/domsson/fakesteak" class="external" target="_blank" rel="noopener noreferrer">Fakesteak</a> inspired my own three years ago.</p>
+
+<p>insert_code() seeds the Matrix, blend() creates the old monochrome CRT display
+nostalgia, and ANSI control sequences paint the screen. The result is a digital
+rain that captures the original Matrix aesthetic with high visual fidelity:</p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>$ cc -O3 main.c -o matrix
$ ./matrix