OOLOI.ORG
Menu

OOLOI

OVERVIEW

FAQ

DOCUMENTATION

NEWSLETTER

Dials

29/10/2026

10 Comments

 
In the comments to Ut Tensio, Sic Vis I told Magnus Johansson that Hegazy and Gourlay provide the physics, I provide the dials, and the user provides the artistic judgement. I meant it as a summary, but it also is a work plan. 

The physics has had several posts of its own. This one is about a few of the dials: what they are, what each is called, what kind of control it is, and what it does to the page. Two animations show them at work. The first is about what takes the room when a system is looser than its notes need. The second answers the question Magnus asked in those comments, which NOTATIO took up almost at once: who gives way when an accidental meets a ledger line?

Who Takes the Room

​When a system has more room than its notes need, something has to take it. Which notes take it is decided by a single setting, the stretch dial: a slider from 0 to 100%, shown in the animation at three positions, labelled λ = 0, 0.5 and 1.
Picture
At 0, the whole distance from one note to the next stretches. Every gap grows in proportion to its ideal width, so a loose system is simply the ideal one, scaled. At 100%, only the air stretches: the white space left over once the noteheads have taken theirs. The half note then takes most of the room, and the sixteenths stay together. That end of the slider is LilyPond’s behaviour. At 50% the two share it, and the slider can stop anywhere along the way. Where its default belongs is for the plates to say, not me.

Watch three moments. While the bar is compressed, all three rows are identical, because the dial only acts when there’s room to spare. At r = 0, the ideal spacing, they’re still identical, with the gaps before the sharps held open at exactly the width the sharps need. Then the barline moves out, and the rows go their separate ways.
​
The gauges show the adjustment ratio, r, the number the line breaker judges each system by. At −1 the music is as tight as it can go; at 0 it's ideal; the green band is the looseness the breaker accepts. All three gauges agree at every width, and that's deliberate: the breaker judges a system by how much room it has to spare, not by which notes take it. So the dial never changes its verdict. It decides where the room goes and nothing else, which means it can't move a line break, and turning it never obliges you to adjust anything else to keep the casting off sound.

Note that in practice, r is as close to 0.0 as possible: that's the entire purpose of casting off. Values for r near -1 are very extreme and rarely or never appear, unless you force it explicitly. So keep in mind that an r of -1 results in the music having lost all rhythmic proportionality. But – with Hegazy-Gourlay's algorithm, you still get no horizontal collisions.

Who Gives Way

Magnus asked whether the C♯4 and A♯5 in the ‘Ut Tensio’ examples could keep ledger lines of normal length when there’s room to the left of the accidental. They can. Three settings decide who gives way, the ledger line or the accidental:
​
  1. Minimum protrusion is a measurement in stave spaces: how far a ledger line must still protrude from its notehead on the accidental’s side. It runs from 0 up to the full extension. At the top it becomes ‘full extension’ and stays there, so the line never shortens, however the full extension is set later.

  2. Accidental position is a switch with two positions. Either the accidental moves out past full-length ledger lines when there’s room, or it stays tight to its notehead and the lines are cut around it.

  3. Stays nearer its own note is an on/off switch with a ratio behind it. When it’s on, an accidental may never end up nearer the previous notehead than its own, at a ratio of 1. Its own ledger lines give way instead, as far as setting 1 allows.

One difference between them matters more than any other. The minimum protrusion decides how much room the notes reserve, so it’s the only one of the three that moves notes. The other two only spend room the spacing has already given. They never move a note, and they never move a line break.

(The image below is very large and is reduced in size to fit. Click on it to open it in a new window where it can be zoomed.)
Picture
​Each stave changes one setting from the stave above, and the changed value is highlighted.

Stave 1 never shortens its ledger lines. Magnus, you once said that shortened ledger lines weren’t always necessary as far as you were concerned. This is that setting, and it has a price. At the tight end the bar doesn’t fit, and the sharps end up nearer the previous note than their own. They turn rust when that happens.

Stave 2 lets the lines shorten to 0.16 stave spaces, so the bar fits. But as room appears, the sharps move out past the lengthening lines and drift towards the previous note.

