home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / LASER / HALO_HPL.ZIP / READTHIS < prev   
Encoding:
Text File  |  1988-09-30  |  4.4 KB  |  92 lines
  1. Besides this file, READTHIS, there are 2 other files in this archive.  They
  2. are CUT-HPL.COM and the assembly language source code named CUT-HPL.ASM.
  3. The program was assembled with MS macro asm ver 4.0.
  4.  
  5. CUT-HPL.COM will decompress and print a Dr. Halo II CUT file on a HP LaserJet
  6. printer.  It is required that your Dr. Halo II program be configured with an
  7. X axis parameter of 800, and a Y axis parameter of 1050, at a resolution of
  8. 100 dots per inch.  Mine is also configured to center the image, although I
  9. don't think that is critical for operation of this program.  Also you should
  10. know that when the Halo setup program asks you if you want to reverse the
  11. print colors, you should not choose the default value.  Otherwise you get 
  12. white lines on a field of black and you waste a lot of toner in your expensive
  13. cartridge.  To use different X and Y parameters you would have to modify the
  14. source code and reassemble it.  The source is also setup to be easily modified
  15. to make multiple copies.  The bit dump takes about 8 minutes on a slow IBM PC
  16. but after the first print, multiple copies are produced very quickly.  I
  17. could have added a command line parameter for this feature but I didn't feel
  18. like the brain strain.
  19.  
  20. HOW TO USE IT:
  21. Once the cut file is created Dr. Halo isn't needed to print the picture.
  22. This would be a nice way to send someone a birthday card or flip them the bird
  23. 50 times in Laser style.
  24. The cut file to print must be in the working directory.
  25. Suppose the cut file is named FALCON.CUT
  26. To print it use the command     CUT-HPL FALCON
  27. The program will add the file extension of .CUT
  28.  
  29. The program does NOT check to see if your printer is on-line.  You will get the
  30. familiar Abort, Retry, Ignore? message if it is off line.  Just press R if so.
  31.  
  32. You can abort a print job by pressing any key during printing.  The printer
  33. will do a form feed and reset to text mode.
  34.  
  35. If you dump text into the Laser Jet without a form feed, you can then print
  36. graphics over it.  The reverse don't work.  Sending text will eject the
  37. graphics print first.
  38.  
  39. CUT file format details for the tech minded:
  40. The first 2 bytes of the file (reversed) = the width in bits of the virtual
  41. screen.
  42. The 3rd and 4th bytes (reversed) = the height in bits of the virtual screen.
  43. The 5th and 6th bytes are not used, and = 00
  44. The rest of the file consists of strings of data blocks.
  45.  
  46. DATA BLOCK format:
  47. The first 2 bytes (reversed) = the number of following bytes that describe
  48. one full line of the virtual page.  This number includes the 00 byte which
  49. signals the end of a data block.  My programs don't look at the first 2 bytes
  50. of a data block.  They just look for the 00 to mark the end of a block.
  51.  
  52. The 3rd byte of a DATA BLOCK is the first of many "flag" bytes.  If bit 7 of
  53. this byte is set (if the byte is > 7Fh), then bits 0 through 6 of this byte
  54. equal the number of times to repeat the "data" indicated by the single byte
  55. following.  Example
  56. flag byte = F7
  57. data byte = 01
  58.  
  59. F7 AND 7F = 77 hex, 119 decimal.  So F7 01 means place 119 1's (single bits)
  60. on the map line.
  61. F7 00 would mean place 119 0 bits on the map line.
  62.  
  63. If the flag byte is less than 80 hex then... this is hard to explain
  64. example:  flag byte = 05  data following is 01 00 01 00 01
  65. what this means is there are 5 "data" indicators following the 05 byte.
  66. In this case it means place one 1 bit, one 0 bit, one 1 bit, one 0 bit, and
  67. one 1 bit on the bit map line.
  68.  
  69. If the flag byte = 00 then you have reached the end of line.  The next byte
  70. is the first byte of the next DATA BLOCK, and the system repeats.
  71.  
  72. The program dumps each 100 byte bit map line to the printer one at a time.
  73.  
  74. There is no End of file flag byte.
  75.  
  76. This archiving method is very inefficient.  PKARC compresses a cut file by
  77. about 90%.
  78.  
  79. Contributed to the public domain by author, Jack Garland, St. Louis, Mo.
  80. in the true "Hacker Spirit".
  81.  
  82. A NOTE TO OTHER HACKERS: 
  83. Why is it that you don't usually include source code in your public domain
  84. contributions?
  85. A utility like this will not make anybody rich.  Peter Norton beat us to the
  86. punch a long time ago.  Source code can teach beginners and experienced
  87. programmers won't have to re-invent the wheel from the ground up to put on
  88. a new set of hub caps.
  89.  
  90. There should be another ARC file on this BBS named HALO-PRT.ARC
  91. This is the same program for Epson dot printers & compatibles.
  92.