home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / DOS / GRAFIK / TOOLS / PS / PS.DOC < prev   
Text File  |  1993-12-01  |  23KB  |  596 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                               PRINT SCREEN
  22.  
  23.                               Version 1.4
  24.  
  25.  
  26.  
  27.                           Graphics Print Screen
  28.           for the IBM Personal Computers and Other Compatibles
  29.  
  30.                                ---------
  31.  
  32.  
  33.  
  34.                              User's Manual
  35.  
  36.  
  37.                   (c) 1991 O'Brien Consulting Services
  38.                               March, 1991
  39.  
  40.  
  41.  
  42.  
  43.                               Table of Contents
  44.  
  45.  
  46.  
  47.  
  48.  
  49.       Introduction................................................1
  50.  
  51.       Registered Version Features.................................2
  52.  
  53.       Installation................................................3
  54.  
  55.       Color Translation File Format...............................4
  56.  
  57.  
  58.  
  59.       APPENDICES:
  60.       -----------
  61.  
  62.  
  63.       System Requirements and Limits..............................A
  64.  
  65.       Warranty/Disclaimer/Terms and Conditions....................B
  66.  
  67.       Registration................................................C
  68.  
  69.  
  70.                                                        PAGE  1
  71.  
  72.  
  73. -- INTRODUCTION --
  74.  
  75.  
  76.  
  77.      PRINT SCREEN is memory resident utility which supercedes your
  78.      systems built in print screen function.  The program will print
  79.      all standard CGA, EGA and VGA graphics screens with resolutions
  80.      up to 640 by 480 in up to 16 colors.  It will also print the
  81.      monochrome graphics screen in 720 by 348 resolution.  256 color
  82.      screens are not supported since translating 256 colors to a
  83.      black on white printed output would almost certainly be
  84.      unreadable.  Graphics modes above the standard 640 by 480 (such
  85.      as 800 by 600 and 1024 by 768) are also not supported because
  86.      there is no standard followed by board manufacturers on how to
  87.      implement these graphics modes.
  88.  
  89.      PRINT SCREEN supports the IBM, EPSON and HP LASER JET printers
  90.      and their 100% compatibles.  Most printers made today for MS-DOS
  91.      based PC's can emulate one of these printer standards.
  92.  
  93.      Once PRINT SCREEN is installed you simply have to press the
  94.      print screen key (or execute interrupt 05h within your program)
  95.      to get the screen printed.  If PRINT SCREEN does not support
  96.      the current video mode, such as a screen in text mode or one
  97.      with 256 colors, it will invoke the print screen function that
  98.      was active before PRINT SCREEN was loaded.
  99.  
  100.      If your printer is not ready when the print screen key is
  101.      pressed, a beep will sound and the screen will not be printed.
  102.  
  103.      Once PRINT SCREEN decides to print a screen, the screen image
  104.      will be centered on the page (based on 8.5 by 11 inch paper),
  105.      rotated by 90 degrees, printed, and then a form feed issued.
  106.  
  107.      PRINT SCREEN uses less than 5k once it is installed.
  108.  
  109.  
  110.                                                        PAGE  2
  111.  
  112.  
  113. -- REGISTERED VERSION FEATURES --
  114.  
  115.  
  116.  
  117.      If and when you register your version of PRINT SCREEN, you will
  118.      receive a version which provides more features than the
  119.      shareware version found on many bulletin boards.  This version
  120.      provides the following:
  121.  
  122.           o  The ability to remove the program from memory
  123.           o  The ability to use parallel port 2 (LPT2)
  124.           o  The ability to change the programs configuration
  125.              on the fly
  126.           o  The ability to change color patterns printed.  If you
  127.              don't like or can't read the printed version of light
  128.              blue on a red background for example, you can can change
  129.              the light blue and red to patterns that are more readable.
  130.  
  131.  
  132.                                                        PAGE  3
  133.  
  134.  
  135. -- INSTALLATION --
  136.  
  137.  
  138.  
  139.      The PRINT SCREEN program is named PS.COM.  Simply typing 'PS'
  140.      followed by the enter key will install PRINT SCREEN using
  141.      its default configuration of parallel port 1 using an EPSON
  142.      printer.
  143.  
  144.      Typing 'PS ?' and pressing enter will display the copyright
  145.      information and the format of the command line used to start
  146.      PRINT SCREEN:
  147.  
  148.        Registered Version:
  149.  
  150.               PS x [/2][/colorfile]
  151.                  Where x = I     for an IBM Proprinter
  152.                        x = 4     for an IBM 4019 Laser
  153.                        x = H     for an HP Laserjet
  154.                        x = SPACE for an Epson (default)
  155.                        x = U     to unload from memory
  156.                        /2 =      Optionally to use parallel port 2
  157.                        /colorfile = Optional ascii file to override
  158.                                     default color patterns
  159.  
  160.               Example:
  161.                   PS h/2               --> HP Laserjet on LPT2
  162.                   PS /2                --> Epson on LPT2
  163.                   PS I/c:\my_color     --> IBM on LPT1 with overriding
  164.                                            color translation file named
  165.                                            C:\MY_COLOR
  166.                   PS u                 --> Unloads PRINT SCREEN from
  167.                                            memory
  168.                   PS 4/2/c:\util\color --> IBM 4019 laser printer on
  169.                                            LPT2 with overriding color
  170.                                            translation file C:\UTIL\COLOR
  171.  
  172.        Shareware Version:
  173.  
  174.               PS x
  175.                  Where x = I     for an IBM Proprinter
  176.                        x = 4     for an IBM 4019 Laser
  177.                        x = H     for an HP Laserjet
  178.                        x = SPACE for an Epson (default)
  179.  
  180.               Example:
  181.                   PS h                 --> HP Laserjet on LPT1
  182.                   PS                   --> Epson (default) on LPT1
  183.  
  184.  
  185.                                                        PAGE  4
  186.  
  187.  
  188. -- COLOR TRANSLATION FILE FORMAT --
  189.  
  190.  
  191.      The process of creating your own tailored color patterns may
  192.      seem somewhat teedious but can have drastic effects if you want
  193.      to incorporate PRINT SCREEN into custom applications.  Each
  194.      pixel on the screen translates into a pixel or dot printed, so
  195.      the entire process deals with turning bits on and off.
  196.  
  197.      Each pattern printed consists of an 8 by 8 bit block that repeats
  198.      from column to column, row to row.  Each color, 16 in all, then
  199.      has an 8 by 8 bit block associated with it.  The translation file
  200.      has sixteen records which correspond to the following colors:
  201.  
  202.            Record  1 - Black
  203.            Record  2 - Blue
  204.            Record  3 - Green
  205.            Record  4 - Cyan
  206.            Record  5 - Red
  207.            Record  6 - Magenta
  208.            Record  7 - Brown
  209.            Record  8 - White
  210.            Record  9 - Dark Gray
  211.            Record 10 - Light Blue
  212.            Record 11 - Light Green
  213.            Record 12 - Light Cyan
  214.            Record 13 - Light Red
  215.            Record 14 - Light Magenta
  216.            Record 15 - Yellow
  217.            Record 16 - High Intensity White
  218.  
  219.      Each record is terminated by a carriage return and line feed
  220.      which is makes this a standard ascii file which can be created
  221.      with a text editor like DOS's EDLIN.
  222.  
  223.      Each record (or color translated) is an 8 by 8 bit block which
  224.      totals 64 bits, supplied in hexadecimal format.  As you will soon
  225.      see, this requires 16 bytes or characters per each record.
  226.  
  227.      If we look at a simple screen that has a black background and
  228.      high intensity white text, you might say the background is blank
  229.      and the foreground is as bright as possible.  This is the default
  230.      that PRINT SCREEN uses.  Black is blank, so no dots are printed
  231.      on the output.  The bright white is just the opposite in that
  232.      all dots are printed.  The following are the bit blocks used
  233.      for these two colors.  A '0' means a dot will not be printed,
  234.      a '1' means a dot will be printed.
  235.  
  236.  
  237.                                                        PAGE  5
  238.  
  239.  
  240. -- COLOR TRANSLATION FILE FORMAT (continued) --
  241.  
  242.  
  243.           BLACK               HIGH INTENSITY WHITE
  244.  
  245.          00000000                   11111111
  246.          00000000                   11111111
  247.          00000000                   11111111
  248.          00000000                   11111111
  249.          00000000                   11111111
  250.          00000000                   11111111
  251.          00000000                   11111111
  252.          00000000                   11111111
  253.  
  254.  
  255.      All other colors inbetween BLACK and HIGH INTENSITY WHITE have
  256.      varing patterns of '0' and '1' such as in the following colors
  257.  
  258.  
  259.          LIGHT RED                    CYAN
  260.  
  261.          11101110                   01010100
  262.          11011101                   00101011
  263.          10111011                   01010101
  264.          01111111                   11101000
  265.          11111110                   01010100
  266.          11011101                   00101011
  267.          10111011                   01010101
  268.          01110111                   11101000
  269.  
  270.  
  271.      All the bit patterns supplied above have 8 rows (left-to-right)
  272.      and 8 columns (top-to-bottom).  Each ROW of bits has to be
  273.      translated into hexadecimal format.  A chart of the bit
  274.      translations is supplied.
  275.  
  276.      A bit pattern of '00000000' (a row in black) translates to
  277.      hex '00'.  A bit pattern of '11111111' (a row in white)
  278.      translates to hex 'FF'.
  279.  
  280.      Using BLACK as an example, we need 8 occurances of '00' which,
  281.      in the first record of the translation file would be
  282.      '0000000000000000'.  The record for WHITE would then be
  283.      'FFFFFFFFFFFFFFFF'.  This is why each of the 16 records in the
  284.      color translation file needs 16 bytes or characters.
  285.  
  286.  
  287.                                                        PAGE  6
  288.  
  289.  
  290. -- COLOR TRANSLATION FILE FORMAT (continued) --
  291.  
  292.  
  293.      A color translation file that exactly matches the defaults
  294.      used in PRINT SCREEN would be as follows:
  295.  
  296.                0000000000000000
  297.                0008004000000200
  298.                8A452A158A452A15
  299.                542B55E8542B55E8
  300.                EEDDBB77EEDDBB77
  301.                77BBDDEE77BBDDEE
  302.                7EBDDBE7E7DBBD7E
  303.                FFFFFFFFFFFFFFFF
  304.                0000008000000080
  305.                0800008008022000
  306.                AA45AA158A452A95
  307.                552B55E8552B55E8
  308.                EEDDBB7FFEDDBB77
  309.                77BBDDFE7FBBDDEE
  310.                FFBDFFE7FFDBFF7E
  311.                FFFFFFFFFFFFFFFF
  312.  
  313.  
  314.      Using the bit translation table on the next page, CYAN and
  315.      LIGHT RED are translated as follows:
  316.  
  317.  
  318.          LIGHT RED                    CYAN
  319.  
  320.          11101110 =  EE             01010100 = 54
  321.          11011101 =  DD             00101011 = 2B
  322.          10111011 =  BB             01010101 = 55
  323.          01111111 =  7F             11101000 = E8
  324.          11111110 =  FE             01010100 = 54
  325.          11011101 =  DD             00101011 = 2B
  326.          10111011 =  BB             01010101 = 55
  327.          01110111 =  77             11101000 = E8
  328.  
  329.  
  330.      LIGHT RED's record then is 'EEDDBB7FFEDDBB77'
  331.      CYAN's record then is '542B55E8542B55E8'
  332.  
  333.  
  334.      Make sure that when you create the file, all letters are
  335.      entered in upper case, 16 records exist in the file, each
  336.      record contains 16 bytes or characters, and each record is
  337.      terminated by a carriage return and line feed.
  338.  
  339.  
  340.      Bit pattern to hexidecimal table:                 PAGE  7
  341.  
  342. 00000000=00   00110100=34   01101000=68   10011100=9C   11010000=D0
  343. 00000001=01   00110101=35   01101001=69   10011101=9D   11010001=D1
  344. 00000010=02   00110110=36   01101010=6A   10011110=9E   11010010=D2
  345. 00000011=03   00110111=37   01101011=6B   10011111=9F   11010011=D3
  346. 00000100=04   00111000=38   01101100=6C   10100000=A0   11010100=D4
  347. 00000101=05   00111001=39   01101101=6D   10100001=A1   11010101=D5
  348. 00000110=06   00111010=3A   01101110=6E   10100010=A2   11010110=D6
  349. 00000111=07   00111011=3B   01101111=6F   10100011=A3   11010111=D7
  350. 00001000=08   00111100=3C   01110000=70   10100100=A4   11011000=D8
  351. 00001001=09   00111101=3D   01110001=71   10100101=A5   11011001=D9
  352. 00001010=0A   00111110=3E   01110010=72   10100110=A6   11011010=DA
  353. 00001011=0B   00111111=3F   01110011=73   10100111=A7   11011011=DB
  354. 00001100=0C   01000000=40   01110100=74   10101000=A8   11011100=DC
  355. 00001101=0D   01000001=41   01110101=75   10101001=A9   11011101=DD
  356. 00001110=0E   01000010=42   01110110=76   10101010=AA   11011110=DE
  357. 00001111=0F   01000011=43   01110111=77   10101011=AB   11011111=DF
  358. 00010000=10   01000100=44   01111000=78   10101100=AC   11100000=E0
  359. 00010001=11   01000101=45   01111001=79   10101101=AD   11100001=E1
  360. 00010010=12   01000110=46   01111010=7A   10101110=AE   11100010=E2
  361. 00010011=13   01000111=47   01111011=7B   10101111=AF   11100011=E3
  362. 00010100=14   01001000=48   01111100=7C   10110000=B0   11100100=E4
  363. 00010101=15   01001001=49   01111101=7D   10110001=B1   11100101=E5
  364. 00010110=16   01001010=4A   01111110=7E   10110010=B2   11100110=E6
  365. 00010111=17   01001011=4B   01111111=7F   10110011=B3   11100111=E7
  366. 00011000=18   01001100=4C   10000000=80   10110100=B4   11101000=E8
  367. 00011001=19   01001101=4D   10000001=81   10110101=B5   11101001=E9
  368. 00011010=1A   01001110=4E   10000010=82   10110110=B6   11101010=EA
  369. 00011011=1B   01001111=4F   10000011=83   10110111=B7   11101011=EB
  370. 00011100=1C   01010000=50   10000100=84   10111000=B8   11101100=EC
  371. 00011101=1D   01010001=51   10000101=85   10111001=B9   11101101=ED
  372. 00011110=1E   01010010=52   10000110=86   10111010=BA   11101110=EE
  373. 00011111=1F   01010011=53   10000111=87   10111011=BB   11101111=EF
  374. 00100000=20   01010100=54   10001000=88   10111100=BC   11110000=F0
  375. 00100001=21   01010101=55   10001001=89   10111101=BD   11110001=F1
  376. 00100010=22   01010110=56   10001010=8A   10111110=BE   11110010=F2
  377. 00100011=23   01010111=57   10001011=8B   10111111=BF   11110011=F3
  378. 00100100=24   01011000=58   10001100=8C   11000000=C0   11110100=F4
  379. 00100101=25   01011001=59   10001101=8D   11000001=C1   11110101=F5
  380. 00100110=26   01011010=5A   10001110=8E   11000010=C2   11110110=F6
  381. 00100111=27   01011011=5B   10001111=8F   11000011=C3   11110111=F7
  382. 00101000=28   01011100=5C   10010000=90   11000100=C4   11111000=F8
  383. 00101001=29   01011101=5D   10010001=91   11000101=C5   11111001=F9
  384. 00101010=2A   01011110=5E   10010010=92   11000110=C6   11111010=FA
  385. 00101011=2B   01011111=5F   10010011=93   11000111=C7   11111011=FB
  386. 00101100=2C   01100000=60   10010100=94   11001000=C8   11111100=FC
  387. 00101101=2D   01100001=61   10010101=95   11001001=C9   11111101=FD
  388. 00101110=2E   01100010=62   10010110=96   11001010=CA   11111110=FE
  389. 00101111=2F   01100011=63   10010111=97   11001011=CB   11111111=FF
  390. 00110000=30   01100100=64   10011000=98   11001100=CC
  391. 00110001=31   01100101=65   10011001=99   11001101=CD
  392. 00110010=32   01100110=66   10011010=9A   11001110=CE
  393. 00110011=33   01100111=67   10011011=9B   11001111=CF
  394.  
  395.  
  396.                                                        APPENDIX A
  397.  
  398.  
  399. -- SYSTEM REQUIREMENTS AND LIMITS --
  400.  
  401.  
  402.      PRINT SCREEN has been successfully run using DOS 2.0 through
  403.      DOS 4.01 and has been run on the following machines (not all
  404.      versions of DOS on all machines):
  405.  
  406.       o   IBM PC
  407.       o   IBM XT
  408.       o   IBM XT/286
  409.       o   IBM AT
  410.       o   IBM PS/2 Model 50, 60, 70 and 80
  411.       o   Compac Deskpro
  412.       o   Compac SLT 286
  413.       o   Leading Edge Model D
  414.       o   Gateway 2000 25mhz 80386
  415.       o   AMI 33mhz 80486
  416.  
  417.  
  418.      PRINT SCREEN requires about 7k on startup and when installed
  419.      uses less than 5k of memory.
  420.  
  421.      A CGA, EGA, VGA, MCGA or Monochrome Graphics card is required.
  422.  
  423.      An HP Laserjet Series II, Epson, IBM Proprinter or IBM 4019
  424.      Laser printer or their 100% compatibles is required.
  425.  
  426.  
  427.                                                        APPENDIX B
  428.  
  429.  
  430.     -- WARRANTY/DISCLAIMER/TERMS & CONDITIONS --
  431.  
  432.     O'Brien Consulting Services warrants to the original purchaser of
  433.     this computer software product that the recording media on which
  434.     the programs are recorded will be free from defects in material
  435.     and workmanship for ninety (90) days from the date of purchase.
  436.     Defective media returned by the purchaser within ninety (90) days
  437.     will be replaced without charge provided the returned media have
  438.     not been subjected to misuse, damage, or excessive wear.
  439.  
  440.     O'Brien Consulting Services does NOT warrant that the programs
  441.     will meet the purchaser's specific requirements.  ANY STATEMENTS
  442.     MADE REGARDING THE UTILITY OF THE PROGRAMS ARE NOT TO BE CONSTRUED
  443.     AS EXPRESS OR IMPLIED WARRANTIES.
  444.  
  445.     THIS WARRANTY IS IN LIEU OF ALL OTHER WARRANTIES, WHETHER WRITTEN
  446.     OR ORAL, EXPRESSED OR IMPLIED. ANY IMPLIED WARRANTIES, INCLUDING
  447.     IMPLIED WARRANTIES OF MECHANTABILITY AND FITNESS FOR A SPECIFIC
  448.     PURPOSE ARE EXCLUDED.
  449.  
  450.     IN NO EVENT WILL O'BRIEN CONSULTING SERVICES BE LIABLE FOR
  451.     INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY KIND IN CONNECTION WITH
  452.     THE SOFTWARE PRODUCT.
  453.  
  454.  
  455.     Registered copies of PRINT SCREEN may be purchased by completing
  456.     the attached registration form and send it with a check for $20.00
  457.     each for PRINT SCREEN (quantity discounts, network pricing and
  458.     site licenses also available) to O'Brien Consulting Services at
  459.     the address given. Purchase orders will be accepted subject at all
  460.     times to apprval of O'Brien Consulting Services.  Terms of payment
  461.     for orders received via purchase order are "Due Upon Receipt".
  462.  
  463.     O'Brien Consulting Services shall not be liable for delays in
  464.     performance caused by riots, strikes, floods, accidents, or any
  465.     other contingency beyond its control.
  466.  
  467.     Accepted orders are subject to cancellation charges to the extent
  468.     O'Brien Consulting Services shall be reimbursed for the cost of
  469.     reasonable expense incurred prior to the cancellation as a result
  470.     of order acceptance.
  471.  
  472.  
  473.     PRINT SCREEN distribution package, consisting of the program and
  474.     documentation files are copyright (c) 1991 by O'Brien Consulting
  475.     Services.  The author reserves the exclusive right to distribute
  476.     this product, or any part thereof, for profit.
  477.  
  478.     Under NO CIRCUMSTANCES may modified versions or disassembled
  479.     versions be distributed, either for profit or in the public
  480.     domain.
  481.  
  482.  
  483.                                                        APPENDIX B
  484.  
  485.  
  486.     -- WARRANTY/DISCLAIMER/TERMS & CONDITIONS (con't)--
  487.  
  488.  
  489.     User's groups, clubs, libraries and clearing houses are authorized
  490.     to distribute the FREE version of PRINT SCREEN pursuant to the
  491.     following conditions:
  492.  
  493.         1.  No charge is made for the software or documentation.  A
  494.             nominal distribution fee may be charged, provided that it
  495.             is no more that $7 total.
  496.  
  497.         2.  The program and documentation are distributed together and
  498.             are not modified in ANY way.
  499.  
  500.  
  501.                                                        APPENDIX C
  502.  
  503.  
  504.     -- REGISTRATION --
  505.  
  506.  
  507.     Once you become a registered user of PRINT SCREEN you will receive
  508.     a new version of PRINT SCREEN which will include capabilities for
  509.     LPT2, unloading, updating configuration and color translation
  510.     tailoring.  You will also receive the following benefits:
  511.  
  512.           o   Support by phone or mail.  Support will only be
  513.               provided to registered users.
  514.  
  515.           o   Notice of significant upgrades and bug fixes.  You will
  516.               be notified by mail for any such updates.  There will be
  517.               no charge for updates as long as you send us a diskette
  518.               and return postage.
  519.  
  520.  
  521.     Each copy of PRINT SCREEN is registered for use on one computer
  522.     only and a registered copy is required for each additional
  523.     computer.  The price breakdown is given below:
  524.  
  525.  
  526.                                PRINT SCREEN
  527.        Copies                 Price Per Copy
  528.       --------               ----------------
  529.          1-50                      $20.00
  530.        51-100                      $17.00
  531.       101-500                      $15.00
  532.           500+                     $14.00
  533.  
  534.  
  535.     The price for networks $100.00 for each file server and $7.00
  536.     for each computer (node) on the network.
  537.  
  538.     The registered version of PRINT SCREEN can be used in commercial,
  539.     educational, and governmental institutions.
  540.  
  541.     The shareware version of PRINT SCREEN is expressly prohibited for
  542.     use in commercial, educational, and governmental institutions
  543.     except for the purpose of evaluation.
  544.  
  545.  
  546.                                                        APPENDIX C
  547.  
  548.  
  549.     -- REGISTRATION FORM --
  550.  
  551.     Please send me a copy of the current full version of PRINT SCREEN
  552.     and add me to the list of registered users, to be eligible for
  553.     support and update notices.
  554.  
  555.  
  556.      Computer Model: _____________________________________________
  557.  
  558.  
  559.      Quantity by diskette Type:    _______ 5.25 in.  ________ 3.5 in.
  560.  
  561.  
  562.      Company Name: _____________________________________________
  563.  
  564.      Your Name:    _____________________________________________
  565.  
  566.      Title:        _____________________________________________
  567.  
  568.      Address:      _____________________________________________
  569.  
  570.      City, State, Zip: _________________________________________
  571.  
  572.      Phone:        _____________________________________________
  573.  
  574.  
  575.      Any initial comments about PRINT SCREEN?
  576.      ___________________________________________________________
  577.      ___________________________________________________________
  578.      ___________________________________________________________
  579.  
  580.  
  581.      Where did you hear about PRINT SCREEN?
  582.      ___________________________________________________________
  583.      ___________________________________________________________
  584.      ___________________________________________________________
  585.  
  586.  
  587.      May we use your comments and/or name in future literature for
  588.      PRINT SCREEN products?        _____(yes)            _____(no)
  589.  
  590.      Send registration form and check or money order to:
  591.  
  592.                    O,Brien Consulting Services
  593.                    P.O. Box 742
  594.                    Mequon, Wi.  53092
  595.                    (414) 241-9504
  596.