home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / PCXSLT18.ZIP / README < prev    next >
Text File  |  1991-04-08  |  10KB  |  237 lines
  1.  
  2.                          PCX Scan Line Translator
  3.                     (c) Copyright 1991, Matthew Wilson
  4.                         Version 1.8 Documentation
  5.                              (PCX to DXF)
  6.  
  7.                             Matthew Wilson
  8.                          5040 Whitman Terrace
  9.                          Pennsauken, NJ 08109
  10.  
  11.    I. Catalog Description
  12.  
  13.       PCXSLT18
  14.       Translates PCX (black/white) to DXF. This program was written
  15.       to handle huge CAD scanner files (unlimited size), but is also
  16.       great for translating clip art files. There are extensive methods
  17.       to handle large files. Set the layer size then extract all layers
  18.       or any single layer. Scan at high resolution then selectively
  19.       eliminate scan lines to reduce file size. Pixel filters can be set
  20.       to eliminate as much as you want. These features make it possible
  21.       to extract pieces of large files for tracing and later combining.
  22.  
  23.   II. Improvements Since Version 1.7
  24.  
  25.       1. Improved pixel filtering.
  26.  
  27.       2. Help screen added.
  28.  
  29.       3. Output file is now compatible with AutoRender.
  30.  
  31.  III. Additional Program Information
  32.  
  33.       1. Maximum of 32000 points per layer.
  34.       2. Black and white images only.
  35.       3. Memory requirements - 256k.
  36.  
  37.   IV. Benefits of Registering
  38.  
  39.       1. Receive an improved version that reduces the size of the
  40.          output file.
  41.  
  42.       2. Future upgrades will include an outlining feature. This feature
  43.          will trace the PCX image producing an output file containing
  44.          lines and curves. This currently works but improvements are being
  45.          made before release.
  46.  
  47.       3. Special emphasis on handling text is also planned for future
  48.          releases.
  49.  
  50.       4. To register type: PRINTME
  51.  
  52.    V. Background Information
  53.  
  54.       While trying to develop some maps for my small business I found
  55.       that conversion and overlay programs were too expensive. I thought
  56.       that if I could just get the PCX image into a DXF format as line
  57.       segments then I could trace it. This program was written to help
  58.       me inexpensively convert my huge map files to a vector format.
  59.       I added features to handle large files because I ran into problems
  60.       dealing with such large output files.
  61.  
  62.  
  63.  
  64.  
  65.   VI. Program Documentation
  66.  
  67.  
  68.       1. To run program type: PCXSLT18
  69.  
  70.       2. A screen containing the following data will appear:
  71.  
  72.             1. Input file         : INFIL.PCX
  73.  
  74.             2. Output file        : OUTFIL.DXF
  75.  
  76.             3. Points per layer   : 32000
  77.  
  78.             4. Reverse video      : 0
  79.  
  80.             5. Layer #            : -1
  81.  
  82.             6. Line Filter        : -1
  83.  
  84.             7. Pixel Filter       : -1
  85.  
  86.         F1 - SAVE/RUN   F2 - RESET  F3 - EXIT  F4 - HELP
  87.  
  88.       3. Explanation of screen:
  89.  
  90.            1. Input file - Enter input file with PCX extension.
  91.            2. Output file - Enter output file with DXF extension.
  92.            3. Points per layer - Set any number of points per layer
  93.                                  that you would like. Max. = 32000.
  94.            4. Reverse video - 0 = default; 1 = reverse video.
  95.            5. Layer # - -1 = Turn off this feature.
  96.                              Select all layers.
  97.                          0 = Select layer 0 only.
  98.                          1 = Select layer 1 only.
  99.                          2 = Select layer 2 only.
  100.                 etc.     . .   .      .   .   .
  101.            6. Line Filter     - -1 = Turn off this feature.
  102.                                      Include every scan line.
  103.                                  2 = Include every 2nd scan line.
  104.                                  3 = Include every 3rd scan line.
  105.                                  4 = Include every 4th scan line.
  106.                 etc.             . .   .      .    .    .    .
  107.  
  108.                                 -2 = Exclude every 2nd scan line.
  109.                                 -3 = Exclude every 3rd scan line.
  110.                                 -4 = Exclude every 4th scan line.
  111.                 etc.             . .    .      .    .    .    .
  112.  
  113.            7. Pixel Filter    - -1 = Turn off this feature.
  114.                                      Include every pixel.
  115.               Be careful with    1 = If a single pixel sequence is
  116.               filtering. Some        encountered in a scan line then
  117.               thin lines may         reject it.
  118.               be filtered out.   2 = If a single pixel or a pair of
  119.                                      pixels is encountered in a scan line
  120.                                      then reject it.
  121.                                  3 = If one pixel, a two pixel or a three
  122.                                      pixel sequence is encountered in a
  123.                                      scan line then reject it.
  124.  
  125.                 etc.             . .    .      .    .    .    .
  126.  
  127.            7. Pixel Filter    - -2 = Accept only one or two pixel
  128.               (Continued)            sequences.
  129.                                 -3 = Accept only one, two or three
  130.                                      pixel sequences.
  131.  
  132.                 etc.             . .    .      .    .    .    .
  133.  
  134.            8. F1 - SAVE/RUN - Press F1 to save your current selections
  135.                               and then to run the program. After the
  136.                               program finishes it will return to this
  137.                               screen.
  138.            9. F2 - RESET    - Press F2 to replace current screen with
  139.                               old screen.
  140.           10. F3 - EXIT     - Press F3 to exit program.
  141.  
  142.           11. F4 - HELP     - Press F4 to see the help screen. This
  143.                               screen lists most of the available options.
  144.  
  145.  
  146.  
  147.  
  148.       4. Program Usage
  149.  
  150.            1. This program does produce large output files but I've
  151.               included several methods to get around this problem.
  152.  
  153.                    - Extract a single layer.
  154.                    - Set the layer size in points per layer.
  155.                    - Pick the sequence of scan lines to include.
  156.                    - Pick the sequence of scan lines to exclude.
  157.                    - Filter pixels.
  158.  
  159.               Example 1: You need to translate a small clip art file to
  160.                          DXF format. Use the default settings. Some
  161.                          drawings may need the reverse video set to 1.
  162.  
  163.                             - Points per layer   : 32000
  164.                             - Reverse video      : 0
  165.                             - Layer #            : -1
  166.                             - Line Filter        : -1
  167.                             - Pixel Filter       : -1
  168.  
  169.               Example 2: You have a large clip art file scanned at a
  170.                          resolution of 300 dots per inch. You need to
  171.                          trace the image and a resolution of 100 dots
  172.                          per inch is ok. Do the following:
  173.  
  174.                             - Line Filter         : 3
  175.  
  176.                             - Selecting every 3rd scan line will
  177.                               reduce the vertical resolution to
  178.                               100 dots per inch.
  179.                             - If the file is still too large try
  180.                               extracting a single layer only.
  181.  
  182.               Example 3: A massive scanner file (E size) needs to be
  183.                          translated. The file has a lot of stray marks
  184.                          on it so pixel filtering is necessary.
  185.  
  186.  
  187.                              -Line Filter         : 10
  188.                              -Pixel Filter        : 1
  189.  
  190.                              - This will cause every 10th scan line
  191.                                to be extracted. Single stray pixels
  192.                                are filtered out. You can now look at
  193.                                the image. Decide if you like the layer
  194.                                size and resolution.
  195.  
  196.                              - Layer #            : 3
  197.                              - Line Filter        : -4
  198.                              - Pixel Filter       : 2
  199.                              or
  200.                              - Points per layer   : 20000
  201.                              - Layer #            : 3
  202.  
  203.                              -Let's say you want to start with layer
  204.                               3. You like the scanner resolution but
  205.                               the layer file is still a little too
  206.                               large. Excluding every 4th scan line
  207.                               will reduce the file size by 25%. An
  208.                               alternative is to reduce the layer size.
  209.  
  210.  
  211.   VII. Registration Information
  212.  
  213.  
  214.          Registering this program will allow you to obtain an improved
  215.       version of this program that will help reduce the size of the
  216.       output file. Also, registering will give you access to future
  217.       upgrades. Future upgrades will include:
  218.  
  219.                   1. Outlining feature. This will trace the image
  220.                      rather than use the scan line translator. This
  221.                      method is used by standard PCX to DXF conversion
  222.                      programs costing hundreds of dollars. All upgrades
  223.                      will be able to handle files of unlimited size.
  224.  
  225.                   2. Special text handling abilities. Wouldn't it be
  226.                      nice to quickly locate text and then replace the
  227.                      lines and arcs with actual text?
  228.  
  229.  
  230.       In order to register send $15.00 to:
  231.  
  232.                    Matthew Wilson
  233.                    5040 Whitman Terrace
  234.                    Pennsauken, NJ 08109
  235.  
  236.  
  237.