Stave 3 switches on setting 3. The lines give way instead, and the sharps stay where they belong. They turn blue while the setting holds them.

Stave 4 keeps every sharp tight to its notehead and cuts the ledger lines around it.

Given room to spare, the first three staves agree. The fourth keeps its own look.

Beside each stave, a panel magnifies one gap, C6 to C♯6. The note’s own notehead stays put, so you can watch the sharp travel, and the distances to both noteheads change as it does. In stave 4 the panel shows something else as well. Bravura’s sharp has open corners, and the lower ledger line reaches into one of them, further under the sharp than the line beside the notehead. Nobody had to write a rule for that: the sharp’s outline, band by band, is all the springs need.

The ledger lines don’t only give way to accidentals. Look at C6 in the panels when the bar is at its tightest: its lower ledger line is shorter on the left than the one above it. B5 has a ledger line at the same height, and the two share the space between them, keeping a sliver of air in the middle; the line above has no neighbour at its height and only has to clear B5’s notehead. There’s no special rule here. The lines reserve only their shortest acceptable form, so they never push the notes apart, and the notes stay where their durations put them. If you’d rather the lines kept their full length and the notes moved apart instead, that’s the minimum protrusion on the other side, set to the full extension.

So these three aren’t the whole story. Whether a note’s ledger lines should be evened out, so that the lower one is never shorter than the one above, is a matter of taste, and so is shortening both ends of a line symmetrically, which someone on NOTATIO suggested. Both are candidates for dials of their own, and both will get their turn.

Division of Labour

​A word on what you’re looking at. Both animations are conceptual. Positions are computed from the published specifications and drawn from a real music font, but nothing in either was rendered by Ooloi. Bravura’s metrics are real; every other value is a placeholder until the plates have spoken.

What they do show is the division of labour. The springs guarantee that notes stay where their durations put them and that nothing collides. Within that guarantee, the dials decide how the page looks, each doing a single job, none needing to know about the others. Which positions are right is the engraver’s call, as it always was.

Both animations are free to use. Download them, put them in a lecture, a forum post, a book or a presentation, cut them up or build on them; no permission is needed. Formally, they’re released under CC0.
10 Comments
Magnus Johansson
29/10/2026 19:30:12

Continually impressive, Peter. Would it be possible to let Stave 1 have the position of the accidental in relation to its note like in Stave 4 but with no ledger line shortening of C#6?

Reply
Peter Bengtson
29/10/2026 20:39:24

You mean put the accidental actually on top of the ledger line? Yes. Stave 4 already places the sharp; drawing C♯6’s line at full length under it changes nothing else, so no note and no line break moves. The animation doesn’t show it and there’s no setting for it yet, but it’s one of the dials still to come.

Reply
Peter Bengtson
29/10/2026 21:26:35

But while we’re at it, I’d like to pick your brain about the first animation: which of the three rows do you prefer? I lean towards λ = 1, where the sixteenths stay together and the half note takes the room. (ADR-0055 starts the dial there, at LilyPond’s default, until the plates have had their say.)

Reply
Magnus Johansson
30/10/2026 08:59:13

I prefer the same one as you do; the half note should take the room.

Reply
Peter Bengtson
30/10/2026 10:15:09

I thought you would. It’s what a flesh-and-blood engraver does: the half note is mostly air, so it gives way, and the sixteenths stay together. λ = 0 always takes me back to an earlier era of notation software, and not in a good way.

Magnus Johansson
30/10/2026 10:35:13

"λ = 0 always takes me back to an earlier era of notation software, and not in a good way."

Yes, I can see that it can do that.

I have suggestions for the stemming and beaming of the sixteenths but I assume we can wait with that until the time comes.

Reply
Peter Bengtson
30/10/2026 11:09:49

Oh, the beams and stems in that first example irritate me too, as I said at the end of that section. Each beam end does sit, straddle or hang, but that’s about all that can be said for them: the slant takes no account of how close the notes are, and the stems were only ever placeholders. I’m thinking of redoing them so they don’t distract from what the animation is about, and so that nobody takes them for Ooloi’s beaming.

