| 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.6 - Mask Stacking Script Commands
For scripting, F/x implements a stack for masks. When a script is run, it is provided with the mask that the user (or the timeline) created with an area selection. That mask may be "pushed" to and "pulled" from, a mask stack that can hold up to 100 masks (memory permitting.)
A stack of masks 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 mask stack works just like this, allowing you to save and retrieve masks, rather than plates, in an orderly manner.
To place a mask on the stack, use PUSHMASK. To remove a mask from the stack and make it the current mask, use POPMASK or PULLMASK. There is now one less mask on the stack. F/x's mask stack may contain up to 100 masks.
The following script commands provide tools to manipulate masks against the mask stack within the context of a script:
To remove a mask from the stack and make it the current mask, use POPMASK. There is now one less mask on the stack.
To put the current mask on the stack, use PUSHMASK. This mask is now the "top" mask on the stack, and can be retrieved using POPMASK.
This command exchanges the specified mask on the stack with the current mask. Setting level to 0 swaps with the top of the stack; setting it to one swaps with the mask one level deeper in the stack, and so on.
To dispose of the mask on the top of the stack without making it the current mask, use DELMASK.
This command discards the top mask in the stack, making the stack one level shallower.
This exchanges the current mask with the mask on the top of the stack.
This combines the current mask with the mask on the top of the stack. The mask on the top of the stack is not affected, nor is it removed from the stack. The combination is such that the mask will represent the lesser of the two selection values; if, for a particular mask pixel, the mask was 25 and the mask on top of the stack was 13, then the result value is 13.
, Previous Page . Next Page t TOC i Index o Operators g Glossary
Copyright © 1992-2007 Black Belt Systems ALL RIGHTS RESERVED Under the Pan-American Conventions
WinImages F/x Manual Version 7, Revision 6, Level A
