<doc>

<legacy_id>1979</legacy_id>

<name>qtVersion</name>

<type>function</type>

<syntax>

<example>the qtVersion</example>

<example>qtVersion()</example>

</syntax>

<synonyms>

</synonyms>

<summary><glossary tag="return">Returns</glossary> the version of <glossary tag="QuickTime">QuickTime</glossary> installed on the system. </summary>

<examples>

<example>the qtVersion</example>

<example>if the qtVersion &lt; 3 then answer &quot;You need QuickTime 3.0 or later.&quot;</example>

</examples>

<history>

<introduced version="1.0">Added. </introduced>

<deprecated version=""></deprecated>

<removed version=""></removed>

</history>

<objects>

</objects>

<platforms>

<mac/>

<windows/>

<linux/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

</classes>

<security>

</security>

<classification>

<category>Images &amp; Multimedia</category>

<category>The System Environment</category>

</classification>

<references>

<function tag="systemVersion">systemVersion Function</function>

<function tag="qtEffects">qtEffects Function</function>

<function tag="recordFormats">recordFormats Function</function>

<function tag="buildNumber">buildNumber Function</function>

<command tag="play">play Command</command>

<property tag="dontUseQT">dontUseQT Property</property>

<property tag="videoClipPlayer">videoClipPlayer Property</property>

<property tag="dontUseQTEffects">dontUseQTEffects Property</property>

<property tag="qtIdleRate">qtIdleRate Property</property>

</references>

<description>

<overview>Use the <b>qtVersion</b> function to make sure the version of QuickTime that's installed is recent enough to handle any version-dependent features in movies you want to play.</overview>

<parameters>

</parameters>

<value>The <b>qtVersion</b> function returns a positive number.</value>

<comments>On Unix systems, the <b>qtVersion</b> function always <glossary tag="return">returns</glossary> 2.0.<p></p><p>On Mac OS and Windows systems, if <glossary tag="QuickTime">QuickTime</glossary> is not installed, the <b>qtVersion</b> function <glossary tag="return">returns</glossary> 0.0. Otherwise, it returns the <glossary tag="QuickTime">QuickTime</glossary> version number.</p><p></p><p></p><tip>It can take LiveCode a second or two to load the code needed to use <glossary tag="QuickTime">QuickTime</glossary>, depending on the machine speed. Since this code is only <glossary tag="loaded into memory">loaded into memory</glossary> once per session, you can speed up the first occurrence of a QuickTime-related action by calling the <function tag="qtVersion">qtVersion</function> function during otherwise dead time--for example, during startup of your application--to preload the code.</tip></comments>

</description>

</doc>