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

	<syntax>
		<example>set the compositorTileSize of <i>stack</i> to <i>tileSize</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies the size the fragments of object images it caches should be.</summary>

	<examples>
<example>set the compositorTileSize of this stack to 128</example>
<example><p>put 256 into tTileSize</p><p>set the compositorTileSize of this stack to tTileSize</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="compositorCacheLimit">compositorCacheLimit Property</property>
		<property tag="layerMode">layerMode Property</property>
	</references>

	<description>
	<overview>Use the <b>compositorTileSize </b>property to specify the size the fragments of object images it caches should be. It must be a power-of-two between 16 and 256 inclusive (i.e. 16, 32, 64, 128 or 256).</overview>

		<parameters>

  <parameter>
    <name>Stack</name>
    <description>The name or ID of the stack.</description>
  </parameter>
  <parameter>
    <name>tileSize</name>
    <description>A number specifying the size of tiles the engine uses when caching. It must be a power-of-two between 16 and 256 inclusive (16, 32 (default), 64, 128 or 256). The smaller the number, the more potential for engine optimizations as less is redrawn when layers change. However, there is a higher overhead. Experimentation is required to gain optimal performance.</description>
  </parameter>
		</parameters>

	<value></value>
	<comments>General suggested <i>tileSize</i> settings:<p>- iOS Retina displays: 64</p><p>- iOS Non-retina: 32</p><p>- Android large screens: 64</p><p>- Android small screens: 32</p><p>- Desktop: 32</p><p></p><p></p><note>Use a large tile size when creating big scrolling layers. The maximum size of a scrolling layer is 256 * the <i>tileSize</i>. </note><p></p><p></p><warning>Using a very small <i>tileSize</i> when in openGL mode may decrease performance.</warning><p></p><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>