home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 545a.lha / PowerVisor_v1.0 / docs.LZH / docs / Screen < prev    next >
Encoding:
Text File  |  1991-08-22  |  36.2 KB  |  941 lines
  1. *-------------------*
  2. * Tutorial : screen * Wed Aug 21 21:31:25 1991
  3. *-------------------*
  4.  
  5. ===================== Commands used in this tutorial =========================
  6.  
  7.    active      Set active logical window
  8.    awin        Open the 'Rexx' logical window
  9.    color       Set RGB colors for PowerVisor screen
  10.    colrow      Set the number of columns and rows for a logical window
  11.    current     Make another logical window the current one
  12.    dwin        Open the 'Debug' logical window
  13.    fit         Fit the logical window to the visible size
  14.    home        Go to the home position of the logical window
  15.    list        Show a list (tasks, libraries, message ports, ...)
  16.    log         Log output to a file
  17.    memory      List memory
  18.    mode        Set PowerVisor preferences
  19.    move        Move a physical window
  20.    on          Execute command on other logical window
  21.    owin        Open the 'PPrint' logical window
  22.    prefs       Set preferences
  23.    refresh     Refresh a command on the 'Refresh' logical window
  24.    rwin        Open the 'Refresh' logical window
  25.    screen      Set PowerVisor on another screen
  26.    setfont     Set another font on a logical window
  27.    size        Size a physical window
  28.    to          Redirect output to a file
  29.    xwin        Open the 'Extra' logical window
  30.  
  31. ===================== Functions used in this tutorial ========================
  32.  
  33.    cols        Ask the number of columns on a logical window
  34.    getactive   Ask the active logical window
  35.    getlwin     Ask the current logical window
  36.    getcol      Ask the prefered number of columns on a logical window
  37.    getrow      Ask the prefered number of rows on a logical window
  38.    lines       Ask the number of rows on a logical window
  39.  
  40. ============================== Introduction ==================================
  41.  
  42. The screen and window of PowerVisor are very customizable.
  43. Interlace, pal, ntsc, vga, even the A2024 monitor, colors, fonts, ... .
  44. All these characteristics and more are customizable. Read this tutorial
  45. for more information about these options.
  46.  
  47. ========================== The PowerVisor Screen =============================
  48.  
  49. Normally PowerVisor uses an ²Intuition screen for output.
  50. The default screen has the following characteristics :
  51.  
  52.   - ²2 bitplanes (four colours)
  53.   - ²non interlaced
  54.   - ¹PAL, ¹NTSC, ¹VGA or ¹A2024 depending on your ²preferences settings
  55.     if you use AmigaDOS 2.0.
  56.     If you use AmigaDOS 1.2 or 1.3 PowerVisor will open a screen as big as
  57.     the ²workbench screen would be if it is not interlaced.
  58.   - Size is inherited from the preferences settings. PowerVisor uses
  59.     ¹overscan if you set overscan in preferences (only AmigaDOS 2.0).
  60.   - ¹Colours are inherited from the Workbench.
  61.   - ¹Topaz.font 8 is uses for all text (default).
  62.   - The screen is a ²public screen if you have AmigaDOS 2.0 (with the
  63.     name ¹'PowerVisorScreen').
  64.  
  65. The PowerVisor screen is partitioned in ²logical windows (see the Logical
  66. Windows section of this tutorial file). PowerVisor gives you the option to
  67. open its window on ²another screen, to change the colours, switch to
  68. interlace, switch to another monitor (2.0) or to use more bitplanes.
  69.  
  70. Note that in this tutorial we constantly talk about three different things :
  71.  
  72.    - The ²PowerVisor screen : This is the Intuition screen. It is possible
  73.      that this screen does not exist. In that case, PowerVisor resides
  74.      on another screen.
  75.    - The ²PowerVisor window : This is the Intuition window that normally
  76.      lives on the screen. When we talk about the PowerVisor window we
  77.      are talking about the physical window 'Main'. PowerVisor can have
  78.      more physical windows.
  79.    - ²Physical windows : These correspond directly with Intuition windows.
  80.    - ²Logical Windows : Each physical window is partitioned in logical
  81.      windows, do not confuse a logical window with an Intuition window.
  82.  
  83. ========================== Reading this chapter ==============================
  84.  
  85. All the examples in this chapter assume that you have an ²NTSC monitor.
  86. If this is not the case replace 'NTSC' with 'PAL' and 'PAL' with 'NTSC'
  87. (in your mind) when you read this chapter. I also assume that you have
  88. started a vanilla PowerVisor. This means that there was no
  89. ¹s:PowerVisor-config and a minimal ¹s:PowerVisor-startup when you started
  90. PowerVisor.
  91.  
  92. ========================= Interlace and Monitors =============================
  93.  
  94. If the PowerVisor screen is open (default when you start PowerVisor),
  95. you can switch to interlace or to another monitor using the 'mode'
  96. command (This command is also used for other settings, see the
  97. appropriate documentation). The 'mode' command with screen arguments
  98. has no effect when PowerVisor resides on another screen.
  99.  
  100. The following 'mode' arguments have something to do with screens or
  101. windows :
  102.  
  103.    - lace         switch to ¹interlace
  104.    - nolace       switch to ²non interlace (default)
  105.  
  106.    - pal          ²pal monitor (AmigaDOS 2.0)       640x256 or 640x512
  107.    - ntsc         ²ntsc monitor (AmigaDOS 2.0)      640x200 or 640x400
  108.    - vga          ²vga monitor (AmigaDOS 2.0)       640x480 or 640x960
  109.    - viking       ²a2024 monitor (AmigaDOS 2.0)     1024x1008
  110.  
  111.    - fancy        use ²two bitplanes (default)
  112.    - nofancy      use only ²one bitplane
  113.  
  114.    - sbottom      ¹sizegadget is included in ²bottom border (default)
  115.                   this option is only useful if there are more physical
  116.                   windows, or if the 'Main' physical window is a
  117.                   ²non-backdrop window.
  118.    - nosbottom    ¹sizegadget is included in ²right border
  119.  
  120. Here are some examples :
  121.  
  122. < mode lace nofancy <enter>
  123.  
  124. You will now get a one bitplane interlace screen (if you have enough
  125. memory).
  126.  
  127. Note that PowerVisor only uses half the interlaced screen for output
  128. (try some commands with a lot of output to test this: 'help commands',...).
  129. This is normal. We will see later how you can make the logical window
  130. ²full size again (in the Logical Windows section).
  131.  
  132. Back to normal with :
  133.  
  134. < mode fancy nolace <enter>
  135.  
  136. =========================== Setting the colours ==============================
  137.  
  138. Try :
  139.  
  140. < color 0 0 0 7 <enter>
  141. < color 1 15 15 15 <enter>
  142.  
  143. This will install a blue background and a white foreground. (Note that
  144. this command only works if PowerVisor is on its own screen (see later for
  145. more info)).
  146.  
  147. ======================= PowerVisor on other screen ===========================
  148.  
  149. You can open the ²PowerVisor window on each screen available in the system.
  150. However, when you do this you must be very careful NOT to close the screen
  151. where PowerVisor resides.
  152.  
  153. Example :
  154.  
  155. List all screens :
  156.  
  157. < list scrs <enter>
  158. > Screen name         : Address  Left  Top Width Height FirstWindow
  159. > ---------------------------------------------------------------------------
  160. > PowerVisor   (V1.00/: 07EA28F0    0    0   692    442 07EA67B8
  161. > Workbench Screen    : 07E280D0    0 -582   692   1024 07E1F0F8
  162.  
  163. For example, let's open on the ²Workbench screen :
  164.  
  165. < screen Workbench <enter>
  166.  
  167. You can now change the size of the PowerVisor window :
  168.  
  169. < size main 600 150 <enter>
  170.  
  171. This command sizes the specified ²physical window ('Main' in this case). The
  172. 'size' command only works on ²non-backdrop windows.
  173.  
  174. You can also move the PowerVisor window with :
  175.  
  176. < move main 10 10 <enter>
  177.  
  178. You can also resize the PowerVisor window using the size gadget.
  179. The 'screen' command normally opens a window with the same size as the previous
  180. size. If this is too big for the new screen, PowerVisor will make the window
  181. as big as possible.
  182.  
  183. When PowerVisor is on another screen, you cannot use the following commands :
  184.  
  185.    - color
  186.    - mode with one of the following arguments :
  187.          fancy,nofancy,pal,ntsc,vga,viking,lace,nolace
  188.  
  189. If you are configuring PowerVisor in a special way you can also make the
  190. 'Main' physical window a non-backdrop window on the PowerVisor screen :
  191.  
  192. < screen 0 <enter>
  193.  
  194. Now you can size and move the PowerVisor window.
  195.  
  196. Go back to the PowerVisor intuition screen :
  197.  
  198. < screen <enter>
  199.  
  200. Note that the 'screen' commands moves all physical windows (see later)
  201. present.
  202.  
  203. ====================== The PowerVisor window system ==========================
  204.  
  205. The PowerVisor window system is fairly complex. At the hart of the system
  206. you have the ²²physical windows. These correspond directly with
  207. ²Intuition windows. Normally there is only one physical window called 'Main'.
  208. This window also contains the ¹stringgadget. You can open more physical
  209. windows if you want (see later).
  210.  
  211. Each physical window has a ³tree of boxes. A ¹¹box is some space that can
  212. later be used by ²logical windows. By default there is only one box on
  213. a physical window. This box is called the ¹masterbox and is always present
  214. (you can't remove this box). When you open more logical windows on a physical
  215. windows the appropriate boxes are made automatically, so you generally need
  216. not concern yourselves with these objects.
  217.  
  218. A box is not always used by a logical window. Sometimes it is used by two
  219. other boxes. For example: if you want three logical windows, two above
  220. each other and the third one right of the previous two. You now seem to
  221. have three boxes :
  222.  
  223.                   +---------+-------+
  224.                   |         |       |
  225.                   |         |       |
  226.                   |    1    |       |
  227.                   |         |       |
  228.                   |         |       |
  229.                   +---------+   3   |
  230.                   |         |       |
  231.                   |         |       |
  232.                   |    2    |       |
  233.                   |         |       |
  234.                   |         |       |
  235.                   +---------+-------+
  236.  
  237. In this example there are three boxes containing a logical window. But there
  238. are in fact five boxes on the physical window.
  239. First the masterbox :
  240.  
  241.                   +-----------------+
  242.                   |                 |
  243.                   |                 |
  244.                   |                 |
  245.                   |                 |
  246.                   |                 |
  247.                   |        4        |
  248.                   |                 |
  249.                   |                 |
  250.                   |                 |
  251.                   |                 |
  252.                   |                 |
  253.                   +-----------------+
  254.  
  255. The masterbox contains two boxes :
  256.  
  257.                   +---------+-------+
  258.                   |         |       |
  259.                   |         |       |
  260.                   |         |       |
  261.                   |         |       |
  262.                   |         |       |
  263.                   |    5    |   3   |
  264.                   |         |       |
  265.                   |         |       |
  266.                   |         |       |
  267.                   |         |       |
  268.                   |         |       |
  269.                   +---------+-------+
  270.  
  271. Box 5 contains two other boxes and box 3 contains a logical window.
  272.  
  273. It is easy to see the tree structure for the boxes. Box 4 is the masterbox
  274. and only the leaves of the tree contain logical windows.
  275.  
  276.                            +---+
  277.                            | 4 |
  278.                            +---+
  279.                             / \
  280.                            /   \
  281.                           /     \
  282.                        +---+   +---+
  283.                        | 5 |   | 3 |
  284.                        +---+   +---+
  285.                         / \
  286.                        /   \
  287.                       /     \
  288.                    +---+   +---+
  289.                    | 1 |   | 2 |
  290.                    +---+   +---+
  291.  
  292. All boxes containing two other boxes automatically draw a ²²size bar.
  293. By ¹dragging this size bar you can change the size of the two child
  294. boxes. For example, dragging the ³vertical size bar between box 5
  295. and box 3 (thus managed by box 4) changes the size of box 5,3,1 and 2.
  296. Dragging the ³horizontal size bar between box 1 and 2 (managed by
  297. box 5) only changes the size of box 1 and 2. Note that each parent
  298. box remembers the size for the two children with one number: this number
  299. is the percentage (x10) that child A may use of the parent box. This
  300. means that if you change the size of a box, all children are resized
  301. proportionally.
  302.  
  303. When you add a logical window using the appropriate commands (see later),
  304. PowerVisor will add two boxes. For example, if you want to add a logical
  305. window below all boxes already visible, the tree will look as follows
  306. (box 6 and 7 are new) :
  307.  
  308.                            +---+
  309.                            | 6 |
  310.                            +---+
  311.                             / \
  312.                            /   \
  313.                           /     \
  314.                        +---+   +---+
  315.                        | 7 |   | 4 |
  316.                        +---+   +---+
  317.                                 / \
  318.                                /   \
  319.                               /     \
  320.                            +---+   +---+
  321.                            | 5 |   | 3 |
  322.                            +---+   +---+
  323.                             / \
  324.                            /   \
  325.                           /     \
  326.                        +---+   +---+
  327.                        | 1 |   | 2 |
  328.                        +---+   +---+
  329.  
  330. (Note that the masterbox has changed)
  331. The physical window changes to :
  332.  
  333.                   +---------+-------+
  334.                   |         |       |
  335.                   |    1    |       |
  336.                   |         |       |
  337.                   +---------+   3   |
  338.                   |         |       |
  339.                   |    2    |       |
  340.                   |         |       |
  341.                   +---------+-------+
  342.                   |                 |
  343.                   |        7        |
  344.                   |                 |
  345.                   +-----------------+
  346.  
  347.  
  348. A ²²logical window is the object you are probably going to use most. It can
  349. contain text. To know where the text must appear in the ²physical window,
  350. the logical window uses a ¹box. The standard logical window for output is
  351. the ³'Main' logical window. This logical window always resides on the
  352. ³'Main' physical window (but there can be more logical windows on the
  353. 'Main' physical window). There are six predefined logical windows :
  354.  
  355.    - Main         for normal output
  356.    - Extra        for output
  357.    - Refresh      used by the 'refresh' command for output
  358.    - Debug        for the fullscreen debugger
  359.    - Rexx         if present, all output from a ¹rexx command goes to this
  360.                   logical window. Otherwise the output goes to the current
  361.                   logical window.
  362.    - PPrint       if present, all ¹PortPrint messages go to this logical window.
  363.                   Otherwise the output goes to the current logical window.
  364.  
  365. You can add your own logical windows.
  366.  
  367. All physical windows currently present can be found in the 'pwin' list.
  368. All logical window can be found in the 'lwin' list.
  369.  
  370. ====================== The size of a logical window ==========================
  371.  
  372. A logical window contains text. It has a certain ³number of rows and a
  373. certain ³number of columns. Normally this number is independent of the
  374. ²visible size of the logical window. What this means is that the number of
  375. columns and rows remains the same even if you switch to interlace or if
  376. you change the size of a logical window (by dragging the ²size bar).
  377. This is the reason that PowerVisor only uses half the screen when you
  378. switch from ¹non-interlaced to ¹interlaced. There are several solutions to
  379. this problem :
  380.  
  381. - If you want the number of columns and rows automatically ¹fit for the
  382.   visible size you can make the logical window ¹autoscalable. You can
  383.   do this with the 'colrow' command (see later). The disadvantage of this
  384.   is that the logical window will be cleared everytime the visible size
  385.   changes. If you want you can also make the logical window autoscalable
  386.   for the number of rows only, or for the number of columns only.
  387.  
  388. - If interlace is your default screen type (defined with the 'mode' and
  389.   the 'saveconfig' commands) the 'Main' logical window will be bigger.
  390.   If you switch to non-interlace, the number of columns and rows will
  391.   remain the same. This means that you can scroll in the logical window
  392.   (see later).
  393.  
  394. - You can explicitelly tell PowerVisor to fit the 'Main' logical window
  395.   to the visible size with the 'fit' command (see later). This is not
  396.   the same as the first method since the window will have a ²fixed size
  397.   (not autoscalable).
  398.  
  399. - You can explicitelly set the size of the 'Main' logical window using
  400.   the 'colrow' command. If this size is too big for the visible size,
  401.   you will be able to ¹scroll in the logical window.
  402.  
  403. The first, second and fourth methods can be made permanent with the
  404. 'mode', 'prefs' and 'saveconfig' commands (see the 'Installing
  405. PowerVisor' chapter).
  406.  
  407. Note that this discussion is also valid for other logical windows as well.
  408. All the standard logical windows behave a bit different (you can
  409. change this behaviour with the 'prefs' command) :
  410.  
  411.    - Main      number of columns and rows is set to a fixed value. This value
  412.                is the maximum number of columns and rows at the time the
  413.                logical window is created.
  414.    - Extra     like 'Main'
  415.    - Refresh   the number of columns is set to a fixed value. This value is
  416.                the maximum number of columns at the time the logical window
  417.                is created. The number of rows is fixed and always set to
  418.                50.
  419.    - Debug     the number of columns is fixed and set to 82. The number of
  420.                rows is fixed and set to 42.
  421.    - Rexx      Like 'Refresh'
  422.    - PPrint    Like 'Refresh'
  423.  
  424. ================= Standard behaviour for logical windows =====================
  425.  
  426. All logical windows can behave different. Here are the possible behaviours
  427. for logical windows :
  428.  
  429.    ¹-MORE- enabled or disabled
  430.                When enabled, PowerVisor will pause when there is a full
  431.                window of output.
  432.    ¹Interrupt/Pause enabled or disabled
  433.                When enabled you can use the <esc> and <right-alt>+<help>
  434.                keys to interrupt or pause PowerVisor when PowerVisor is
  435.                sending output to the logical window.
  436.    ²Home position is top-visible or real-top
  437.                PowerVisor maintains a home position for each logical window.
  438.                This position is either the ²real top of the logical window
  439.                or the first line that is visible (starting from above)
  440.                of the bottom visible half of the logical window.
  441.                When a ³top-visible logical window is cleared, PowerVisor will
  442.                scroll to the bottom part of the logical window and set
  443.                the current cursor position to the first line of this visible
  444.                part.
  445.                When a ³real-top logical window is cleared, PowerVisor will
  446.                scroll to the top part of the logical window and set the
  447.                current cursor position to the first line.
  448.                There is yet another difference between top-visible and
  449.                real-top logical windows. When the visible size of a logical
  450.                window changes (this does not always imply a change of the
  451.                number of rows and columns), PowerVisor will try to keep
  452.                the top visible line (for real-top logical windows) or the
  453.                bottom visible line (for top-visible logical windows) on the
  454.                same visible position.
  455.    ²Status line on/off
  456.                The statusline is the bar at the top of a logical window.
  457.    ³Auto Output Snap on/off
  458.                When enabled, PowerVisor will automatically scroll the logical
  459.                window to the position of the appearing output. This means
  460.                that you will always see all new output on the logical window.
  461.                When disabled, PowerVisor will not scroll and output may
  462.                appear off screen. Note that this flag is only useful when
  463.                the logical window is bigger than the current visible size.
  464.  
  465. The standard logical windows have the following behaviour :
  466.  
  467.    - Main      -MORE- enabled/disabled depending on the setting of
  468.                the 'mode' command (see later)
  469.                Interrupt/Pause enabled
  470.                Home position is top-visible
  471.                Status line on
  472.                Auto Output Snap is on
  473.    - Extra     -MORE- disabled
  474.                Interrupt/Pause enabled
  475.                Home position is top-visible
  476.                Status line on
  477.                Auto Output Snap is on
  478.    - Refresh   -MORE- disabled
  479.                Interrupt/Pause disabled
  480.                Home position is real-top
  481.                Status line on
  482.                Auto Output Snap is off
  483.    - Debug     -MORE- disabled
  484.                Interrupt/Pause disabled
  485.                Home position is real-top
  486.                Status line on
  487.                Auto Output Snap is off
  488.    - Rexx      -MORE- disabled
  489.                Interrupt/Pause disabled
  490.                Home position is top-visible
  491.                Status line on
  492.                Auto Output Snap is off
  493.    - PPrint    -MORE- disabled
  494.                Interrupt/Pause disabled
  495.                Home position is top-visible
  496.                Status line on
  497.                Auto Output Snap is off
  498.  
  499. All other logical windows have the following default behaviour :
  500.  
  501.    -MORE- disabled
  502.    Interrupt/Pause enabled
  503.    Home position is top-visible
  504.    Status line on
  505.    Auto Output Snap is off
  506.  
  507. You can change the ²default behaviour for the standard logical windows
  508. with the 'prefs' command. You can change the behaviour for each logical
  509. window with the 'setflags' command (see later).
  510.  
  511. ==================== Opening standard logical windows ========================
  512.  
  513. There are predefined commands to open the ³standard logical windows :
  514.  
  515.    - xwin   Extra
  516.    - dwin   Debug
  517.    - rwin   Refresh
  518.    - awin   Rexx
  519.    - owin   PPrint
  520.  
  521. These commands open/close the specified logical window at the top. This means
  522. that they split the ¹masterbox and add a new box above all other logical
  523. windows. This box gets 30 % of the total physical window height. The logical
  524. windows in the remaining 70 % are shrinked accordingly. These predefined
  525. commands always open the window on the ³'Main' physical window.
  526.  
  527. Some examples :
  528.  
  529. < xwin <enter>
  530.  
  531. Now we have two logical windows on our 'Main' physical window. These two
  532. logical windows are called 'Main' and 'Extra'. You can change the size
  533. of the windows by dragging the ²horizontal bar.
  534.  
  535. You can now use this window instead of 'Main' for output :
  536.  
  537. < current extra <enter>
  538.  
  539. Type some command :
  540.  
  541. < list task <enter>
  542. > Task node name      : Node     Pri StackPtr  StackS Stat Command         Acc
  543. > ----------------------------------------------------------------------------
  544. > Background Process  : 07E28330 00  07E2D500    4096 Wait iprefs     (02) -
  545. > PowerSnap 1.0 by Nic: 07E51228 05  07E51A72    2000 Wait            PROC -
  546. > Background Process  : 07E5B3E8 00  07E5AD92    4096 Wait addtools   (06) -
  547. > SYS:System/CLI      : 07E5CAA8 00  07E5D9E6    4096 Wait            (00) -
  548. > * Blanker           : 07E605D8 00  07E615E4    4000 Wait            PROC -
  549. > RexxMaster          : 07E4AD58 04  07E4B59A    2048 Wait            (00) -
  550. > ...
  551.  
  552. The output appears on 'Extra'.
  553.  
  554. < current main <enter>
  555.  
  556. Now all following output will appear on 'Main'.
  557.  
  558. You can also use the 'on' command :
  559.  
  560. < on extra list task <enter>
  561. > Task node name      : Node     Pri StackPtr  StackS Stat Command         Acc
  562. > ----------------------------------------------------------------------------
  563. > Background Process  : 07E28330 00  07E2D500    4096 Wait iprefs     (02) -
  564. > PowerSnap 1.0 by Nic: 07E51228 05  07E51A72    2000 Wait            PROC -
  565. > Background Process  : 07E5B3E8 00  07E5AD92    4096 Wait addtools   (06) -
  566. > SYS:System/CLI      : 07E5CAA8 00  07E5D9E6    4096 Wait            (00) -
  567. > * Blanker           : 07E605D8 00  07E615E4    4000 Wait            PROC -
  568. > RexxMaster          : 07E4AD58 04  07E4B59A    2048 Wait            (00) -
  569. > ...
  570.  
  571. This command temporarily sets the current logical window to the parameter
  572. supplied. It then executes the following command ('list task' in this
  573. example).
  574.  
  575. To see all logical windows you can list them :
  576.  
  577. < list lwin <enter>
  578. > Logical Window      : Node
  579. > ---------------------------------------------------------------------------
  580. > Extra               : 07EBCB20
  581. > Main                : 07E25A60
  582.  
  583. Close 'Extra' with :
  584.  
  585. < xwin <enter>
  586.  
  587. =================== Opening logical windows in general =======================
  588.  
  589. Instead of using the predefined commands to open the standard logical windows
  590. you can also use the more powerful 'openlw' and 'closelw' commands. These
  591. commands can also be used to open other logical windows.
  592.  
  593. Some examples :
  594.  
  595. To open the 'Extra' logical window right from the 'Main' logical window
  596. (instead of above the 'Main' logical window) you can use :
  597.  
  598. < openlw main extra 80 40 main r <enter>
  599.  
  600. The first argument is the ²physical window where we want to open the new
  601. ²logical window. The second argument is the name of the logical window.
  602. The two following arguments are the number of columns and rows. If you
  603. want an ³autoscale logical window you can use -1 for one or both of
  604. these arguments. The two last arguments specify where you want to open
  605. the 'Extra' logical window. In this case we opened it at the right ('r')
  606. of the 'Main' logical window.
  607.  
  608. Do not close this logical window yet. We will first open a third :
  609.  
  610. < openlw main testwindow 100 -1 extra u <enter>
  611.  
  612. This window is autoscalable for the height. This means that when you change
  613. the horizontal visible size nothing will happen, but if you change the
  614. visible vertical size the window will be cleared and the number of columns
  615. will change.
  616. Now we have three logical windows on the 'Main' physical window.
  617.  
  618. Suppose we wanted to open a logical window at the bottom of the physical
  619. window. This can be done with :
  620.  
  621. < openlw main bottomwindow 80 40 main pd <enter>
  622.  
  623. The 'pd' argument means that we first take the parent and then go down.
  624. You will probably understand how this works when you think how PowerVisor
  625. manages ²logical windows and ¹boxes. When you said something like 'extra u'
  626. some commands ago, PowerVisor interpreted this as : take the box containing
  627. the 'extra' logical window. Split this box (make a new parent instead of
  628. the old box and make the existing 'extra' box a child of this new parent,
  629. also create a new box as the brother of the 'extra' box) and put the new
  630. logical window above the 'extra' logical window. When you say something like
  631. 'main pd' in the previous command, PowerVisor interpretes this as : take
  632. the box containing the 'main' logical window. Take the parent of this box
  633. (the 'p' stands for parent) and perform the same action as described before
  634. on this parent box.
  635.  
  636. You can use as many p's in front of the direction argument as you wish.
  637. You can use u (up), d (down), r (right) or l (left) for direction
  638. arguments.
  639.  
  640. To close all logical windows use :
  641.  
  642. < closelw extra <enter>
  643. or
  644. < xwin <enter>
  645.  
  646. < closelw testwindow <enter>
  647. < closelw bottomwindow <enter>
  648.  
  649. Now we are back with only one logical window: 'Main'.
  650.  
  651. ======================== Opening physical windows ============================
  652.  
  653. You are not limited to the default physical window 'Main'. You can open
  654. five additional ²physical windows (This limitation stems from the fact that
  655. PowerVisor only has 5 remaining signals. In a later release of PowerVisor
  656. this limitation will probably be removed). These physical windows can contain
  657. as many logical windows as memory permits.
  658.  
  659. For example, open a physical windows and two logical windows in it :
  660.  
  661. < openpw test 0 0 400 150 <enter>
  662.  
  663. You now have an extra window on position (0,0), width 400 and height 150.
  664.  
  665. < openlw test leftwin 80 40 <enter>
  666.  
  667. Note that for the first logical window on a physical window you need not
  668. give positional arguments.
  669.  
  670. < openlw test rightwin 80 40 leftwin r <enter>
  671.  
  672. Some tests :
  673.  
  674. < on leftwin list wins <enter>
  675. > ...
  676.  
  677. < on rightwin list scrs <enter>
  678. > ...
  679.  
  680. You need not close the logical windows. If you close the physical window
  681. the logical windows are closed automatically :
  682.  
  683. < closepw test <enter>
  684.  
  685. ====================== Scrolling in logical windows ==========================
  686.  
  687. As was mentioned before, the number of columns and rows in a logical window
  688. can be greater than the visible number of columns and rows. If this is
  689. the case you can ¹¹scroll in the logical window.
  690.  
  691. The window that will scroll when you use the appropriate ¹keys (see below)
  692. is the one that is active. The ³active logical window has a full (blue for
  693. two bitplanes or black for one bitplane) ²size bar.
  694. All the other logical windows have an ³empty size bar.
  695.  
  696. The following keys are defined (numeric keypad) :
  697.  
  698.    - <l-alt>+<home>   (7)  go to the top left position in the logical window
  699.    - <l-alt>+<end>    (1)  go to the bottom left position
  700.    - <l-alt>+<pgup>   (9)  scroll 5 lines up
  701.    - <l-alt>+<pgdn>   (3)  scroll 5 lines down
  702.    - <l-alt>+<arrows> (2,4,6,8)
  703.                            scroll one line/column in the right direction
  704.    - <l-alt>+<cntr>   (5)  go to the complete right
  705.    - <tab>                 make the next logical window active
  706.  
  707. You can also set the active logical window using the 'active' command.
  708. Note that the ³active logical window is NOT the same as the current
  709. logical window. The active logical window is ONLY useful for scrolling with
  710. the keyboard. The ³current logical window is the window that will receive
  711. all output.
  712.  
  713. To let you experiment with all keys try the following :
  714.  
  715. < colrow main 100 80 <enter>
  716.  
  717. This command sets the number of columns and rows to 100 and 80
  718. resp. Now put some output on the screen (with 'memory' or 'list')
  719. and scroll in all directions.
  720.  
  721. Note that the little box in the statusline changes when you scroll.
  722. This box is an indicator of where you are in the logical window. If you
  723. can't scroll (because the number of columns and rows is less or equal than
  724. the number of columns and rows visible) the box will be full. Otherwise
  725. it represents the position of the visible size of the logical window.
  726.  
  727. ============================ Setting the Font ================================
  728.  
  729. You can install a different ²non-proportional font for each logical window.
  730. The ²default font is always ²'topaz 8'.
  731.  
  732. Open the 'Debug' window :
  733.  
  734. < dwin <enter>
  735.  
  736. (Ignore the 'task not loaded' message, you will need this later when you
  737. start debugging).
  738.  
  739. < setfont debug topaz.font 9 <enter>
  740.  
  741. You will see that the size of the letters change.
  742. The fonts you want to use must be either memory resident or available in
  743. the 'fonts:' directory.
  744.  
  745. < setfont main courier.font 13 <enter>
  746.  
  747. (You must have a non-proportional courier.font in your 'fonts:' directory to
  748. do this).
  749.  
  750. To restore everything type :
  751.  
  752. < dwin <enter>
  753. < setfont main topaz.font 8 <enter>
  754.  
  755. ============================ The Snap Feature ================================
  756.  
  757. (Also see the 'Snapping Away' section of the 'GettingStarted' tutorial file).
  758.  
  759. If you click anywhere on the PowerVisor window (except on size bars),
  760. PowerVisor will ¹'snap' the word under the mousepointer to
  761. the commandline. If there is no word under the mousepointer nothing
  762. happens.
  763.  
  764. This feature works on all logical windows regardless of their size, font,
  765. number of columns, ...
  766.  
  767. Note that the snap will not happen if the window is just made active.
  768. You must click twice if the window is not active and you want to snap
  769. something.
  770.  
  771. The 'snapping' feature can behave in different ways. You can use the
  772. 'mode' command to set the behaviour you like most.
  773.  
  774. ================================= Refresh ====================================
  775.  
  776. The 'Refresh' logical window is used together with the 'refresh' command.
  777.  
  778. Open the 'Refresh' window and make the window big enough :
  779.  
  780. < rwin <enter>
  781.  
  782. Start the refresh of the current list :
  783.  
  784. < refresh 10 {home;list} <enter>
  785.  
  786. (See the 'Expressions' tutorial file for more info about the grouping
  787. operator '{}').
  788.  
  789. This 'refresh' command will execute 'home' and 'list' one time
  790. each second and send the output to the 'Refresh' logical window.
  791. Using the 'tab' key and the numeric keypad keys (with left-alt) you
  792. can now scroll in this refresh display.
  793.  
  794. To disable the refresh use :
  795.  
  796. < refresh 0 <enter>
  797.  
  798. and close 'Refresh' with :
  799.  
  800. < rwin <enter>
  801.  
  802. =============================== Redirection ==================================
  803.  
  804. If you want to ³redirect all output of a logical window to a file you can
  805. use :
  806.  
  807. < log main file <enter>
  808.  
  809. Now all output that appears on 'Main' is also sent to the file 'file'.
  810.  
  811. You can stop the redirection with :
  812.  
  813. < log <enter>
  814.  
  815. or 'log' with another logical window, since there can only be one log
  816. file active at the same time.
  817.  
  818. If you are ²logging output to a file it can be useful to have no output on
  819. the PowerVisor screen. You can accomplish this with :
  820.  
  821. < -list <enter>
  822.  
  823. When you precede a line with '-', PowerVisor will send the output from the
  824. following command to void. Except when you have logging enabled.
  825.  
  826. If you want to temporarily discard the ¹feedback (the reprint of the
  827. executed command on the screen) you can type :
  828.  
  829. < ~list <enter>
  830. > ...
  831.  
  832. This '~' operator is very useful if you want to ³attach a command to a key.
  833. If you precede the command in this attachment with a '~', PowerVisor will
  834. execute the command without showing it on the screen.
  835.  
  836. You can also disable this feedback for all commands you type with :
  837. < mode nofb <enter>
  838.  
  839. To enable it type (this is default) :
  840. < mode fb <enter>
  841.  
  842. If you want to combine these two operators you must use the following order
  843. (See the 'TechnicalInfo' file for more information about commandline
  844. parsing) :
  845.  
  846. < ~-list <enter>
  847.  
  848. If you only want the output from one command in a file you can use the
  849. 'to' command :
  850.  
  851. < to ram:MyOutputFile list task <enter>
  852. > ...
  853.  
  854. The output will still appear on the current logical window. This command
  855. temporarily works like the 'log' command. The real log file is restored
  856. after this command exits.
  857. If you only want output in a file you can use :
  858.  
  859. < -to ram:MyOutputFile list task <enter>
  860.  
  861. or
  862.  
  863. < to ram:MyOutputFile -list task <enter>
  864.  
  865. You can also combine the 'to' and the 'on' command :
  866.  
  867. First open the 'Extra' window (if it is not already open) :
  868. < xwin <enter>
  869.  
  870. < to ram:MyOutputFile on extra list task <enter>
  871. > ...
  872.  
  873. This command will list all tasks on the 'Extra' logical window. No output
  874. will be written to the file since the 'to' command only redirects the output
  875. from the ³current logical window. However :
  876.  
  877. < on extra to ram:MyOutputFile list task <enter>
  878. > ...
  879.  
  880. will also list all task on the extra window. The difference is that this
  881. time there will be output in the file since the 'to' command redirects
  882. the output from the current logical window. At the time the 'to' command
  883. is executed, this logical window is equal to 'Extra'.
  884.  
  885. ================================== Pens ======================================
  886.  
  887. You can change the color pens used for various drawing elements with the
  888. 'prefs pens' command. See the 'InstallingPowerVisor' tutor file for
  889. more information.
  890.  
  891. ================================ More ... ====================================
  892.  
  893. If the output of a specific command is too big, PowerVisor will wait and
  894. display a ¹prompt. Try this :
  895.  
  896. Make the number of columns and rows for 'Main' just big enough :
  897.  
  898. < fit main <enter>
  899.  
  900. List a lot of memory :
  901.  
  902. < memory 0 10000 <enter>
  903. > 00000000: 00000000  07E007CC  00F80834  00F80B16           ...........4....
  904. > 00000010: 00F80ADA  00F80ADC  00F80ADE  00F80AE0           ................
  905. > 00000020: 00F80C00  00F80AE4  00F80AE7  00F80AE8           ................
  906. > 00000030: 00F80AEA  00F80AEC  00F80AEE  00F80AF0           ................
  907. > 00000040: 00F80AF2  00F80AF4  00F80AF6  00F80AF8           ................
  908. > 00000050: 00F80AFA  00F80AFC  00F80AFE  00F80B00           ................
  909. > 00000060: 00F80B02  00F810F4  00F81152  00F81188           ...........R....
  910. > 00000070: 00F811E6  00F8127C  00F812C6  00F81310           .......|........
  911. > 00000080: 00F80B70  00F80B72  00F80B74  00F80B76           ...p...r...t...v
  912. > 00000090: 00F80B78  00F80B7A  00F80B7C  00F80B7E           ...x...z...|...~
  913. > 000000A0: 00F80B80  00F80B82  00F80B84  00F80B86           ................
  914. > ...
  915.  
  916. After each page of output PowerVisor will display a prompt. Press any key
  917. to ³continue the output. Press ¹<esc> ³abort the output.
  918.  
  919. < <esc>
  920. > Break...
  921.  
  922. Note that PowerVisor will display this prompt after each page. A ¹page is
  923. defined as the number of lines in the logical window. All these lines
  924. do not have to be visible. For example, if the 'Main' logical window
  925. is bigger than the visible size on screen, PowerVisor will only display
  926. a prompt after the TOTAL number of lines has passed. You can always
  927. scroll back to view the rest of the output if you want.
  928.  
  929. You can disable this prompt with :
  930.  
  931. < mode nomore <enter>
  932.  
  933. And enable it with :
  934.  
  935. < mode more <enter>
  936.  
  937. The 'Main' logical window is the only window with a ²'-MORE-' prompt. All
  938. the other logical windows simply scroll until you interrupt them in one
  939. way or another. (Note that you can change this behaviour if you want to
  940. with the 'prefs' command (see the 'InstallingPowerVisor' file)).
  941.