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.45orlevel_level=.45 - absolute level 0%:
level_level=0 - relative: increase level by 20% (i.e. from 35% to 55%):
level_levelDelta=0.2orlevel_levelDelta=.2 - relative: decrease level by 55% (i.e. from 90% to 35%):
level_levelDelta=-0.55orlevel_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
