home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff226.lzh / Vlt / docs / vlt4p036.doc < prev    next >
Text File  |  1989-06-25  |  32KB  |  790 lines
  1. +----------------------------------------------------------------------+
  2. |                                                                      |
  3. |                  D I S C L A I M E R   N O T I C E                   |
  4. |                                                                      |
  5. |  This document and/or  portions of the material and  data furnished  |
  6. |  herewith,  was developed under sponsorship of the U.S. Government.  |
  7. |  Neither the U.S.  nor  the U.S.D.O.E.,  nor  the  Leland  Stanford  |
  8. |  Junior University, nor their employees,  nor their respective con-  |
  9. |  tractors, subcontractors, or their employees, makes  any warranty,  |
  10. |  express or implied, or assumes any liability or responsibility for  |
  11. |  accuracy,  completeness or  usefulness of any information, appara-  |
  12. |  tus, product or process disclosed, or represents that its use will  |
  13. |  not infringe privately-owned rights.  Mention of any product,  its  |
  14. |  manufacturer, or suppliers shall not, nor is it intended to, imply  |
  15. |  approval, disapproval, or fitness for any particular use. The U.S.  |
  16. |  and  the University at all times  retain the right to use and dis-  |
  17. |  seminate same for any purpose whatsoever.                           |
  18. |                                                                      |
  19. +----------------------------------------------------------------------+
  20.  
  21.  
  22.                 VLT 4.036  Additional Documentation
  23.                 ===================================
  24.  
  25.                         (C) Copyright 1989
  26.  
  27.                                by
  28.  
  29.                         W.G.J. Langeveld
  30.  
  31.                 Stanford Linear Accelerator Center
  32.  
  33.  
  34. Introduction
  35. ============
  36.  
  37.         This document describes the various enhancements that have been
  38. made to VLT over the past six months, from version 3.656 to the present
  39. version 4.036 . Since there have been quite a few changes, I will give a
  40. brief description of most of it from scratch. More details will be found in
  41. a new manual that I'll be working on in the future.
  42.     Some features people have asked for have not yet been implemented
  43. for lack of time: it seemed better to release the current version first and
  44. then add some more things. Most notably, the scripting facility has not yet
  45. been rewritten, and therefore certain limitations to the ARexx interface
  46. are still present. On the other hand, many features people have *not* asked
  47. for, are now in place...
  48.     Section 1 describes what the menus of both alpha-numeric and
  49. Tektronix screens do (very briefly). I will indicate at each point what is
  50. new by ***> three-asterisk arrows <***. Section 2 gives a list of the
  51. script commands with their arguments and limitations. Section 3 will give
  52. some more detail on various other changes and will list some bugs that were
  53. fixed.
  54.     For any questions or bug reports contact me on BIX, user ID
  55. langeveld, or at SLAC, extension 2280.
  56.  
  57.  
  58. 1. VLT's Menus
  59. ==============
  60.  
  61.     Quite a few menu items were added. The behavior of the existing
  62. menu items was in some cases changed, so be careful! In the descriptions,
  63. where applicable, the corresponding right-Amiga sequence is given in
  64. parentheses.
  65.  
  66. 1.1 VLT menu
  67. ------------
  68.  
  69. - Capture Session (O)    When first selected, diplays a file requester to enter
  70.             a capture file name.
  71.             ***> If the file exists, a requester appears asking
  72.             whether it is okay to overwrite it, if the answer is
  73.             No, a requester appears asking whether you want to
  74.             append to it. <***
  75.             Subsequent selections of this option toggle between
  76.             Suspend    Capture and Resume Capture.
  77.  
  78. - End Capture     (E)    Closes the capture file.
  79.  
  80. - Open Console        ***> Opens a small four line console ("chat") window
  81.             at the bottom of the screen, if ConMan is installed.
  82.             Provides command history and editing. Allows execution
  83.             of VLT script commands by prefixing command with key
  84.             script character. Disadvantages: line oriented, no
  85.             access to VLT menus. <***.
  86.  
  87. - Save Configuration    Save the file VTPrefs.dat in current directory or s:.
  88.  
  89. - Version         (V)    Display VLT version number.
  90.  
  91. - Exit            Exit VLT.
  92.  
  93.  
  94. 1.2 Comm menu
  95. -------------
  96.  
  97. - Select Device        ***> Select a different serial device (used with, e.g.
  98.             ASDG's Twin-X serial boards). First a file requester
  99.             will appear to select the device, then a string 
  100.             requester to select the unit number. <***
  101.  
  102. - Select Unit        ***> Select a different unit number for the currently
  103.             selected serial device. <***
  104.  
  105. - Baud            Select the baud rate.
  106.   -   110            ***> 110 baud is now supported. <***
  107.   -  ...
  108.   - 19200
  109.  
  110. - Parity        Select parity, wordlength, number of stop bits.
  111.   - 8N1
  112.   - ...
  113.   - 7O2
  114.  
  115. - Protocol        Select handshake protocol.
  116.   - None
  117.   - xON/xOFF
  118.   - 7-Wire
  119.   - 7-Wire/X
  120.  
  121. - Send Break (B)    Send a break.
  122.  
  123. - Hangup     (H)    Drop carrier for one second.
  124.  
  125. - Echo            Switch local echo on or off.
  126.   - Off (*)        
  127.   - On  (+)
  128.  
  129. - Strip Bit 8        ***> Enable/disable masking of the 8th bit on 
  130.   - Off            parity/wordlength settings that allow 8 data
  131.   - On            bits. <***
  132.  
  133. - Set Break Time    ***> Set break time (micro-seconds). <***
  134.  
  135. - Set Buffer Size    ***> Set buffer size (bytes). <***
  136.  
  137.  
  138. 1.3 Transfer Menu
  139. -----------------
  140.  
  141. - Send File    (S)    Send file using current protocol
  142.  
  143. - Receive File (R)    Receive file using current protocol
  144.  
  145. - Protocol        Select type of protocol
  146.   - External   (T)           ***> External protocols are now supported. <***
  147.   - Kermit     (K)
  148.   - XMODEM     (X)
  149.  
  150. - Kermit Options    Select options for Kermit.
  151.   - Send/Receive     (-)
  152.   - Host is Server   (=)
  153.   - Change Directory (D)    Set default directory for received files.
  154.   - Kermit Bye       (Y)    Send a Kermit Bye command.
  155.  
  156. - XMODEM Options    Select options for XMODEM
  157.   - Checksum         ([)
  158.   - Checksum / 1K Blocks
  159.   - CRC
  160.   - CRC / 1K Blocks  (])
  161.  
  162. - External Options    ***> Enter options for external protocol (only 
  163.             active when external protocol is selected). <***
  164.  
  165. - Translate Options    Select various translation options.
  166.   - No Translation      (,)
  167.   - CR/LF -> LF         (.)    Convert cr/lf pairs to lf.
  168.   - Downcase File Names (/)    Downcase file names when receiving files.
  169.  
  170.  
  171. 1.4 Macros Menu
  172. ---------------
  173.  
  174. - ARexx Macro (A)    Execute an ARexx macro.
  175.  
  176. - VLT Macro   (M)    Execute a VLT script
  177.  
  178. - Abort VLT Macro    Abort a VLT script (cannot be used for ARexx macros).
  179.  
  180. - Keyboard Macros    This menu item makes right-amiga 1, 2,... 0
  181.   -  1  (1)        programmable key strokes.
  182.   - ...
  183.   -  0  (0)
  184.  
  185. - Program Mode        Switch program mode on/off. In program mode, all
  186.   - On   (()        function keys can be programmed, ***> as well as
  187.   - Off  ())        what the Beep function should do. <***
  188.  
  189.  
  190. 1.5 Screen Menu
  191. ---------------
  192.  
  193. - Clear Screen      (C)    Erase the screen contents.
  194.  
  195. - Screen to Back    (J)    Move VLT to the back of all other screen/windows.
  196.  
  197. - Select Screen Type    Select screen type.
  198.   - Custom Screen
  199.   - Workbench
  200.   - Interlaced
  201.   - Non-Interlaced
  202.  
  203. - Number of Colors    Select the number of colors.
  204.   - 2
  205.   - 4
  206.   - 8
  207.  
  208. - Select Colors     (U)    Brings up a Palette requester to adjust the screen
  209.             colors.
  210.  
  211. - Number of Lines   (L)    Set the number of lines to aim for. ***> This 
  212.             option no longer shows the actual number of lines
  213.             but the requested number instead. This means that
  214.             resizing the screen/window no longer loses the
  215.             requested number of lines, and when possible, this
  216.             number of lines is indeed displayed. <***
  217.  
  218. - Number of Columns (Z) Set the number of columns to aim for. ***> Similar
  219.             changes were made as for the number of lines. <***
  220.  
  221. - Amount of Prescroll    Sets the maximum number of lines to scroll in case
  222.             look-ahead has determined multiple line scrolls
  223.             are needed.
  224.  
  225. - Cursor Height        ***> Set the block cursor's height in pixels. <***
  226.  
  227. - Rendering Mode    Select the way in which text updates take place.
  228.   - Quick    (Q)        Fastest mode, uses 1 bitplane.
  229.   - Normal   (N)        Same, using second bitplane for BOLD.
  230.   - Color    (G)        Use colors instead of bold, italic, etc.
  231.   - ANSI Color            ***> Use ANSI color sequences "properly".
  232.                 "Color" mode recognizes ANSI colors, but
  233.                 uses some of them in non-standard ways.
  234.                 The ANSI switch can be set at the same time
  235.                 to inhibit the non-standard behavior. <***
  236.  
  237. 1.6 Operation Menu
  238. ------------------
  239.  
  240.     These options, when selected, do the following:
  241.  
  242. - Wrap                 (W) Wrap lines longer than current columns seting.
  243.  
  244. - Numeric Keypad       Keypad sends numeric values, not escape sequences.
  245.  
  246. - Application Cursor       Cursor keypad sends application style sequences.
  247.  
  248. - Swap BS <-> Delete   (I) Reverse the meaning of Backspace and Delete keys.
  249.  
  250. - Destructive BS       Make backspace destructive in local echo mode.
  251.  
  252. - Help Key = LF           Help key sens Linefeed.
  253.  
  254. - Shift TAB = ESC TAB       Shifted TAB key sends <ESC> <TAB>
  255.  
  256. - Function Key Gadgets (P) Display function key gadgets at bottom of screen.
  257.  
  258. - Mouse Support        (\) Clicking mouse sends arrow-key sequences.
  259.  
  260. - Beep Volume           Adjust volume of built-in beep. Volume of 0
  261.                flashes the screen instead. Negative values
  262.                give different pitch. ***> In program mode, a 
  263.                Beep Command can be entered, allowing arbitrary
  264.                things to be executed on receipt of a beep. <***
  265.  
  266. - CR-Key: Echo CR/LF       ***> In local echo, echo CR and LF when CR is
  267.                pressed. <***
  268.  
  269. - CR-Key: Send CR/LF       ***> Send CR and LF when CR is pressed. <***
  270.  
  271. - Auto-Screen to Back       ***> During file transfers, bring the Workbench to
  272.                the front and display the status window there. <***
  273.  
  274.  
  275. 1.7 Graphics Menu
  276. -----------------
  277.  
  278. - Lock Graphics (;)    Disallow switching to the graphics screen when
  279.             receiving Tektronix control characters.
  280.  
  281. - To Graphics   (F)    Display the graphics screen.
  282.  
  283.  
  284. 1.8  (Tek) Image Menu
  285. ---------------------
  286.  
  287. - Save To Current File     (S)    Save vector file to currently designated file.
  288.  
  289. - Save To New File       (A)     Save vector file to disk.
  290.  
  291. - Load From Archive        (L)    Load a vector file from disk.
  292.  
  293. - Quit Archive             (Q)    Stop viewing a vector file and redisplay.
  294.  
  295. - Save Bitmap As IFF File  (I)    ***> Save current image as an IFF file. <***
  296.  
  297. - Print Bitmap            ***> Print current image to an attached
  298.   - Maximum Size       (()    printer as a bitmap graphics dump in one
  299.   - 1/3 Page           ())    of four different sizes. <***
  300.   - 2/3 Page               (/)
  301.   - Full Page              (*)
  302.  
  303. - Save/Print as PostScript® (E)    ***> Save vector file in PostScript® format
  304.                 (saving to par: will print it if a PS printer
  305.                 is attached). <***
  306.  
  307.  
  308. 1.9  (Tek) Zoom/Pan Menu
  309. ------------------------
  310.  
  311. - Select Zoom Area (Z)        Set up for a Zoom operation.
  312.  
  313. - Select Pan  Area (P)        Set up for a Pan operation.
  314.  
  315. - Reset Zoom/Pan   (R)        Reset Zoom/Pan to default.
  316.  
  317.  
  318. 1.10 (Tek) Cursor Menu
  319. ----------------------
  320.  
  321. - Switch Graphic Cursor On  (X)    Display the Graphic cursor.
  322.  
  323. - Switch Graphic Cursor Off (Y)    Remove the Graphic cursor.
  324.  
  325. - Display Cross Hair Only   (H)    When on, only show the cross hair.
  326.  
  327. - Display Cross Hair + XY   (N)    When on, show both cross hair and the current
  328.                 X,Y position ***> in a separate window. <***
  329.  
  330.  
  331. 1.11 (Tek) Screen Menu
  332. ----------------------
  333.  
  334. - Clear Screen      (C)    Erase the screen contents.
  335.  
  336. - Screen To Back    (J)    Move VLT behind all other screens/windows.
  337.  
  338. - Select Screen Type    Select type of screen.
  339.   - Custom Screen
  340.   - Workbench
  341.   - Interlaced
  342.   - Non-Interlaced
  343.  
  344. - Number of Colors    Select the number of colors.
  345.   - 2
  346.   - 4
  347.   - 8
  348.   - 16            The use of 16 colors is not recommended.
  349.  
  350. - Select Colors     (U)    Bring up a Palette requester to adjust colors.
  351.  
  352. - Lock Colors        (K)    ***> Disallow the host to modify the current color
  353.             values. <***
  354.  
  355. - Mask Colors        (M)    ***> Draw only in the bitplanes necessary for the
  356.             currently selected pen. <***
  357.  
  358. - Close Screen        (\)    Close the graphics screen.
  359.  
  360.  
  361. 1.12 (Tek) Control Menu
  362. -----------------------
  363.  
  364. - Lock Graphics           (;)    ***> Disallow switching to the graphics screen
  365.                 when receiving Tektronix control
  366.                 characters. <***
  367.  
  368. - Return to Alpha-Numeric (F)    Return to Alpha-Numeric screen.
  369.  
  370. - Set Preferences      (T)    Set various Tektronix options.
  371.  
  372.  
  373.  
  374.  
  375.  
  376. 2. VLT's Script language
  377. ========================
  378.  
  379.     Below is a list of commands VLT currently recognizes. The names are
  380. none too pretty, but hey, the original code isn't my own... Typically, the
  381. commands take one argument, which can be a string, a number, a keyword or a
  382. boolean value. Boolean values are written ON or OFF, or equivalently YES or
  383. NO.
  384.     The commands work in the context of a regular VLT script (by
  385. convention called a .scp file). All commands save five are also recognized
  386. when they come from a REXX script (please use the extension .vlt). Some may
  387. not work: this part has not been tested very well. The five commands that
  388. have no effect when used in a REXX script are: EXIT, GOTO, DELAY, WAIT and
  389. ON. Also, since the RX command itself is SCRIPT ONLY and REXX scripts cannot
  390. be used as init files, REXX scripts can not run any INIT ONLY commands.
  391.     Note, that the script language is likely to change in a next version
  392. of VLT.
  393.     BIXmail me with any questions and I'll try to find out how something
  394. is supposed to work... (Did I mention the script stuff isn't originally my
  395. code?).
  396.  
  397.  
  398. Name          |    argument values          |    function
  399. --------------+-----------------------+-----------------------------
  400.  
  401. INIT only commands
  402. - - - - - - - - - -
  403.  
  404. BACkground    hex (e.g. 000, FFF)    Set background color (color 0)
  405. BOLd                    Set bold color       (color 2)
  406. COL4            "        Set color 4
  407. COL5            "        Set color 5
  408. COL6            "        Set color 6
  409. COL7            "        Set color 7
  410. CURsor            "        Set cursor color     (color 3)
  411. DEPth            "        Set screen depth 
  412. FOReground        "        Set foreground color (color 1)
  413. INTerlace    ON/OFF, YES/NO        Interlace ON/OFF
  414. SCReen        W, C            Screen, Workbench/Custom 
  415. TEK_load    ON/OFF, YES/NO        Preload Tektronix screen
  416. WB_colors    ON/OFF, YES/NO        Use Workbench colors
  417.  
  418. Script only commands
  419. - - - - - - - - - - -
  420.  
  421. ACTivate    V, T            Move VT100/Tektronix Screen to front
  422. BEEp        none            Beep
  423. CAPture        "filename"        Capture to a file
  424. CAPture        OFF, SUSPEND, RESUME    Capture off, suspend/resume capture
  425. CD        "new path"        Change directory
  426. DELay        integer (seconds)    Delay number of seconds
  427. EMIT        "string"        Display line on screen
  428. FLush                    Flush ascii capture buffer to disk
  429. GOTo        "labelname"        Goto label
  430. INITXPR        "init string"        Initialize an External Protocol
  431. KB        none            Kermit bye (for server)
  432. KG        "filename"        Kermit get file
  433. KR        none            Kermit receive file
  434. KS        "filename"        Kermit send file
  435. ON        "string" "command"    On a 'string' do a command
  436. RAWEMIT        "string"        Display line, no escape parsing
  437. RAWSEND        "string"        Send string to host, no escape parsing
  438. RX        "Rexx command string"    Do a REXX string command
  439. SB        none            Send a break
  440. SEND        "string"        Send string to host
  441. SRX        "Rexx command string"    Do a REXX string command and wait
  442. WAIT        "string"        Wait for a host string
  443. XPR        SENd,RECeive "filename"    XPR send/receive a file
  444. XR        "filename"        Xmodem receive file
  445. XS        "filename"        Xmodem send file
  446.  
  447. Generally available commands
  448. - - - - - - - - - - - - - - -
  449.  
  450. APPlication    ON/OFF, YES/NO        Turn app. cursor on/off
  451. BAUd        integer (110 - 19200)    Set baud rate
  452. BREaktime    integer (microseconds)    Set break time
  453. BTAb_shift    ON/OFF, YES/NO        Shift-tab sends <ESC>-tab
  454. BUFfer        integer (512 - 2048)    Set buffer size 
  455. DESTBS        ON/OFF, YES/NO        Set destructive backspace
  456. DOWncase    ON/OFF, YES/NO        Kermit: downcase filenames
  457. ECHo        ON/OFF, YES/NO        Turn echo on or off
  458. ECHOLF        ON/OFF, YES/NO        Local echo: echo CR/LF when CR pressed
  459. EXIt        none            Exit script file
  460. EXIt            QUIET            Same without Script Completed message
  461. EXIt            VLT            Exit VLT (can be dangerous!)
  462. F        integer "string"    Define function key
  463. HANdshake    N, X, 7, W        Handshake with serial
  464.                        None, Xon/xoff, 7-wire, 7 + X
  465. HEIgth_cursor    integer (pixels)    Set cursor height
  466. KERmit_flags    S, H            Set kermit flags
  467.                        Send/receive, Host is server
  468. KEYscript_char    hex value (e.g. 7E)    Keyscript character
  469. KMAXPACK    integer (bytes)        Maximum Kermit packet size
  470. LFHelp        ON/OFF, YES/NO        Help key sends LF
  471. LINes        integer            Number of lines 
  472. LOCk_graphics    ON/OFF, YES/NO        Disallow changing to graphics mode
  473. MESSage        "Message"        Post a message on VLT's screen/window
  474. MODe        C, N, I            N, I = None, Image; C = convert CR/LF
  475. MOUse_to_host    ON/OFF, YES/NO        Convert mouseclicks to arrowkeys
  476. NUMKEYpad    ON/OFF, YES/NO        Turn numeric keypad on/off
  477. PARITY        N, E, O, M, S        Set parity
  478.                        None, Even, Odd, Mark, Space
  479. PREScroll    integer            Maximum number of lines of prescroll
  480. RENDer        Q, N, C, A        Rendering mode
  481.                        Quick, Normal, Color, ANSI
  482. SENDLF        ON/OFF, YES/NO        Send CR/LF when CR is pressed
  483. SER        "device name" integer    Change the serial device and unit used
  484. SETXPR        "XPR name"        Set a particular external protocol
  485. STRIP        ON/OFF, YES/NO        Strip bit 8 when 8-bit parity mode
  486. SWAP_bs_del    ON/OFF, YES/NO        Swap BS and DEL
  487. VOLume        integer            Set beep volume
  488. VPFkeys        ON/OFF, YES/NO        Screen (virtual) PF keys
  489. WIDth        integer            Number of columns 
  490. WRAP        ON/OFF, YES/NO        Turn wrap on or off
  491. XFEr_protocol    X, K, A            Set transfer protocol
  492.                        XMODEM, Kermit, External
  493. XMOdem_flags    N, 1, C, 1C        Set xmodem flags
  494.                        1 = 1K blocks, C = CRC
  495.  
  496.     Script commands that require a string in their argument now allow a
  497. different unquoting convention. When the string is preceded wit two quote or
  498. double-quote characters, the rest of the string until the end of the line is
  499. considered to be the argument. This allows one to embed any number of quotes
  500. in the string. Previously, VLT would parse on the first quote sign and stop
  501. parsing on the next matching quote sign, which is still the behavior if the
  502. string starts with a single quote or double-quote. In combination with the
  503. RAWSEND and RAWEMIT commands described above, one can now display or send any
  504. ASCII character (except NULL).
  505.  
  506.  
  507.  
  508. 3. Other changes in VLT
  509. =======================
  510.  
  511.  
  512.     What follows is a brief description of other changes that were made to VLT
  513. since version 3.656. 
  514.  
  515.  
  516. 3.1 Bug fixes
  517. -------------
  518.  
  519.  
  520. A. VT100 part:
  521. - - - - - - - -
  522.  
  523.     The audible beep was modified such that it will not allocate any
  524. audio channels unless the the beep function is invoked. This allows VLT to
  525. multitask with such programs as Sonix.
  526.     Some bugs were fixed in case one attempted to switch to the graphics
  527. screen without sufficient memory being available. VLT should no longer crash
  528. under those circumstances.
  529.     The problem where VLT would sometimes use the Topaz 60 font instead
  530. of Topaz 80 at 11 point is fixed. This problem did not show up when using
  531. FastFonts.
  532.     In some cases, VLT used to look for .scp files in the s: directory,
  533. rather than the rexx: directory where they are now kept routinely. This was
  534. fixed. VLT still looks for VLT.init (although pretty much obsolete), and
  535. VTPrefs.dat and TekPrefs.dat in s:.
  536.     Although VLT used to run fine on 68020 based Amigas, it used to crash
  537. when the SetCPU program had been run with the TRAP option. This is now fixed.
  538.     A problem with saving VTPrefs.dat files to the current default
  539. directory when one in s: existed, was fixed.
  540.     VLT now correctly reads the meaning of the Interlace field in the
  541. current Preferences structure. It used to be confused by bits set in that
  542. field by alpha versions of the 1.4 operating system.
  543.     In some versions of VLT the wrap function used to eat one character.
  544. This is now fixed.
  545.     A bug in the code for the various requesters was fixed. It would only
  546. show up and crash the machine if some misbehaving program had changed the
  547. value at address 0.
  548.     VLT's screens used to have no 'DefaultTitle'. These titles are now
  549. the same as the shared screen names.
  550.  
  551.  
  552. B. Tektronix part:
  553. - - - - - - - - - -
  554.  
  555.     Echoplex suppression is now performed on reports to the host.
  556.     A small problem with the block cursor was fixed: it sometimes didn't
  557. appear when needed.
  558.     As indicated above, the crashes when changing to graphics mode in low
  559. memory situations should be fixed now.
  560.     Because of additions to the Graphics menus it was necessary to change
  561. the TekPrefs.dat file format. The message indicating that your TekPrefs.dat
  562. file was obsolete used to appear on the VT100 screen. It now correctly
  563. appears on the Tektronix screen. If you have an obsolete TekPrefs.dat file,
  564. select Set Preferences from the Control menu and click on the Save gadget.
  565. That should write a new TekPrefs.dat file.
  566.     A problem was found with handling text. The limited 4105 emulation
  567. requires that at least 80 columns be displayed on the screen, whereas strict
  568. 4010/14 only allows 73 columns of text. I decided to change the emulation in
  569. favor of 4105 compliance: it now has a text pitch that allows 80 columns to
  570. be displayed. This is unfortunately not backwards compatible.
  571.     The escape sequence <ESC> ?, while implemented in previous versions
  572. of VLT, apparently has never worked. This problem was fixed. It only affected
  573. operation with mainframe applications that would use this sequence instead of
  574. sending the <DEL> character (ASCII 127).
  575.  
  576.  
  577. 3.2 Enhancements
  578. ----------------
  579.  
  580.  
  581. A. VT100 part:
  582. - - - - - - - -
  583.  
  584.     There are a number of new menu options, as we've seen already in 
  585. section 1. One new menu option is Open Console in the VLT menu. It opens a
  586. little ConMan console window at the bottom of the screen. You can proceed to
  587. type lines of text there instead of in the main VLT window. This has
  588. advantages and disadvantages: you do have command history and you can edit
  589. the line before  sending it. Also, you can prefix the line with the keyscript
  590. introducer (typically a tilda) and execute any of VLT's script commands. But
  591. on the other hand, while this window is active you cannot use VLT's menus or
  592. function keys, and such things as ctrl-S and ctrl-Q don't work either. For
  593. those you will have to click in VLT's main window to activate it.
  594.     Also new are the options to set the serial device and unit to use,
  595. though these are only of interest to people that have additional serial ports
  596. such as the ASDG Twin-X board.
  597.     The ANSI color option in the Rendering Mode menu item is there to
  598. allow VLT to work with certain bulletin board systems that support ANSI color
  599. sequences. If the color option is selected, some of the ANSI sequences are
  600. interpreted differently from ANSI standards unless the ANSI color option is
  601. also selected. 
  602.     The menu options CR-Key: Send CR/LF and CR-Key: Echo CR/LF affect the
  603. behavior of the <return> key: normally, the return key just sends a return
  604. character, and when in local echo mode, only a return is displayed on the
  605. screen. With the Send CR/LF option set, VLT will send both a return and a
  606. linefeed to  the host. When Echo CR/LF is set, VLT will (in local echo mode)
  607. echo both a return and a linefeed.
  608.     The action performed when VLT needs to beep is now more programmable.
  609. Already, the user could set VLT to use the usual screen flash technique by
  610. setting the beep volume to 0. An audible beep is used when the beep volume is
  611. set to a value between 0 and 64 (or to between 0 and -64 for a higher pitched
  612. beep). Now however, the beep function is truely programmable. When VLT is set
  613. to Program Mode On, and you select Beep Volume, a requester pops up to ask
  614. you which command to execute when a beep is needed. My favorite command
  615. currently is
  616.  
  617.     ~srx "address 'PingServer' beep"
  618.  
  619. This executes a VLT command (srx) which sends the BEEP command to a host with
  620. the name 'PingServer', which in turn starts sounding a nice 'Ping' sound. In
  621. this context, the difference between  rx  and  srx  should be discussed: rx
  622. sends a command to ARexx and then goes on to do other things, while srx does
  623. the same,  but waits until ARexx indicates the command was completed. This
  624. synchronous behavior allows one to sequence ARexx commands correctly, and
  625. this is one of the reasons srx is used in the above instead of rx.
  626.  
  627.     There are various new script commands, see section 2. The ASCII
  628. capture facility was modified substantially and bears closer inspection. The
  629. menu options "Capture Session" and "End Capture" still work the same way:
  630. when first selected, the "Capture Session" option displays a file requester
  631. to allow the user to enter the name of a file to capture to. Selecting ths
  632. option again suspends capture, and subsequent selection resumes capture. "End
  633. Capture" closes the current capture file. New here is that if on first
  634. selection, the selected file already exists, the user is asked whether to
  635. append, overwrite or abort the capture attempt (see secion 1). The
  636. corresponding script command "CAPture" was also modified.  "CAPture
  637. <filename>" now starts a new capture file, overwriting the file if a file of
  638. the given name already existed. From a script, capture can now be supended,
  639. resumed and turned off by "CAPture SUSPEND", "CAPture RESUME" and "CAPture
  640. OFF" respectively, while the "FLUSH" (not "CAPture FLUSH"!) command only
  641. flushes the current buffer to disk (or wherever it is written) without
  642. suspending or closing the capture file. This implies, that certain file names
  643.  have now become illegal: you cannot call your files SUSPEND, RESUME or OFF.
  644.     At the request of many users, the EXIT script command can now be used
  645. with the QUIET parameter, in order to prevent VLT from displaying the "Script
  646. Completed" message.
  647.  
  648.     A new escape sequence was introduced to allow the host to send a
  649. script command to be executed by VLT. Together with VLT's 'rx' script
  650. command, this  allows one to execute ARexx scripts on command by the host.
  651. The syntax is:
  652.  
  653.    <start-of-VLT-command><SystemPassWord><VLT command><end-of-VLT-command>
  654.  
  655. where
  656.  
  657.    <start-of-VLT-command> = <CSI>?91h
  658.    <end-of-VLT-command>   = <CSI>?91l
  659.    <SystemPassWord>       = current value of environment variable
  660.                             "SystemPassWord"
  661.    <VLT command>          = a valid VLT script command
  662.    <CSI>                  = <ESC>[ or ASCII command sequence introducer
  663.                             character
  664.    <ESC>                  = ASCII escape character
  665.  
  666. An example would be:
  667.  
  668.    <esc>[?91hMyAmigaPassword~rx "address
  669.                                  command 'WLens 100 100 VLT'"<esc>[?91l
  670.  
  671. The sequence of events in VLT, on receipt of this string from the host would
  672. be: VLT would enter "command capture" mode after receiving the h of the
  673. escape sequence, it would then store every incoming printable ASCII character
  674. (with a maximum of 255 characters) until the <esc> character of the
  675. end-of-command sequence in a buffer; it would then compare the first part of
  676. the string with the current value of the environment variable SystemPassWord
  677. on the Amiga, and if the two match, execute the rest of the string as a
  678. standard VLT command. In this case, it would find the tilda, indicating that
  679. this is indeed a VLT script command, and it would send the command "address
  680. command 'WLens 100 100 VLT'" to ARexx, which, if WLens is installed would
  681. open the WLens window on VLT's screen. The requirement of the SystemPassWord
  682. is for security reasons. Obviously, an ill-intending person on a
  683. not-too-secure mainfram could send you a command to reformat your hard disk.
  684. Now, if the password does not match the current value of the environment
  685. variable called SystemPassWord, you wil get a notice on your screen saying
  686. that a command was sent to you, and it will also show the first part of that
  687. command. If there is no such environment variable, the command will always
  688. fail this way.
  689.  
  690.     This version of VLT has support for external file transfer protocols
  691. that comply with the XPR standard, now in the process of being set. In the
  692. Transfer menu, one of the available protocols is now "External". When you
  693. select this option, a file requester will appear showing you all available
  694. XPR libraries. Currently, the only one you will find is "xprascii.library", a
  695. simple external protocol that takes the place of the ASCII upload facility
  696. that used to be in that place in the menu. When you select this library as
  697. your upload protocol, you can then select the External Options item in the
  698. Transfer menu, and you will find a requester asking you for the amount of
  699. delay to be inserted after each 80 character packet sent to the host. When
  700. you have selected that (say 50 ticks), you can proceed as you would in
  701. previous versions of VLT: select Send File to upload a file to the host,
  702. select Receive File to find out that you should use capture. Notice, that
  703. when you have selected an external protocol, and you save your configuration,
  704. the name of the protocol is also stored, and the next time you run VLT that
  705. protocol is selected. Notice also that the External Protocol options string
  706. is NOT saved.
  707.  
  708.     VLT now has a number of new command line options. The full syntax is:
  709.  
  710.     1> VLT [-i]
  711.            [+i <init-script-name>]
  712.            [+s <serial-device-name>]
  713.            [+u <unit-number>]
  714.            [+n <vlt-port-name>]
  715.            [<script-1> [<script-2> ... [<script-n>]]]
  716.  
  717. All these parameters are optional. As an example, let's consider what the 
  718. command:
  719.  
  720.     1> VLT -i +s siosbx.device +u 1 +n VLT2 myscript.scp
  721.  
  722. does. The -i tells VLT not to look for a vlt.init file. The +s options tells
  723. VLT to use siosbx.device instaed of the normal Amiga serial.device (but the
  724. device MUST look identical to the Amiga's serial device!), whereas the +u
  725. option tells VLT to use unit 1 of that device. The +n option tells VLT that
  726. it should use VLT2 for everything where it would normally have used VLT. This
  727. means that the shared screen names will be VLT2 and VLT2TEK for the VT100 and
  728. graphics screens respectively and that the ARexx port will be named VLT2. And
  729. finally, VLT will start running  myscript.scp once it has started up. Notice,
  730. that withthe +s and +n options, it is now possible to run more than one copy
  731. of VLT at the same time. Again, this is only useful if you have more than one
  732. serial port. Notice, that when you save your configuration, all of these
  733. settings (serial device name, unit, and port name) will also be saved.
  734.  
  735.     Other enhancements include:
  736. - The Quick Rendering Mode is now allowed on the Workbench.
  737. - The status windows for file transfers have a much nicer format.
  738. - VLT now checks if it is already running and brings the running version to
  739.   the front.
  740. - VLT now scrolls even faster.
  741. - VLT now works with characters above 127 in the ASCII character set. In
  742.   particular, the character $9B is now recognized as <CSI>.
  743. - VLT now sounds a bell/flashes the screen twice after up- or downloads.
  744. - VLT windows are now sizable and draggable and depth arrangeable when used
  745.   on the Workbench. One problem may be that on a standard size Workbench (no 
  746.   morerows) VLT no longer can fit 80 columns. Solution: use morerows.
  747. - The cursor height can now be changed from the menu.
  748. - The Auto-Screen-to-Back menu option brings the Workbench to the front during
  749.   file transfers.
  750. - The emit command was modified to emit its argument string in a manner
  751.   identical to text coming from the serial device, for greater speed.
  752. - Support for 110 baud was added.
  753.  
  754.  
  755.  
  756. B. Tektronix part:
  757. - - - - - - - - - -
  758.  
  759.     In the Tektronix emulation, the most notable additions have been in
  760. the Image menu: VLT now supports saving the current picture as a bitmap in
  761. IFF form, or the vectors themselves in Encapsulated PostScript form. Also,
  762. printing the bitmap as a graphics dump is now supported in four different
  763. sizes. When the Tektronix emulation is busy doing something, it will show a
  764. BUSY pointer, and it will no longer flash or beep at the end.
  765.     A Mask Colors option was added. This option changes the way in which
  766. the picture is redrawn. When Mask Colors is in effect, graphics are drawn
  767. only in the bitmaps needed for the particular color index. This allows you to
  768. draw in  separate bitplanes without erasing the contents of other bitplanes.
  769. By carefully selecting which color index to draw with, you can herewith
  770. determine which color is used for areas where two lines of different color
  771. overlap.
  772.  
  773.     Other enhancements:
  774. - when the Numeric option is selected for the graphics cursor, the X and Y
  775.   coordinates are now displayed in a separate window when the graphics cursor
  776.   is active.
  777. - The Tektronix window now has a Lock Graphics option, just like the VT100 
  778.   window. This option will set the graphics lock and switch to the VT100
  779.   window.
  780. - Many more menu options have command key abbreviations.
  781. - The current picture will now be redrawn automatically whenever an operation
  782.   has changed the window or screen.
  783. - A Lock Colors option has been added. It prevents the host from changing the
  784.   colors you had just set so carefully.
  785. - The escape parser was rewritten and now eats most 4105 escape sequences
  786.   without leaving traces.
  787.  
  788.  
  789.             ----------------------
  790.