## Slurs Slurs don't belong to the scope of a measure. Because they can connect units from different measures and even staves. You can declare slurs in a scope of a line, or you can declare all slurs after all page lines. ### 1. Simple slurs Let's start with basics:

Let's create slurs on multiple lines:

As you see, each slur applies on the last line declared before the slur. But you can declare slurs after all lines and have the same result:

Let's see how you can defined slurs in different measures:

Let's see how you can defined slurs in different staves:

Slurs can connect units only in the same voice:

As you see, you can control the direction of a slur with `up` and `down` key words. Slur is a cross-measure element:

Slur is also a cross-stave element:

As you see, it's important to mention at which exact unit a slur changes stave, because otherwise it misjudges which units are under slur and would potentially intersect or ignore them:

You can also set direction of a start/end point by `above`, `below` key words that apply to a unit where it starts/ends. Cross-stave slurs work and look better if they are s-shaped. More about that you can read here. If a slur needs to start before a unit or finish after a unit, you just mention that in the text:

You can set a direction for slurs in different ways, just by simple key words: `up`, `down`; or you can say that a slur should start/end `below` or `above` a certain unit:

In terms of coordinates of units (like `line`, `measure`, `stave` and `voice`) for using in slurs, you have to repmember following rules: 1. If a `line` is not specified after `slur` key word, then it applies to the last declared line before `slur`. 2. If you don't specify `measure`, `stave` and `voice` after `slur` key word, it always assumes that you mean `first measure`, `first stave` and `first voice`. 3. You can specify only `measure` and `stave` coordinates along with `unit` coordinate(like `first note in first measure, in second stave`). You cannot set `voice` along with `unit` coordinate, only right after `slur` key word to set a voice to whole slur, because slur is not a cross-voice element. And you cannot set `line` coordinate along with `unit` coordinate, because each slur or a part of a slur must be delcared for each line where it is located. This separation allows of coordinates to set rules on slurs' behaviour more clearly. 4. If you specified `measure` and `stave` for first unit in a slur, and those coordinates don't change for other units, then you don't need to repeat them. Another thing that you can configure for slurs is how rounded they are. By specifying the number from **1** to **10** you can set the roundness (or convex) for slurs:

You can set vertical correction for left and right points for slurs:

Slur adjusts itself, so it does not intersect any notes or chords:

For the right point of a slur, you can also say where it needs to be attached (it will be especially useful for slurs with grace notes).

### 2. S-shape slurs If you need to create a cross-stave slur, it's highly recommended to use s-shape slurs:

You can also use slurs with s-shape as follows:

`goes through` indicates where a slur changes its direction. As you see, all the features for simple slurs are also applicable for s-shaped slurs. **P.S.:** You can use numbers from 1 to 10 as words. For example, `1` is `first`, or even `1st`. We could've made possible that all numbers can be expressed as words, but unfortunately it would slow down highlighting in the editor and rendering the image. So, it was decided to enable this feature only for numbers from 1 to 10, since majority of times only these numbers are used and moreover it's easier just to type numbers as numbers. But you still can write `11` as `11th`. When you type numbers to declare coordinates (like `line`, `measure`, `stave`, `voice`, `chord/note/unit`), you can put them before or after those key words, like for example: `first measure` or `measure 1`. Read next: Glissando