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

	<syntax>
		<example>set the acceleratedRendering of <i>stack</i> to { true | false }</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies whether to use accelerated rendering for this stack</summary>

	<examples>
<example>set the acceleratedRendering of this stack to true</example>
	</examples>

	<history>
		<introduced version="5.0.2">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="compositorTileSize">compositorTileSize Property</property>
		<property tag="layerMode">layerMode Property</property>
	</references>

	<description>
	<overview>Use the <b>acceleratedRendering </b>property to put LiveCode into accelerated rendering mode and set the compositor properties to recommended defaults.</overview>

		<parameters>
  <parameter>
    <name>Stack</name>
    <description>The name or ID of the stack.</description>
  </parameter>		</parameters>

	<value></value>
	<comments>The <b>acceleratedRendering</b> property has been added to help simplify the use of the accelerated rendering features. When set to true, LiveCode automatically configures the compositor properties to the best defaults for the current platform.<p></p><p>When <b>acceleratedRendering</b> is set to true, if the compositorType has not previously been set, the engine configures the compositor properties as follows:</p><p></p><p>* Mac: compositorType = CoreGraphics, compositorTileSize = 32, compositorCacheLimit = 32Mb</p><p>* Windows/Linux: compositorType = Software, compositorTileSize = 32, compositorCacheLimit = 32Mb</p><p>* iOS (non-Retina iPhone): compositorType = OpenGL, compositorTileSize = 32, compositorCacheLimit = 16Mb</p><p>* iOS (iPad / Retina iPhone): compositorType = OpenGL, compositorTileSize = 64, compositorCacheLimit = 32Mb</p><p>* iOS (iPad Retina): compositorType = OpenGL, compositorTileSize = 64, compositorCacheLimit = 64Mb</p><p>* Android (VGA screen or smaller): compositorType = OpenGL, compositorTileSize = 32, compositorCacheLimit = 16Mb</p><p>* Android (larger than VGA screen): compositorType = OpenGL, compositorTileSize = 64, compositorCacheLimit = 32Mb</p><p></p><p>If the <b>acceleratedRendering</b> property is set to false, then the compositorType is set to empty.</p><p></p><p></p><p></p><warning>Changing the compositor settings from their defaults is only recommended for advanced users.</warning><p></p><p></p><p></p><note>Set the <b>acceleratedRendering</b> property in a preOpenStack or preOpenCard handler - it is not persistent (not saved into the stackfile).</note></comments>
	</description>
</doc>