Because they aren’t. Ross and Gould will supply the rules for placement and slant, and you’ll be able to follow the design and the reasoning in ADRs devoted to beaming. The aim is to have beaming right from the first release.

Now that horizontal spacing rests on one piece of mathematics, beams, slurs and vertical spacing all become much easier to do well. Every note is in its final place before any of them is worked out. And the same glyph outlines that space the notes tell a slur how close it may come, and two staves how close they may stand: the same question as before, asked in the other direction. I’m actually looking forward to it.

Reply
Peter Bengtson
2/11/2026 21:30:59

I've replaced the beams in the first animation with something that doesn't break the Ross and Gould rules. Whether the longer stems are acceptable or not is ultimately a matter of taste. The updated beams of the second group no longer create ink wedges, which is important.

Magnus Johansson
3/11/2026 11:02:39

"Whether the longer stems are acceptable or not is ultimately a matter of taste."

Yes, it is a choice between standard stem lengths and white wedges, a number of non-standard stem lengths and fewer white wedges, and no standard stem lengths and no white wedges.

Reply
Peter Bengtson
3/11/2026 15:27:47

True, and that’s exactly the kind of choice that should be a dial rather than a decree. NOTATIO has seen its share of wars over it (‘no engraver would ever accept stems that long’, and so on).

‘What is truth?’ said jesting Pilate, and would not stay for an answer. I’d rather stay.

Reply



Leave a Reply.

    Author

    Peter Bengtson –
    Cloud architect, Clojure advocate, concert organist, opera composer. Craft over commodity. Still windsurfing through parentheses.

    Search

    Archives

    November 2026
    October 2026
    September 2026
    August 2026
    July 2026
    June 2026
    May 2026
    April 2026
    March 2026
    February 2026
    January 2026
    December 2025
    November 2025
    October 2025
    September 2025
    August 2025
    July 2025
    June 2025
    April 2025
    March 2025
    September 2024
    August 2024
    July 2024

    Categories

    All
    Accidentals
    Alfred Korzybski
    Architecture
    Backend
    Beaming
    Benchmarks
    Casting Off
    Clefs
    Clojure
    CLOS
    Common Lisp
    DDD
    Death Of Igor Engraver
    Documentation
    Donald E Knuth
    Dorico
    Dynamic Programming
    Finale
    Fonts
    FrankenScore
    Franz Kafka
    Frontend
    Functional Programming
    Generative AI
    GRPC
    Hegazy Gourlay
    Hegazy-Gourlay
    Igor Engraver
    Ingmar Bergman
    Instruments
    Jacques Derrida
    JVM
    Knuth Plass
    Knuth-Plass
    License
    LilyPond
    Lisp
    Localisation
    MIDI
    MPL 2.0
    MuseScore
    MusicXML
    Ooloi
    Ortography
    Pitches
    Platforms
    Playback
    Plugins
    Python
    QuickDraw GX
    Rendering
    Rhythm
    Rich Hickey
    Road Map
    Scheme
    Semiotics
    Sibelius
    Silicon Valley
    Site
    Skia
    Sponsorship
    Testing
    Transposition
    UI
    Umberto Eco
    Vertigo
    VST/AU
    Wednesday Addams

    RSS Feed

Home
​Overview
Documentation
About
Contact
Newsletter
Ooloi is an open-source desktop music notation system for musicians who need stable, precise engraving and the freedom to notate complex music without workarounds. Scores and parts are handled consistently, remain responsive at scale, and support collaborative work without semantic compromise. They are not tied to proprietary formats or licensing.
​
Ooloi is currently under development. No release date has been announced.


  • Home
  • Overview
    • Background and History
    • Project Goals
    • Introduction for Musicians
    • Introduction for Programmers
    • Technical Comparison
  • FAQ
  • Documentation
  • About
  • Contact
  • Workbench
  • Home
  • Overview
    • Background and History
    • Project Goals
    • Introduction for Musicians
    • Introduction for Programmers
    • Technical Comparison
  • FAQ
  • Documentation
  • About
  • Contact
  • Workbench