home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / print / setupprn.zip / SETUPPRN.TXT < prev   
Text File  |  1993-06-18  |  13KB  |  315 lines
  1. (c) Copyright MG Software, P.O.Box 939, Lake Shore, MD 21122
  2.  
  3.             SETUPPRN.EXE
  4.  
  5. INTRODUCTION
  6. ------------
  7. MG Software developed this program to solve a report printing 
  8. problem many computer users encounter.
  9.  
  10. THE PROBLEM: Some programs do not let users change margins or 
  11. select fonts and other printer features when printing a report, 
  12. EVEN when their printer supports such commands.
  13.  
  14. SetupPRN solves this problem for most programs by providing a 
  15. simple user interface which sends commands to printers. It works 
  16. with any printer properly connected to an MS-DOS based computer 
  17. running DOS 3.x or Windows 3.x.
  18.  
  19. The READ.ME file describes installation.
  20.  
  21.  
  22. METHOD OF OPERATION
  23. -------------------
  24. To setup a printer you must send commands to the printer. The 
  25. commands take the form of strings of printable and non printing 
  26. ASCII characters. These commands are sometimes called escape 
  27. sequences and are typically listed in a table or appendix in your 
  28. printer manual. Frequently such tables include decimal, hexadecimal 
  29. and the ASCII equivalent of each command.
  30.  
  31. SetupPRN has a text box in the center of the screen labeled DECIMAL 
  32. PRINTER COMMAND. You may type decimal values between 0 and 255 into 
  33. this text box and edit them with your backspace keys, cursor, home
  34. key, end key and mouse.
  35.  
  36. When you press the EXECUTE button, all of the text in the DECIMAL 
  37. PRINTER COMMAND text box is converted to ASCII characters and sent 
  38. to your printer.
  39.  
  40. A list box holding printer functions and several other buttons 
  41. are available to make your work easier then just typing decimal 
  42. numbers. Each feature is described briefly in the table below. 
  43. Detailed instructions follow the table.
  44.  
  45. BUTTON    ACTION
  46. ------    ------------------------------------------------------------
  47. About     Displays information about SetupPrn and MG Software.
  48. Append... Converts characters to decimal and appends the result to the
  49.           to the DECIMAL PRINTER COMMAND text box.
  50. Colors    Changes the foreground and background colors.
  51. Clear     Clears FUNCTIONs or DECIMAL commands.
  52. Execute   Sends DECIMAL command to printer.
  53. Help      Displays this text.
  54. Load      Loads printer FUNCTIONs from disk.
  55. Quit      Ends SetupPrn.exe.
  56. Save      Writes the decimal command and an identifier to disk.
  57. Test Page Prints a test page.
  58.  
  59.  
  60. PRINTER FUNCTIONS LIST BOX
  61. --------------------------
  62. The list box on the left side of the screen holds printer functions 
  63. like Bold, Italic, Underline and Form Feed. On program startup it 
  64. includes four functions common to almost all printers: Carriage 
  65. Return, Escape, Form Feed and Line Feed.
  66.  
  67. To select a printer function from the list box place the mouse
  68. pointer over the desired printer function and click once. The matching 
  69. decimal command will be added to the printer commands list box.
  70.  
  71. If you are not using a mouse TAB to the list box, move the highlight
  72. to the desired function and press ENTER.
  73.  
  74. The LOAD button (below the list box) loads previously saved commands
  75. into the list box. One printer command file HP.CMD is included in the
  76. shareware distribution. HP.CMD is loaded automatically for windows 
  77. users. 
  78.  
  79. You can build your own command file by pressing the save button. 
  80.  
  81. You will be sent a list of available free printer command files when 
  82. you register.
  83.  
  84. Details on building printer command files are provided below.
  85.  
  86. The CLEAR button (below the printer functions list box) clears the 
  87. list and returns it to its original state with four generic commands.
  88.  
  89.  
  90. PRINTER COMMAND TEXT BOX
  91. ------------------------
  92. The printer command text box holds the current printer command 
  93. represented as a set of decimal numbers separated by spaces.
  94.  
  95. You can type digits into this text box and you can edit any
  96. digits in the text box. Editing keys include backspace, home, end,
  97. and the four cursor keys.  Highlighting keys are available for 
  98. deleting or replacing a group of digits. Highlighting keys are 
  99. shifted cursor keys. The mouse is also useful for highlighting 
  100. and moving the insertion point.
  101.  
  102. The CLEAR button (below the printer command text box) deletes all
  103. text from the text box. 
  104.  
  105. The APPEND CHARACTERS button allows you to enter a set of printable
  106. ASCII characters which are then converted to decimal and appended to
  107. whatever is in the text box.
  108.  
  109. The SAVE button saves the printer command currently in the printer
  110. command text box to the file you select. If you do not select a
  111. file (e.g. press cancel), you will be asked if you want to create
  112. a new printer commands file.
  113.  
  114. The EXECUTE button converts the contents of the printer command
  115. text box to ASCII and sends the ASCII string to the printer.
  116. It also clears the printer command text box, so it is wise to save
  117. your printer command before executing it.
  118.  
  119.  
  120. OTHER BUTTONS
  121. -------------
  122. The ABOUT button gives a brief description of the program and its
  123. origin at MG Software.
  124.  
  125. The COLORS button helps you change the foreground and background 
  126. screen colors.
  127.  
  128. The HELP button gives a brief description the program and
  129. each button.
  130.  
  131. The TEST PAGE button prints lines from the document in 
  132. setupprn.txt as a test of your current printer settings.
  133.  
  134. The QUIT button exits the program.
  135.  
  136.  
  137. CREATING A PRINTER COMMAND FILE
  138. -------------------------------
  139. SetupPRN will append to an existing printer command file. The 
  140. format of the printer command file is:
  141.  
  142. <printer name>
  143. <command name>|<decimal command string>
  144. <command name>|<decimal command string>
  145. <command name>|<decimal command string>
  146.       .
  147.       .
  148.       .
  149.  
  150. If you press cancel on the save dialog box you will be asked
  151. if you want SetupPRN to create a new command file for you.
  152.  
  153. You may also use any text editor to make your own command file
  154. without SetupPRN. We advise you to look at HP.CMD first.
  155.  
  156.  
  157. COMMAND LINE ARGUMENTS
  158. ----------------------
  159. Two command line arguments are supported: (1) default printer
  160. file name and (2) colors.
  161.  
  162. These arguments allow you to customize SetupPRN so that it always 
  163. loads your command set and colors. 
  164.  
  165. USAGE: SetupPRN [<command file name> [<foreground> <background>]]
  166.  
  167. Command file name is the complete path and file name of the
  168. command file you want to load at startup.
  169.  
  170. Foreground and background colors are numbers separated by spaces.
  171. The easiest way to derive good color numbers is to press the COLORS
  172. button on SetupPRN. After selecting colors you will be told their
  173. numerical equivalent.
  174.  
  175.  
  176. CAVEATS
  177. -------
  178. The DOS version of SetupPRN works like a Windows program. If 
  179. you are familiar with Windows you will know how to use it when
  180. you see it.
  181.  
  182. Any digits between 0 and 255 which you type into the printer 
  183. command text box will be converted to ASCII and sent to the 
  184. printer. SetupPRN does not validate printer commands. If you 
  185. make an error it will be sent to the printer! Although you are
  186. given two opportunities to abort before execution. 
  187.  
  188. You may want to send a reset command to clear all settings and 
  189. try again when you send an incorrect string to the printer.
  190.  
  191. SetupPRN will always send its command string to the printer. 
  192.  
  193. Some programs like to reset the printer before printing a report,
  194. in this case any settings made with SetupPRN will be lost.
  195.  
  196. Printers are usually reset when power is interrupted. So if you
  197. turn your printer off and then back on, you will loose any setup
  198. you did with SetupPRN. So, save your settings and rerun SetupPRN
  199. each time you power up your printer.
  200.  
  201. Sometimes you may configure your printer with SetupPRN and then
  202. decide you want a completely different configuration. In such cases
  203. execute a reset command using SetupPRN followed by the new
  204. configuration.
  205.  
  206. Your configuration command my be several thousand digits and spaces
  207. long, so you may want to save difficult configurations as ONE 
  208. printer function.
  209.  
  210. MG Software does have a native Windows version of SetupPRN. It
  211. is available to registered users. The DOS version is the most
  212. useful version even to Windows users because: most Windows programs 
  213. which print do so using Print Manager. Most Print Manager printer 
  214. drivers send a RESET and then re configure the printer so configuration
  215. via SetupPRN is replaced before the report is generated. 
  216.  
  217. The DOS version of SetupPRN is most useful under Windows when
  218. run in an MS-DOS window since printer commands go to the printer
  219. via DOS. 
  220.  
  221. When running under Windows you may find that your mouse does not 
  222. work on SetupPRN in "windowed mode". In that case change to full 
  223. screen mode and your mouse will work. To change to full screen mode
  224. change the "settings" in the Windows control menu box (click once
  225. on the box in the upper left corner of the Setup Printer window).
  226. You can use the TAB and ENTER keys instead of a mouse.
  227.  
  228. The borders of the 3D buttons on SetupPRN don't always appear on 
  229. LCD screens in monochrome mode. The COLORS button will allow
  230. you to try different combinations of fore and background. Try
  231. the color in row 1 column 1 for foreground and row 3 column 4
  232. for background, that works nicely on our monochrome laptops.
  233.  
  234.  
  235. SHAREWARE
  236. ---------
  237. This version of SetupPrn.exe is shareware developed by MG Software.
  238. PLEASE copy and distribute it freely.
  239.  
  240. To register your copy please send $9.95 to:
  241.  
  242. MG Software
  243. PO Box 939
  244. Lake Shore, MD 21122-0004
  245.  
  246. Registered users will receive early notice of upgrades and have access to
  247. other shareware programs developed by MG Software.
  248.  
  249. MG Software sponsors a BETA TEST PROGRAM. Participants receive free copies
  250. of new software in exchange for their comments and suggestions. To join send
  251. your request and registration to the address above, ATTEN: BETA TESTING. 
  252.  
  253.  
  254. REWARD
  255. ------
  256. As always, the first registered user to report an unreported bug in an MG
  257. Software product will receive a credit toward any future purchase from MG
  258. Software. The value of your credit is your registration fee squared.
  259.  
  260.  
  261. SUMMARY OF LICENSE AGREEMENT
  262. ----------------------------
  263. Anyone may copy and distribute this program freely as long as they do so
  264. at no charge to the receiving party.  
  265.  
  266. You only need to distribute the file: SETUPPR.EXE since this archive
  267. holds all the files and documentation needed to run SetupPRN.
  268.  
  269. The purpose of shareware is to provide computer users the opportunity 
  270. to try a program before buying it.  Should you find this program useful 
  271. and desire to continue to utilize it please register as described above. 
  272. If you want to include this program in a commercial product please contact 
  273. the MG LICENSE GROUP at the address above.
  274.  
  275. MG Software warranties that this software will function substantially as
  276. described in its on-line help text. No warranties for specific use or 
  277. purpose are given or implied. In no event shall MG Software be responsible 
  278. or liable for damages, claims, or problems which are the result of use or
  279. misuse of this product beyond the purchase price or registration fee for
  280. the product.
  281.  
  282. A copy of the complete license agreement is available to registered users
  283. of this product upon request.
  284.  
  285.  
  286. A SCREEN REPRESENTATION
  287. -----------------------
  288.  
  289.  
  290. +ª_ª                             SETUP PRINTER                              ªª+
  291. ª+--------------------+---------------------------------------+---------------+ª
  292. ªª Printer Functions  ª        Decimal Printer Command        ª               ªª
  293. ªª+------------------+ª+-------------------------------------+ª+-------------+ªª
  294. ªªª Carriage Return  ªª012                                  ªª   About...  ªªª
  295. ªªª Escape            ªª                                      ª+-------------+ªª
  296. ªªª Form Feed        _ªª                                     _ª               ªª
  297. ªªª Line Feed        _ªª                                     _ª               ªª
  298. ªªª                  _ªª                                     _ª+-------------+ªª
  299. ªªª                  _ªª                                     _ªª    Colors   ªªª
  300. ªªª                  _ªª                                     _ª+-------------+ªª
  301. ªªª                  _ªª                                     _ª+-------------+ªª
  302. ªªª                  _ªª                                     _ªª     Help    ªªª
  303. ªªª                  _ªª                                     _ª+-------------+ªª
  304. ªªª                  _ªª                                     ª               ªª
  305. ªªª                  _ª+-------------------------------------+ª               ªª
  306. ªªª                  _ª+------------++-----------------------+ª+-------------+ªª
  307. ªªª                  ªª    Clear   ªª   Append Characters   ªªª  Test Page  ªªª
  308. ªª+------------------+ª+------------++-----------------------+ª+-------------+ªª
  309. ªª+--------++--------+ª+------------++-----------------------+ª+-------------+ªª
  310. ªªª  Load  ªª  Clear ªªª    Save    ªª        Execute        ªªª     QUIT    ªªª
  311. ªª+--------++--------+ª+------------++-----------------------+ª+-------------+ªª
  312. ª+--------------------+---------------------------------------+---------------+ª
  313. ª(C)Copyright 1993, MG Software Inc.          PO Box 939, Lake Shore, MD 21122 ª
  314. +------------------------------------------------------------------------------+
  315.