home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 455.lha / CLIanywhere_v1.0 / OpenScreen.doc < prev    next >
Encoding:
Text File  |  1990-12-10  |  6.9 KB  |  152 lines
  1.  
  2.  
  3.                             OpenScreen Version 1
  4.  
  5.                        Created by Ray Lambert in 1990
  6.  
  7.  
  8. Overview.
  9.  
  10.     OpenScreen is a utility program which allows you to create additional
  11. Workbench-compatible screens.  You may use OpenScreen to create nearly any
  12. type of screen possible using combinations of command line options, and then
  13. (using the accompanying program CLIanywhere) open CLIs on it, load an extra
  14. copy of Workbench, etc.  You may create as many screens as you like,
  15. providing that your system has the memory to accomodate them.  Combinations
  16. of OpenScreen and CLIanywhere can even be utilized from your
  17. Startup-Sequence to produce the same set of extra screens every time you
  18. boot.
  19.  
  20.  
  21.  
  22. Usage.
  23.  
  24.     OpenScreen does not run from Workbench (with an icon) however it can be
  25. run in just about any other way (directly from the CLI, in scripts, etc.).
  26. OpenScreen defaults to creating an exact duplicate of your Workbench screen,
  27. however you can change almost all attributes of the screen it creates by
  28. using the correct command line options.  Below is a list of the command line
  29. options (switches) that OpenScreen understands.  (Remember, OpenScreen
  30. starts with the definition of your Workbench screen, and the following
  31. switches _modify_ that definition).
  32.  
  33.     All switches are introduced with the dash ('-') character, which is
  34. followed by a single, _case_sensitive_ letter which identifies the option.
  35. In many cases the option letter must then be directly followed by a
  36. parameter with no intervening spaces.  The parameter is either numeric or
  37. string data.  In the following list, a dollar sign ('$') denotes string data
  38. (a name for example) and a hash sign ('#') denotes numeric data.  If neither
  39. of these characters are present no parameter is required for the option (any
  40. extra text will be ignored).  If a parameter must contain space characters
  41. (for example, your screen title), the whole switch must be enclosed in
  42. double quotes.  For example, if you wanted to name your screen, "My Screen",
  43. you would use the following switch on the command line (WITH the quotes):
  44.  
  45.                                "-tMy Screen"
  46.  
  47. List of switches:
  48.  
  49.     -t$       define screen Title text
  50.     -w#       define screen Width
  51.     -h#       define screen Height
  52.     -d#       define screen Depth
  53.     -c#,#,... set screen Colors (see below for detailed description)
  54.     -e#       set screen initial top Edge
  55.     -1#       set screen pen 1 (DetailPen)
  56.     -2#       set screen pen 2 (BlockPen)
  57.     -H        turn HIRES on
  58.     -L        turn HIRES off (Lowres)
  59.     -I        turn Interlace on
  60.     -N        turn interlace off (No interlace)
  61.     -B        open this screen Behind all others
  62.  
  63.     All numeric data is in decimal EXCEPT the "-c" (set screen Colors)
  64. option, which requires numeric data in HEXADECIMAL format.  A 'hex' screen
  65. color value consists of three characters as such: "RGB", where "R" is the
  66. color's RED component, "G" is GREEN and "B" is BLUE.  Each color component
  67. can have a value of 0 through 15.  In hexadecimal notation, the numerals 0
  68. through 9 are equal to 0 through 9, and the letters A through F are equal to
  69. 10 through 15.  (Leading zeros may be left off).  To define a color whose
  70. components are: RED=5, GREEN=14, and BULE=9, you would use the value: 5E9.
  71. The "-c" option takes a list of color values, each seperated by a comma.
  72. The first value in the list is for color 0, the second for color 1, etc.
  73. Any value may be omitted and the cooresponding Workbench default will be
  74. substituted.  For example, if you wanted to duplicate your Workbench screen,
  75. and only change color 2 (so you can easily distinguish the two screens at a
  76. glance) you could use the following switch:
  77.  
  78.                                   -c,,5E9,
  79.  
  80. This would cause your default Workbench color values for colors 0, 1 and 3
  81. to be used, and color 2 would become 5E9.
  82.  
  83.     Some people may be able to create colors directly using this method,
  84. however some will not.  To help you in determining the proper values for
  85. your desired colors, you may use the program called "palette" which is found
  86. on your Workbench distribution diskette in the "Tools" directory.  This
  87. program is a standard palette editor that allows you to change the palette
  88. on your Workbench screen and others.  This program has two special features
  89. which make it particularily useful.  The first is that it displays the
  90. hexadecimal value of the color it is currently editing in its window,
  91. allowing you to experiment with colors and then get their values to feed to
  92. OpenScreen.  The second helpful feature is that "palette" always opens
  93. itself on the topmost screen in the system, allowing you to edit that
  94. screens colors.  Thus, you can easily edit your new screen's colors using
  95. "palette" even _after_ you've created the screen.  The only drawback to
  96. editing your colors in this manner is that you would have to edit those
  97. colors _everytime_ you create the screen with OpenScreen.  This makes the
  98. color option in OpenScreen quite useful.
  99.  
  100.     If you forget these switches you can get help by typing: 
  101.  
  102.                                 SetScreen ?
  103.  
  104.  
  105.  
  106. Warnings.
  107.  
  108.     OpenScreen actually does something that, under normal circumstances, is
  109. considered quite nasty.  It opens a new custom screen, sets its screen type
  110. to WBENCHSCREEN, and the EXITS, leaving the new screen stranded!  Normally
  111. if a program did this it would be grounds to have the programmer lynched!
  112. However, in this case, the whole purpose is to provide a new screen which
  113. acts as an extra Workbench screen -- this makes it okay.  There is no need
  114. for a program to sit around in memory to manage the screen, because
  115. Intuition does that for us!  So rather than use unneccessary resources,
  116. OpenScreen terminates itself after creation of the new screen is complete.
  117. The only drawback to this approach is that the screen CANNOT be closed by
  118. normal means.  I'm not sure how neccessary this would be anyway because
  119. Workbench screens are usually meant to be permanent.  Those of you who use
  120. utilities such as "GOMF" or "Xoper" can remove the screens that OpenScreen
  121. creates using those utilities -- otherwise, there is no way to remove them.
  122. Also, if you specify a title for your new screen, OpenScreen allocates
  123. memory for that title which never gets free'd.  Although this is only a
  124. small amount of memory, the practice is not normally considered to be
  125. 'okay'.  (BTW, please note that under normal circumstances I NEVER do nasty
  126. things like this!  _Really_, I don't!)
  127.  
  128.  
  129.  
  130. Legal stuff.
  131.  
  132.     OpenScreen is public domain and is part of the CLIanywhere package and I
  133. would very much like the whole package to be kept together as one if it is
  134. distributed anywhere.
  135.  
  136.  
  137.  
  138. Get to know me!
  139.  
  140.     If you have any questions, suggestions, flames, propositions, etc., I
  141. can be reached at the following places:
  142.  
  143. People/Link:  Analog*Kid    (log on often)
  144.  
  145. BIX:          AnalogKid     (log on sparsely)
  146.  
  147. U.S. Snail:   Ray Lambert
  148.               PO Box 1253
  149.               Westport, Massachusetts  02790
  150.  
  151. Phone:        (508) 677-9217
  152.