Web API Parameter
Level
“Level” is a numeric value denoting the level a given thing (e.g. playback) is to be set to, fired at, or whatsoever.
- The level can be absolute ('set playback x to y%') or relative ('lower playback x by y%').
- If used absolute the value itself needs to be in the range 0 ~ 1. If used relative the value needs to be in the range -1 ~ 1
- decimal places are allowed using a
.
Examples
- absolute level 100%:
level_level=1
- absolute level 45%:
level_level=0.45
orlevel_level=.45
- absolute level 0%:
level_level=0
- relative: increase level by 20% (i.e. from 35% to 55%):
level_levelDelta=0.2
orlevel_levelDelta=.2
- relative: decrease level by 55% (i.e. from 90% to 35%):
level_levelDelta=-0.55
orlevel_levelDelta=-.55
Errors
If the parsing method is given incorrectly or not given at all then Titan guesses the numeric value to be the absolute level:
level=0.4
or level_dummy=0.4
both are treated as absolute level 40%.
However leveldelta (small letter d!) is treated a different parsing:
level_leveldelta=.2
throws this error
“Error: Das Objekt mit dem Typ \”System.Boolean\“ kann nicht in den Typ \”Avolites.Menus.Maths.LevelAdjust\“ konvertiert werden.”
(cannot convert System.Boolean to LevelAdjust)
level_level=
results in “Error: Die Eingabezeichenfolge hat das falsche Format.”
(wrong format)
Reason: the value is missing
level_level
results in “Error: Der Objektverweis wurde nicht auf eine Objektinstanz festgelegt.”
(no object instantiated)
Reason: the equal sign =
(and the value) are missing, thus the parameter isn't recognized at all