#!/usr/bin/env python3
"""Generate six original A4 Dance aids and one quiet original two-note cue."""
from __future__ import annotations
import html
import math
import struct
import textwrap
import wave
from pathlib import Path
ROOT = Path(__file__).resolve().parent
INK = "#173344"
TEAL = "#a34850"
SOFT = "#fff1ed"
LINE = "#6d8490"
FONT = "DejaVu Sans, sans-serif"
def esc(value: str) -> str:
return html.escape(value, quote=True)
def label(x: float, y: float, value: str, size: float = 4.0, bold: bool = False) -> str:
weight = ' font-weight="700"' if bold else ""
return (
f'{esc(value)}'
)
def box(x: float, y: float, w: float, h: float, fill: str = "#fff") -> str:
return (
f''
)
DIAGRAMS: dict[str, tuple[str, ...]] = {
"invitation-score": (
'',
'',
'',
'',
'',
'',
),
"answer-choice": (
'',
'',
'',
'',
'',
'',
),
"choice-share": (
'',
'',
'',
'',
'',
'',
),
"smooth-change-pause": (
'',
'',
'',
'',
'',
'',
),
"maker-audience": (
'',
'',
'',
'',
'',
'',
),
"evidence-split": (
'',
'',
'',
'',
'',
'',
),
}
def diagram(name: str, index: int, y: float) -> str:
"""Broad pictogram inside each field; ordered text supplies the exact meaning."""
return (
f''
f"{DIAGRAMS[name][index]}"
)
def panel(name: str, y: float, number: int, words: str) -> str:
lines = textwrap.wrap(words, width=35)
text_lines = "\n".join(
label(31, y + 8 + 5 * i, line, 3.75, True) for i, line in enumerate(lines)
)
return "\n".join(
(
box(14, y, 182, 33),
box(18, y + 4, 9, 9, SOFT),
label(20.6, y + 10.5, str(number), 4, True),
text_lines,
diagram(name, number - 1, y),
f'',
label(31, y + 28, "Point, mark, dictate or leave blank.", 2.6),
)
)
def page(name: str, title: str, subtitle: str, fields: tuple[str, ...]) -> str:
assert len(fields) == 6
desc = "; ".join(fields)
body = "\n".join(
panel(name, 54 + i * 36, i + 1, word) for i, word in enumerate(fields)
)
if name in {"invitation-score", "smooth-change-pause"}:
upper = 54 + (1 if name == "invitation-score" else 0) * 36 + 16
lower = 54 + (3 if name == "invitation-score" else 2) * 36 + 16
body += (
f'\n'
f''
)
return f'''
'''
PAGES: tuple[tuple[str, str, str, tuple[str, ...]], ...] = (
(
"invitation-score",
"An idea can invite an answer",
"OPEN to WAIT to chosen shape is a paper score, not a floor route.",
(
"MAKER'S OWN IDEA",
"OPEN / OFFER",
"WAIT / SPACE",
"CHOSEN THIRD SHAPE",
"WHAT I WANT TO COMMUNICATE",
"PAPER / ACTUAL MOVEMENT / UNKNOWN",
),
),
(
"answer-choice",
"Answer without copying exactly",
"Put two choices side by side and name what changed.",
(
"SOURCE IDEA I NOTICED",
"MY ANSWER MAY BE DIFFERENT",
"CHANGE DIRECTION / QUALITY / PAUSE",
"TWO IDEAS SIDE BY SIDE",
"NO EXACT COPY REQUIRED",
"WHAT IS OBSERVED / UNKNOWN",
),
),
(
"choice-share",
"Choose whether to share",
"A puppet-only scene is rehearsal, not a real audience.",
(
"ASK BEFORE SHOWING",
"YES / NO / NOT NOW",
"NO REASON NEEDED",
"CHOOSE A WILLING PERSON OR PRIVATE ROUTE",
"STOP OR CHANGE AT ANY TIME",
"ACTUAL PERSON SAW / HEARD? YES / NO",
),
),
(
"smooth-change-pause",
"Smooth, change, pause",
"A scored curve is not a request to roll a body.",
(
"SMOOTH LINE ON PAPER",
"CHANGE DIRECTION ON PAPER",
"PAUSE MARK",
"CHILD-CHOSEN SAFE ACTION IF ANY",
"SOURCE: PAPER / ACTUAL / ADULT",
"WHAT THE MAKER MEANT",
),
),
(
"maker-audience",
"Who made it? Who actually saw it?",
"Record events, not an imagined listener result.",
(
"WORK TITLE + MAKER",
"ORIGINAL SCORE OR AUTHORIZED REAL WORK",
"ACTUALLY PERFORMED? DATE / NO",
"CHOSEN WILLING AUDIENCE OR PRIVATE",
"ACTUAL RESPONSE OR NO RESPONSE",
"COMMUNITY MEANING: SOURCE OR UNKNOWN",
),
),
(
"evidence-split",
"Keep the Dance sources separate",
"Private teacher record only; no child identifiers in public pages.",
(
"DATE + SCHOOL APPROVAL",
"CHILD'S PAPER IDEA + SUPPORT",
"CHILD'S ACTUAL MOVEMENT OR NOT OBSERVED",
"ACTUAL WORK / MAKER SOURCE OR NOT ENCOUNTERED",
"SHARED WITH REAL WILLING PERSON OR NOT",
"ACTUAL AUDIENCE RESPONSE OR NONE",
),
),
)
def two_note_cue() -> None:
"""Quiet, deterministic PCM cue; equivalent numbered cards need no audio."""
sample_rate = 22050
seconds = 1.5
notes = ((0.18, 0.23, 392.0), (0.86, 0.23, 523.25))
pcm = bytearray()
for index in range(round(seconds * sample_rate)):
t = index / sample_rate
value = 0.0
for start, duration, hz in notes:
relative = t - start
if 0 <= relative < duration:
envelope = min(1.0, relative / 0.025, (duration - relative) / 0.06)
value += 0.055 * envelope * math.sin(2 * math.pi * hz * relative)
pcm += struct.pack(" None:
for name, title, subtitle, fields in PAGES:
(ROOT / f"{name}.svg").write_text(
page(name, title, subtitle, fields), encoding="utf-8"
)
two_note_cue()
print(f"Generated {len(PAGES)} original A4 SVG aids and quiet PCM cue")
if __name__ == "__main__":
main()