<doc>
  <legacy_id>3526</legacy_id>
  <name>dropShadow</name>
  <type>property</type>
  <syntax>
    <example>set the dropShadow of object to <i>propertiesArray</i></example>
    <example>set the dropShadow[<i>propertyName</i>] of object to <i>propertyValue</i></example>
  </syntax>
  <library></library>
  <objects>
    <group/>
    <field/>
    <button/>
    <graphic/>
    <scrollbar/>
    <player/>
    <image/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
  </classification>
  <references>
    <property tag="colorOverlay">colorOverlay Property</property>
    <property tag="innerGlow">innerGlow Property</property>
    <property tag="innerShadow">innerShadow Property</property>
    <property tag="outerGlow">outerGlow Property</property>
    <property tag="blendLevel">blendLevel Property</property>
    <property tag="ink">ink Property</property>
  </references>
  <history>
    <introduced version="4.0.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Specifies the drop shadow to use for an object.</summary>
  <examples>
    <example>set the dropShadow of button "Ok" to tDropshadowPropertiesArray</example>
    <example>set the dropShadow["color"] of me to "255,0,0"</example>
  </examples>
  <description>
    <p>Use the <b>dropShadow</b> property to create a shadow effect on an object. The <b>dropShadow</b> is an array style property, each key of the array controls a different <b>dropShadow</b> parameter that will affect its final appearance. The easiest way to adjust these properties is by using the Graphic Effects card of the property inspector which has full control over each parameter. To control the effect by script use the following properties:</p>
<p></p>
<p>dropShadow[&quot;<b>color</b>&quot;]</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The color of the shadow, in the format red,green,blue where each value is between 0 and 255.</p>
<p></p>
<p>dropShadow[&quot;<b>blendMode</b>&quot;]</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;How the shadow is blended with objects behind it. This is one of the following values:</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- &quot;normal&quot; : the shadow is laid over the background.</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- &quot;multiply&quot; : this results in a darkening effect</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- &quot;colorDodge&quot; : this results in a lightening effect</p>
<p></p>
<p>dropShadow[&quot;<b>opacity</b>&quot;]</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;How opaque the shadow is. The value is between 0 (fully transparent) and 255 (fully opaque).</p>
<p></p>
<p>dropShadow[&quot;<b>filter</b>&quot;]</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Which algorithm is used to render the shadow. This is one of the following options:</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;gaussian&quot; : highest quality (and slowest)</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;box3pass&quot; : high quality.</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;box2pass&quot; : medium quality</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&quot;box1pass&quot; : low quality (and fastest)</p>
<p></p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;When using the &quot;colorDodge&quot; blend mode, it is recommended that you set the filter mode to &quot;gaussian&quot;.</p>
<p></p>
<p>dropShadow[&quot;<b>size</b>&quot;]</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The size of the shadow, i.e. how large the shadow is. This is between 0 and 255.</p>
<p></p>
<p>dropShadow[&quot;<b>spread</b>&quot;]</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This controls where the effect begins to blend. This is between 0 and 255.</p>
<p></p>
<p>dropShadow[&quot;<b>distance</b>&quot;]</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This controls how far the shadow is offset from the object. This is between 0 and 359.</p>
<p></p>
<p>dropShadow[&quot;<b>angle</b>&quot;]</p>
<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The controls the direction the shadow is cast in. This is between 0 and 360.</p>
  </description>
</doc>