User Tools

Site Tools


macros:identifier:handle

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
macros:identifier:handle [2018/06/19 15:34] – ↷ Links adapted because of a move operation icke_siegenmacros:identifier:handle [2024/08/24 08:50] (current) icke_siegen
Line 1: Line 1:
-Types/Object+Identifiers
  
 ====== Handle ====== ====== Handle ======
Line 7: Line 7:
 >>>Handle is a specific object type used to describe a particular item inside the whole Titan show structure. Examples for handles are: playbacks (the physical faders/buttons, as well as the touch buttons), palette handles (palette buttons, touch or real, as well as palettes addressed by their name/number), fixture handles (again: real buttons or touch buttons or abstract places addressed by their number). >>>Handle is a specific object type used to describe a particular item inside the whole Titan show structure. Examples for handles are: playbacks (the physical faders/buttons, as well as the touch buttons), palette handles (palette buttons, touch or real, as well as palettes addressed by their name/number), fixture handles (again: real buttons or touch buttons or abstract places addressed by their number).
  
-As such, a handle has at minimum these properties:+As such, a handle has at minimum these properties (listed here as identifiers themselves as they may be used in various context):
  
   * the [[macros:identifier:titanid]]   * the [[macros:identifier:titanid]]
-  * the [[macros:types:object:handle:location]] +  * the [[macros:identifier:location]] 
-  * the [[macros:types:object:handle:usernumber]]+  * the [[macros:identifier:usernumber]]
  
 These properties can also be used to identify a particular handle, e.g. to retrieve its other values, to store something onto it, or to delete its contents. These properties can also be used to identify a particular handle, e.g. to retrieve its other values, to store something onto it, or to delete its contents.
Line 30: Line 30:
 ==== select by location ==== ==== select by location ====
  
-More details for [[macros:types:object:handle:location|location are here]].+More details for [[macros:identifier:location|location are here]].
  
 <code xml> <code xml>
Line 36: Line 36:
 </code> </code>
  
-This calls the function [[macros:function:cuelists.goback]] and refers it to the handle identified by the [[macros:types:object:handle:location]] string ''"Location=Playbacks,2,1"'': Playbacks, Page 3, Number 2.+This calls the function [[macros:function:cuelists.goback]] and refers it to the handle identified by the [[macros:identifier:location]] string ''"Location=Playbacks,2,1"'': Playbacks, Page 2, Number 1. You may also want to have a look at [[http://www.avosupport.de/downloads/miditoweb/gettitanids.htm|getTitanIds]] in order to find the correct locations.
  
 In general, location is passed as string, with strict formating: In general, location is passed as string, with strict formating:
Line 60: Line 60:
 ==== select by userNumber ==== ==== select by userNumber ====
  
-More details for [[macros:types:object:handle:usernumber|userNumber are here]].+More details for [[macros:identifier:usernumber|userNumber are here]].
  
 <code xml> <code xml>
Line 66: Line 66:
 </code> </code>
  
-This calls the function [[macros:function:playbacks.releaseplayback]] for the playback handle with the [[macros:types:object:handle:usernumber]] 2 (and again some more parameters which are not relevant for this object call).+This calls the function [[macros:function:playbacks.releaseplayback]] for the playback handle with the [[macros:identifier:usernumber]] 2 (and again some more parameters which are not relevant for this object call).
  
 Here, the userNumber is passed like this: Here, the userNumber is passed like this:
Line 73: Line 73:
  
 Technically, this syntax looks like https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/classes-and-structs/named-and-optional-arguments: you have to name the argument 'userNumber', and after a colon give the value. Technically, this syntax looks like https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/classes-and-structs/named-and-optional-arguments: you have to name the argument 'userNumber', and after a colon give the value.
 +
 +Another hint http://forum.avolites.com/viewtopic.php?f=20&t=5997:
 +
 +>You cannot use the userNumber cast for the IsClaimed function as Handles is used for all types of handles and therefore it doesn’t know to what type of handle the user number pertains.
 +
 +  Handles.IsClaimed(userNumber:83)
 +
 +does not work but
 +
 +  Handles.IsClaimed("cueHandleUN=1")
 +  
 +does.
  
 == Also used in == == Also used in ==
macros/identifier/handle.1529422449.txt.gz · Last modified: 2018/06/19 15:34 (external edit)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki