home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / geos / drivers / printers / Shell Printer Drivers.src.lnx / Shell easy docs (.txt) < prev    next >
Encoding:
GEOS ConVerT  |  1999-06-16  |  4.0 KB  |  25 lines
  1. sHELL EASY DOCS
  2. prg FORMATTED geos FILE v1.0
  3. wRITE iMAGE v2.0
  4. GEOwRITE    v2.1
  5. .GEOpROGRAMMERS INTERESTED IN MAKING sHELL pRINTER dRIVERS SHOULD READ THIS FIRST
  6. tHIS DOCUMENT SHOULD BE THE FIRST ONE TO READ IF YOU ARE A PROGRAMMER INTERESTED IN CREATING OR MODIFYING sHELL pRINTER dRIVERS USING GEOpROGRAMMER.  a MORE COMPLETE DOCUMENT IS AVAILABLE AFTER YOU HAVE MASTERED THIS ONE.  yOU CAN PRINT THIS DOCUMENT QUICKLY USING draft MODE.  aLSO PRINT THE GEOpAINT DOCUMENT sHELLwINDOW.
  7. yOU NEED TO HAVE A DISK WITH THE FOLLOWING FILES ON IT (WHICH YOU WILL ALREADY HAVE IF YOU JUST DISSOLVED THESE FILES AFTER DOWNLOADING FROM qlINK):
  8. ePSON8PIN.LNK
  9. sHELLhEADER.REL
  10. sHELLzERO
  11. pRINTERsHELL.REL
  12. ePSON8PINg
  13. pRINTascii.REL
  14. pcHANsERIAL5.REL
  15. yOU ALSO NEED GEOwRITE, GEOaSSEMBLER AND GEOlINKER WHICH CAN BE ON A SEPARATE DISK IF YOU HAVE TWO DRIVES.
  16. aSSEMBLE THE FILE ePSON8PINg AND RUN GEOlINKER USING ePSON8PIN.LNK.  tHIS WILL CREATE THE DRIVER ePSON8PIN (IDENTICAL TO THE ONE UPLOADED TO qlINK).  yOU SHOULD ACTUALLY CREATE THIS DRIVER TO INSURE THAT THERE IS NO PROBLEM WITH THE PROCEDURE.
  17. tO MODIFY THE DRIVER FOR OTHER SIMILAR PRINTERS, ONLY THE FILE ePSON8PINg NEEDS TO BE CHANGED.  iT CONTAINS ALL OF THE GRAPHICS RELATED ROUTINES.  uSE GEOwRITE TO EXAMINE THIS FILE WHILE READING THE REMAINDER OF THIS DOCUMENT.
  18. aFTER DEFINING THE PAGE SIZE, THE sHELLzERO FILE IS ".INCLUDE"D INTO ePSON8PINg.  tHIS SETS THE ZSECT PARAMETER SO THAT WE CAN DEFINE VARIABLES WITH ".BLOCK" DIRECTIVES AS IS DONE FOR gRAPHICbYTE.  iT ALSO SETS UP A "wINDOW" OF 72 BYTES ON PAGE ZERO WHICH IS THE MAIN FUNCTION OF THE sHELL.
  19. tHE wINDOW IS FILLED BY THE sHELL WITH A PIXEL IMAGE OF A SECTION OF THE DOCUMENT BEING PRINTED.  iT CAN BE THOUGHT OF AS 24 PIXELS WIDE AND 24 PIXELS HIGH ALTHOUGH WE WILL NOT USUALLY USE ALL OF THEM.  tHE sHELL PROVIDES SUBROUTINES WHICH EFFECTIVELY MOVE THE DOCUMENT THROUGH THE wINDOW SO THAT OUR PRINTER DRIVER SIMPLY HAS TO ASSEMBLE A PORTION OF IT CORRESPONDING TO THE PINS ON THE PRINT HEAD.  tHE wINDOW IS ORGANIZED IN THREE PANES, EACH A BYTE WIDE (8 PIXELS) AND 24 BYTES (OR PIXELS, OR LINES) HIGH.  wE WILL ALWAYS PRINT FROM THE CENTER PANE WHICH BEGINS AT wINDOW+24.
  20. tHE FIRST SUBROUTINE iNITfORpRINT IS CALLED BY THE sHELL ONCE PER DOCUMENT BUT IS NOT USED IN THIS DRIVER AND JUST RETURNS.
  21. tHE SECOND SUBROUTINE pRINTpAGE IS CALLED BY THE sHELL ONCE PER PAGE.  nOTICE THAT IT BEGINS AND ENDS BY SENDING A MESSAGE (CODE SEQUENCE) TO THE PRINTER.  iN BETWEEN IT SCANS THE HEAD ACROSS AND DOWN THE PAGE.
  22. tHE THIRD SUBROUTINE PRINTS ONE SCAN ACROSS THE PAGE.  iT ALSO BEGINS AND ENDS BY SENDING A MESSAGE TO THE PRINTER.  iN BETWEEN IT PRINTS THE 80 COLUMNS, 8 BYTES AT A TIME.
  23. tHE LAST SUBROUTINE PRINTS ONE VERTICAL GRAPHIC BYTE.  iTS MAIN FUNCTION IS TO TAKE THE LEFT-HAND PIXEL (THE msb) OF EIGHT HORIZONTAL BYTES NEAR THE TOP OF THE CENTER PANE OF THE wINDOW AND ASSEMBLE THEM INTO ONE BYTE TO SEND TO THE PRINTER.  eACH TIME IT IS CALLED, THE PREVIOUS SUBROUTINES PUT THE wINDOW IN A SLIGHTLY DIFFERENT POSITION.
  24. mAKE SURE YOU UNDERSTAND HOW THIS DRIVER WORKS BEFORE ATTEMPTING MORE COMPLEX ONES.  iF YOU NEED HELP, POST A QUESTION ON ONE OF THE qlINK geos pRINTER bOARDS.
  25.