home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 015 / vps.arc / VPS.DOC < prev    next >
Encoding:
Text File  |  1986-03-09  |  19.3 KB  |  588 lines
  1.  
  2. Page 1        VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  3.  
  4.  
  5.  
  6.  
  7. What is VPS?
  8. ------------
  9.  
  10.   VPS is an attempt to provide a generic printer setup utility that may
  11.   be configured for any printer that uses escape sequences to control
  12.   the printer.  There are many good printer setup utilities available,
  13.   but they usually are designed to work with a specific model or brand of
  14.   printer and with a limited set of escape codes.  VPS allows you to define
  15.   the escape sequences that you want to use and can be tailored for your
  16.   specific printer and needs.  If you have more than one printer, you can
  17.   create setup definitions for each printer and use VPS as needed to configure
  18.   each printer based upon the printer definition you choose.
  19.  
  20.  
  21. There are three programs available.
  22.  
  23.   VPS    -  a menu driven version where options are selected by the cursor
  24.             control keys.
  25.  
  26.   VPSB   -  a 'batch' version which may be used in BAT files.
  27.  
  28.   VPSRES -  a version similar to VPS that remains resident. This version
  29.             is available only to registered users.
  30.  
  31.  
  32. Page 2        VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  33.  
  34.  
  35.  
  36.  
  37. Using VPS
  38. ---------
  39.  
  40.  
  41. VPS [d:\path\vpsfile]
  42.  
  43.  
  44.  
  45.     vpsfile - a text file which contains definitions for various printer
  46.               commands and options.  If not specified VPS.DEF is assumed.
  47.  
  48.  
  49. Examples:
  50.  
  51.   VPS vps.ibm
  52.  
  53.      - Will look for a file named vps.ibm on the logged drive.
  54.  
  55.  
  56.   VPS A:vps.oki
  57.  
  58.      - Will look for a file named vps.oki on drive A:
  59.  
  60.  
  61.   VPS C:\DOS\vps.eps
  62.  
  63.      - Will look for a file named vps.eps on drive C: in directory DOS
  64.  
  65.   VPS
  66.      - Will look for a file named vps.def on the current logged drive and
  67.        directory.
  68.  
  69.  
  70. Once VPS is activated use the cursor keys UP-ARROW, DOWN-ARROW, LEFT-ARROW,
  71. and RIGHT-ARROW to select an item from the VPS menu and then press RETURN
  72. to send the associated printer control codes to the printer.  The VPS menu
  73. is sensitive to the first character of each menu item.  An item may
  74. be selected by pressing the key corresponding to the first character of
  75. the desired menu item.  This method not only selects the option, but also
  76. sends the control codes to the printer.  Of course for this method to work
  77. properly you must insure that the first characters of all the menu options
  78. are unique. The PgUp and PgDn keys may be used to select LPT1, LPT2, or LPT3.
  79.  
  80. Page 3        VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  81.  
  82.  
  83.  
  84.  
  85. Using VPSB
  86. ----------
  87.  
  88.  
  89. VPSB lptx: [d:\path\vpsfile or /nn,nn,...,nn/]
  90.  
  91.      VPSB is a batch version of VPS.  It can be placed in BAT files.  A
  92.      typical use would be in AUTOEXEC.BAT to initialize a printer at
  93.      boot time.
  94.  
  95.      lptx:   -  is used to specify which printer you want to initialize.
  96.                 Valid values are LPT1:, LPT2:, LPT3:
  97.                 The colon is required.
  98.  
  99.      vpsfile -  a text file which contains definitions for various printer
  100.                 options and commands.  The format of this file is the same
  101.                 as used by VPS and VPSRES.  All printer control characters
  102.                 found in the file will be sent to the printer.
  103.  
  104.      /nn,nn,...,nn/  - this is alternative method of specifying the printer
  105.                        control codes.  The nn's represent escape codes
  106.                        in either decimal or character format. The slashes are
  107.                        required. See DEFINING PRINTER CONTROL FILES for
  108.                        more information.
  109.  
  110.  
  111. Examples:
  112.  
  113.   VPSB LPT1: vps.int
  114.  
  115.      - Will look for a file named vps.int on the current logged drive and
  116.        directory and send all printer codes to LPT1:
  117.  
  118.   VPSB LPT2: /27,"C",68/
  119.  
  120.      - Will send the escape codes 27 C 68 to LPT2:
  121.  
  122.   VPSB LPT3: C:\DOS\vps.eps
  123.  
  124.      - Will look for a file named vps.eps on drive C: in directory DOS
  125.        and send all printer control codes to LPT3:
  126.  
  127.  
  128.  
  129.  
  130. Page 4        VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  131.  
  132.  
  133.  
  134.  
  135.  
  136. Using VPSRES
  137. ------------
  138.  
  139. VPSRES [d:\path\vpsfile] [activate key] [deinstall key]
  140.  
  141.    VPSRES is a resident version of VPS.  This version map be activated
  142.    at the press of a key, control codes sent to a printer, and return
  143.    to your original application.
  144.  
  145.    vpsfile - see previous descriptions
  146.  
  147.    [activate key] - optional parameter which if specified must be a decimal
  148.                     key code for the keys you wish to use to activate
  149.                     VPSRES. The default is 91 which is SHIFT-F8.  A
  150.                     partial list of key codes is provided in APPENDIX A.
  151.  
  152.    [deinstall key]- optional parameter which if specified must be a decimal
  153.                     key code for the keys you wish to use to deinstall
  154.                     VPSRES.  There is no default.  Deinstalling VPSRES
  155.                     can cause problems if some other memory resident
  156.                     programs have been loaded after VPSRES was loaded.
  157.                     Use this option only if VPSRES was loaded last.
  158.  
  159.     NOTE: these parameters are positional. In order to specify a deinstall
  160.           key you must specify a vpsfile and an activate key code.
  161.  
  162.  
  163. Examples:
  164.  
  165.     VPSRES \DOS\vps.ibm 91 93
  166.  
  167.       - Will load VPSRES and look for a file named vps.ibm in directory DOS
  168.         on the current looged drive.  SHIFT-F8 (91) will be used to activate
  169.         VPSRES.  SHIFT-F10 (93) will be used to deinstall VPSRES.
  170.  
  171.     VPSRES
  172.  
  173.       - WIll load VPSRES and look for file vps.def in the currently logged
  174.         drive and directory.  SHIFT-F8 (the default) will be used to
  175.         activate VPSRES.  No key is provided to deinstall VPSRES.
  176.  
  177.     VPSRES vps.ibm
  178.  
  179.       - Will load VPSRES and look for a file named vps.named vps.ibm on the
  180.         current logged drive and directory. SHIFT-F8 will be used to activate
  181.         VPSRES and no deinstall key will be defined.
  182.  
  183.  
  184. Page 5        VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  185.  
  186.  
  187.  
  188.     NOTE:  VPSRES will only be loaded once (i.e. become resident).  The
  189.            printer definition file will not be accessed until the first
  190.            time VPSRES is actually activated.  Thereafter the printer
  191.            definition file will not be accessed again unless errors were
  192.            detected while loading the printer control codes. Once the
  193.            control codes are loaded without errors the printer definition
  194.            file will not be accessed again and need not be available.
  195.            Once the printer definition file is loaded, another file cannot
  196.            be loaded unless VPSRES is first deactivated. This is one reason
  197.            that an option is provided for deactivation.  Remember that
  198.            VPSRES may only be safely deinstalled if it was the last program
  199.            to become resident.
  200.  
  201.  
  202. Once VPSRES is activated use the cursor keys UP-ARROW, DOWN-ARROW, LEFT-ARROW,
  203. and RIGHT-ARROW to select an item from the VPSRES menu and then press RETURN
  204. to send the associated printer control codes to the printer.  The VPSRES menu
  205. is sensitive to the first character of each menu item.  An item may
  206. be selected by pressing the key corresponding to the first character of
  207. the desired menu item.  This method not only selects the option, but also
  208. sends the control codes to the printer.  Of course for this method to work
  209. properly you must insure that the first characters of all the menu options
  210. are unique. The PgUp and PgDn keys may be used to select LPT1, LPT2, or LPT3.
  211.  
  212. Page 6        VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  213.  
  214.  
  215.  
  216.  
  217. DEFINING PRINTER CONTROL FILES
  218. ------------------------------
  219.  
  220.  
  221. A printer control code file is a text file that you create using your
  222. favorite editor.  It is used to provide information to the VPS programs
  223. about the escape sequences that your printer will recognize.
  224.  
  225. The statements in this file have the following format:
  226.  
  227.  
  228.    <desc>=nn,nn,nn,...,nn
  229.  
  230.    where:
  231.  
  232.       <desc> - up to 20 bytes of descriptive text which will be displayed
  233.                in the VPS menus. This must begin in column 1.  If the
  234.                first character is unique then the menu option may be
  235.                selected by pressing the key for that character. This
  236.                descriptive text is terminated with and equal sign (=).
  237.  
  238.       nn,nn  - ASCII decimal or character escape codes. If character
  239.                format is used the characters must be enclosed in quotes
  240.                ("). Character strings are limted to a max of four
  241.                characters. A max of 20 escape codes may be specified
  242.                per statement.  Two special control codes have been
  243.                defined to perform two special functions. INIT which
  244.                will force a hardware reset of the printer with a 2
  245.                second delay after the reset. WRIT which will display
  246.                some test text information to assist in determining
  247.                whether the printer is responding properly to the printer
  248.                escape codes.
  249.  
  250.                NOTE: some printers have a reset escape sequence which
  251.                      should be used in preference to the INIT code. The
  252.                      Epson FX-100+ is one such printer. If the INIT
  253.                      function is used, sometimes a CANCEL (24) code is
  254.                      required in conjunction with the INIT.
  255.  
  256. In addition, three special <desc> (@LPT, @TITLE, and @WRITDATA) have been
  257. provided to allow definition of default printer, menu title information and
  258. to override the default test text. These three special <desc>'s must be
  259. in upper case only.
  260.  
  261. Page 7        VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  262.  
  263.  
  264.  
  265.  
  266. Examples:
  267.  
  268. @LPT=x where x=1 or 2 or 3
  269.  
  270.      - To define the default printer.
  271.  
  272.  
  273. @TITLE=IBM GRAPHICS PRINTER SETUP
  274.  
  275.      - To define a menu title.
  276.  
  277. @WRITDATA=This is some sample text for use with VPS
  278.  
  279.      - To define some test text.
  280.  
  281.  
  282. FORM FEED=12
  283.  
  284.    - the descriptive text "FORM FEED" will be display in the VPS menus.
  285.      When this option is chosen a form feed character (12) will be sent
  286.      to the printer.
  287.  
  288.  
  289. LINE FEED=10
  290.  
  291.    - the descriptive text "LINE FEED" will display in the VPS menus.
  292.      When this option is chosen a line feed character (10) will be sent
  293.      to the printer.
  294.  
  295.  
  296. UNDERLINE ON=27,"-1"
  297.        or
  298. UNDERLINE ON=27,"-","1"
  299.  
  300.    - the descriptive text "UNDERLINE ON" will display in the VPS menus.
  301.      When this option is chosen the codes 27 "-1" will be sent to the
  302.      printer.
  303.  
  304.  
  305. UNDERLINE ON=27,45,49
  306.  
  307.    - this equivalent to the above since decimal 45 is a "-" and 49 is
  308.      a "1".
  309.  
  310.  
  311. 7-TINY TEXT=15,27,"3",15,27,"S1",27,"M"
  312.  
  313.    - will turn on elite subscripting compressed with 15/216 line spacing.
  314.      Valid for Epson FX-100+ printers.
  315.  
  316.  
  317. APPENDIX B contains several sample printer code files.
  318.  
  319. Page 8        VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  320.  
  321.  
  322.  
  323.                       APPENDIX A
  324.  
  325.                       KEY CODES
  326.  
  327.  
  328. KEY           UNSHIFTED     SHIFT       CTRL         ALT
  329. ------------------------------------------------------------
  330. F1               59          84          94          104
  331. F2               60          85          95          105
  332. F3               61          86          96          106
  333. F4               62          87          97          107
  334. F5               63          88          98          108
  335. F6               64          89          99          109
  336. F7               65          90          100         110
  337. F8               66          91          101         111
  338. F9               67          92          102         112
  339. F10              68          93          103         113
  340. LARR             75                      115
  341. RARR             77                      116
  342. UARR             72
  343. DARR             80
  344. HOME             71
  345. END              79                      117
  346. PGUP             73                      132
  347. PGDN             81                      118
  348. INS              82
  349. DEL              83
  350. A                                                    30
  351. B                                                    48
  352. C                                                    46
  353. D                                                    32
  354. E                                                    18
  355. F                                                    33
  356. G                                                    34
  357. H                                                    35
  358. I                                                    23
  359. J                                                    36
  360. K                                                    37
  361. L                                                    38
  362. M                                                    50
  363. N                                                    49
  364. O                                                    24
  365. P                                                    25
  366. Q                                                    16
  367. R                                                    19
  368. S                                                    31
  369. T                                                    20
  370. U                                                    22
  371. V                                                    47
  372. W                                                    17
  373. X                                                    45
  374. Y                                                    21
  375. Z                                                    44
  376.  
  377. Page 9        VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  378.  
  379.  
  380.  
  381.                       APPENDIX A
  382.  
  383.                       KEY CODES
  384.  
  385.  
  386. KEY           UNSHIFTED     SHIFT       CTRL         ALT
  387. --------------------------------------------------------
  388. 0                                                    129
  389. 1                                                    120
  390. 2                                                    121
  391. 3                                                    122
  392. 4                                                    123
  393. 5                                                    124
  394. 6                                                    125
  395. 7                                                    126
  396. 8                                                    127
  397. 9                                                    128
  398.  
  399. Page 10       VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  400.  
  401.  
  402.  
  403.                          APPENDIX B
  404.  
  405. SAMPLE 1
  406. --------
  407.  
  408. @LPT=1
  409. @TITLE=Epson FX100+ Printer Setup
  410. @WRITDATA=This is some test data, which can be used to verify options
  411. A-RESET=27,"@"
  412. B-8LPI=27,"0"
  413. C-6LPI=27,"2"
  414. D-DEFAULTS=27,"@",27,"M",27,"0",27,"C",68,27,"N",3
  415. E-ELITE ON=27,"M"
  416. F-DBL WIDTH ON=27,"W1"
  417. G-DBL WIDTH OFF=27,"W0"
  418. H-FORM FEED=12
  419. I-LINE FEED=10
  420. J-COMPRESS ON=15
  421. K-COMPRESS OFF=18
  422. L-PROPORTIONAL ON=27,"p1"
  423. M-PROPORTIONAL OFF=27,"p0"
  424. N-UNDERLINE ON=27,"-1"
  425. O-UNDERLINE OFF=27,"-0"
  426. P-ITALIC ON=27,"4"
  427. Q-ITALIC OFF=27,"5"
  428. R-EMPHASIZED ON=27,"E"
  429. S-EMPHASIZED OFF=27,"F"
  430. T-DBL STRIKE ON=27,"G"
  431. U-DBL STRIKE OFF=27,"H"
  432. V-BEEPER=7
  433. W-UNIDIRECTIONAL ON=27,"U1"
  434. X-UNIDIRECTIONAL OFF=27,"U0"
  435. Y-IMMEDIATE ON=27,"i1"
  436. Z-IMMEDIATE OFF=27,"i0"
  437. 1-68 LINES/PAGE=27,"C",68
  438. 2-INITIALIZE=INIT,24
  439. 3-SUPERSCRIPT ON=27,"S0"
  440. 4-SUBSCRIPT ON=27,"S1"
  441. 5-SUB/SUPER OFF=27,"T"
  442. 6-WRITE TEST DATA=WRIT
  443. 7-TINY=15,27,"3",15,27,"S1",27,"M"
  444. 8-FORWARD 1/216 IN=27,"J",1
  445. 9-REVERSE 1/216 IN=27,"j",1
  446. 0-66 LINES PAGE=27,"C",66
  447.  
  448.  
  449. Page 11       VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  450.  
  451.  
  452.  
  453.                          APPENDIX B
  454.  
  455. SAMPLE 2
  456. --------
  457. @TITLE=IBM Color Printer Setup
  458. @WRITDATA=This is some test data, which can be used to verify options
  459. A-SET DEFAULTS=27,"C",68,27,"0",27,58
  460. B-DBL WIDTH ON=27,"W",1
  461. C-DBL WIDTH OFF=27,"W",0
  462. E-ELITE ON=27,58
  463. F-FORM FEED=12
  464. G-PROPORTIONAL ON=27,"p",1
  465. H-PROPORTIONAL OFF=27,"p",0
  466. I-COMPRESS ON=15
  467. J-COMPRESS OFF=18
  468. L-LINE FEED=10
  469. M-UNDERLINE ON=27,"-1"
  470. N-UNDERLINE OFF=27,"-0"
  471. O-EMPHASIZED ON=27,"E"
  472. P-68 LINES/PAGE=27,"C",68
  473. Q-EMPHASIZED OFF=27,"F"
  474. R-RESET TO POWER UP=27,"?",0,INIT
  475. S-DBL STRIKE ON=27,"G"
  476. T-DBL STRIKE OFF=27,"H"
  477. U-UNIDIRECTIONAL ON=27,"U1"
  478. V-UNIDIRECTIONAL OFF=27,"U0"
  479. W-WRITE TEST DATA=WRIT
  480. X-SUPERSCRIPT ON=27,"S",0
  481. Y-SUBSCRIPT ON=27,"S",1
  482. Z-SUB/SUPER OFF=27,"T"
  483. 1-SET TOP OF PAGE=27,52
  484. 2-TINY=15,27,"3",15,27,"S",1,27,"M"
  485. 3-DP QUALITY PRINT=27,"I",1
  486. 4-TEXT QUALITY PRINT=27,"I",2
  487. 5-LETTER QUALITY PRINT=27,"I",3
  488. 6-6LPI=27,"2"
  489. 8-8LPI=27,"0"
  490. 9-PRINT LABELS=INIT,27,"I",3
  491. 0-66 Lines/Page=27,"C",66
  492.  
  493. Page 12       VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  494.  
  495.  
  496.  
  497.                          APPENDIX B
  498.  
  499. SAMPLE 3
  500. --------
  501. @TITLE=Okidata 192/193 Printer Setup
  502. @WRITDATA=This is some test data, which can be used to verify the options
  503. A-RESET TO POWER UP=INIT,24
  504. B-8LPI=27,48
  505. C-LETTER QUALITY ON=27,88,1
  506. D-LETTER QUALITY OFF=27,88,0
  507. E-DBL WIDTH ON=27,"W",1
  508. F-DBL WIDTH OFF=27,"W",0
  509. G-FORM FEED=12
  510. H-LINE FEED=10
  511. I-COMPRESS ON=15
  512. J-COMPRESS OFF=18
  513. K-ELITE=27,58
  514. L-UNDERLINE ON=27,"-1"
  515. M-UNDERLINE OFF=27,"-0"
  516. N-EMPHASIZED ON=27,"E"
  517. O-EMPHASIZED OFF=27,"F"
  518. P-DBL STRIKE ON=27,"G"
  519. Q-DBL STRIKE OFF=27,"H"
  520. R-BEEPER=7
  521. S-UNIDIRECTIONAL ON=27,55,1
  522. T-UNIDIRECTIONAL OFF=27,55,0
  523. U-68 LINES/PAGE=27,"C",68
  524. V-SUPERSCRIPT ON=27,"S",0
  525. W-SUBSCRIPT ON=27,"S",1
  526. X-SUB/SUPER OFF=27,"T"
  527. Y-WRITE TEST DATA=WRIT
  528. Z-TINY=15,27,"3",15,27,"S",1,27,"M"
  529. 1-DP QUALITY PRINT=27,"I",1
  530. 2-TEXT QUALITY PRINT=27,"I",2
  531. 3-LETTER QUALITY PRINT=27,"I",3
  532. Page 13       VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  533.  
  534.  
  535. General Information
  536. -------------------
  537.  
  538. The VPS programs were developed on a PC/XT with 512K using DOS 2.1.
  539. The resident version VPSRES requires approximately 39K of address
  540. space.
  541.  
  542. The following files are provided in the ARC library:
  543.  
  544.             VPS.COM    - menu driven version
  545.             VPSB.COM   - batch version
  546.             VPS.DEF    - default printer code file (Epson FX-100+)
  547.             VPS.OKI    - printer code file for OKIDATA 193
  548.             VPS.IBM    - printer code file for IBM Graphics Printer
  549.             VPS.DOC    - this document
  550.  
  551.  
  552. FX-100+ is a registered trademark of EPSON AMERICA Inc.
  553.  
  554. IBM is a registered trademark of International Business Machines.
  555.  
  556. OKIDATA is a registered trademark of OKIDATA.
  557.  
  558. Page 14       VPS-Versatile Printer Setup Utility  Version 1.0        03-01-86
  559.  
  560.  
  561.  
  562. License information
  563. -------------------
  564.  
  565. You are free to use, copy and distribute all VPS files providing that
  566.  
  567.            NO FEE IS CHARGED FOR USE, COPYING, OR DISTRIBUTION
  568.  
  569.            IT IS NOT MODIFIED IN ANY WAY
  570.  
  571. These programs are provided AS IS without any warranty, expressed or implied,
  572. including but not limited to fitness for a particular purpose.
  573.  
  574. If you find these programs to be useful, a $10 contribution would be
  575. appreciated.  For a $20 contribution you become a registered user
  576. entitled to the resident version VPSRES and the latest versions of the
  577. other programs and documentation.
  578.  
  579. You may not use these programs in a commercial environment or a
  580. government organization without paying a licesnse fee of $20.
  581.  
  582. In any case, you are encouraged to provide any comments, suggestions, or
  583. problems to:
  584.  
  585.  
  586.                               S & S SYSTEMS
  587.                               P.O. BOX 1725
  588.                               CLAREMORE, OK 74018