From 0a4fb6e7fcd9c5427c7c06cc626e7be7d7bdf14f Mon Sep 17 00:00:00 2001
From: joachimheintz <jh@joachimheintz.de>
Date: Sun, 25 Jan 2026 18:50:07 +0100
Subject: [PATCH] addition to quick reference

---
 docs/img/04_rot3.svg | 15 +++++++++++++++
 docs/index.md        | 20 ++++++++++++++++++++
 2 files changed, 35 insertions(+)
 create mode 100644 docs/img/04_rot3.svg

diff --git a/docs/img/04_rot3.svg b/docs/img/04_rot3.svg
new file mode 100644
index 0000000..c36bfd7
--- /dev/null
+++ b/docs/img/04_rot3.svg
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"
+     width="600" height="200" viewBox="0 0 300 100">
+<defs>
+</defs>
+<circle cx="10" cy="50" r="3" stroke="red" fill="red" />
+<text x="10" y="50" font-size="12" fill="grey" text-anchor="" dominant-baseline="" font-family="monospace">default</text>
+<text x="0" y="0" font-size="12" transform="translate(10,50) rotate(-90)" text-anchor="" dominant-baseline="" font-family="monospace">default</text>
+<circle cx="110" cy="50" r="3" stroke="red" fill="red" />
+<text x="110" y="50" font-size="12" fill="grey" text-anchor="middle" dominant-baseline="" font-family="monospace">centered</text>
+<text x="0" y="0" font-size="12" transform="translate(110,50) rotate(-90)" text-anchor="middle" dominant-baseline="" font-family="monospace">centered</text>
+<circle cx="210" cy="50" r="3" stroke="red" fill="red" />
+<text x="210" y="50" font-size="12" fill="grey" text-anchor="middle" dominant-baseline="middle" font-family="monospace">and baseline</text>
+<text x="0" y="0" font-size="12" transform="translate(210,50) rotate(-90)" text-anchor="middle" dominant-baseline="middle" font-family="monospace">and baseline</text>
+</svg>
\ No newline at end of file
diff --git a/docs/index.md b/docs/index.md
index 32d5ad8..65cb212 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -650,6 +650,8 @@ d.append(dw.Text('Fall', 24, 10, 30,
 
 ### Rotate
 
+#### Characters
+
 Either one angle (degrees), or a list which is applied to all characters.
 If the list is smaller than the number of characters, the last angle persists.
 
@@ -676,6 +678,24 @@ d.append(txt)
 
 ![svg](img/04_rot2.svg)
 
+#### Lines
+
+Rotating lines of text can be done via the *transform* keyword, holding a combination of *translate()* and *rotate()*. If the text's x/y coordinates are set to zero, the text is moved to and rotated around the x/y coordinates of *translate()*, in the angle given by *rotate()*. The result depends on the text anchor and on the dominant baseline. The example shows the default on the left side, the centered anchor in the middle, and the baseline set to middle on the right side. The red point is the rotating reference, the grey text is the text at the point's coordinates without rotation, and the black text the final result after rotation.
+
+```python
+text = ['default', 'centered', 'and baseline']
+anchor = ['', 'middle', 'middle']
+baseline = ['', '', 'middle']
+xpos = [10, 60, 110]
+for x,t,a,b in zip(xpos,text,anchor,baseline):
+    d.append(dw.Circle(x,50,3,stroke='red',fill='red'))
+    d.append(dw.Text(t,12,0,0,transform="translate(%d,50) rotate(-90)" % x,
+                     text_anchor='%s' % a, dominant_baseline='%s' % b,
+                     font_family='monospace'))
+```
+
+![svg](img/04_rot3.svg)
+
 
 ### Setting Text Length