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

	<syntax>
		<example>set the pixelScale to <i>scale</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Determines the scaling factor between logical and device pixels.</summary>

	<examples>
<example><p>on preOpenStack</p><p>   set the pixelScale to 1.5</p><p>end preOpenStack</p></example>
<example>set the pixelScale to the systemPixelScale -- Reset the pixelScale to the device pixel scale</example>
	</examples>

	<history>
		<introduced version="6.5">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
		<global/>
	</objects>

	<platforms>
		<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>
		<command tag="iphoneUseDeviceResolution">iphoneUseDeviceResolution Command</command>
		<property tag="systemPixelScale">systemPixelScale Property</property>
		<property tag="usePixelScaling">usePixelScaling Property</property>
	</references>

	<description>
	<overview>Use the <b>pixelScale </b>property to set the scale at which your stack is rendered on mobile devices.</overview>

		<parameters>
  <parameter>
    <name>scale</name>
    <description>Any positive real number.</description>
  </parameter>		</parameters>

	<value></value>
	<comments>Modern mobile devices have screens of varying densities. For example, the iPad and iPad retina both have a logical screen size of 1024x768 pixels. However, the iPad retina has 2048x1536 device pixels. The intention of higher density is not to provide the developer with more screen real estate to work with, but rather to make text and other assets appear crisper.<p></p><p>LiveCode reports the <function tag="screenRect">screenRect</function> of both iPad and iPad retina in logical pixels (1024x768). When your app runs on the iPad Retina, LiveCode renders text, graphics and image assets according to the pixelScale.</p><p></p><p>The <b>pixelScale</b> property enables you to change the standard behavior and use the additional pixels provided by higher density devices.</p><p></p><p></p><note> The <b>pixelScale</b> is initialised to the systemPixelScale property on startup but can be modified at any point.</note><p>&#9;</p></comments>
	</description>
</doc>