home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 607.lha / Manager_v1.0 / Manager.doc.pp / Manager.doc
Encoding:
Text File  |  1992-02-04  |  5.4 KB  |  125 lines
  1.  
  2.  Manager 1.0 - a public screen manager for Release 2.04
  3.  
  4.   by Chris Papademetrious, REM-CTP Software
  5.  
  6.  
  7. I.    What is Manager?
  8.  
  9.  Public screens are a new feature of Release 2.04. What are they? Public
  10. screens are nothing more than that - screens that are publicly accessable,
  11. and thus can be shared by different programs. For example, with public
  12. screens, you can put a desktop publishing program, a Shell window, and
  13. a menu utility on the same screen.
  14.  
  15.  Since public screens are unique to Release 2.04 (and higher), they
  16. require programs to specifically support public screens. There are some ways
  17. around this, as we shall see later, however.
  18.  
  19.  
  20. II.    How do I run Manager?
  21.  
  22.  Manager is easy to run. Just double-click on its icon, or type "run Manager"
  23. in a Shell window (assuming Manager is in the current directory, or in your
  24. search path). Manager will bring up its window, ready for use.
  25.  
  26.  
  27. III.    Manager's main window - what is it?
  28.  
  29.  "Open Screen" will bring up the screen definition window, which lets you
  30. define the type of screen you wish to open. Note that even when the screen
  31. definition window is open, the main window is still available for use;
  32. the "Open Screen" gadget is ghosted, however, so that you cannot select it
  33. once more by accident; only one screen definition window may be open at a
  34. time.
  35.  
  36.  "Close Screen" will close the screen that you have selected in the public
  37. screen list at the top of the window. If there is no selected screen, no
  38. action will be taken. If the screen cannot be closed for some reason, the
  39. display will flash indicating an error. A public screen can only be closed
  40. if there are no 'locks' on it, and no windows are opened on it (this
  41. includes Manager itself!)
  42.  
  43.  "Jump To Screen" will move Manager to the currently selected screen. If
  44. Manager can not jump to the new screen, it will try to reopen on the
  45. default screen. If this fails as well, it will exit with an error.
  46.  
  47.  "Make Default" will designate the currently selected screen as the new
  48. default screen. As a result, any program requesting the default public
  49. screen (such as Manager) will be pointed to this screen. The current
  50. default screen is shown at the bottom of Manager's window.
  51.  
  52.  The "Shanghai" checkbox, when checked, will cause windows requesting the
  53. Workbench screen to receive the default screen instead. Note that this does
  54. not work with every Workbench window, such as those of Workbench itself,
  55. but it should work with most programs that open their window on Workbench.
  56.  
  57.  The "PopPubScreen" checkbox stands for Pop Public Screen. When checked,
  58. it will cause a public screen to pop to the front of the display any time
  59. a window is opened on it.
  60.  
  61.  
  62. IV.    Manager's screen definition window - what is it?
  63.  
  64.  This window is where you define a screen to be opened. You can give it
  65. a name, size, display mode, and much more. The options are listed below,
  66. along with a short description of what they control.
  67.  
  68.  "Screen Name" designates the name of the screen to be opened. It must be
  69. unique from other public screens already opened. If a duplicate name is
  70. entered, you will be informed, and given the opportunity to change it.
  71.  
  72.  "Width" and "Height" specify the width and height, in pixels, of the screen
  73. to be opened. To the right of the numeric gadgets there are cycle gadgets.
  74. These cycle gadgets control the size of the display that the screen
  75. can cover. In other words, the cycle gadgets control the degree of overscan
  76. that the screen may use, not the size of the screen itself. When the cycle
  77. gadgets are selected, however, suggested size values are placed into the
  78. numeric Width and Height gadgets automatically.
  79.  
  80.  "Colors" specifies the number of colors desired for the screen to be opened.
  81. More colors use up more memory, of course.
  82.  
  83.  "Font" specifies the font to be used for the screen and window titles. You
  84. may select another font by clicking on the "Choose Font" gadget directly
  85. beneath it.
  86.  
  87.  "Autoscroll" will allow you to scroll around on the screen by pushing the
  88. pointer against the edge of the screen. This only works when a window is
  89. active on a screen which does not fit entirely on the display. Try opening
  90. a large screen (say, 1000 by 1000) to see an example of this.
  91.  
  92.  "Open" tells Manager to attempt to open the screen with the selected
  93. characteristics. If the screen cannot be opened, you will be asked whether
  94. you want to cancel, or modify the settings to try again. The "Cancel"
  95. button will abort the current screen definition.
  96.  
  97.  On the right side of the window, a list of display modes resides. This
  98. list should contain the display modes that are currently installed in the
  99. system via the Monitor drawer on Workbench. If you want a display mode that
  100. is not listed, be sure to check if the monitor is being installed properly.
  101. See your Amiga Release 2.0 manual for more details.
  102.  
  103.  
  104.     TECHNICAL NOTE [programmers only]: To implement the font selection,
  105.     I store a pointer to the screen's TextAttr structure in the screen
  106.     structure's UserData field. Any public screen clients must NOT alter
  107.     this field, or the system will crash when the screen is closed!
  108.     The font name in the TextAttr is allocated via AllocVec(), as is
  109.     the TextAttr() itself.
  110.  
  111. V.    Wow! What should I do now?
  112.  
  113.  If you have any questions or comments regarding Manager, they can be
  114. GEmailed to me on GEnie, or sent via US Mail. Donations are quite welcome.
  115.  
  116.  
  117.  GEnie:   CHRIS.P  [-=Chrispy=-]
  118.  
  119.  US Mail: Chris Papademetrious
  120.           306 Summit Drive
  121.           Ephrata, PA  17522
  122.  
  123.  Enjoy!
  124.  
  125.