Mac Home Automation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

=====Adjust Color=====
The Adjust Color verb can be used to adjust the brightness of an HTML color string. It takes a starting color and some number of adjustments as parameters and returns a new HTML color string with the new color in standard HTML color format “RRGGBB”

The only adjustment currently supported is for brightness. You can adjust the brightness absolutely or relatively. 

===Brightness===
The optional **brightness** parameter is for absolute color adjustment. It takes a decimal number between 0 and 1 with 1 being full brightness and 0 being black. 

===Brightness By===
The optional **brightness by** parameter is for relative adjustments of color. To brighten a color pass a positive decimal number between 0 and 1. To darken a color pass a negative value between 0 and 1. You cannot brighten a color more than 1 nor darken it to less than 0 but it doesn’t hurt to pass values that would result in that. The color will just be fully bright or fully black as a result.



===Usage:===
Absolute setting of a pure red color to 50% brightness.

<code>
set myColorString to adjust color “FF0000” brightness 0.5
</code>

Making a slightly darker version of a yellow

<code>
set myColorString to adjust color “FFAA22” brightness by -0.25
</code>

===History:===
  * Added to XTension in version 9.3.2

Mac Home Automation

User Tools

Site Tools

Page Tools