home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / graphics / utility / jetemu11 / jetemu.doc next >
Encoding:
Text File  |  1993-01-28  |  5.8 KB  |  151 lines
  1. JETEMU.PRG V1.1x
  2.  
  3.  
  4.  
  5. Disclaimer:
  6.  
  7. This program is public domain and may be copied and distributed free 
  8. of charge, provided that all the following files are included:
  9.  
  10. JETEMU.PRG
  11.  
  12. JETEMU.DOC
  13.  
  14. PGS1.PRT
  15.  
  16.  
  17.  
  18. There are no garanties concerning its performance. I am not 
  19. responsible for any damage resulting from its use.
  20.  
  21.  
  22.  
  23. B'Brox Productions is:
  24.  
  25. Monika Herzig/Peter Kienle
  26.  
  27. 1502 S. Olive St.
  28.  
  29. Bloomington, IN 47401
  30.  
  31. (812) 334 3022
  32.  
  33. GEnie: M.HERZIG
  34.  
  35. --------------------------------------------------
  36.  
  37.  
  38.  
  39. Changes from Version 1.0:
  40.  
  41. Now supports all ST resolutions (low, medium and high) mono and 
  42. color. I don't know what it does on graphic expansion cards and the 
  43. like.
  44.  
  45.  
  46.  
  47. This little program arose out of the need to verify printer data that 
  48. is being sent printers of the DeskJet printer family. Ever since 
  49. working with the SPECTRE MacIntosh Emulator I experienced some odd 
  50. things about printing to the DeskJet from this setup. The printer 
  51. would choke on data, then stop for a while and pick up printing after 
  52. it had lost half a page or so of data.
  53.  
  54.  
  55.  
  56. Using a Null Modem cable between to STs, printing to the modem port 
  57. from the ST running SPECTRE and receiving on the 'real' ST with 
  58. STALKER, running a little program that writes the received bytes 
  59. straight to disk I was finally able to capture the stuff that would 
  60. normally be sent to the DeskJet.
  61.  
  62.  
  63.  
  64. Not unlike PostScript®, the printer language of the DeskJet (HP PCL III) 
  65. is quite readable (Ok, not quite as readable...). So I started to 
  66. scan the printer data for possibly corrupt sequences that could cause 
  67. the printer to choke. However, on a regular 8.5x11" page those are up 
  68. to 3300 lines of data and to scan through printer code line by line 
  69. with your eyes really sucks. So I started writing a little 
  70. interpreter for HP PCL III (in PostScript® they call that Display 
  71. Postscript). And JetEmu is the result.
  72.  
  73.  
  74.  
  75. It has only one function: Load a DeskJet printer file (that has been 
  76. created on disk by any application capable of doing so), and displaying 
  77. the resulting page on the screen. Each dot on the screen thereby 
  78. represents one dot sent to the printer. Since most printing is done in 
  79. 300dpi one inch on paper is blown up to about half a screen. But at 
  80. least you can see some details. So JetEmu can also be used as print 
  81. preview for most programs that can _print to disk_ with a DeskJet 
  82. driver.
  83.  
  84.  
  85.  
  86. When you run JetEmu you are presented with a file selector. You can 
  87. select any file, however, non-printer files could cause trouble. There 
  88. is only a limited format check (all printer drivers I know send a 
  89. Dots-Per-Inch command before sending any data, therefore if JetEmu 
  90. doesn't find such a command it won't process the file).
  91.  
  92.  
  93.  
  94. Current limitations and known bugs:
  95.  
  96.  
  97.  
  98. 1) At the moment the two compaction modes in HP PCL III are not 
  99. decoded. I am working on this, but couldn't get any information yet, 
  100. of how to decode this. It is time consuming to try to find out by 
  101. myself. (all programs I use with HP output omit compacted graphics - 
  102. it does save a lot of disk space and prints FAST, though)
  103.  
  104.  
  105.  
  106. 2) I still can't get the X position command to work right. (but this 
  107. also is not used by any program I have)
  108.  
  109.  
  110.  
  111. 3) ONLY graphic commands are displayed on screen. This means that 
  112. straight ASCII characters in a print file will be ignored!
  113.  
  114.  
  115.  
  116. 4) I don't know what printer files for color DeskJets looks like, 
  117. therefore I don't know what Jetemu does with such a file.
  118.  
  119.  
  120.  
  121. 5) There is still some wrong stuff in my GEMDOS error handler. For 
  122. example: running out of memory will very likely crash the program.
  123.  
  124.  
  125.  
  126.  
  127.  
  128. Most DeskJet printer files come in very respectable sizes. Output from 
  129. Pagestream can be up to 1.5 Meg per page (depending on how dense the 
  130. page is). In addition JetEmu builds up a virtual page in RAM. For a 
  131. 8.5x11" page the virtual page is around 1 Meg. So under 2MB of RAM it 
  132. is probably problematic to run the program.
  133.  
  134.  
  135.  
  136. I tried to make the program consistent with GEM rules, although I 
  137. don't have any other hardware but a monochrome ST/MegaSte and can use 
  138. a TV to check color stuff. JetEmu works on the MONSTER big screen 
  139. emulation.
  140.  
  141.  
  142.  
  143. Here are the menu selections:
  144.  
  145.  
  146.  
  147. JetEmu
  148.  
  149.     About JetEmu...
  150.  
  151.         You know what...
  152.  
  153.  
  154.  
  155. Other
  156.  
  157.     Open...
  158.  
  159.         To load another file select this option. After the file has 
  160.         been successfully loaded, it may take a few seconds (up to 30), 
  161.         until the the virtual page is ready. The busy bee tells you 
  162.         that the computer didn't crash.
  163.  
  164.  
  165.  
  166.     Info...
  167.  
  168.         DPI:                resolution of the printer file
  169.  
  170.  
  171.  
  172.         Virtual Page Width: width in pixels of virtual page (2550 at 
  173.                             8.5")
  174.  
  175.  
  176.  
  177.         Virtual Page Height:height in pixels of virtual page (3300 at 
  178.                             11")
  179.  
  180.  
  181.  
  182.         RAM used:           The virtual page uses this amount of your 
  183.                             RAM (~(DPI*(Page Width/8)*Page Height)
  184.  
  185.  
  186.  
  187.         File size:          Size of your original printer file.
  188.  
  189.  
  190.  
  191.             Click Ok to go on.
  192.  
  193.  
  194.  
  195.     Goto...
  196.  
  197.         Enter directly where you want to go on the virtual page. ALL 
  198.         values are accepted, try to stay pretty much within the virtual 
  199.         page area (after all what you see on the screen is a portion of 
  200.         the ST RAM, so too high values can easily get into protected 
  201.         memory locations).
  202.  
  203.  
  204.  
  205.         Ok to go with the values
  206.  
  207.  
  208.  
  209.         Cancel to abort.
  210.  
  211.  
  212.  
  213.     Quit
  214.  
  215.         What do you think?
  216.  
  217.  
  218.  
  219.  
  220.  
  221. All window gadgets work as you would expect and the program uses 
  222. VDI/AES exclusively, so it should work on all machines.
  223.  
  224.  
  225.  
  226.  
  227.  
  228. As time permits I would like to fix the following problems and add 
  229. features:
  230.  
  231. 1) decode HP compacted graphics
  232.  
  233. 2) emulate other printers (loadable modules)
  234.  
  235. 3) suggestions are welcome, source code available
  236.  
  237. Bloomington, 1/28/93
  238.  
  239.  
  240.  
  241.