Plugin: Accessing rest dots

• Apr 9, 2022 - 18:00

How do I access rests dots in a plugin to change their colour? I can change the colour of the rests themselves but, even though there are dotted rests in my score, I can't seem to get a handle on the dots.

This console.log line never triggers:

Comments

jeetee

• Apr 9, 2022 - 20:48

They're not available :'(
While dots internally can be accessed for a ChordRest, for some reason the Plugin API defined them directly and solely on a Note: https://github.com/musescore/MuseScore/blob/3.x/mscore/plugin/api/eleme…

yonah_ag

• Apr 9, 2022 - 21:31

Thanks. I'll use 2 rests instead of a dotted rest.

parkingb

• Apr 12, 2022 - 17:12

You can assess this by the duration:

var current = durationTo64(element.duration);
var analyze = analyzeDuration(current);
 
console.log(current + " => " + analyze.base + "/" + analyze.ratio)
 
function analyzeDuration(target) {
    var base = Math.log(target) / Math.log(2);
    var remaining = base - (base | 0); // base - trunc(base);
    base = base | 0; // = trunc
    base = Math.pow(2, base);
    var ratio = ((Math.pow(2, remaining) * 10000) | 0) / 10000;
 
    var half = null; ;
 
    // Gestion des arrondis
    // Gestion des arrondis
    if (Math.abs(ratio - 1.125) <= 0.01) {
        ratio = 1.125;
        half = 1.25;
    } else if (Math.abs(ratio - 1.25) <= 0.01) {
        ratio = 1.25;
        half = 1.5;
    } else if (Math.abs(ratio - 1.375) <= 0.01) {
        ratio = 1.375;
        half = 1.75;
    } else if (Math.abs(ratio - 1.4375) <= 0.01) {
        ratio = 1.4375;
        half = 1.875;
    } else if (Math.abs(ratio - 1.46875) <= 0.01) {
        ratio = 1.46875;
        half = 1.9375;
    } else if (Math.abs(ratio - 1.5) <= 0.01)
        ratio = 1.5;
    else if (Math.abs(ratio - 1.75) <= 0.01)
        ratio = 1.75;
    else if (Math.abs(ratio - 1.875) <= 0.01)
        ratio = 1.875;
    else if (Math.abs(ratio - 1.9375) <= 0.01)
        ratio = 1.9375;
 
    return {
        "base": base,
        "ratio": ratio,
        "half": half
    };
 
}
 
 
function durationTo64(duration) {
    return 64 * duration.numerator / duration.denominator;
    }

Remark: "dotted" elements have always a length >= 1.5* the "non-dotted" element length.
This code also deals where one have to achieve a length between in [1,1.5[ of the the "non-dotted" element.

jeetee

• Apr 12, 2022 - 20:47

Good guessing. Not sure how it holds up if inside a tuplet?

But it doesn't help at all in getting the dot element to be able to change it's color property ;-)

parkingb

• Apr 12, 2022 - 23:58

Actually, it does because the duration of an element within a tuplet is not affected by the tuplet. It is the duration "as-if-there-were-no-tupelt" (should retest it to be sure at 100%).

yonah_ag

• Apr 12, 2022 - 22:46

If I can't get a JavaScript object to access the rest dot then I don't see any way of changing the dot's properties, e.g. colour. Am I missing something?

(I can do this easily enough via my Excel plugout framework but that means working with the MSCX file rather than the MSCZ file which, in this case, is just not an efficient way to work.)

jeetee

• Apr 12, 2022 - 22:51

I'm now wondering whether the dot would be included in selection.elements if you select that chord as a range.

yonah_ag

• Apr 12, 2022 - 22:55

Maybe, but this code already runs against the whole score which I guess is already a range.

https://github.com/yonah-ag/musescore-tidy-tab-score/blob/main/TidyTabS…

jeetee

• Apr 12, 2022 - 23:49

That's a private repo, so 404 for me.
My line of thinking was that if the dot is included in selection.elements then you could use the Selection API to range select your rest, which should also select the dot.

yonah_ag

• Apr 13, 2022 - 08:14

Oops! It's public now.

Selection.elements sounds like it would not be useable unless I actually selected a range. This plugin processes the whole score as it has no benefit in applying only to selections, but I'll check out your suggestion as a possible workaround.

parkingb

• Apr 13, 2022 - 08:35

You can force a selection with the selectRange method. Sometimes with the API you don't have any other choices than making an explicit selection in order to access some elements or functions you would normally expect to be exposed by the API as object properties or object methods but that are not.

yonah_ag

• Apr 13, 2022 - 10:33

Thanks, I'll have a go with that idea.