User Tools

Site Tools


webapi:parameters:level

This is an old revision of the document!


Table of Contents

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

Used In

webapi/parameters/level.1586772507.txt.gz · Last modified: 2020/04/13 12:08 by icke_siegen