<doc>

<legacy_id>1625</legacy_id>

<name>image</name>

<type>object</type>

<syntax>

</syntax>

<library></library>

<objects>

</objects>

<synonyms>

<synonym>img</synonym>

</synonyms>

<classification>

<category>Objects &amp; Messages</category>

</classification>

<references>

<object tag="graphic">graphic Object</object>

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

<keyword tag="templateImage">templateImage Keyword</keyword>

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

</references>

<history>

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

</history>

<platforms>

<mac/>

<windows/>

<linux/>

<ios/>

<android/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

<mobile/>

</classes>

<security>

</security>

<summary>A <keyword tag="control">control</keyword> that contains a <glossary tag="bitmap">bitmapped</glossary> picture.</summary>

<examples>

<example>hide image "Blinking Star"</example>

<example>export image ID 9234 to file "Test Image.jpg"</example>

</examples>

<description>

<p>Use the <b>image</b> <glossary tag="object type">object type</glossary> to hold photographs, icons, and decorative elements, and to allow the user to paint.</p><p/><p><b>Comments:</b></p><p>Each image contains a bitmapped picture, which can either be imported with the <b>import</b> <glossary tag="command">command</glossary> or created using the <glossary tag="paint tool">paint tools</glossary>. An <keyword tag="image">image</keyword> can display either its own data, or a <keyword tag="file">file</keyword> specified by the <glossary tag="image">image's</glossary> <property tag="filename">filename</property> <glossary tag="property">property</glossary>.</p><p/><p>An image is contained in a card, group, or background. Images cannot contain other objects.</p><p/><p>The image object has a number of properties and messages associated with it. To see a list of messages that can be sent to an image as a result of user actions or internal LiveCode events, open the "LiveCode Language Dictionary" page of the main Documentation window, ensure that the image column is visible and use sort and filter to bring the relevant entries to the top</p><p/><p><b>Note:</b> Animated GIFs cannot be resized in LiveCode.</p>

</description>

</doc>