Function

====== Programmer.Editor.Fixtures.SetControlValueById ======

  Void Programmer.Editor.Fixtures.SetControlValueById
  (
    Int32 controlId, Int32 functionId, Single value, Boolean programmer, Boolean createRestorePoint
  )

^ API | http://api.avolites.com/10.1/Programmer.Editor.Fixtures.SetControlValueById.html |
^ description | Sets the attribute current value of all currently selected fixtures. |
^ [[macros:namespace|namespace]] | [[macros:namespace:Programmer.Editor.Fixtures]] |
^ parameter | controlId ( [[macros:type:int32]] ) : id of the attribute to set, see [[macros:identifier:fixturecontrolid|]] |
^ ::: | functionId ( [[macros:type:int32]] ) : id of the attribute function to set |
^ ::: | value ( [[macros:type:single]] ) : the value to set the attribute to |
^ ::: | programmer ( [[macros:type:boolean]] ) : if set to true puts the attribute into the programmer. | 
^ ::: | createRestorePoint ( [[macros:type:boolean]] ) : should a restore point be created |
^ return value | [[macros:type:void]] |  

tbd. elaborate on control ID and function ID

for the moment: 
  * controlIDs are listed by Olie here: http://forum.avolites.com/viewtopic.php?f=21&t=5189
  * functionIDs most likely refer to the ID which is set in the personality

==== Example in ==== 
//This is an untested example.//

<code xml>
  <step>Programmer.Editor.Fixtures.SetControlValueById(16, 1, 0.5, true, true)</step>
</code>

This should set the currently selected fixtures to 50% dimmer level, put this in the programmer and create a restore point:
  * 16 refers to 0x10 which is the hex [[:macros:identifier:FixtureControlId]] of the [[:personality:attribute id|attribute ID]] for the dimmer
  * 1 is the - assumed - function ID for the [[personality:attribute function|attribute function]] 'Dimmer'
  * 0.5 is 50%
  * true (the first) puts this into the programmer
  * true (the second) creates a restore point

See also [[:macros:function:Programmer.Editor.Fixtures.SetControlValueByName]] which takes the name of the attribute and function instead of requiring the ID numbers.

== Also used in ==

{{backlinks>.}}

== Remarks ==

~~DISCUSSION~~