Lingo Dictionary > G-K > image |
![]() ![]() ![]() |
image
Syntax
whichMember
.image
(the stage).image window(windowName
).image
Description
This property refers to the image object of a bitmap or text cast member, of the Stage, or of a window. You can get or set a cast member's image, but you can only get the image of the Stage or a window.
Setting a cast member's image property immediately changes the contents of the member. However, when you get the image of a member or window, Director creates a reference to the image of the specified member or window. If you make changes to the image, the contents of the cast member or window change immediately.
If you plan to make a lot of changes to an item's image property, it is faster to copy the item's image property into a new image object using the duplicate()
function, apply your changes to the new image object, and then set the original item's image to the new image object. For non-bitmap members, it is always faster to use the duplicate()
function.
The image
property can be tested but not set for text, Flash, and vector shape members.
Example
This statement puts the image of cast member originalFlower into cast member newFlower.
member("newFlower").image = member("originalFlower").image
Example
These statements place a reference to the image of the stage into the variable myImage
and then put that image into cast member flower.
myImage=(the stage).image member("flower").image = myImage
See also
setPixel(), draw(), image(), fill(), duplicate() (image function), copyPixels()
![]() ![]() ![]() |