<doc>
	<legacy_id></legacy_id>
	<name>compositorCacheLimit</name>
	<type>property</type>

	<syntax>
		<example>set the compositorCacheLimit of <i>stack</i> to <i>cacheLimit</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies the maximum number of bytes the engine should use to cache content for the stack.</summary>

	<examples>
<example>set the compositorCacheLimit of this stack to 8388608 -- 8Mb</example>
<example><p>put 4 *1024 * 1024 into tCacheLimit -- 4Mb</p><p>set the compositorCacheLimit of this stack to tCacheLimit</p></example>
	</examples>

	<history>
		<introduced version="5.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
	</history>

	<objects>
		<stack/>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Objects &amp; Messages</category>
		<category>Windows &amp; Dialog Boxes</category>
		<concept>display</concept>
	</classification>

	<references>
		<property tag="compositorType">compositorType Property</property>
		<property tag="compositorTileSize">compositorTileSize Property</property>
		<property tag="layerMode">layerMode Property</property>
	</references>

	<description>
	<overview>Use the <b>compositorCacheLimit </b>property to specify the maximum number of bytes the engine should use to cache content for the stack. If the limit is not big enough to render the stack, accelerated rendering is not used and the default rendering used instead.</overview>

		<parameters>

      <parameter>
        <name>Stack</name>
        <description>The name or ID of the stack.</description>
      </parameter>
      <parameter>
        <name>cacheLimit</name>
        <description>A number containing the maximum number of bytes to be used when caching dynamic content.</description>
      </parameter>
		</parameters>

	<value></value>
	<comments><note>The required size of the <b>compositorCacheLimit</b> can be determined by the objects whose <property tag="layerMode">layerMode</property> property is set to 'dynamic'.  The <b>compositorCacheLimit </b>should be set to the amount of memory the LiveCode engine needs to cache them. If you have 10 layers all 400x400 pixels, you need roughly 10*400*400*4 bytes. Experimentation is required to find the optimal value.<p></note><p></p><note>Set the compositor properties in a preOpenStack or preOpenCard handler - they are not persistent (not saved into the stackfile).</note></comments>
	</description>
</doc>