Page 210
Mask Stacking Script Commands
For scripting, WinImages 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. WinImages 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. WinImages 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:
|
POPMASK
To remove a mask from the stack and make it the current mask, use POPMASK. There is now one less mask on the stack.
|
|
PUSHMASK
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.
|
|
SWAPMASK(level)
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.
|
|
DELMASK
To dispose of the mask on the top of the stack without making it the current mask, use DELMASK.
|
|
DROPMASK
This command discards the top mask in the stack, making the stack one level shallower.
|
|
EXGMASK
This exchanges the current mask with the mask on the top of the stack.
|
|
SMASKCOMBINE
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.
|
Page 210
WinImages F/x, WinImages 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 5, Level B |
HTML Documentation Management System © 1992-2007 Black Belt Systems