4 Commits
Author SHA1 Message Date
Cursor Agentandchen 837fcb2751 End each fingering chart at the thumb hole.
AppImage release / appimage (push) Successful in 53s
The beak, window, and mouthpiece lines are gone. The staff stays underneath. Version 0.2.4.

Co-authored-by: catpersonisme <catpersonisme@gmail.com>
2026-10-11 11:02:53 +00:00
Cursor Agentandchen 7c988e9347 Add a New line button for another fingering row.
AppImage release / appimage (push) Successful in 49s
Each line keeps its own charts and staff. Save PNG stacks every line. Version 0.2.3.

Co-authored-by: catpersonisme <catpersonisme@gmail.com>
2026-10-11 10:14:28 +00:00
Cursor Agentandchen e51fdf8216 Write the staff one octave below sounding pitch.
AppImage release / appimage (push) Successful in 54s
Sounding C5 sits on the ledger line below the treble staff. Sharps and flats move with the note. Fingerings and the foot-up charts stay as they are. Version 0.2.2.

Co-authored-by: catpersonisme <catpersonisme@gmail.com>
2026-10-11 10:08:19 +00:00
Cursor Agentandchen dcca7f5e83 Show length on a staff under each fingering chart.
AppImage release / appimage (push) Successful in 50s
Dragging no longer selects text. The line box resizes, rests and spaces can be added, and Save PNG writes the row. Each chart keeps the foot at the top, and the treble staff shows the pitch with a notehead, stem, flags, and dots. Version 0.2.1.

Co-authored-by: catpersonisme <catpersonisme@gmail.com>
2026-10-11 09:49:17 +00:00
11 changed files with 1160 additions and 158 deletions

No files matched your search

