[no parameter]
|
Invoke the Add/Remove Over/Underlay dialog box.
|
||||||
lay_type
|
This parameter only applies when creating a layer: if removing a layer, this parameter is not needed.
|
||||||
-
|
Indicates that the following layer name should be removed from the current PageDef.
For example:
tplay -"name"
|
||||||
>
|
Indicates that a new named layer (a layer control stream) is to be created from the frames currently on the default <page> layer. The <page> layer will be emptied and an instance of the new named layer will be added to the current PageDef. If the target named layer already exists it will be overwritten with the new layer (without warning). If the tag name already exists and is a different type, the tag will not be overwritten and the frames that were on the <page> layer will be lost.
For example:
tplay >"name"
Using an empty name (i.e. "") is a very special case: all frames on all layers in the current PageDef will be copied (in the same order) to the current default <page> layer, and the current page is switched to a new, empty [unnamed] PageDef. Effectively, the current page is ‘flattened’ as all layers are removed.
For example:
tplay >""
|
||||||
lay_name
|
Usually the layer control stream tag name.
Must be declared in double quotes.
If there is a preceding >character, this will be the tag name to which to create and write to (see above). If not, it will be the tag name to use to create an instance of the layer on the currently selected PageDef; if the tag does not exist, it will be created.
When not preceded by the > symbol, this parameter can also be a PageDef control stream tag name. In this case, the add or remove operation is repeated for every layer name currently in the PageDef. This makes it easy to add or remove all layers from one PageDef to another.
For example:
tplay "name"
|
||||||
start_page
|
The first page on which the add or remove action should apply
|
||||||
end_page
|
The last page on which the add or remove action should apply
|
||||||
mode
|
The mode of the overlay or underlay:
|