[ << Translation ]	[Top][Contents][Index]	[ Backend >> ]
[ < Collision_engraver ]	[ Up : Engravers and Performers ]	[ Completion_rest_engraver > ]

---

2.2.27 Completion_heads_engraver

This engraver replaces Note_heads_engraver. It plays some trickery to break long notes and automatically tie them into the next measure.

Music types accepted: note-event

Properties (read)

completionFactor (an exact rational or procedure)

When Completion_heads_engraver and Completion_rest_engraver need to split a note or rest with a scaled duration, such as c2*3, this specifies the scale factor to use for the newly-split notes and rests created by the engraver.

If #f, the completion engraver uses the scale-factor of each duration being split.

If set to a callback procedure, that procedure is called with the context of the completion engraver, and the duration to be split.

completionUnit (positive exact rational or +inf.0)

Sub-bar unit of completion.

measureLength (positive exact rational or +inf.0)

The musical length of the current measure.

measurePosition (moment)

The current point within the measure.

middleCPosition (number)

The place of the middle C, measured in half staff-spaces. Usually determined by looking at middleCClefPosition and middleCOffset.

timing (boolean)

Keep administration of measure length, position, bar number, etc.? Switch off for cadenzas.

Properties (write)

completionBusy (boolean)

Whether a completion-note head is playing.

This engraver creates the following layout object(s): NoteHead, Tie and TieColumn.

Completion_heads_engraver is not part of any context