+8 -8
View File
@@ -1,23 +1,23 @@
# Recorder fingering editor # Recorder fingering editor
A soprano recorder tool for arranging fingering charts. Drag a chart onto a line, reorder it, set how long the note lasts, or take it off. Baroque fingering is the chart. The foot, with the double holes, is at the top of each chart, and the mouthpiece is at the bottom. A soprano recorder tool for arranging fingering charts. Drag a chart, a rest, or a space onto a line, reorder it, set how long it lasts, or take it off. Resize the line box, then save the finished row as a PNG. Baroque fingering is the chart. The foot, with the double holes, is at the top of each chart. The tube ends at the thumb hole.
The usual way to run it is one Linux AppImage. That file contains the window and the fingering charts. It does not read sheet music, and it does not include oemer, ONNX, or model files. The usual way to run it is one Linux AppImage. That file contains the window and the fingering charts. It does not read sheet music, and it does not include oemer, ONNX, or model files.
## Run the AppImage ## Run the AppImage
```bash ```bash
chmod +x Recorder-Tab-Converter-0.2.0.AppImage chmod +x Recorder-Tab-Converter-0.2.4.AppImage
./Recorder-Tab-Converter-0.2.0.AppImage ./Recorder-Tab-Converter-0.2.4.AppImage
``` ```
If the file will not start because FUSE is missing: If the file will not start because FUSE is missing:
```bash ```bash
APPIMAGE_EXTRACT_AND_RUN=1 ./Recorder-Tab-Converter-0.2.0.AppImage APPIMAGE_EXTRACT_AND_RUN=1 ./Recorder-Tab-Converter-0.2.4.AppImage
``` ```
Open **Empty line**, or start from **Twinkle, opening** or **Ode, held note**. Drag any chart from C5 to D7 onto the line. Drag a placed chart to move it. Choose a duration under the chart. Remove takes a note off. Open **Empty line**, or start from **Twinkle, opening** or **Ode, held note**. Drag any chart from C5 to D7, or drag **Rest** or **Space**, onto a line. Drag a placed item to move it, including onto another line. **New line** adds a row underneath. Plus and minus change the length. Remove takes an item off. **Shorter**, **Taller**, **Narrower**, **Wider**, and the corner grip change the box. **Save PNG** downloads every line.
## Build the AppImage ## Build the AppImage
@@ -30,7 +30,7 @@ From a checkout, one command:
That installs Node packages, builds the app, and writes: That installs Node packages, builds the app, and writes:
```text ```text
dist/Recorder-Tab-Converter-0.2.0.AppImage dist/Recorder-Tab-Converter-0.2.4.AppImage
``` ```
The AppImage is not committed. Keep it under 600MB. The AppImage is not committed. Keep it under 600MB.
@@ -47,6 +47,6 @@ The dev server listens on [http://127.0.0.1:3847](http://127.0.0.1:3847).
## Fingerings ## Fingerings
Baroque (English) fingerings are the first choice on the [Dolmetsch Online chart for recorders in C](https://dolmetsch.com/textfingeringchart.htm) (Brian Blood). The soprano is treated in concert pitch: it sounds as written, low C is C5, and the chart stops at D7. Double holes 6 and 7, forked F, and the second-octave thumb pinch are included. Alternate fingerings on that chart are not shown. Baroque (English) fingerings are the first choice on the [Dolmetsch Online chart for recorders in C](https://dolmetsch.com/textfingeringchart.htm) (Brian Blood). The soprano is labeled in concert pitch: low C is C5, and the chart stops at D7. Double holes 6 and 7, forked F, and the second-octave thumb pinch are included. Alternate fingerings on that chart are not shown.
Each chart is drawn foot-up: holes 7 and 6 at the top, then 5 through 1, then the thumb, with the mouthpiece at the bottom. A filled hole is closed. An arrow after a placed chart is one more beat in 4/4. Each chart is drawn foot-up: holes 7 and 6 at the top, then 5 through 1, then the thumb. The tube ends there. A filled hole is closed. A treble staff under the holes is written one octave below the sounding pitch. Low C, labeled C5, sits on the ledger line below the staff. Sounding C6 is written C5, and sounding C7 is written C6. Length is a notehead, stem, flags, dots, and rests. Labels keep the sounding names.
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "recorder-tab-converter", "name": "recorder-tab-converter",
"version": "0.2.0", "version": "0.2.4",
"private": true, "private": true,
"description": "Arrange soprano recorder fingering charts by dragging them onto a line.", "description": "Arrange soprano recorder fingering charts by dragging them onto a line.",
"main": "electron/main.cjs", "main": "electron/main.cjs",
+6
View File
@@ -117,6 +117,12 @@
--sidebar-ring: oklch(0.556 0 0); --sidebar-ring: oklch(0.556 0 0);
} }
body.line-drag,
body.line-drag * {
user-select: none !important;
-webkit-user-select: none !important;
}
@layer base { @layer base {
* { * {
@apply border-border outline-ring/50; @apply border-border outline-ring/50;
+1 -1
View File
@@ -18,7 +18,7 @@ const display = Fraunces({
export const metadata: Metadata = { export const metadata: Metadata = {
title: "Recorder fingering editor", title: "Recorder fingering editor",
description: description:
"Drag soprano recorder fingering charts onto a line, reorder them, and set how long each note lasts.", "Drag soprano recorder fingering charts, rests, and spaces onto a line, then save the row as a PNG.",
}; };
export default function RootLayout({ children }: LayoutProps<"/">) { export default function RootLayout({ children }: LayoutProps<"/">) {
+427 -108
View File
@@ -1,41 +1,42 @@
"use client"; "use client";
import { BeatArrow, FingeringDiagram } from "@/components/fingering-diagram"; import { FingeringDiagram, RestMark } from "@/components/fingering-diagram";
import { Button } from "@/components/ui/button"; import { Button } from "@/components/ui/button";
import { DURATION_PRESETS } from "@/lib/duration"; import { DURATION_PRESETS } from "@/lib/duration";
import { downloadBlob, renderLinePng } from "@/lib/export-png";
import { CHART_NOTES, fingeringFor } from "@/lib/fingering"; import { CHART_NOTES, fingeringFor } from "@/lib/fingering";
import { import {
appendLine,
clampLineBox,
cloneLine, cloneLine,
createNote, createNote,
createRest,
createSpace,
dropIndexFromPoint, dropIndexFromPoint,
insertNote,
LINE_EXAMPLES, LINE_EXAMPLES,
moveNote, neighborDuration,
placeOnLine,
removeLine,
removeNote, removeNote,
setDuration, setDuration,
transferNote,
type LineKind,
type LineNote, type LineNote,
type ScoreLine,
} from "@/lib/line"; } from "@/lib/line";
import { extraBeatArrows } from "@/lib/score"; import { chartPixelHeight } from "@/lib/notation";
import { ChevronLeft, ChevronRight, X } from "lucide-react"; import { pngFilename, PNG_CHART_WIDTH } from "@/lib/png-layout";
import { useEffect, useRef, useState, type PointerEvent as ReactPointerEvent, type RefObject } from "react"; import { ChevronLeft, ChevronRight, Minus, Plus, X } from "lucide-react";
import { useEffect, useRef, useState, type PointerEvent as ReactPointerEvent, type ReactNode, type RefObject } from "react";
const FOUR_FOUR = { beats: 4, beatType: 4 }; const CHART_WIDTH = 44;
type Drag = type Drag = {
| { source: "palette" | "line";
source: "palette"; kind: LineKind;
pitch: string; pitch: string;
pointerId: number;
startX: number;
startY: number;
x: number;
y: number;
armed: boolean;
}
| {
source: "line";
id: string; id: string;
pitch: string; lineId: string;
pointerId: number; pointerId: number;
startX: number; startX: number;
startY: number; startY: number;
@@ -44,30 +45,46 @@ type Drag =
armed: boolean; armed: boolean;
}; };
type DropTarget = { lineId: string; index: number };
export function Editor() { export function Editor() {
const [notes, setNotes] = useState<LineNote[]>([]); const [lines, setLines] = useState<ScoreLine[]>([{ id: "line-1", notes: [] }]);
const [title, setTitle] = useState("Empty line"); const [title, setTitle] = useState("Empty line");
const [drag, setDrag] = useState<Drag | null>(null); const [drag, setDrag] = useState<Drag | null>(null);
const [dropIndex, setDropIndex] = useState<number | null>(null); const [dropTarget, setDropTarget] = useState<DropTarget | null>(null);
const [boxWidth, setBoxWidth] = useState<number | null>(null);
const [boxHeight, setBoxHeight] = useState(520);
const [saving, setSaving] = useState(false);
const [saveError, setSaveError] = useState<string | null>(null);
const dragRef = useRef<Drag | null>(null); const dragRef = useRef<Drag | null>(null);
const lineRef = useRef<HTMLDivElement>(null); const frameRef = useRef<HTMLDivElement>(null);
const paletteRef = useRef<HTMLDivElement>(null); const paletteRef = useRef<HTMLDivElement>(null);
const exportRef = useRef<HTMLDivElement>(null);
function updateDrag(next: Drag | null) { function updateDrag(next: Drag | null) {
dragRef.current = next; dragRef.current = next;
setDrag(next); setDrag(next);
if (!next) document.body.classList.remove("line-drag");
} }
useEffect(() => { useEffect(() => {
function pointIndex(clientX: number, clientY: number) { function pointTarget(clientX: number, clientY: number): DropTarget | null {
const line = lineRef.current; const rows = [...document.querySelectorAll<HTMLElement>("[data-line-id]")];
if (!line) return -1; let best: (DropTarget & { distance: number }) | null = null;
const rect = line.getBoundingClientRect(); for (const row of rows) {
const centers = [...line.querySelectorAll<HTMLElement>("[data-note-id]")].map((element) => { const lineId = row.dataset.lineId;
if (!lineId) continue;
const rect = row.getBoundingClientRect();
const centers = [...row.querySelectorAll<HTMLElement>("[data-note-id]")].map((element) => {
const box = element.getBoundingClientRect(); const box = element.getBoundingClientRect();
return box.left + box.width / 2; return box.left + box.width / 2;
}); });
return dropIndexFromPoint(clientX, clientY, rect, centers); const index = dropIndexFromPoint(clientX, clientY, rect, centers);
if (index < 0) continue;
const distance = Math.abs(clientY - (rect.top + rect.bottom) / 2);
if (!best || distance < best.distance) best = { lineId, index, distance };
}
return best ? { lineId: best.lineId, index: best.index } : null;
} }
function onMove(event: PointerEvent) { function onMove(event: PointerEvent) {
@@ -83,54 +100,133 @@ export function Editor() {
Math.abs(dx) > Math.abs(dy); Math.abs(dx) > Math.abs(dy);
if (touchScroll) { if (touchScroll) {
updateDrag(null); updateDrag(null);
setDropIndex(null); setDropTarget(null);
return; return;
} }
if (Math.hypot(dx, dy) < 8) return; if (Math.hypot(dx, dy) < 8) return;
} }
if (lineRef.current) { window.getSelection()?.removeAllRanges();
const rect = lineRef.current.getBoundingClientRect(); const rows = [...document.querySelectorAll<HTMLElement>("[data-line-id]")];
if (event.clientX > rect.right - 28) lineRef.current.scrollLeft += 14; for (const candidate of rows) {
if (event.clientX < rect.left + 28) lineRef.current.scrollLeft -= 14; const rect = candidate.getBoundingClientRect();
const verticallyNear = event.clientY >= rect.top - 36 && event.clientY <= rect.bottom + 36;
if (!verticallyNear) continue;
if (event.clientX > rect.right - 28) candidate.scrollLeft += 14;
if (event.clientX < rect.left + 28) candidate.scrollLeft -= 14;
} }
const next = { ...current, x: event.clientX, y: event.clientY, armed: true }; const next = { ...current, x: event.clientX, y: event.clientY, armed: true };
updateDrag(next); updateDrag(next);
const index = pointIndex(event.clientX, event.clientY); setDropTarget(pointTarget(event.clientX, event.clientY));
setDropIndex(index >= 0 ? index : null);
} }
function onUp(event: PointerEvent) { function onUp(event: PointerEvent) {
const current = dragRef.current; const current = dragRef.current;
if (!current || event.pointerId !== current.pointerId) return; if (!current || event.pointerId !== current.pointerId) return;
const index = current.armed ? pointIndex(event.clientX, event.clientY) : -1; const target = current.armed ? pointTarget(event.clientX, event.clientY) : null;
if (current.armed && index >= 0) { if (current.armed && target) {
if (current.source === "palette") { if (current.source === "palette") {
setNotes((existing) => insertNote(existing, index, createNote(current.pitch))); const note =
current.kind === "rest"
? createRest()
: current.kind === "space"
? createSpace()
: createNote(current.pitch);
setLines((existing) => placeOnLine(existing, target.lineId, target.index, note));
setTitle("Your line"); setTitle("Your line");
} else { } else {
setNotes((existing) => moveNote(existing, current.id, index)); setLines((existing) => transferNote(existing, current.lineId, current.id, target.lineId, target.index));
} }
} }
updateDrag(null); updateDrag(null);
setDropIndex(null); setDropTarget(null);
}
function onSelectStart(event: Event) {
if (dragRef.current) event.preventDefault();
} }
window.addEventListener("pointermove", onMove); window.addEventListener("pointermove", onMove);
window.addEventListener("pointerup", onUp); window.addEventListener("pointerup", onUp);
window.addEventListener("pointercancel", onUp); window.addEventListener("pointercancel", onUp);
document.addEventListener("selectstart", onSelectStart);
return () => { return () => {
window.removeEventListener("pointermove", onMove); window.removeEventListener("pointermove", onMove);
window.removeEventListener("pointerup", onUp); window.removeEventListener("pointerup", onUp);
window.removeEventListener("pointercancel", onUp); window.removeEventListener("pointercancel", onUp);
document.removeEventListener("selectstart", onSelectStart);
document.body.classList.remove("line-drag");
}; };
}, []); }, []);
function beginDrag(event: ReactPointerEvent, next: Drag) { function beginDrag(event: ReactPointerEvent, next: Drag) {
if (event.button !== 0 && event.pointerType === "mouse") return; if (event.pointerType === "mouse" && event.button !== 0) return;
if (event.pointerType === "mouse") event.preventDefault();
window.getSelection()?.removeAllRanges();
document.body.classList.add("line-drag");
updateDrag(next); updateDrag(next);
} }
const ghostPitch = drag?.armed ? drag.pitch : null; function pageLimit() {
return frameRef.current?.parentElement?.clientWidth ?? 960;
}
function nudgeBox(dw: number, dh: number) {
const maxWidth = pageLimit();
const current = boxWidth ?? frameRef.current?.getBoundingClientRect().width ?? maxWidth;
const next = clampLineBox(current + dw, boxHeight + dh, maxWidth);
setBoxWidth(next.width);
setBoxHeight(next.height);
}
function startResize(event: ReactPointerEvent) {
if (event.pointerType === "mouse" && event.button !== 0) return;
event.preventDefault();
event.stopPropagation();
document.body.classList.add("line-drag");
const startX = event.clientX;
const startY = event.clientY;
const startW = frameRef.current?.getBoundingClientRect().width ?? 640;
const startH = boxHeight;
const maxWidth = pageLimit();
function move(moveEvent: PointerEvent) {
const next = clampLineBox(
startW + (moveEvent.clientX - startX),
startH + (moveEvent.clientY - startY),
maxWidth,
);
setBoxWidth(next.width);
setBoxHeight(next.height);
}
function up() {
document.body.classList.remove("line-drag");
window.removeEventListener("pointermove", move);
window.removeEventListener("pointerup", up);
window.removeEventListener("pointercancel", up);
}
window.addEventListener("pointermove", move);
window.addEventListener("pointerup", up);
window.addEventListener("pointercancel", up);
}
async function savePng() {
const filled = lines.some((line) => line.notes.length > 0);
if (!exportRef.current || !filled) {
setSaveError("Add a note, rest, or space before saving a PNG.");
return;
}
setSaving(true);
setSaveError(null);
try {
const blob = await renderLinePng(exportRef.current, title);
downloadBlob(blob, pngFilename(title));
} catch (error) {
setSaveError(error instanceof Error ? error.message : "Could not save the PNG.");
} finally {
setSaving(false);
}
}
const ghost = drag?.armed ? drag : null;
return ( return (
<div className="mx-auto flex w-full max-w-6xl flex-col gap-6 px-4 py-6 md:px-8 md:py-10"> <div className="mx-auto flex w-full max-w-6xl flex-col gap-6 px-4 py-6 md:px-8 md:py-10">
@@ -138,17 +234,19 @@ export function Editor() {
<p className="text-sm tracking-[0.16em] text-[#6a4328] uppercase">Soprano in C · Baroque</p> <p className="text-sm tracking-[0.16em] text-[#6a4328] uppercase">Soprano in C · Baroque</p>
<h1 className="font-heading text-4xl leading-tight md:text-5xl">Recorder fingering editor</h1> <h1 className="font-heading text-4xl leading-tight md:text-5xl">Recorder fingering editor</h1>
<p className="max-w-2xl text-base leading-7 text-muted-foreground"> <p className="max-w-2xl text-base leading-7 text-muted-foreground">
Drag a chart from the palette onto the line. Drag a placed chart sideways to reorder it, set Drag a chart, a rest, or a space onto a line. Drag a placed item sideways to reorder it, or
how long it lasts, or take it off. The foot, with the double holes, stays at the top. onto another line. New line adds a row underneath. The staff under the holes shows the pitch
and the length. Resize the box, then save every line as a PNG. The foot, with the double holes,
stays at the top.
</p> </p>
</header> </header>
<div className="flex flex-wrap gap-2"> <div className="flex flex-wrap gap-2">
<Button <Button
type="button" type="button"
variant={notes.length === 0 ? "default" : "outline"} variant={lines.length === 1 && lines[0].notes.length === 0 ? "default" : "outline"}
onClick={() => { onClick={() => {
setNotes([]); setLines([{ id: "line-1", notes: [] }]);
setTitle("Empty line"); setTitle("Empty line");
}} }}
> >
@@ -160,7 +258,7 @@ export function Editor() {
type="button" type="button"
variant="outline" variant="outline"
onClick={() => { onClick={() => {
setNotes(cloneLine([...example.notes])); setLines([{ id: "line-1", notes: cloneLine([...example.notes]) }]);
setTitle(example.title); setTitle(example.title);
}} }}
> >
@@ -174,24 +272,68 @@ export function Editor() {
<div> <div>
<h2 className="font-heading text-2xl">Palette</h2> <h2 className="font-heading text-2xl">Palette</h2>
<p className="text-sm text-muted-foreground"> <p className="text-sm text-muted-foreground">
C5 through D7. Drag a chart downward onto the line. Swipe the row sideways to see the rest. C5 through D7, plus a rest and a space. Drag downward onto the line. Swipe the row sideways
to see the rest of the charts.
</p> </p>
</div> </div>
<ScrollButtons target={paletteRef} label="palette" /> <ScrollButtons target={paletteRef} label="palette" />
</div> </div>
<div <div
ref={paletteRef} ref={paletteRef}
className="flex gap-2 overflow-x-auto rounded-2xl bg-card p-3 ring-1 ring-foreground/10" className="flex gap-2 overflow-x-auto rounded-2xl bg-card p-3 ring-1 ring-foreground/10 select-none"
> >
{CHART_NOTES.map((pitch) => ( <PaletteToken
<div label="Rest"
key={pitch}
data-palette-pitch={pitch}
className="flex w-14 shrink-0 cursor-grab touch-pan-x flex-col items-center gap-1 active:cursor-grabbing"
onPointerDown={(event) => onPointerDown={(event) =>
beginDrag(event, { beginDrag(event, {
source: "palette", source: "palette",
kind: "rest",
pitch: "",
id: "",
lineId: "",
pointerId: event.pointerId,
startX: event.clientX,
startY: event.clientY,
x: event.clientX,
y: event.clientY,
armed: false,
})
}
>
<RestMark quarters={1} width={40} />
</PaletteToken>
<PaletteToken
label="Space"
onPointerDown={(event) =>
beginDrag(event, {
source: "palette",
kind: "space",
pitch: "",
id: "",
lineId: "",
pointerId: event.pointerId,
startX: event.clientX,
startY: event.clientY,
x: event.clientX,
y: event.clientY,
armed: false,
})
}
>
<SpaceGlyph width={40} height={chartPixelHeight(40)} />
</PaletteToken>
{CHART_NOTES.map((pitch) => (
<PaletteToken
key={pitch}
label={pitch}
pitch={pitch}
onPointerDown={(event) =>
beginDrag(event, {
source: "palette",
kind: "note",
pitch, pitch,
id: "",
lineId: "",
pointerId: event.pointerId, pointerId: event.pointerId,
startX: event.clientX, startX: event.clientX,
startY: event.clientY, startY: event.clientY,
@@ -202,45 +344,106 @@ export function Editor() {
} }
> >
<FingeringDiagram fingering={fingeringFor(pitch, "baroque")} pitch={pitch} size="sm" /> <FingeringDiagram fingering={fingeringFor(pitch, "baroque")} pitch={pitch} size="sm" />
<span className="text-[11px] leading-none font-medium">{pitch}</span> </PaletteToken>
</div>
))} ))}
</div> </div>
</section> </section>
<section className="space-y-3"> <section className="space-y-3">
<div className="flex items-end justify-between gap-3"> <div className="flex flex-wrap items-end justify-between gap-3">
<div> <div>
<h2 className="font-heading text-2xl">{title}</h2> <h2 className="font-heading text-2xl">{title}</h2>
<p className="text-sm text-muted-foreground"> <p className="text-sm text-muted-foreground">
4/4. An arrow after a chart is one more beat. A dotted value keeps its name under the chart. Treble staff written an octave below the sounding pitch, 4/4. Noteheads, stems, flags, and dots show the length. Plus and minus
change it. A space is empty room you can still drag. The box is {boxHeight}px tall
{boxWidth ? `, ${boxWidth}px wide` : ""}.
</p> </p>
</div> </div>
<ScrollButtons target={lineRef} label="line" /> <ScrollButtons
label="lines"
onLeft={() =>
document.querySelectorAll<HTMLElement>("[data-line-id]").forEach((row) => row.scrollBy({ left: -180, behavior: "smooth" }))
}
onRight={() =>
document.querySelectorAll<HTMLElement>("[data-line-id]").forEach((row) => row.scrollBy({ left: 180, behavior: "smooth" }))
}
/>
</div> </div>
<div className="flex flex-wrap gap-2">
<Button type="button" variant="outline" size="sm" onClick={() => nudgeBox(0, -48)}>
Shorter
</Button>
<Button type="button" variant="outline" size="sm" onClick={() => nudgeBox(0, 48)}>
Taller
</Button>
<Button type="button" variant="outline" size="sm" onClick={() => nudgeBox(-80, 0)}>
Narrower
</Button>
<Button type="button" variant="outline" size="sm" onClick={() => nudgeBox(80, 0)}>
Wider
</Button>
<Button type="button" variant="outline" size="sm" onClick={() => setBoxWidth(null)}>
Fit width
</Button>
<Button
type="button"
variant="outline"
size="sm"
onClick={() => {
setLines((existing) => appendLine(existing));
setBoxHeight((height) => clampLineBox(400, height + 260, 960).height);
}}
>
New line
</Button>
<Button type="button" size="sm" onClick={savePng} disabled={lines.every((line) => line.notes.length === 0) || saving}>
{saving ? "Saving…" : "Save PNG"}
</Button>
</div>
{saveError ? <p className="text-sm text-destructive">{saveError}</p> : null}
<div ref={frameRef} className="relative max-w-full" style={{ width: boxWidth ?? "100%", height: boxHeight }}>
<div <div
ref={lineRef}
data-line data-line
className={`min-h-64 overflow-x-auto rounded-none border-2 bg-card px-3 py-4 ${ className={`flex h-full flex-col gap-4 overflow-auto rounded-none border-2 bg-card px-3 py-4 select-none ${
dropIndex !== null ? "border-primary" : "border-foreground" dropTarget !== null ? "border-primary" : "border-foreground"
}`} }`}
> >
{notes.length === 0 ? ( {lines.map((line, lineIndex) => (
<p className="px-2 py-16 text-center text-sm text-muted-foreground"> <div key={line.id} className="space-y-2">
Drop a fingering here. The line is empty. <div className="flex items-center justify-between gap-2">
<p className="text-sm font-medium">Line {lineIndex + 1}</p>
{lines.length > 1 ? (
<Button
type="button"
variant="ghost"
size="xs"
aria-label={`Remove line ${lineIndex + 1}`}
onClick={() => setLines((existing) => removeLine(existing, line.id))}
>
<X />
Remove line
</Button>
) : null}
</div>
<div data-line-id={line.id} className="overflow-x-auto">
{line.notes.length === 0 ? (
<p className="px-2 py-10 text-center text-sm text-muted-foreground">
Drop a fingering, a rest, or a space here. The line is empty.
</p> </p>
) : ( ) : (
<div className="flex w-max min-w-full items-end gap-2"> <div className="flex w-max min-w-full items-end gap-2">
{notes.map((note, index) => ( {line.notes.map((note, index) => (
<div key={note.id} className="flex items-end gap-2"> <div key={note.id} className="flex items-end gap-2">
{dropIndex === index ? <DropCaret /> : null} {dropTarget?.lineId === line.id && dropTarget.index === index ? <DropCaret /> : null}
<PlacedNote <PlacedItem
note={note} note={note}
dimmed={drag?.source === "line" && drag.armed && drag.id === note.id} dimmed={drag?.source === "line" && drag.armed && drag.id === note.id}
onPointerDown={(event) => onPointerDown={(event) =>
beginDrag(event, { beginDrag(event, {
source: "line", source: "line",
kind: note.kind,
id: note.id, id: note.id,
lineId: line.id,
pitch: note.pitch, pitch: note.pitch,
pointerId: event.pointerId, pointerId: event.pointerId,
startX: event.clientX, startX: event.clientX,
@@ -253,41 +456,131 @@ export function Editor() {
onDuration={(quarters) => { onDuration={(quarters) => {
const preset = DURATION_PRESETS.find((item) => item.quarters === quarters); const preset = DURATION_PRESETS.find((item) => item.quarters === quarters);
if (!preset) return; if (!preset) return;
setNotes((existing) => setDuration(existing, note.id, preset)); setLines((existing) =>
existing.map((row) =>
row.id === line.id ? { ...row, notes: setDuration(row.notes, note.id, preset) } : row,
),
);
}} }}
onRemove={() => setNotes((existing) => removeNote(existing, note.id))} onRemove={() =>
setLines((existing) =>
existing.map((row) =>
row.id === line.id ? { ...row, notes: removeNote(row.notes, note.id) } : row,
),
)
}
/> />
</div> </div>
))} ))}
{dropIndex === notes.length ? <DropCaret /> : null} {dropTarget?.lineId === line.id && dropTarget.index === line.notes.length ? <DropCaret /> : null}
</div> </div>
)} )}
</div> </div>
</div>
))}
</div>
<div
role="slider"
tabIndex={0}
aria-label="Drag to resize the line box"
aria-valuemin={200}
aria-valuemax={880}
aria-valuenow={boxHeight}
aria-valuetext={`${boxWidth ? `${boxWidth} pixels wide` : "full width"}, ${boxHeight} pixels tall`}
className="absolute right-0 bottom-0 z-10 flex h-8 w-8 cursor-nwse-resize touch-none items-end justify-end p-1"
onPointerDown={startResize}
onKeyDown={(event) => {
if (event.key === "ArrowUp") nudgeBox(0, -48);
if (event.key === "ArrowDown") nudgeBox(0, 48);
if (event.key === "ArrowLeft") nudgeBox(-80, 0);
if (event.key === "ArrowRight") nudgeBox(80, 0);
}}
>
<span className="block h-3 w-3 border-r-2 border-b-2 border-foreground" aria-hidden />
</div>
</div>
</section> </section>
<ul className="flex flex-wrap gap-x-4 gap-y-1 text-xs text-muted-foreground"> <ul className="flex flex-wrap gap-x-4 gap-y-1 text-xs text-muted-foreground">
<li>Foot at the top, mouthpiece at the bottom</li> <li>Foot at the top. The tube ends at the thumb hole</li>
<li>Filled hole: closed</li> <li>Filled hole: closed</li>
<li>Empty hole: open</li> <li>Empty hole: open</li>
<li>One of a pair filled: half-hole</li> <li>One of a pair filled: half-hole</li>
<li>Thumb half-filled: pinch</li> <li>Thumb half-filled: pinch</li>
<li>Arrow: one more beat</li> <li>Staff under the chart: pitch and length</li>
<li>Rest: silence on the staff</li>
<li>Space: empty room</li>
</ul> </ul>
{ghostPitch ? ( {ghost ? (
<div <div
className="pointer-events-none fixed z-50 opacity-90" className="pointer-events-none fixed z-50 opacity-90 select-none"
style={{ left: drag!.x - 22, top: drag!.y - 80 }} style={{ left: ghost.x - 22, top: ghost.y - 80 }}
aria-hidden aria-hidden
> >
<FingeringDiagram fingering={fingeringFor(ghostPitch, "baroque")} pitch={ghostPitch} size="sm" /> {ghost.kind === "note" ? (
<FingeringDiagram fingering={fingeringFor(ghost.pitch, "baroque")} pitch={ghost.pitch} size="sm" />
) : null}
{ghost.kind === "rest" ? <RestMark quarters={1} width={40} /> : null}
{ghost.kind === "space" ? <SpaceGlyph width={40} height={chartPixelHeight(40)} /> : null}
</div> </div>
) : null} ) : null}
<div ref={exportRef} className="pointer-events-none absolute h-px w-px overflow-hidden" aria-hidden>
{lines.map((line) => (
<div key={line.id} data-export-line={line.id}>
{line.notes.map((note) => (
<div
key={note.id}
data-export-slot
data-kind={note.kind}
data-quarters={note.quarters}
data-duration={note.label}
data-pitch={note.pitch}
>
{note.kind === "note" ? (
<FingeringDiagram
fingering={fingeringFor(note.pitch, "baroque")}
pitch={note.pitch}
quarters={note.quarters}
width={PNG_CHART_WIDTH}
/>
) : null}
{note.kind === "rest" ? <RestMark quarters={note.quarters} width={PNG_CHART_WIDTH} /> : null}
</div>
))}
</div>
))}
</div>
</div> </div>
); );
} }
function PlacedNote({ function PaletteToken({
label,
pitch,
onPointerDown,
children,
}: {
label: string;
pitch?: string;
onPointerDown: (event: ReactPointerEvent) => void;
children: ReactNode;
}) {
return (
<div
data-palette-pitch={pitch}
className="flex w-14 shrink-0 cursor-grab touch-pan-x flex-col items-center gap-1 select-none active:cursor-grabbing"
onPointerDown={onPointerDown}
onDragStart={(event) => event.preventDefault()}
>
{children}
<span className="text-[11px] leading-none font-medium">{label}</span>
</div>
);
}
function PlacedItem({
note, note,
dimmed, dimmed,
onPointerDown, onPointerDown,
@@ -300,45 +593,55 @@ function PlacedNote({
onDuration: (quarters: number) => void; onDuration: (quarters: number) => void;
onRemove: () => void; onRemove: () => void;
}) { }) {
const fingering = fingeringFor(note.pitch, "baroque"); const fingering = note.kind === "note" ? fingeringFor(note.pitch, "baroque") : null;
const arrows = extraBeatArrows(note.quarters, FOUR_FOUR); const caption = note.kind === "note" ? note.pitch : note.kind === "rest" ? "Rest" : "Space";
const chartHeight = chartPixelHeight(CHART_WIDTH);
const shorter = neighborDuration(note.quarters, -1);
const longer = neighborDuration(note.quarters, 1);
return ( return (
<div data-note-id={note.id} className={`flex flex-col items-center gap-1 ${dimmed ? "opacity-40" : ""}`}> <div data-note-id={note.id} className={`flex flex-col items-center gap-1 select-none ${dimmed ? "opacity-40" : ""}`}>
<div <div
className="flex cursor-grab touch-none items-center gap-1 active:cursor-grabbing" className="flex cursor-grab touch-none items-center gap-1 active:cursor-grabbing"
onPointerDown={onPointerDown} onPointerDown={onPointerDown}
onDragStart={(event) => event.preventDefault()}
> >
<FingeringDiagram fingering={fingering} pitch={note.pitch} /> {note.kind === "note" ? (
{arrows > 0 ? ( <FingeringDiagram fingering={fingering} pitch={note.pitch} quarters={note.quarters} />
<span className="flex items-center gap-1" aria-hidden> ) : null}
{Array.from({ length: arrows }, (_, index) => ( {note.kind === "rest" ? <RestMark quarters={note.quarters} width={CHART_WIDTH} /> : null}
<BeatArrow key={index} /> {note.kind === "space" ? (
))} <SpaceGlyph width={Math.max(36, Math.round(CHART_WIDTH * note.quarters))} height={chartHeight} />
</span>
) : null} ) : null}
</div> </div>
<p className="text-[11px] leading-none font-medium">{note.pitch}</p> <p className="text-[11px] leading-none font-medium">{caption}</p>
<label className="sr-only" htmlFor={`duration-${note.id}`}> <div className="flex items-center gap-1">
Duration for {note.pitch} <Button
</label> type="button"
<select variant="outline"
id={`duration-${note.id}`} size="icon-xs"
className="h-8 w-[4.5rem] rounded-md border border-input bg-card px-1 text-[11px]" aria-label={`Make ${caption} shorter`}
value={String(note.quarters)} disabled={!shorter}
onChange={(event) => onDuration(Number(event.target.value))} onClick={() => shorter && onDuration(shorter.quarters)}
onPointerDown={(event) => event.stopPropagation()} onPointerDown={(event) => event.stopPropagation()}
> >
{DURATION_PRESETS.map((preset) => ( <Minus />
<option key={preset.label} value={preset.quarters}> </Button>
{preset.label} <Button
</option> type="button"
))} variant="outline"
</select> size="icon-xs"
aria-label={`Make ${caption} longer`}
disabled={!longer}
onClick={() => longer && onDuration(longer.quarters)}
onPointerDown={(event) => event.stopPropagation()}
>
<Plus />
</Button>
<Button <Button
type="button" type="button"
variant="ghost" variant="ghost"
size="xs" size="xs"
aria-label={`Remove ${note.pitch}`} aria-label={`Remove ${caption}`}
onClick={onRemove} onClick={onRemove}
onPointerDown={(event) => event.stopPropagation()} onPointerDown={(event) => event.stopPropagation()}
> >
@@ -346,6 +649,18 @@ function PlacedNote({
Remove Remove
</Button> </Button>
</div> </div>
</div>
);
}
function SpaceGlyph({ width, height }: { width: number; height: number }) {
return (
<div
className="rounded-md border border-dashed border-foreground/35 bg-muted/50"
style={{ width, height }}
role="img"
aria-label="Space"
/>
); );
} }
@@ -356,9 +671,13 @@ function DropCaret() {
function ScrollButtons({ function ScrollButtons({
target, target,
label, label,
onLeft,
onRight,
}: { }: {
target: RefObject<HTMLDivElement | null>; target?: RefObject<HTMLDivElement | null>;
label: string; label: string;
onLeft?: () => void;
onRight?: () => void;
}) { }) {
return ( return (
<div className="flex shrink-0 gap-1"> <div className="flex shrink-0 gap-1">
@@ -367,7 +686,7 @@ function ScrollButtons({
variant="outline" variant="outline"
size="icon-sm" size="icon-sm"
aria-label={`Scroll ${label} left`} aria-label={`Scroll ${label} left`}
onClick={() => target.current?.scrollBy({ left: -180, behavior: "smooth" })} onClick={() => onLeft?.() ?? target?.current?.scrollBy({ left: -180, behavior: "smooth" })}
> >
<ChevronLeft /> <ChevronLeft />
</Button> </Button>
@@ -376,7 +695,7 @@ function ScrollButtons({
variant="outline" variant="outline"
size="icon-sm" size="icon-sm"
aria-label={`Scroll ${label} right`} aria-label={`Scroll ${label} right`}
onClick={() => target.current?.scrollBy({ left: 180, behavior: "smooth" })} onClick={() => onRight?.() ?? target?.current?.scrollBy({ left: 180, behavior: "smooth" })}
> >
<ChevronRight /> <ChevronRight />
</Button> </Button>
+230 -39
View File
@@ -1,8 +1,22 @@
import { durationLabel } from "@/lib/duration";
import { import {
fingeringMarks, fingeringMarks,
fingeringProse, fingeringProse,
type Fingering, type Fingering,
} from "@/lib/fingering"; } from "@/lib/fingering";
import {
CHART_VB_H,
CHART_VB_W,
chartPixelHeight,
dotIndex,
ledgerIndexes,
noteValue,
restValue,
staffPlacement,
staffY,
STAFF_SPACE,
stemDown,
} from "@/lib/notation";
type HoleState = Fingering["holes"][number]; type HoleState = Fingering["holes"][number];
@@ -10,8 +24,8 @@ const TUBE = "#9deaf3";
const INK = "#1a1a1a"; const INK = "#1a1a1a";
/** /**
* Foot at the top, mouthpiece at the bottom. * Foot at the top. The tube ends at the thumb hole.
* The drawing is the reverse of a held recorder. Hole states are not changed. * Hole states are not changed.
*/ */
function Hole({ function Hole({
cx, cx,
@@ -43,13 +57,17 @@ export function FingeringDiagram({
fingering, fingering,
pitch, pitch,
size = "lead", size = "lead",
width: widthOverride,
quarters = 1,
}: { }: {
fingering: Fingering | null; fingering: Fingering | null;
pitch: string; pitch: string;
size?: "lead" | "sm"; size?: "lead" | "sm";
width?: number;
quarters?: number;
}) { }) {
const width = size === "lead" ? 44 : 40; const width = widthOverride ?? (size === "lead" ? 44 : 40);
const height = Math.round(width * (188 / 48)); const height = chartPixelHeight(width);
if (!fingering) { if (!fingering) {
return ( return (
<div <div
@@ -64,11 +82,12 @@ export function FingeringDiagram({
} }
const [h1, h2, h3, h4, h5, h6a, h6b, h7a, h7b] = fingering.holes; const [h1, h2, h3, h4, h5, h6a, h6b, h7a, h7b] = fingering.holes;
const label = `${pitch}. Foot at the top, mouthpiece at the bottom. ${fingeringProse(fingering)}. ${fingeringMarks(fingering).join(", ")}`; const value = noteValue(quarters);
const label = `${pitch}, written one octave lower, ${durationLabel(quarters)} on the treble staff. Foot at the top. The tube ends at the thumb hole. ${fingeringProse(fingering)}. ${fingeringMarks(fingering).join(", ")}`;
return ( return (
<svg <svg
viewBox="0 0 48 188" viewBox={`0 0 ${CHART_VB_W} ${CHART_VB_H}`}
width={width} width={width}
height={height} height={height}
role="img" role="img"
@@ -76,7 +95,7 @@ export function FingeringDiagram({
className="shrink-0" className="shrink-0"
> >
<path <path
d="M9 3 H33 V148 H44 V184 H9 Z" d="M9 3 H33 V150 H9 Z"
fill={TUBE} fill={TUBE}
stroke={INK} stroke={INK}
strokeWidth="1.4" strokeWidth="1.4"
@@ -95,56 +114,228 @@ export function FingeringDiagram({
<Hole cx={21} cy={118} r={4.7} state={h1} /> <Hole cx={21} cy={118} r={4.7} state={h1} />
<line x1="9" y1="130" x2="33" y2="130" stroke={INK} strokeWidth="1" /> <line x1="9" y1="130" x2="33" y2="130" stroke={INK} strokeWidth="1" />
<Hole cx={21} cy={140} r={4.5} state={fingering.thumb} /> <Hole cx={21} cy={140} r={4.5} state={fingering.thumb} />
<line x1="9" y1="156" x2="44" y2="156" stroke={INK} strokeWidth="1" /> <Staff pitch={pitch} />
<line x1="9" y1="166" x2="44" y2="166" stroke={INK} strokeWidth="1" /> <NoteOnStaff pitch={pitch} head={value.head} stem={value.stem} flags={value.flags} dots={value.dots} />
<line x1="9" y1="176" x2="44" y2="176" stroke={INK} strokeWidth="1" />
<ellipse cx="26" cy="166" rx="3.2" ry="4.4" fill={TUBE} stroke={INK} strokeWidth="1.2" transform="rotate(-24 26 166)" />
</svg> </svg>
); );
} }
export function BeatArrow() { export function RestMark({ quarters = 1, width = 44 }: { quarters?: number; width?: number }) {
const height = chartPixelHeight(width);
const value = restValue(quarters);
return ( return (
<svg viewBox="0 0 28 22" width={26} height={20} aria-hidden className="shrink-0"> <svg
<path d="M1 7h12V2l14 9-14 9v-5H1z" fill={INK} /> viewBox={`0 0 ${CHART_VB_W} ${CHART_VB_H}`}
width={width}
height={height}
className="shrink-0"
role="img"
aria-label={`${durationLabel(quarters)} rest on the treble staff`}
data-rest={value.rest}
data-dots={value.dots}
>
<Staff />
<RestOnStaff rest={value.rest} dots={value.dots} />
</svg> </svg>
); );
} }
export function RestMark({ label, width = 44 }: { label: string; width?: number }) { const NOTE_X = 31;
const height = Math.round(width * (188 / 48));
const kind = label.includes("whole") function Staff({ pitch }: { pitch?: string }) {
? "whole" return (
: label.includes("half") <g data-staff={pitch ?? "rest"} aria-hidden>
? "half" {[0, 2, 4, 6, 8].map((index) => (
: label.includes("sixteenth") <line
? "sixteenth" key={index}
: label.includes("eighth") x1={1.5}
? "eighth" x2={46.5}
: "quarter"; y1={staffY(index)}
y2={staffY(index)}
stroke={INK}
strokeWidth={0.7}
/>
))}
<TrebleClef />
</g>
);
}
function TrebleClef() {
const y = staffY(2);
return ( return (
<svg viewBox="0 0 48 188" width={width} height={height} className="shrink-0" role="img" aria-label={`${label} rest`}>
<line x1="8" y1="94" x2="40" y2="94" stroke="#8a8174" strokeWidth="1.5" />
{kind === "whole" ? <rect x="14" y="78" width="20" height="12" rx="1" fill={INK} /> : null}
{kind === "half" ? <rect x="14" y="94" width="20" height="12" rx="1" fill={INK} /> : null}
{kind === "quarter" ? (
<path <path
d="M26 62c7 7 7 12 0 18s-7 10 2 17 8 8 3 15" d={`M 7.4 ${y - 10.5}
C 10.6 ${y - 12.2} 12.4 ${y - 8.2} 11.2 ${y - 5.2}
C 10 ${y - 2.4} 7.2 ${y - 1.6} 6.8 ${y + 1.2}
C 6.2 ${y + 4.6} 8.8 ${y + 6.2} 10.2 ${y + 3.6}
C 11.4 ${y + 1.2} 9.2 ${y - 0.6} 7.6 ${y + 0.8}
C 6.8 ${y + 1.6} 7 ${y + 4.2} 8.4 ${y + 7.4}
C 9.6 ${y + 11.2} 10.2 ${y + 15} 8.6 ${y + 17.6}
C 7 ${y + 20.2} 4.2 ${y + 18.6} 4.8 ${y + 15.4}
C 5.2 ${y + 13.2} 7.6 ${y + 13.6} 8 ${y + 15.8}`}
fill="none" fill="none"
stroke={INK} stroke={INK}
strokeWidth="3.2" strokeWidth={1.45}
strokeLinecap="round" strokeLinecap="round"
strokeLinejoin="round"
/> />
);
}
function NoteOnStaff({
pitch,
head,
stem,
flags,
dots,
}: {
pitch: string;
head: "open" | "filled";
stem: boolean;
flags: 0 | 1 | 2;
dots: 0 | 1;
}) {
const placed = staffPlacement(pitch);
if (!placed) return null;
const y = staffY(placed.index);
const down = stemDown(placed.index);
const stemX = NOTE_X + (down ? -1.55 : 1.55);
const stemEnd = y + (down ? 1 : -1) * STAFF_SPACE * 3.5;
return (
<g data-pitch={pitch} data-head={head} data-flags={flags} data-dots={dots} data-stem={stem ? (down ? "down" : "up") : "none"}>
{ledgerIndexes(placed.index).map((index) => (
<line
key={index}
x1={NOTE_X - 5.2}
x2={NOTE_X + 5.2}
y1={staffY(index)}
y2={staffY(index)}
stroke={INK}
strokeWidth={0.7}
/>
))}
{placed.accidental === "sharp" ? <Sharp x={NOTE_X - 7.2} y={y} /> : null}
{placed.accidental === "flat" ? <Flat x={NOTE_X - 7.4} y={y} /> : null}
{stem ? (
<line x1={stemX} y1={y} x2={stemX} y2={stemEnd} stroke={INK} strokeWidth={0.7} strokeLinecap="butt" />
) : null} ) : null}
{kind === "eighth" || kind === "sixteenth" ? ( <ellipse
cx={NOTE_X}
cy={y}
rx={3.15}
ry={2.05}
transform={`rotate(-18 ${NOTE_X} ${y})`}
fill={head === "filled" ? INK : "var(--card)"}
stroke={INK}
strokeWidth={0.75}
/>
{stem && flags > 0 ? <Flag x={stemX} y={stemEnd} down={down} /> : null}
{stem && flags > 1 ? <Flag x={stemX} y={stemEnd + (down ? -STAFF_SPACE * 0.85 : STAFF_SPACE * 0.85)} down={down} /> : null}
{dots > 0 ? <Dot x={NOTE_X + 5.4} index={dotIndex(placed.index)} /> : null}
</g>
);
}
function RestOnStaff({ rest, dots }: { rest: "whole" | "half" | "quarter" | "eighth" | "sixteenth"; dots: 0 | 1 }) {
const x = NOTE_X;
return (
<g data-rest={rest} data-dots={dots}>
{rest === "whole" ? (
<rect x={x - 2.4} y={staffY(6)} width={4.8} height={STAFF_SPACE * 0.48} fill={INK} />
) : null}
{rest === "half" ? (
<rect x={x - 2.4} y={staffY(4) - STAFF_SPACE * 0.48} width={4.8} height={STAFF_SPACE * 0.48} fill={INK} />
) : null}
{rest === "quarter" ? <QuarterRest x={x} /> : null}
{rest === "eighth" || rest === "sixteenth" ? <EighthRest x={x} flags={rest === "sixteenth" ? 2 : 1} /> : null}
{dots > 0 ? <Dot x={x + 6.2} index={5} /> : null}
</g>
);
}
function Dot({ x, index }: { x: number; index: number }) {
return <circle cx={x} cy={staffY(index)} r={0.72} fill={INK} />;
}
function Sharp({ x, y }: { x: number; y: number }) {
return (
<g stroke={INK} strokeLinecap="square">
<line x1={x - 1.15} y1={y - 3.3} x2={x - 1.15} y2={y + 3.1} strokeWidth={0.55} />
<line x1={x + 1.15} y1={y - 3.7} x2={x + 1.15} y2={y + 2.7} strokeWidth={0.55} />
<line x1={x - 2.5} y1={y - 0.55} x2={x + 2.5} y2={y - 1.45} strokeWidth={0.95} />
<line x1={x - 2.5} y1={y + 1.55} x2={x + 2.5} y2={y + 0.65} strokeWidth={0.95} />
</g>
);
}
function Flat({ x, y }: { x: number; y: number }) {
return (
<path
d={`M ${x} ${y - 4.8} V ${y + 1.7}
C ${x + 2.8} ${y + 1.5} ${x + 3.1} ${y - 1.5} ${x} ${y - 1.15} Z`}
fill={INK}
/>
);
}
function Flag({ x, y, down }: { x: number; y: number; down: boolean }) {
const dir = down ? -1 : 1;
return (
<path
d={`M ${x} ${y}
c ${3.2} ${dir * 0.2} ${5.4} ${dir * 2.4} ${4.2} ${dir * 5.2}
c ${-0.6} ${dir * 1.4} ${-2.2} ${dir * 1.8} ${-3.4} ${dir * 0.6}
c ${1.2} ${dir * -1.6} ${1.4} ${dir * -3.2} ${-0.8} ${dir * -3.6}
z`}
fill={INK}
/>
);
}
function QuarterRest({ x }: { x: number }) {
const y = staffY(7);
return (
<path
d={`M ${x + 1.6} ${y}
c ${-2.4} ${1.6} ${-1.2} ${3.2} ${0.8} ${3.6}
c ${2.2} ${0.4} ${1.2} ${2.2} ${-0.8} ${3}
c ${-1.8} ${0.8} ${-0.4} ${2.2} ${1.2} ${2.6}
c ${1.4} ${0.4} ${1.2} ${1.6} ${-0.2} ${2.4}
c ${-1.6} ${0.8} ${-3.2} ${0.2} ${-2.2} ${-1.2}`}
fill="none"
stroke={INK}
strokeWidth={1.15}
strokeLinecap="round"
strokeLinejoin="round"
/>
);
}
function EighthRest({ x, flags }: { x: number; flags: 1 | 2 }) {
const y = staffY(6);
return (
<g fill={INK}> <g fill={INK}>
<circle cx="27" cy="112" r="5" /> <path
<path d="M27 107c8-12 13-16 6-30" fill="none" stroke={INK} strokeWidth="2.6" /> d={`M ${x + 1.4} ${y}
{kind === "sixteenth" ? ( c ${-0.4} ${2.2} ${0.2} ${3.4} ${1.2} ${4.2}
<path d="M23 100c8-8 11-12 5-22" fill="none" stroke={INK} strokeWidth="2.6" /> L ${x - 2.2} ${y + 9.2}
c ${0.8} ${0.2} ${1.6} ${-0.6} ${1} ${-1.4}
L ${x + 1.6} ${y + 4.4}
c ${-0.6} ${-0.8} ${-1} ${-1.8} ${-0.6} ${-3.2}
z`}
/>
<circle cx={x - 1.5} cy={y + 10.2} r={0.85} />
{flags > 1 ? (
<path
d={`M ${x + 0.4} ${y + 2.6}
c ${-0.2} ${1.6} ${0.4} ${2.4} ${1} ${3}
L ${x - 2.4} ${y + 11.4}
c ${0.7} ${0.2} ${1.4} ${-0.5} ${0.8} ${-1.2}
L ${x + 0.6} ${y + 5.6}
z`}
/>
) : null} ) : null}
</g> </g>
) : null}
</svg>
); );
} }
+118
View File
@@ -0,0 +1,118 @@
import { pngItemFromNote, pngStackLayout, type PngItem } from "@/lib/png-layout";
const INK = "#1a1a1a";
const PAPER = "#fbf6ee";
const SPACE_STROKE = "#c4b8a8";
function loadSvg(svg: SVGElement): Promise<HTMLImageElement> {
const clone = svg.cloneNode(true) as SVGElement;
if (!clone.getAttribute("xmlns")) clone.setAttribute("xmlns", "http://www.w3.org/2000/svg");
const xml = new XMLSerializer().serializeToString(clone);
const url = URL.createObjectURL(new Blob([xml], { type: "image/svg+xml;charset=utf-8" }));
return new Promise((resolve, reject) => {
const image = new Image();
image.onload = () => {
URL.revokeObjectURL(url);
resolve(image);
};
image.onerror = () => {
URL.revokeObjectURL(url);
reject(new Error("Could not draw a chart."));
};
image.src = url;
});
}
async function readRow(line: HTMLElement): Promise<{ items: PngItem[]; images: Array<HTMLImageElement | null> } | null> {
const slots = [...line.querySelectorAll<HTMLElement>(":scope > [data-export-slot]")];
const items: PngItem[] = [];
const images: Array<HTMLImageElement | null> = [];
for (const slot of slots) {
const kind = slot.dataset.kind;
if (kind !== "note" && kind !== "rest" && kind !== "space") continue;
items.push(
pngItemFromNote({
kind,
pitch: slot.dataset.pitch ?? "",
quarters: Number(slot.dataset.quarters),
label: "",
}),
);
const svg = slot.querySelector("svg");
images.push(svg ? await loadSvg(svg) : null);
}
if (items.length === 0) return null;
return { items, images };
}
export async function renderLinePng(exportRoot: HTMLElement, title: string): Promise<Blob> {
const lineNodes = [...exportRoot.querySelectorAll<HTMLElement>("[data-export-line]")];
const sources = lineNodes.length > 0 ? lineNodes : [exportRoot];
const rows: Array<{ items: PngItem[]; images: Array<HTMLImageElement | null> }> = [];
for (const line of sources) {
const row = await readRow(line);
if (row) rows.push(row);
}
if (rows.length === 0) throw new Error("Add a note, rest, or space before saving a PNG.");
const layout = pngStackLayout(
rows.map((row) => row.items),
title,
);
const scale = 2;
const canvas = document.createElement("canvas");
canvas.width = Math.ceil(layout.width * scale);
canvas.height = Math.ceil(layout.height * scale);
const ctx = canvas.getContext("2d");
if (!ctx) throw new Error("Could not start a canvas.");
ctx.scale(scale, scale);
ctx.fillStyle = PAPER;
ctx.fillRect(0, 0, layout.width, layout.height);
ctx.fillStyle = "#6a4328";
ctx.font = "600 12px Georgia, serif";
ctx.fillText("Soprano in C · Baroque · 4/4", layout.pad, layout.pad + 14);
ctx.fillStyle = INK;
ctx.font = "600 22px Georgia, serif";
ctx.fillText(title, layout.pad, layout.pad + 40);
let glyphTop = layout.pad + 56;
rows.forEach((row, rowIndex) => {
const laid = layout.rows[rowIndex];
let x = layout.pad;
row.items.forEach((item, index) => {
const slotWidth = laid?.slots[index]?.width ?? item.glyphWidth;
if (item.kind === "space") {
ctx.save();
ctx.strokeStyle = SPACE_STROKE;
ctx.setLineDash([4, 4]);
ctx.strokeRect(x + 6, glyphTop + 8, Math.max(8, item.glyphWidth - 12), laid.glyphHeight - 16);
ctx.restore();
} else if (row.images[index]) {
ctx.drawImage(row.images[index], x, glyphTop, item.glyphWidth, item.glyphHeight);
}
const center = x + item.glyphWidth / 2;
ctx.textAlign = "center";
ctx.fillStyle = INK;
ctx.font = "600 13px sans-serif";
ctx.fillText(item.caption, center, glyphTop + laid.glyphHeight + 18);
ctx.textAlign = "start";
x += slotWidth + laid.gap;
});
glyphTop += laid.glyphHeight + 28 + layout.rowGap;
});
const blob = await new Promise<Blob | null>((resolve) => canvas.toBlob(resolve, "image/png"));
if (!blob) throw new Error("Could not encode the PNG.");
return blob;
}
export function downloadBlob(blob: Blob, filename: string) {
const url = URL.createObjectURL(blob);
const link = document.createElement("a");
link.href = url;
link.download = filename;
document.body.appendChild(link);
link.click();
link.remove();
window.setTimeout(() => URL.revokeObjectURL(url), 1500);
}
+87 -1
View File
@@ -1,17 +1,48 @@
import { DURATION_PRESETS, type DurationPreset } from "@/lib/duration"; import { DURATION_PRESETS, type DurationPreset } from "@/lib/duration";
import { newId } from "@/lib/score"; import { newId } from "@/lib/score";
export type LineKind = "note" | "rest" | "space";
export type LineNote = { export type LineNote = {
id: string; id: string;
kind: LineKind;
pitch: string; pitch: string;
quarters: number; quarters: number;
label: string; label: string;
}; };
export const LINE_BOX = {
minWidth: 280,
minHeight: 200,
maxHeight: 880,
};
const QUARTER = DURATION_PRESETS.find((preset) => preset.quarters === 1) ?? DURATION_PRESETS[3]; const QUARTER = DURATION_PRESETS.find((preset) => preset.quarters === 1) ?? DURATION_PRESETS[3];
export function createNote(pitch: string, preset: DurationPreset = QUARTER, id = newId("n")): LineNote { export function createNote(pitch: string, preset: DurationPreset = QUARTER, id = newId("n")): LineNote {
return { id, pitch, quarters: preset.quarters, label: preset.label }; return { id, kind: "note", pitch, quarters: preset.quarters, label: preset.label };
}
export function createRest(preset: DurationPreset = QUARTER, id = newId("r")): LineNote {
return { id, kind: "rest", pitch: "", quarters: preset.quarters, label: preset.label };
}
export function createSpace(preset: DurationPreset = QUARTER, id = newId("s")): LineNote {
return { id, kind: "space", pitch: "", quarters: preset.quarters, label: preset.label };
}
/** Keep a resized line box on the page. `maxWidth` is the room the page actually has. */
export function clampLineBox(
width: number,
height: number,
maxWidth: number,
): { width: number; height: number } {
const limit = Math.max(160, maxWidth);
const minWidth = Math.min(LINE_BOX.minWidth, limit);
return {
width: Math.round(Math.min(limit, Math.max(minWidth, width))),
height: Math.round(Math.min(LINE_BOX.maxHeight, Math.max(LINE_BOX.minHeight, height))),
};
} }
export function insertNote(notes: LineNote[], index: number, note: LineNote): LineNote[] { export function insertNote(notes: LineNote[], index: number, note: LineNote): LineNote[] {
@@ -36,6 +67,15 @@ export function removeNote(notes: LineNote[], id: string): LineNote[] {
return notes.filter((note) => note.id !== id); return notes.filter((note) => note.id !== id);
} }
const DURATION_ORDER = [...DURATION_PRESETS].sort((a, b) => a.quarters - b.quarters);
/** The next longer or shorter preset. Null at either end of the list. */
export function neighborDuration(quarters: number, direction: -1 | 1): DurationPreset | null {
const index = DURATION_ORDER.findIndex((preset) => Math.abs(preset.quarters - quarters) < 0.001);
if (index < 0) return null;
return DURATION_ORDER[index + direction] ?? null;
}
export function setDuration(notes: LineNote[], id: string, preset: DurationPreset): LineNote[] { export function setDuration(notes: LineNote[], id: string, preset: DurationPreset): LineNote[] {
return notes.map((note) => return notes.map((note) =>
note.id === id ? { ...note, quarters: preset.quarters, label: preset.label } : note, note.id === id ? { ...note, quarters: preset.quarters, label: preset.label } : note,
@@ -46,6 +86,52 @@ export function cloneLine(notes: LineNote[]): LineNote[] {
return notes.map((note) => ({ ...note, id: newId("n") })); return notes.map((note) => ({ ...note, id: newId("n") }));
} }
export type ScoreLine = {
id: string;
notes: LineNote[];
};
export function appendLine(lines: ScoreLine[], id = newId("line")): ScoreLine[] {
return [...lines, { id, notes: [] }];
}
/** Leave the last line in place. An empty score still has one row. */
export function removeLine(lines: ScoreLine[], id: string): ScoreLine[] {
if (lines.length <= 1) return lines;
const next = lines.filter((line) => line.id !== id);
return next.length > 0 ? next : lines;
}
function mapLine(lines: ScoreLine[], id: string, update: (notes: LineNote[]) => LineNote[]): ScoreLine[] {
return lines.map((line) => (line.id === id ? { ...line, notes: update(line.notes) } : line));
}
export function placeOnLine(lines: ScoreLine[], lineId: string, index: number, note: LineNote): ScoreLine[] {
return mapLine(lines, lineId, (notes) => insertNote(notes, index, note));
}
/**
* Move a note onto a line. When it stays on the same line, `toIndex` counts the moving note.
* When it changes lines, `toIndex` is the slot in the destination.
*/
export function transferNote(
lines: ScoreLine[],
fromLineId: string,
noteId: string,
toLineId: string,
toIndex: number,
): ScoreLine[] {
const source = lines.find((line) => line.id === fromLineId);
const note = source?.notes.find((item) => item.id === noteId);
if (!source || !note) return lines;
if (fromLineId === toLineId) return mapLine(lines, fromLineId, (notes) => moveNote(notes, noteId, toIndex));
return lines.map((line) => {
if (line.id === fromLineId) return { ...line, notes: removeNote(line.notes, noteId) };
if (line.id === toLineId) return { ...line, notes: insertNote(line.notes, toIndex, note) };
return line;
});
}
/** -1 when the pointer is outside the line. Otherwise the insertion slot from left to right. */ /** -1 when the pointer is outside the line. Otherwise the insertion slot from left to right. */
export function dropIndexFromPoint( export function dropIndexFromPoint(
pointerX: number, pointerX: number,
+109
View File
@@ -0,0 +1,109 @@
import { quartersMatch } from "@/lib/duration";
/** The tube ends just below the thumb hole. The staff is added underneath. */
export const CHART_VB_W = 48;
const RECORDER_VB_H = 152;
/** Distance between two staff lines. One diatonic step is half of this. */
export const STAFF_SPACE = 4.6;
const STEP = STAFF_SPACE / 2;
/** Highest written note is sounding D7, drawn as D6. */
const TOP_INDEX = 13;
/** Lowest written note is sounding C5, drawn as C4 on the ledger line below. */
const LOW_INDEX = -2;
const PAD_TOP = 6;
const PAD_BOTTOM = 14;
const ABOVE = TOP_INDEX * STEP;
const BELOW = -LOW_INDEX * STEP + PAD_BOTTOM;
export const BOTTOM_LINE_Y = RECORDER_VB_H + 3 + PAD_TOP + ABOVE;
export const CHART_VB_H = Math.ceil(BOTTOM_LINE_Y + BELOW);
export function chartPixelHeight(width: number): number {
return Math.round((width * CHART_VB_H) / CHART_VB_W);
}
export function staffY(index: number): number {
return BOTTOM_LINE_Y - index * STEP;
}
const LETTERS = ["C", "D", "E", "F", "G", "A", "B"] as const;
export type Accidental = "sharp" | "flat";
/**
* Treble staff, written one octave below sounding pitch.
* Index 0 is the bottom line, E4. Sounding C5 is written C4, index -2.
*/
export function staffPlacement(pitch: string): { index: number; accidental: Accidental | null } | null {
const match = /^([A-Ga-g])(#|b|♯|♭)?(-?\d+)$/.exec(pitch.trim());
if (!match) return null;
const letter = match[1].toUpperCase();
const mark = match[2] ?? "";
const accidental: Accidental | null =
mark === "#" || mark === "♯" ? "sharp" : mark === "b" || mark === "♭" ? "flat" : null;
const octave = Number(match[3]);
if (!Number.isInteger(octave)) return null;
const diatonic = (octave - 1 - 4) * 7 + LETTERS.indexOf(letter as (typeof LETTERS)[number]);
return { index: diatonic - 2, accidental };
}
/** Ledger lines a note needs outside the five-line staff. */
export function ledgerIndexes(index: number): number[] {
const lines: number[] = [];
if (index > 8) {
for (let line = 10; line <= index; line += 2) lines.push(line);
}
if (index < 0) {
const start = index % 2 === 0 ? index : index - 1;
for (let line = -2; line >= start; line -= 2) lines.push(line);
}
return lines;
}
/** On the middle line or higher, the stem goes down. */
export function stemDown(index: number): boolean {
return index >= 4;
}
export type NoteValue = {
head: "open" | "filled";
stem: boolean;
flags: 0 | 1 | 2;
dots: 0 | 1;
};
export type RestValue = {
rest: "whole" | "half" | "quarter" | "eighth" | "sixteenth";
dots: 0 | 1;
};
/** One chart has its own staff, so a short note wears flags instead of a beam. */
export function noteValue(quarters: number): NoteValue {
if (quartersMatch(quarters, 4)) return { head: "open", stem: false, flags: 0, dots: 0 };
if (quartersMatch(quarters, 3)) return { head: "open", stem: true, flags: 0, dots: 1 };
if (quartersMatch(quarters, 2)) return { head: "open", stem: true, flags: 0, dots: 0 };
if (quartersMatch(quarters, 1.5)) return { head: "filled", stem: true, flags: 0, dots: 1 };
if (quartersMatch(quarters, 0.75)) return { head: "filled", stem: true, flags: 1, dots: 1 };
if (quartersMatch(quarters, 0.5)) return { head: "filled", stem: true, flags: 1, dots: 0 };
if (quartersMatch(quarters, 0.25)) return { head: "filled", stem: true, flags: 2, dots: 0 };
return { head: "filled", stem: true, flags: 0, dots: 0 };
}
export function restValue(quarters: number): RestValue {
if (quartersMatch(quarters, 4)) return { rest: "whole", dots: 0 };
if (quartersMatch(quarters, 3)) return { rest: "half", dots: 1 };
if (quartersMatch(quarters, 2)) return { rest: "half", dots: 0 };
if (quartersMatch(quarters, 1.5)) return { rest: "quarter", dots: 1 };
if (quartersMatch(quarters, 0.75)) return { rest: "eighth", dots: 1 };
if (quartersMatch(quarters, 0.5)) return { rest: "eighth", dots: 0 };
if (quartersMatch(quarters, 0.25)) return { rest: "sixteenth", dots: 0 };
return { rest: "quarter", dots: 0 };
}
/** A dot sits in a space. A note on a line takes the space above. */
export function dotIndex(index: number): number {
return index % 2 === 0 ? index + 1 : index;
}
+66
View File
@@ -0,0 +1,66 @@
import type { LineNote } from "@/lib/line";
import { chartPixelHeight } from "@/lib/notation";
export const PNG_CHART_WIDTH = 88;
const GAP = 18;
const PAD = 28;
export { chartPixelHeight };
/** A quarter space is about one chart wide. Longer spaces take more room. */
export function spacePixelWidth(quarters: number, chartWidth: number): number {
return Math.max(Math.round(chartWidth * 0.45), Math.round(chartWidth * Math.max(quarters, 0)));
}
export type PngItem = {
kind: LineNote["kind"];
caption: string;
glyphWidth: number;
glyphHeight: number;
};
export function pngItemFromNote(note: Pick<LineNote, "kind" | "pitch" | "quarters" | "label">, chartWidth = PNG_CHART_WIDTH): PngItem {
const glyphHeight = chartPixelHeight(chartWidth);
const caption = note.kind === "note" ? note.pitch : note.kind === "rest" ? "Rest" : "Space";
return {
kind: note.kind,
caption,
glyphWidth: note.kind === "space" ? spacePixelWidth(note.quarters, chartWidth) : chartWidth,
glyphHeight,
};
}
export function pngSlotWidth(item: PngItem): number {
const text = item.caption.length * 8;
return Math.max(item.glyphWidth, text, 48);
}
export const PNG_ROW_GAP = 36;
/** One header, then every fingering line stacked underneath. */
export function pngStackLayout(rows: PngItem[][], title: string) {
const laid = rows.map((items) => pngLayout(items, title));
const width = Math.max(1, ...laid.map((row) => row.width));
const blocks = laid.reduce((sum, row) => sum + row.glyphHeight + 28, 0);
const height = PAD + 44 + blocks + PNG_ROW_GAP * Math.max(0, laid.length - 1) + PAD;
return { width, height, rows: laid, pad: PAD, rowGap: PNG_ROW_GAP };
}
export function pngLayout(items: PngItem[], title: string) {
const slots = items.map((item) => ({ item, width: pngSlotWidth(item) }));
const content =
slots.reduce((sum, slot) => sum + slot.width, 0) + GAP * Math.max(0, slots.length - 1);
const titleWidth = Math.max(220, title.length * 13 + 8);
const width = Math.max(titleWidth, content, 1) + PAD * 2;
const glyphHeight = chartPixelHeight(PNG_CHART_WIDTH);
const height = PAD + 44 + glyphHeight + 28 + PAD;
return { width, height, slots, glyphHeight, pad: PAD, gap: GAP };
}
export function pngFilename(title: string): string {
const slug = title
.toLowerCase()
.replace(/[^a-z0-9]+/g, "-")
.replace(/^-|-$/g, "");
return `${slug || "line"}.png`;
}
+107
View File
@@ -2,16 +2,31 @@ import { describe, expect, it } from "vitest";
import { fingeringCode, fingeringFor, fingeringMarks, CHART_NOTES } from "@/lib/fingering"; import { fingeringCode, fingeringFor, fingeringMarks, CHART_NOTES } from "@/lib/fingering";
import { DURATION_PRESETS } from "@/lib/duration"; import { DURATION_PRESETS } from "@/lib/duration";
import { import {
clampLineBox,
cloneLine, cloneLine,
createNote, createNote,
createRest,
createSpace,
dropIndexFromPoint, dropIndexFromPoint,
insertNote, insertNote,
LINE_EXAMPLES, LINE_EXAMPLES,
appendLine,
moveNote, moveNote,
neighborDuration,
removeLine,
removeNote, removeNote,
setDuration, setDuration,
transferNote,
} from "@/lib/line"; } from "@/lib/line";
import {
ledgerIndexes,
noteValue,
restValue,
staffPlacement,
stemDown,
} from "@/lib/notation";
import { parsePitch } from "@/lib/pitch"; import { parsePitch } from "@/lib/pitch";
import { pngFilename, pngItemFromNote, pngLayout, pngStackLayout } from "@/lib/png-layout";
import { extraBeatArrows } from "@/lib/score"; import { extraBeatArrows } from "@/lib/score";
const BAROQUE: Record<string, string> = { const BAROQUE: Record<string, string> = {
@@ -122,4 +137,96 @@ describe("fingering line", () => {
expect(extraBeatArrows(LINE_EXAMPLES[0].notes[6].quarters, { beats: 4, beatType: 4 })).toBe(1); expect(extraBeatArrows(LINE_EXAMPLES[0].notes[6].quarters, { beats: 4, beatType: 4 })).toBe(1);
expect(extraBeatArrows(LINE_EXAMPLES[1].notes[0].quarters, { beats: 4, beatType: 4 })).toBe(0); expect(extraBeatArrows(LINE_EXAMPLES[1].notes[0].quarters, { beats: 4, beatType: 4 })).toBe(0);
}); });
it("inserts a rest and a space without changing the notes beside them", () => {
const note = createNote("C5", quarter, "c");
const rest = createRest(half, "r");
const space = createSpace(quarter, "s");
const line = insertNote(insertNote([note], 1, rest), 2, space);
expect(line.map((item) => item.kind)).toEqual(["note", "rest", "space"]);
expect(moveNote(line, "r", 0).map((item) => item.kind)).toEqual(["rest", "note", "space"]);
expect(setDuration(line, "s", half)[2]).toMatchObject({ kind: "space", quarters: 2, label: "half" });
expect(removeNote(line, "s").map((item) => item.kind)).toEqual(["note", "rest"]);
});
it("keeps a resized line box inside the page", () => {
expect(clampLineBox(10, 10, 800)).toEqual({ width: 280, height: 200 });
expect(clampLineBox(900, 2000, 640)).toEqual({ width: 640, height: 880 });
expect(clampLineBox(400, 360, 200)).toEqual({ width: 200, height: 360 });
});
it("lays out a PNG with a rest, a space, and a filename", () => {
const note = pngItemFromNote(createNote("G5", half, "g"));
const rest = pngItemFromNote(createRest(quarter, "r"));
const space = pngItemFromNote(createSpace(quarter, "s"));
expect(note.caption).toBe("G5");
expect(rest.kind).toBe("rest");
expect(space.glyphWidth).toBeGreaterThan(40);
expect(note.glyphHeight).toBeGreaterThan(note.glyphWidth);
const layout = pngLayout([note, rest, space], "Your line");
expect(layout.width).toBeGreaterThan(layout.slots[0].width + layout.slots[2].width);
expect(layout.height).toBeGreaterThan(layout.glyphHeight);
expect(pngFilename("Twinkle, opening")).toBe("twinkle-opening.png");
expect(pngFilename(" ")).toBe("line.png");
});
it("appends a line and can move a note onto it", () => {
const top = { id: "a", notes: [createNote("C5", quarter, "c"), createNote("E5", quarter, "e")] };
const next = appendLine([top], "b");
expect(next.map((line) => line.id)).toEqual(["a", "b"]);
expect(next[1].notes).toEqual([]);
expect(next[0].notes.map((note) => note.pitch)).toEqual(["C5", "E5"]);
const moved = transferNote(next, "a", "e", "b", 0);
expect(moved[0].notes.map((note) => note.pitch)).toEqual(["C5"]);
expect(moved[1].notes.map((note) => note.pitch)).toEqual(["E5"]);
expect(removeLine(moved, "b").map((line) => line.id)).toEqual(["a"]);
expect(removeLine([{ id: "a", notes: [] }], "a")).toHaveLength(1);
});
it("stacks every fingering line in the PNG", () => {
const top = [pngItemFromNote(createNote("C5", quarter, "c"))];
const bottom = [pngItemFromNote(createNote("G5", quarter, "g"))];
const one = pngStackLayout([top], "Your line");
const two = pngStackLayout([top, bottom], "Your line");
expect(two.rows).toHaveLength(2);
expect(two.height).toBeGreaterThan(one.height);
expect(pngLayout(top, "Your line").glyphHeight).toBe(one.rows[0].glyphHeight);
});
it("steps duration without skipping a preset", () => {
expect(neighborDuration(1, 1)?.quarters).toBe(1.5);
expect(neighborDuration(1, -1)?.quarters).toBe(0.75);
expect(neighborDuration(0.25, -1)).toBeNull();
expect(neighborDuration(4, 1)).toBeNull();
});
});
describe("treble staff", () => {
it("writes each sounding pitch one octave lower", () => {
expect(staffPlacement("C5")).toEqual({ index: -2, accidental: null });
expect(staffPlacement("C#5")).toEqual({ index: -2, accidental: "sharp" });
expect(staffPlacement("Eb5")).toEqual({ index: 0, accidental: "flat" });
expect(staffPlacement("C6")).toEqual({ index: 5, accidental: null });
expect(staffPlacement("C7")).toEqual({ index: 12, accidental: null });
expect(staffPlacement("D7")).toEqual({ index: 13, accidental: null });
expect(ledgerIndexes(-2)).toEqual([-2]);
expect(ledgerIndexes(5)).toEqual([]);
expect(ledgerIndexes(12)).toEqual([10, 12]);
expect(ledgerIndexes(13)).toEqual([10, 12]);
expect(stemDown(-2)).toBe(false);
expect(stemDown(5)).toBe(true);
});
it("writes length as noteheads, stems, flags, and dots", () => {
expect(noteValue(4)).toEqual({ head: "open", stem: false, flags: 0, dots: 0 });
expect(noteValue(2)).toEqual({ head: "open", stem: true, flags: 0, dots: 0 });
expect(noteValue(1.5)).toEqual({ head: "filled", stem: true, flags: 0, dots: 1 });
expect(noteValue(1)).toEqual({ head: "filled", stem: true, flags: 0, dots: 0 });
expect(noteValue(0.5)).toEqual({ head: "filled", stem: true, flags: 1, dots: 0 });
expect(noteValue(0.25)).toEqual({ head: "filled", stem: true, flags: 2, dots: 0 });
expect(restValue(2)).toEqual({ rest: "half", dots: 0 });
expect(restValue(3)).toEqual({ rest: "half", dots: 1 });
expect(restValue(0.5)).toEqual({ rest: "eighth", dots: 0 });
expect(restValue(0.25)).toEqual({ rest: "sixteenth", dots: 0 });
});
}); });