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

	<syntax>
		<example>set the usePixelScaling to <i>true</i>|<i>false</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Determines whether or not LiveCode will automatically apply pixel scaling.</summary>

	<examples>
<example><p>on preOpenStack</p><p>   set the usePixelScaling to false</p><p>end preOpenStack</p></example>
	</examples>

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

	<objects>
		<global/>
	</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>
		<command tag="iphoneUseDeviceResolution">iphoneUseDeviceResolution Command</command>
		<property tag="systemPixelScale">systemPixelScale Property</property>
		<property tag="usePixelScaling">usePixelScaling Property</property>
		<property tag="pixelScale">pixelScale Property</property>
		<property tag="screenPixelScale">screenPixelScale Property</property>
		<property tag="screenPixelScales">screenPixelScales Property</property>
	</references>

	<description>
	<overview>Set the <b>usePixelScaling </b>property to false to prevent LiveCode automatically scaling your stack.</overview>

		<parameters>
		</parameters>

	<value>The <b>usePixelScaling</b> property returns true or false.</value>
	<comments>If the <b>usePixelScaling</b> property is set to false, pixel scaling will be disabled and LiveCode will draw at a 1:1 scale, allowing the operating system to perform any default scaling. For example, by default, iOS will upscale stacks running on retina devices.<p></p><p>When the <b>usePixelScaling</b> property is false, the <property tag="pixelScale">pixelScale property</property> is set to 1 and is not modifiable.</p><p></p><p>Due to limitations of the platform, applications on Windows will not be able to enable or disable pixel scaling. On Android there is no equivalent OS-level scaling provided, so pixel scaling will always be used.</p><p></p><p><b>Handling multiple displays</b></p><p>Desktop systems may have multiple displays attached, each with their own density value. On platforms that support different scale values for each display, LiveCode  automatically renders each stack at the correct scale for the screen on which it is displayed.</p><p></p><p>As there may be multiple displays with differing scale values, The global systemPixelScale property returns the maximum screen density for all connected displays.</p><p></p><p>Two additional global properties have been added to provide the pixel scale values when multiple displays are available:</p><p>* The <property tag="screenPixelScale">screenPixelScale property </property>returns the pixel scale of the main screen</p><p>* The <property tag="screenPixelScales">screenPixelScales property</property> a return-delimited list of the pixel scale of each connected display</p></comments>
	</description>
</doc>