home *** CD-ROM | disk | FTP | other *** search
/ Collection of Hack-Phreak Scene Programs / cleanhpvac.zip / cleanhpvac / PCXDXB11.ZIP / PCXDXB.DOC next >
Text File  |  1990-11-22  |  9KB  |  222 lines
  1.       ** PCXDXB V1.1: Paintbrush to AutoCAD Translation Utility **
  2.  
  3.                   Copyright 1990 by Robert L. Church   
  4.                          All Rights Reserved
  5.  
  6. ======================
  7. DISCLAIMER - AGREEMENT
  8. ======================
  9.  
  10.    Users of PCXDXB must accept this disclaimer of warranty:
  11.  
  12.       "This software is supplied on an AS IS basis. The 
  13.       author, Robert L. Church, specifically disclaims ANY 
  14.       warranty, expressed or implied, as to merchantability or 
  15.       fitness for any particular purpose of the software. 
  16.       Under no circumstances will Robert L. Church be liable 
  17.       for any direct, consequential, special, indirect, or 
  18.       other damages including, but not limited to, loss of 
  19.       data, profit, or the use of the software arising from 
  20.       the distribution, use, or misuse of the software. YOU 
  21.       USE THE SOFTWARE AT YOUR OWN RISK. BY USING THE SOFT
  22.       WARE, YOU AGREE TO THE TERMS OF USAGE SET FORTH IN THIS 
  23.       DISCLAIMER."
  24.  
  25. ======
  26. NOTICE
  27. ======
  28.  
  29.    These programs are not in any way connected with or supported by
  30.    CompuServe, Inc., Autodesk, Inc., or Z-Soft Corp.
  31.  
  32. ==========
  33. TRADEMARKS
  34. ==========
  35.  
  36.    CompuServe is a trademark of CompuServe, Inc.
  37.    AutoCAD is a trademark of AutoDesk, Inc.
  38.    Paintbrush is a trademark of Z-Soft Corp.
  39.  
  40. ================
  41. SHAREWARE NOTICE
  42. ================
  43.  
  44.    This program is being released by the author as shareware. 
  45.    It is NOT public domain! You may copy and use the program 
  46.    freely. You may distribute it to whomever you like but:
  47.  
  48.          1. Do NOT distribute modified versions.
  49.          2. Do NOT remove the copyright notice.
  50.          3. ALWAYS distribute with the documentation.
  51.  
  52.    If you feel that these program are useful, please register your 
  53.    copy by sending $20.00 to:
  54.  
  55.                    Robert L. Church
  56.                    9738 Commerce Ave.
  57.                    Tujunga, CA, 91042
  58.  
  59.    Registered users will receive a disk containing the latest version
  60.    of the program, a documentation file formatted for printing and 
  61.    notification of any bug fixes, updates, new products, etc.
  62.  
  63. =====
  64. FILES
  65. =====
  66.  
  67.    The distribution disk contains the following files:
  68.  
  69.                PCXDXB.DOC        This File
  70.                PCXDXB.EXE        PCXDXB Program 
  71.  
  72. ============
  73. INTRODUCTION
  74. ============
  75.  
  76.    This package contains the file translation utility PCXDXB.EXE 
  77.    which translates 2 color .PCX files into .DXB files which can
  78.    be imported into AutoCAD using the DXBIN command. The image 
  79.    produced consists of a crosshatch of horizontal and vertical
  80.    lines which trace horizontal and vertical lines of black pixels
  81.    in the original .PCX file. This produces an intersection at
  82.    each 'ON' pixel.
  83.  
  84. =================
  85. TRANSLATING FILES
  86. =================
  87.  
  88.    Translate the .PCX file to .DXB format by typing:
  89.    
  90.                        PCXDXB Filename
  91.    
  92.    at the DOS prompt where Filename is the name of the .PCX file to 
  93.    be translated. It may include a path to the file. The program will 
  94.    produce a .DXB file with the same name as the original. For instance;
  95.  
  96.                        PCXDXB \ACAD\MYPIC
  97.  
  98.    Will read the file MYPIC.PCX on the \ACAD directory and produce
  99.    the file MYPIC.DXB on the \ACAD directory. If \ACAD\MYPIC.DXB 
  100.    already exists, you will receive a message asking if you want
  101.    to overwrite the existing file. Answer 'Y' to overwrite. Any other
  102.    key cancels the translation.
  103.    
  104.    Progress during the translation is displayed on the screen as a
  105.    percent of input file processed.
  106.  
  107. ====================
  108. LOADING THE DXB FILE
  109. ====================
  110.  
  111.    Get into AutoCAD and open a new drawing. At the prompt, issue a DXBIN 
  112.    command. When prompted for the filename, enter the name of the .DXB 
  113.    file just created.
  114.  
  115.    The image created puts the pixel intersections on 2 inch centers,
  116.    so the scale of the drawing is very large. This is not a problem
  117.    since the image can be scaled after it has been input to AutoCAD.
  118.    If you are zoomed in on a relatively small piece of the drawing,
  119.    like (0,0 36,24), you may not see anything happen during the DXBIN
  120.    command. It's all happening off-screen. When the command is done,
  121.    do a ZOOM EXTENTS to see the entire image.
  122.  
  123.    If you know the size of the .PCX image, do a ZOOM WINDOW before 
  124.    the DXBIN command. When prompted for the window coordinates, use 
  125.    0,0 for the lower left corner. For the upper right corner use twice 
  126.    the size of the .PCX image in pixels plus a little. This will allow 
  127.    you to see the file as it is input on the screen. For instance, if 
  128.    the image was 640 x 480, use 0,0 and 1300,1000 (1280,960 plus a little).
  129.  
  130. =====
  131. HINTS
  132. =====
  133.    
  134.    The drawings created using the DXBIN command tend to be large and
  135.    clumsy, especially if the .PCX file was large or contained a lot of
  136.    'texture'. The best way to use the image is as a basis for tracing.
  137.   
  138.    The DXBIN command draws lines on the current layer. Once the command
  139.    is complete, switch to another layer and color and 'trace' the 
  140.    important features. If you use INTersection OSnap or set the SNAP
  141.    to 2 inches, it is very easy to grab the intersections where the
  142.    black pixels were.
  143.  
  144.    Once the image has been traced, you can turn the trace layer off
  145.    and erase the underlying image. This greatly reduces the size of
  146.    the drawing and the time for REGEN/REDRAW.
  147.  
  148.    Tracing seems to work best using PLINEs. Trace each feature of the
  149.    image using a single PLINE. Then you can use a PEDIT to fit a curve 
  150.    to the points and end up with a pretty smooth outline without much
  151.    trouble. When tracing, it is best to start a new PLINE when the
  152.    nature of the outline changes. For instance, if the image has a 
  153.    curved side and a straight side, use 2 PLINES. This prevents the
  154.    straight side from interfering with the PEDIT curve fit. A little
  155.    trial and error will help you find the best methods.
  156.    
  157.    If you are going to scan an image for input to PCXDXB, it is usually
  158.    better to use the lowest resolution possible. This will result in
  159.    much smaller and more easily managed drawing files since the number
  160.    of pixels is greatly reduced. A 100 dpi scan is only 1/9th the size
  161.    of a 300 dpi scan. The lower resolution will still provide adequate
  162.    information for tracing most images.
  163.  
  164.    As mentioned earlier, the program only converts 2-color .PCX files.
  165.    If you have multi-colored .PCX files, they first need to be converted 
  166.    to 2-color. If you have .GIF files, they can be converted using the
  167.    GIFPCX converter available on the PICS forum. This always produces 
  168.    a 2-color image. If you have a converter that will translate colored
  169.    .PCX files to .GIF files, GIFPCX could then be used to translate back
  170.    to 2-color .PCX for input to PCXDXB.
  171.  
  172. ==============
  173. ERROR MESSAGES
  174. ==============
  175.  
  176.    The program provide error messages to handle most foreseeable
  177.    problems. These cover file not found, disk full, disk read/write,
  178.    and other common errors. The messages are self-explanatory. Other
  179.    errors will produce an "Unknown Error in Input File" message.
  180.    This is probably caused by an input file of the wrong format
  181.    but may be due to other errors.
  182.  
  183. =================
  184. TECHNICAL SUPPORT
  185. =================
  186.  
  187.    Registered users may obtain technical support by contacting
  188.    me on CompuServe at 73207,3242 or writing to me at the following 
  189.    address:   
  190.  
  191.                       Robert L. Church
  192.                       9738 Commerce Ave.
  193.                       Tujunga, CA, 91042
  194.  
  195.    I will respond as soon as possible to such requests. Support for 
  196.    non-registered users will be provided as time permits. Verifiable
  197.    bugs will be corrected as quickly as possible. The latest version
  198.    of the program will be made available on Compuserve when it is 
  199.    released.
  200.    
  201.    Bug reports, comments, suggestions, etc. are appreciated and may 
  202.    also be directed to these locations. 
  203.  
  204. ================
  205. REVISION HISTORY
  206. ================
  207.  
  208.   Version     Date       Revision Notes
  209. ---------------------------------------------------------------------
  210.    V1.0     11/15/90     Initial Release.
  211. ---------------------------------------------------------------------
  212.    V1.1     11/22/90     Improved Progress Display.
  213.  
  214.                          Added Overwrite (Y/N)? message if output
  215.                            file already exists.
  216.  
  217.                          Improved handling of non-existent input
  218.                            files and files of the wrong format.
  219.  
  220.                          Modified and expanded documentation.
  221. ---------------------------------------------------------------------
  222.