home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / ibm1 / do101j2.arj / DISPLAY.SCR < prev    next >
Text File  |  1991-12-29  |  9KB  |  244 lines
  1. .pg wi full clr cy
  2.     COMMAND NAME»gray«: »%t« Display »ye«
  3.  
  4.     /DISP[LAY] [ON|OFF] [ {display parameters}]
  5. /cw
  6.     This command displays all following lines which are »+re«NOT»#« not
  7.     comments or labels on the screen. »%t«DO»#« continues to display
  8.     lines until a command, i.e. starting with a slash ("»ye«/»#«"), is
  9.     encountered in the script. Lines starting with a period
  10.     ("»gr«.»#«") are treated as display control lines. Up to »cy«19 display
  11.     control parameters»co« can also be entered on the »%t«/DISPLAY»#«
  12.     command line (see »bo«DISPLAY CONTROL PARAMETERS»#« following in
  13.     this discussion).
  14.  
  15.     »re«DISPLAY is »+c 14 4«OPTIONAL»#«.  Any line not recoginzed as a »cy«command»#« or »cy«label»#«
  16.     and »cy«not written to a file»#« will be displayed on the screen.
  17.  
  18. .pg clr
  19.     The »%t«Display»#« command has special meaning when used in »ma«Interactive
  20.     mode»#«. Lines which are not »%t«DO»#« commands are passed to »ye«COMMAND.COM»#« to
  21.     execute as »cy«DOS commands»#« in Interactive mode. To display the lines,
  22.     use the command "»%t«/DISPLAY ON»#«". To return to normal Interactive
  23.     operation, use the command "»%t«/DISPLAY OFF»#«".
  24.  
  25.     You can also force »%t«DO»#« to display a single line by starting it
  26.     with a greater-than sign ("»cy«>»#«").
  27.  
  28. :DISPLAY PARAMETERS
  29. .pg wi full clr ye
  30.     DISPLAY CONTROL PARAMETERS
  31.  
  32.     »+cy«.»cy«{parameter 1} {parameter 2} .. {parameter 20}
  33. /cw
  34.     Display control parameters control the format of the lines
  35.     printed on the screen during the execution of a display
  36.     command.
  37.  
  38.     Up to »ye«20 control parameters»#« can be placed on each control
  39.     line. (Up to »ye«19»#« parameters can also be included on the
  40.     »%t«/DISPLAY»#« command line.)
  41.  
  42.     The line must start with a period ("»+ye«.»#«") in column »ye«1»#«. Values
  43.     such as »wh«speed»#«, »wh«color»#«, etc. remain in effect until they are
  44.     explicitly changed by another display control parameter.
  45.     This is true even across or executed scripts (see the
  46.     »bo«ExecScript»#« command).
  47. .pg clr
  48.     Display Control Parameters can also be placed on the »wh«display
  49.     line»#«. These are contained between the characters "»wh«»»»#«" (ASCII 175)
  50.     and "»wh«~174»#«" ASCII 174.
  51. .pg
  52.  
  53.     These characters appear as small arrows. They are entered on
  54.     the keyboard by entering »wh«174»#« and »wh«175»#« on the numeric keypad while
  55.     holding down the »bo«<Alt>»#« key. When you release the »bo«<Alt>»#« character,
  56.     the symbol appears.
  57. .pg
  58.  
  59.     If you are using the built-in »%t«DO»wh« editor»#« by entering the "»cy«/R»#«" or
  60.     "»cy«/E»#«" switch on the »wh«command line»#«, you may generate the characters
  61.     by pressing the »bo«<F1>»#« key.  »%t«DO»#« will generate both characters and
  62.     position the cursor to begin entering the display paramaters.
  63.  
  64.     Here's a display line with imbedded control characters:
  65.  
  66. |    This »bo«word»#« is highlighted.
  67. .pg
  68.  
  69.     You can see that imbedded characters have the same effect
  70.     those entered on their own line.
  71.  
  72.     »bl«NOTE»gy«: »#«Because variables are evaluated before control codes,
  73.           embeded control codes can be assigned to »ye«variables»#« to
  74.           make life easier.
  75.  
  76. |/set %t "c 14 1"
  77. |This line will display colors in the »%t«variable»#«.
  78.  
  79. .pg clr ye
  80.     WI[NDOW] [{X Y X Y}|{FULL}]
  81. »#«
  82.          The window command creates a "»ye«window»#«" on the screen.
  83.          After the window is set, commands are relative to that
  84.          window. When setting a window smaller than the »cy«FULL»#«
  85.          window, the next parameters must contain the »cy«X»#« and »cy«Y»#«
  86.          coordinates of the »ye«upper-left corner»#«, followed by the
  87.          coordinates of the »ye«lower-right corner»#«. To reset the
  88.          window to the full window, follow the »bo«WINDOW»#« parameter
  89.          with the keyword »cy«FULL»#«.
  90.  
  91.          »cy«WINDOW 10 10 50 17»gray« :»wh« creates a window from row 10,
  92.          column 10 to row 17, column 50.
  93.  
  94.          »cy«WINDOW FULL»gray« :»wh« resets the window to the full »%t«DO»wh« screen.
  95. .pg clr ye
  96.     SP[EED] {millisecond delay}
  97. »#«
  98.          Set the speed at which lines are displayed. The default
  99.          (FAST) is full speed. Enter a number representing
  100.          millisecond delay between characters following the
  101.          SPEED parameter.
  102. .pa 1
  103.  
  104.          Here's a line with a built-in speed parameter.
  105.          Press »bo«<Enter>»#« to see its effect. . .
  106.  
  107. |         »sp 100«Sets a »wh«100»#« millisecond delay between characters.»FAST«
  108.  
  109. .pg clr std ye
  110.     FAST
  111. »#«
  112.          Sets the display to full speed.
  113. .pg clr ye
  114.     CLICK
  115.  
  116. »# type go 10 3«Sounds a brief click when each character is displayed.
  117. »go 10 4«(Simulates typing).
  118. .pg clr std ye
  119.     QU[IET]
  120. »#«
  121.          »sp 75«Supresses the audible click when each character is
  122.          displayed.
  123. .pg clr std ye
  124.     C {foreground} {background}
  125. »#«
  126.          Sets the screen colors for the foreground and
  127.          background display in the currently active window.
  128. .pg clr
  129.          The color numbers are integers:
  130.  
  131. .wi 10 7 79 25
  132.   »c 0 7«Black        »#«=  0
  133.   »c 1 0«Blue         »#«=  1
  134.   »c 2 0«Green        »#«=  2
  135.   »c 3 0«Cyan         »#«=  3
  136.   »c 4 0«Red          »#«=  4
  137.   »c 5 0«Magenta      »#«=  5
  138.   »c 6 0«Brown        »#«=  6
  139.   »c 7 0«LightGray    »#«=  7
  140.   »c 8 0«DarkGray     »#«=  8
  141.   »c 9 0«LightBlue    »#«=  9
  142.   »c 10 0«LightGreen   »#«= 10
  143.   »c 11 0«LightCyan    »#«= 11
  144.   »c 12 0«LightRed     »#«= 12
  145.   »c 13 0«LightMagenta »#«= 13
  146.   »c 14 0«Yellow       »#«= 14
  147.   »c 15 0«White        »#«= 15
  148.  
  149. .pg clr
  150. You can also use »wh«color abbreviations»#« to set foreground
  151. colors, these are:
  152.  
  153. »wh«bl»gy«   = »bl«blue
  154. »wh«gr»gy«   = »gr«green
  155. »wh«cy»gy«   = »cy«cyan
  156. »wh«re»gy«   = »re«red
  157. »wh«ma»gy«   = »ma«magenta
  158. »wh«ye»gy«   = »ye«yellow
  159. »wh«wh»gy«   = »wh«bright white
  160. »wh«gy»gy«   = »gy«gray »#«(»cy«"»wh«gray»cy«" is also acceptable»#«)
  161. »wh«# »gray«   = »#«clear to light gray (normal, will also reset
  162.                background to »wh«black»#«)
  163.  
  164. .pg
  165. Placing a "»+wh«+»#«" in front of the »cy«color abbreviation»#« or "»cy«C»#«" will
  166. cause the color to »+#«blink»#«.
  167.  
  168. .pg clr
  169. The actual colors displayed may vary on your monitor.
  170. These settings produce various shades of gray,
  171. highlighting, underlining, etc. on monochrome monitors.
  172. The effects may vary.
  173.  
  174. .pg wi 1 5 79 25 clr ye
  175.     CLR
  176. »#«
  177.          Clears the active window to the »wh«background color»#«
  178.          defined by the »ye«COLOR»#« parameter (default is »wh«black»#«).
  179. .pg clr wh
  180. /MATH Num1 0
  181. /REPEAT
  182.     xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  183. /INC Num1
  184. /UNTIL %Num1 EQ 10
  185. »#«
  186.     Here's a screen full. Now we'll use the clr command to clear the
  187.     active window (which is below the line).
  188. |.clr
  189. .pg clr ye
  190.     BELL
  191. »#«
  192.          Sounds the computer's bell.
  193. |.bell
  194. .pg clr ye
  195.     PAGE (PG)
  196. »#«
  197.          Pauses the execution of the script. It is the
  198.          equivalent of the »%t«/PAGE»#« command. Displays the
  199.          »%t«/PAGEPROMPT»#« and waits for the user to press any key.
  200.          Pressing »bo«<Esc>»#« will terminate the display.
  201. .pg clr ye
  202.     GO[TO] {column} {row}
  203. »#«
  204.          Positions the next display at the row and column
  205.          indicated. »cy«NOTE»gray«:»#« row and column are relative to the
  206.          current active window.
  207. .pg clr
  208. |.go 5 5
  209. Position 5,5
  210. |.go 7 10
  211. Position 7,10
  212. |.go 40 15
  213. Position 40,15
  214. .pg clr ye
  215.     PA[USE] {seconds}
  216. »#«
  217.          Pauses the script execution for the number of »wh«seconds»#«
  218.          indicated. Processing continues immediately if the user
  219.          presses any key except »bo«<Esc>»#«. If the user presses »bo«<Esc>»#«
  220.          the »%t«/PAGEPROMPT»#« is displayed. The »ye«PAUSE»#« parameter then
  221.          reacts the same as the »ye«PAGE»#« parameter.
  222. .pg clr ye
  223.     RE[SET]
  224. »#«
  225.          Resets the page line count to zero. A »%t«/PAGEPROMPT»#« is
  226.          automatically displayed when the line count reaches the
  227.          length of the active window less one line.
  228.  
  229.          »cy«NOTE»gray«:»#« The »%t«/PAGE»#« command or »ye«PAGE»#« parameter also resets
  230.          the line count.
  231. .pg clr
  232.     There are also several "»wh«shortcut»#«" display parameters. These
  233.     are abbreviations for the equivalent commands:
  234. .pg
  235.  
  236.     STD   is the same as COLOR 7 0 QUIET FAST
  237.           (it resets the default »%t«DO»#« display parameters)»pg -24«
  238.     BO    is the equivalent of »bo«COLOR 7 0»# pg -24«
  239.     UL    is the equivalent of »ul«COLOR 1 0»# pg -24«
  240.     NORM  resets the display to COLOR 7 0 (white on black)»pg -24«
  241.     TYPE  »type«is the equivalent of SPEED 75 CLICK»std«
  242.  
  243. /ENDEXEC CLEAR
  244.