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