This is a child page. You can use Parent in the quick nav bar at the top or the bottom of the page to navigate directly back to the parent of this page. Some child pages are more than one level deep, and in that case will require more than one Parent click to reach the outermost document level.

16.96.5 - Image Stacking Script Commands

When a script is run, it is provided with the action image that the user (or the timeline) created an area selection upon. That image may be "pushed" to and "pulled" from, an image stack that can hold up to 100 images (memory permitting.)

For scripting, F/x implements a stack for images. A stack of images is just like a stack of plates; when you put the first object on the stack, it's now both the "top" and the "bottom" of the stack. We'll call that plate one. Now, if you put another plate on the stack (plate 2), you now cannot reasonably get at plate one unless you take plate two away first, because it is sitting on top of plate one. F/x's image stack works just like this, allowing you to save and retrieve images, rather than plates, in an orderly manner.

To place an image on the stack, use PUSHIMAGE. To remove an image from the stack and make it the current image, use POPIMAGE or PULLIMAGE. There is now one less image on the stack. F/x's image stack may contain up to 100 images.

The following script commands provide tools to manipulate images against the image stack within the context of a script:

PUSHIMAGE

This command places the current image on the top of the stack, increasing the stack's depth by one level.
PULLIMAGE

This command removes the topmost image on the stack and makes it the current image. The previous current image is lost. A synonym for this command is POPIMAGE.
POPIMAGE

This command removes the topmost image on the stack and makes it the current image. The previous current image is lost. A synonym for this command is PULLIMAGE.
SWAPIMAGE(level)

This command exchanges the specified image level within the stack with the top image in the stack. Setting level to one swaps the top of the stack with the image one level deeper in the stack and so on. The currently used image is not affected by this operation.
EXGIMAGE

This command exchanges the current image with the top image in the stack.
DUPIMAGE

This command pushes the top image in the stack down one level, then places a duplicate of that image on the top of the stack.
DROPIMAGE

This command discards the top image in the stack, making the stack one level shallower.
Keyboard Navigation
, Previous Page . Next Page t TOC i Index o Operators g Glossary
WinImages F/x, Morph and all associated documentation
Copyright © 1992-2007 Black Belt Systems ALL RIGHTS RESERVED Under the Pan-American Conventions
WinImages F/x Manual Version 7, Revision 6, Level A

Valid HTML 4.01 Loose
 

This manual was generated with wtfm
wtfm uses aa_macro and SqLite
aa_macro uses python 2.7
Page 263