ArborX


tplay

Longname: t p age lay out   Open the Documentation Legend
Released: not available 
Created: not available 
Last modified: 7.10 
See also: tfheader tpboard tpgoto tfmode

Summary
Creates, assigns or removes a specified overlay or underlay page layout to or from a specified range of pages.
Example extract

The macro below adds an underlay called name to pages 1--30, creating it if it does not already exist.

 tplay 1, "name", 1, 30

Syntax (7.10)
tplay  lay_type:n?  add_remove:L?  lay_name:t?  start_page:n?  end_page:n?  mode:s?  )  )  )  )
lay_type:n
Create overlay (default).
Create underlay.
add_remove:L
Add.
remove.
lay_name:t The name of an overlay or underlay page. If lay_name does not already exist then it will be created. When preceded by a '-' the overlay or underlay frame is removed from the page.
start_page:n The first page on which to add or remove the overlay or underlay.
end_page:n The last page on which to add or remove the overlay or underlay.
mode:s

Sets the mode of the overlay or underlay.

Enabled
x,X,-  Disabled
Controlled by <?layer>. For more information see layer

Assigning an overlay or underlay to a page effectively adds all of the underlay or overlay's frames to the page. An underlay's frames are added before any existing frames on the page (lower numbers). An overlay's frames are added after the existing ones (higher numbers). If more than one overlay or underlay is assigned to a page (to a maximum of 10) the frames will be added in the same order as the overlays or underlays were added. There is no easy way to change the order of overlays or underlays once they are added, they would have to be removed and then reassigned in the correct order.

Once created an overlay cannot be converted to an underlay or vice versa, other than by editing the .3d file in an ASCII text editor and changing the word 'underlay' to 'overlay'.

Example

The macro below removes the underlay from page 2:

 tplay -"name", 2
Example

The macro below selects the underlay page called 'name':

 tpgoto "name"

Document created on 01-Jan-2001, last reviewed on 19-Jan-2004 (revision 02)