Languages

Dynamics API properties

• Feb 18, 2022 - 20:42

I'm considering writing a plugin that would enable increasing/decreasing dynamics by step so that if one has a selection of varying dynamics, they could change them all at once and keep the same relationship. See feature in Dorico: https://steinberg.help/dorico/v3.5/en/dorico/topics/notation_reference/…

Can someone explain the dynamic subtype property? It seems to be associated with the dynamic (ppp is 4, pp is 5, fff is 11), but has no bearing on the text if it's changed. So, if I wanted to change a dynamic, I should still adjust this property as well as the text and velocity?

Comments

jeetee

• Feb 18, 2022 - 21:25

I'd indeed think it'd be best to change all of the relevant properties here. For dynamics the subType corresponds with the DynamicType which is a value of this enum:

      enum class Type : char {
            OTHER,
            PPPPPP,
            PPPPP,
            PPPP,
            PPP,
            PP,
            P,
            MP,
            MF,
            F,
            FF,
            FFF,
            FFFF,
            FFFFF,
            FFFFFF,
            FP,
            SF,
            SFZ,
            SFF,
            SFFZ,
            SFP,
            SFPP,
            RFZ,
            RF,
            FZ,
            M,
            R,
            S,
            Z
            };

jonarnold

• Feb 18, 2022 - 22:29

That's great, thanks! It's going to be easier to make a new array that also contains the velocity and text value (i.e. dynamicPiano) than try to access the one you posted, right?

jeetee

• Feb 18, 2022 - 22:35

The enum I posted is on the C++ side, in the API you only get/use the numeric equivalent.
So yes, making an object array makes sense for this.