X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=docs%2Freference%2Fglk-window-arrangement.sgml;h=fe9f66705d67b8b1612bd3d3583b21a7d5b17f04;hb=79e849f3294d0d7824a8a06955a6baf3f2a2a5b7;hp=9926d817c5d81f04bbc138de262021190da24540;hpb=890e2ad862eb2132ddae3458d590e2fe2f3b7496;p=rodin%2Fchimara.git
diff --git a/docs/reference/glk-window-arrangement.sgml b/docs/reference/glk-window-arrangement.sgml
index 9926d81..fe9f667 100644
--- a/docs/reference/glk-window-arrangement.sgml
+++ b/docs/reference/glk-window-arrangement.sgml
@@ -37,11 +37,40 @@ It is important to remember that the order of splitting matters. If you split tw
Example time. Say you do two splits, each a 50-50 percentage split. You start with the original window A, and split that into A and B; then you split B into B and C.
-Screen shot 1
+
+
+
+ O
+ / \
+ A O
+ / \
+ B C
+
+
Or, you could split A into A and B, and then split A again into A and C.
-Screen shot 2
+
+
+
+ O
+ / \
+ O B
+ / \
+ A C
+
+
I'm using the simplest possible splits in the examples above. Every split is 50-50, and the new window of the pair is always below the original one (the one that gets split.) You can get fancier than that. Here are three more ways to perform the first example; all of them have the same tree structure, but look different on the screen.
-Screen shot 3
+
+
+
+
+
+ O
+ / \
+ A O
+ / \
+ B C
+
+
On the left, we turn the second split (B into B/C) upside down; we put the new window (C) above the old window (B).
@@ -55,7 +84,28 @@ The visible windows on the Glk screen are leaf nodes
of the binar
You don't create pair windows directly; they are created as a consequence of window splits. Whenever you create a new window, a new pair window is also created automatically. In the following two-split process, you can see that when a window is split, it is replaced by a new pair window, and moves down to become one of that O
's two children.
-Screen shot 4
+
+
+
+ A
+
+
+
+
+ O
+ / \
+ A B
+
+
+
+
+ O
+ / \
+ A O
+ / \
+ B C
+
+
You can't draw into a pair window. It's completely filled up with the two windows it contains. They're what you should be drawing into.