<doc>
  <legacy_id>1898</legacy_id>
  <name>lockColorMap</name>
  <type>property</type>
  <syntax>
    <example>set the lockColormap to {true | false}</example>
  </syntax>
  <library></library>
  <objects>
    <global/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Appearance &amp; Positioning</category>
  </classification>
  <references>
    <command tag="unlock colorMap">unlock colorMap Command</command>
    <property tag="remapColor">remapColor Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
  </security>
  <summary>Specifies whether changes to the <glossary tag="color table">color table</glossary> cause the screen to be <glossary tag="redraw">redrawn</glossary> with the new <glossary tag="color table">color table</glossary>.</summary>
  <examples>
    <example>set the lockColormap to true</example>
  </examples>
  <description>
    <p>Use the <b>lockColorMap</b> <glossary tag="property">property</glossary> to trade off between color accuracy and possible screen flashing when the <glossary tag="bit depth">bit depth</glossary> of the screen is 8 <glossary tag="bit">bits</glossary> (256 colors) or less.</p><p/><p><b>Value:</b></p><p>The <b>lockColormap</b> is true or false.</p><p/><p>By default, the <b>lockColorMap</b> <glossary tag="property">property</glossary> is set to true on <glossary tag="Mac OS">Mac OS systems</glossary> with 8-<glossary tag="bit">bit</glossary> displays (the <function tag="screenColors">screenColors</function> equal to 256), and to false otherwise.</p><p/><p><b>Comments:</b></p><p>If the <b>lockColorMap</b> <glossary tag="property">property</glossary> is set to false, newly-displayed <glossary tag="image">images</glossary>, <glossary tag="video clip">videoclips</glossary>, and <glossary tag="player">players</glossary> can change the <glossary tag="color table">color table</glossary> used by LiveCode. This displays the colors in <glossary tag="image">images</glossary> and movies more accurately, but can cause screen flashing. (To minimize screen flashing when the <b>lockColorMap</b> is false, go to the <keyword tag="card">card</keyword> containing the <keyword tag="image">image</keyword> and then set the <b>lockColorMap</b> <glossary tag="property">property</glossary> to true.)</p><p/><p>If the <b>lockColorMap</b> is true, the <glossary tag="color table">color table</glossary> cannot be changed. In this case, if an <keyword tag="image">image</keyword>, <glossary tag="video clip">video clip</glossary>, or <keyword tag="player">player</keyword> contains a color not in the current <glossary tag="color table">color table</glossary>, the closest existing color is substituted. This may cause banding or strange-looking displays in photographs and other <glossary tag="image">images</glossary> that contain a smooth gradation of colors.</p><p/><p>This property has no effect on systems using 16-bit or 24-bit color.</p>
  </description>
</doc>