Timothy Lanfear's example illustrates this perfectly. On Mon, Dec 29, 2025 at 1:55 AM Werner LEMBERG <[email protected]> wrote:
> > > It's a little strange that [`ignore-ambitus`] is documented under > > AmbitusNoteHead when it really doesn't have anything to do with the > > note heads of the ambitus itself. > > You are mistaken. Looking up properties for a grob in the Internals > Reference is the wrong way; this only shows default values for > properties but not the available properties. Instead, you should > always check which *interface* a property belongs to – the > `ignore-ambitus` property is part of the `note-head-interface`. As > you might have guessed, `NoteHead` uses the `note-head-interface` > also, and the `Ambitus_engraver` walks over such grobs to collect (or > exclude) notes for the ambitus range. > > Note also that there is no guarantee in general that properties > provided by an interface are actually used by a grob. As you > correctly observe, `AmbitusNoteHead` does nothing with > `ignore-ambitus`. > > > It should be explained on the main Ambitus documentation page. > > No, it should not. If we documented all and every property in the > Notation Reference, it would be three times as long as it is already. > > Please add a snippet to the Wiki, which can then be eventually added > to the 'Snippets' manual. > > > Werner >
