Example

====== Capture - Ambient Lighting ======

^ by: | Alex del Bondio, April 2019 |
^ published: | here |
^ description: | change Capture ambient lighting settings via macro |
^ remarks: |  |

Remarks
  * these macros use a combination of ambient lighting and exposure to simulate night, dusk and daytime (which can also be helpful to make fixtures more visible when setting up capture)

{{tag> capture ambient lighting exposure settings }}

==== functions ====
  * [[:macros:function:ActionScript.SetProperty.Float]]

==== affected properties ====
  * [[:macros:property:Visualiser.Capture.AmbientLighting]]
  * [[:macros:property:Visualiser.Capture.ExposureAdjustment]]

===== Code =====
<code xml captureambientlighting.xml>
<?xml version="1.0" encoding="utf-8"?>
<avolites.macros>

  <!-- AmbientLighting, Alex del Bondio - April 2019 -->
  <macro id="adb.Macros.Capture.day" name="Capture Day">
    <active binding="{propertyLink id='Visualiser.Capture.AmbientLighting' 
      converter='Math.EqualityConverter' 
      converterParameter='1'}"/>
    <sequence>
      <step>ActionScript.SetProperty.Float("Visualiser.Capture.AmbientLighting", 1)</step>
      <step>ActionScript.SetProperty.Float("Visualiser.Capture.ExposureAdjustment", 1)</step>
    </sequence>
  </macro>
  
  <macro id="adb.Macros.Capture.dusk" name="Capture Dusk">
    <active binding="{propertyLink id='Visualiser.Capture.AmbientLighting' 
      converter='Math.EqualityConverter' 
      converterParameter='0.3'}"/>
    <sequence>
      <step>ActionScript.SetProperty.Float("Visualiser.Capture.AmbientLighting", 0.3)</step>
      <step>ActionScript.SetProperty.Float("Visualiser.Capture.ExposureAdjustment", 0.5)</step>
    </sequence>
  </macro>
  
  <macro id="adb.Macros.Capture.night" name="Capture Night">
    <active binding="{propertyLink id='Visualiser.Capture.AmbientLighting' 
      converter='Math.EqualityConverter' 
      converterParameter='0.05'}"/>
    <sequence>
      <step>ActionScript.SetProperty.Float("Visualiser.Capture.AmbientLighting", 0.05)</step>
      <step>ActionScript.SetProperty.Float("Visualiser.Capture.ExposureAdjustment", 0.5)</step>
    </sequence>
  </macro>

</avolites.macros>
</code>


===== Explanation =====

This explains the functional steps within the sequence. For all the other XML details please refer to [[:macros:formats_and_syntax#xml_format|Formats and syntax]]

  * ''Visualiser.Capture.AmbientLighting'' sets the Ambient Lighting level
  * ''Visualiser.Capture.ExposureAdjustment'' sets the Exposure level


===== How to use it =====

  * [[:macros:deploying|make this macro available]]

~~DISCUSSION~~