home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / dbase / tab123.zip / TAB123.DOC < prev    next >
Text File  |  1992-09-09  |  21KB  |  565 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                    Tab123, copyright (c) 1991 by Mountain Software
  10.  
  11.  
  12.  
  13.                                         Tab123
  14.  
  15.  
  16.  
  17.  
  18.                         AutoCAD Spreadsheet Interface Utility
  19.                                      Version 1.0
  20.                                   September 8, 1991
  21.  
  22.  
  23.  
  24.  
  25.                                   ┌─────────┐
  26.                             ┌─────┴───┐     │               (R)
  27.                           ──│         │o    │──────────────────
  28.                             │   ┌─────┴╨──┐ │  Association of
  29.                             │   │         │─┘  Shareware
  30.                             └───│    o    │    Professionals
  31.                           ──────│    ║    │────────────────────
  32.                                 └────╨────┘    MEMBER
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                                  Jerry Workman, P.E. 
  41.                                  1579 Nottingham Road
  42.                                  Charleston, WV 25314
  43.                                    CIS 70717,3564 
  44.  
  45.  
  46.      Tab123 for AutoCAD                                User's Guide, version 1.0
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                                   Table of Contents
  54.  
  55.  
  56.  
  57.      I.   U s i n g   T a b 1 2 3  . . . . . . . . . . . . . . . . . . . . .   3
  58.           Purpose  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  59.           Installation . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  60.           Running Tab123 . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  61.           Read_WKS . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  62.           Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  63.           Suggestions  . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  64.  
  65.      II.  A d d e n d u m  . . . . . . . . . . . . . . . . . . . . . . . . .   6
  66.           Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  67.           Liability  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  68.           Author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  69.  
  70.      III. L i c e n s e  . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  71.           Registration Information . . . . . . . . . . . . . . . . . . . . .   7
  72.           Definition of Shareware  . . . . . . . . . . . . . . . . . . . . .   8
  73.           Disclaimer - Agreement . . . . . . . . . . . . . . . . . . . . . .   8
  74.           Trademark  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  75.  
  76.      IV.  I n d e x  . . . . . . . . . . . . . . . . . . . . . . . . . . .    10
  77.  
  78.  
  79.      Tab123 for AutoCAD                                User's Guide, version 1.0
  80.  
  81.  
  82.  
  83.      I.   U s i n g   T a b 1 2 3
  84.  
  85.  
  86.      Purpose
  87.      -------
  88.  
  89.      Tab123 is  a utility  that provides  the ability  to import  Lotus 123  and
  90.      Symphony spreadsheet  files into  an AutoCAD  drawing as  a  table of  text
  91.      entities, and if  desired, a cell  grid to enclose  the table. Tab123  runs
  92.      from within  the AutoCAD drawing  editor and will  read .WKS and  WK1 files
  93.      directly. The  program reads not  only the data from  the spreadsheet file,
  94.      but  also calculated formula values. Formatting information; Column widths,
  95.      cell formats,  and cell  alignment are  also read  and used  to create  the
  96.      table. Tab123 is  executed through an AutoLisp program  (TAB123.LSP) and an
  97.      external  executable program  (READ_WKS.EXE). Tab123  works on  any  IBM PC
  98.      compatible computer capable of running AutoCAD.
  99.  
  100.  
  101.      Installation
  102.      ------------
  103.  
  104.      Copy the Tab123 files from the distribution diskette (or  extract them from
  105.      the archive file) to your AutoCAD subdirectory, or to sub-directories where
  106.      DOS and AutoCAD can find them. READ_WKS.EXE can be in any directory that is
  107.      on the DOS PATH.  TAB123.LSP must be in a directory that  is in the AutoCAD
  108.      library path. If you are not sure of your DOS  or AutoCAD paths, place both
  109.      files in the same directory  as ACAD.EXE (usually C:\ACAD). To insure  that
  110.      AutoCAD can find files in your support directory, add the following to your
  111.      AUTOEXEC.BAT file:
  112.  
  113.      SET ACAD=C:\ACAD\SUPPORT (or where ever your support files are located)
  114.  
  115.  
  116.           NOTE:     The   AutoCAD  command   SHELL   must   work  so   that
  117.                     READ_WKS.EXE can execute.
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      Chapter 1, Using Tab123                                              Page 3
  138.  
  139.  
  140.      Tab123 for AutoCAD                                User's Guide, version 1.0
  141.  
  142.  
  143.      Running Tab123
  144.      -------------------
  145.  
  146.      First load the AutoLISP program:
  147.  
  148.      Command: (LOAD"TAB123")
  149.  
  150.      Then execute...
  151.  
  152.      Command: TAB123
  153.  
  154.      Follow the prompts:
  155.  
  156.      Load/Draw/All/Parms/Exit/<All>:
  157.  
  158.      Load:     Loads  a spreadsheet file, an external DOS program (READ_WKS.EXE)
  159.                is executed  to convert  the data  in a  range to  a format  that
  160.                AutoLISP  can read.  A  file  named ACAD.123  is  created in  the
  161.                current directory containing the extracted data.
  162.  
  163.      Draw:     Draws  the  previously  loaded  table in  the  drawing.  You  are
  164.                prompted for  the table location,  and text size (if  the current
  165.                style has a text size of 0.0), and  if you wish a grid drawn. The
  166.                file  ACAD.123, created  in the  previous step,  is read  and the
  167.                table drawn.
  168.  
  169.      All       Both Loads and Draws the table
  170.  
  171.      Parms     Display / change Tab123 variables
  172.  
  173.      RowScaleFactor/CharOffsetFactor/Exit/<Exit>:
  174.  
  175.           RowScaleFactor: Centers  / spacing between  rows. A value of  2.0 (the
  176.           default)  will space  rows  at 2.0  x text  height (determined  by the
  177.           AutoCAD text style active or the height entered by the user).
  178.  
  179.           CharOffsetFactor: Offset  of the first and last  character(s) from the
  180.           left and right  margins. A value of  1.0 (the default) will  make cell
  181.           margins 1.0  x text  character width (determined  by the  AutoCAD text
  182.           style active).
  183.  
  184.      Exit      Exits Tab123 with no action.
  185.  
  186.  
  187.      Read_WKS
  188.      --------
  189.  
  190.      Read_WKS is the DOS executable program that does the actual extraction from
  191.      the worksheet file. This program can be used external to AutoCAD to extract
  192.      data from a .WK? file  in comma delimited format for use by other programs,
  193.      or  for  reporting. Read_WKS  operated  form  the  DOS command  line  using
  194.      switches and parameters to control it's operations. The switches / commands
  195.      / functions are as follows:
  196.  
  197.  
  198.      Chapter 1, Using Tab123                                              Page 4
  199.  
  200.  
  201.      Tab123 for AutoCAD                                User's Guide, version 1.0
  202.  
  203.  
  204.      Usage: READ_WKS <switches> <filename>.WK1 <outfilename>
  205.      The .WK1 extension is added to <filename> if omitted
  206.      Switches must start with / or - and are not case sensitive.
  207.  
  208.      /D        Debug diagnostic display
  209.      /R___     Lotus Range [default A1..D25] (eg /RB11..F35)
  210.      /A        AutoCAD LISP output (default output filename is ACAD.123)
  211.      /I        Ignore repeating label cells (eg \=)
  212.      /U        Unformatted (maximum precision) output"
  213.      /X        eXpanded formatted report output, no delimiter, fully formatted"
  214.      /S_       Separator / Delimiter character(s) (eg /S;)"
  215.      /Q        Quiet, no display except errors"
  216.      /P        Password program - register Read_WKS"
  217.      /H        Help - This message.
  218.  
  219.      Example: READ_WKS /RC19..F35 MYFILE MYFILE.PRN
  220.           Or: READ_WKS /A /RC19..F35 MYFILE
  221.  
  222.  
  223.      Limits
  224.      ------
  225.  
  226.      Tab123 can  not read  version 3  Lotus, 123G  or SQZ  files. If  you use  a
  227.      version of Lotus  123 after version 2.2 or  a different spreadsheet program
  228.      (eg Quattro  or Excel) then  save your file  as a .WK1  or .WKS file,  most
  229.      spreadsheets  (and many  other programs)  provide  can save  in these  file
  230.      formats.
  231.  
  232.      Tab123 / Read_WKS  can not recalculate  you spreadsheet. If you  use manual
  233.      recalculation then be sure  to recalculate prior to saving  so that formula
  234.      values will be correctly displayed.
  235.  
  236.      If you wish  to extract tables from  very large spreadsheets then  you must
  237.      provide the DOS program READ_WKS.EXE with as much memory  as possible. With
  238.      AutoCAD 386 the programs  BigShell and SHROOM  will provide a large  memory
  239.      SHELL.  SHROOM.COM is  included with  AutoCAD  release 11  and a  shareware
  240.      version is available on Compuserve and many Computer Bulletin boards.
  241.  
  242.  
  243.      Suggestions
  244.      -----------
  245.  
  246.      While developing  your table  in Lotus 123  (or your  favorite spreadsheet)
  247.      make  sure that text does not overlap into the next cell. Set column widths
  248.      to  a value that  is just wider  than the values  and text.  Use "Comma" or
  249.      "Dollars" formats to make large values easier to read.
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.      Chapter 1, Using Tab123                                              Page 5
  260.  
  261.  
  262.      Tab123 for AutoCAD                                User's Guide, version 1.0
  263.  
  264.  
  265.      II.  A d d e n d u m
  266.  
  267.  
  268.      Error Messages
  269.      --------------
  270.  
  271.      Cannot open file XXXX
  272.  
  273.           Reason: Misspelled filename or possible disk error (possibly full).
  274.  
  275.      Unknown switch => X <=
  276.  
  277.           An unknown DOS command line switch was passed to READ_WKS.EXE.
  278.  
  279.      Out of memory
  280.  
  281.           Not enough memory to load  a spreadsheet file. READ_WKS does not  read
  282.           the entire file  into memory, but  only pointers to cell  locations in
  283.           the file and can usually handle large  files with a minimum of memory.
  284.           Revise  your  SHELL entry  in  your  ACAD.PGP file  or  use SHROOM  to
  285.           increase SHELL memory.
  286.  
  287.      Unidentified Cell. OpCode = XXh Length = XX
  288.  
  289.           Usually caused  by processing a  spreadsheet file format not  known by
  290.           READ_WKS.EXE.
  291.  
  292.      Liability
  293.      ---------
  294.  
  295.      Careful  testing  has been  made  to  ensure  that these  programs  perform
  296.      correctly. No liabilities  are assumed in the use or misuse of this program
  297.      resulting in data loss or damage. It is the users responsibility to be sure
  298.      that the results are as expected.
  299.  
  300.  
  301.      Author
  302.      ------
  303.  
  304.      If you have any suggestions or comments, please contact me.
  305.  
  306.      Jerry Workman, PE
  307.      1579 Nottingham Rd.
  308.      Charleston, WV 25314 
  309.      CIS 70717,3564
  310.      304-744-7748 (after 7:30 ET)
  311.  
  312.      Copyright 1991 by Mountain Software All rights reserved 
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.      Chapter 2, Addendum                                                  Page 6
  321.  
  322.  
  323.      Tab123 for AutoCAD                                User's Guide, version 1.0
  324.  
  325.  
  326.      III. L i c e n s e
  327.  
  328.  
  329.      Shareware
  330.      ---------
  331.  
  332.      This version of Tab123 is NOT public domain or free software,  but is being
  333.      distributed  as "shareware". You may try it out  to see if it is useful for
  334.      you. If you  wish to continue to  use Tab123 you must  register. Registered
  335.      users are provided  with a password  to remove the  opening delay and  with
  336.      support for one year.
  337.  
  338.      The program  in the form of  the original archived file only  may be freely
  339.      distributed, but not sold (except  under license, or for a  nominal copying
  340.      or disk fee).
  341.  
  342.      Non-registered users of this software are granted a  limited 30 day license
  343.      to  make an evaluation  copy for trial  use for the  purpose of determining
  344.      whether  Tab123  is suitable  for their  needs.  At the  end of  this trial
  345.      period, you may either register your copy, or discontinue using Tab123.
  346.  
  347.      All users are granted a  limited license to copy Tab123 only  for the trial
  348.      use of others and subject to  the above limitations. This license does  NOT
  349.      include distribution or copying of this software for use:
  350.  
  351.      1.   In connection with any other product or service.
  352.      2.   For general use within a company or institution.
  353.      3.   For distribution  in modified  form;  i.e., the  file containing  this
  354.           license  information MUST  be  included, along  with  the full  Tab123
  355.           documentation.
  356.  
  357.      Operators  of electronic bulletin board systems  (Sysops) are encouraged to
  358.      post  TAB123xx.ZIP  for  downloading  by  their users,  as  long  as  these
  359.      conditions are met.
  360.  
  361.  
  362.      Registration Information
  363.      ------------------------
  364.  
  365.      A Tab123 registration licenses  you to use the product on  a regular basis.
  366.      Individual license cost for Tab123 is $20. You may purchase a diskette with
  367.      the latest version of Tab123 for an additional $10. West Virginia residents
  368.      should include 6% sales tax.
  369.  
  370.      Educational institutions, full-time students and BBS sysops can apply a 50%
  371.      discount. PLEASE include your educational institution letterhead (with your
  372.      title), or a photocopy of your  most recent registration slip, or the  name
  373.      and number of your BBS.
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.      License                                                              Page 7
  382.  
  383.  
  384.      Tab123 for AutoCAD                                User's Guide, version 1.0
  385.  
  386.  
  387.      Definition of Shareware
  388.      -----------------------
  389.  
  390.      Shareware distribution gives  users a chance to try  software before buying
  391.      it.  If you try a Shareware program and continue using it, you are expected
  392.      to  register.  Individual  programs  differ  on  details  --  some  request
  393.      registration while others require it,  some specify a maximum trial period.
  394.      With registration, you get anything from the simple right to continue using
  395.      the software to an updated program with printed manual.
  396.  
  397.      Copyright laws  apply to  both Shareware and  commercial software,  and the
  398.      copyright  holder retains  all rights,  with a  few specific  exceptions as
  399.      stated below.  Shareware authors  are accomplished  programmers, just  like
  400.      commercial authors,  and the programs  are of comparable quality.  (In both
  401.      cases, there are good programs and bad ones!) The main difference is in the
  402.      method of  distribution. The author  specifically grants the right  to copy
  403.      and  distribute the  software, either to  all and  sundry or to  a specific
  404.      group.  For  example,  some  authors require  written  permission  before a
  405.      commercial disk vendor may copy their Shareware.
  406.  
  407.      Shareware is a distribution method, not a type of software. You should find
  408.      software that suits  your needs and pocketbook, whether  it's commercial or
  409.      Shareware. The  Shareware system makes  fitting your needs  easier, because
  410.      you can try before you buy. And because the overhead is low, prices are low
  411.      also. Shareware has the ultimate  money-back guarantee -- if you  don't use
  412.      the product, you don't pay for it.
  413.  
  414.  
  415.      Disclaimer - Agreement
  416.      ----------------------
  417.  
  418.      Users  of  Tab123 must  accept  this  disclaimer  of warranty:  "Tab123  is
  419.      supplied as is.  The author disclaims all warranties, expressed or implied,
  420.      including, without  limitation, the  warranties of  merchantability and  of
  421.      fitness  for any  purpose. The  author  assumes no  liability for  damages,
  422.      direct or consequential, which may result from the use of Tab123."
  423.  
  424.      Tab123  is a "shareware program" and  is provided at no  charge to the user
  425.      for evaluation.  Feel free to share it with your friends, but please do not
  426.      give  it away  altered  or as  part  of  another system.    The essence  of
  427.      "user-supported"  software is  to  provide  personal  computer  users  with
  428.      quality  software without  high prices,  and yet  to provide  incentive for
  429.      programmers to continue to develop new products.   If you find this program
  430.      useful  and find that you are using Tab123 and continue to use Tab123 after
  431.      a reasonable  trial period, you must make a  registration payment of $30 to
  432.      Mountain Software.  The $30 registration fee  will license one copy for use
  433.      on any  one computer at any  one time.   You must treat this  software just
  434.      like a book.  An example is that this software may be used by any number of
  435.      people and may  be freely moved from  one computer location to  another, so
  436.      long as there is no possibility of it being used at one location while it's
  437.      being used  at another. Just  as a  book cannot  be read  by two  different
  438.      persons at the same time.
  439.  
  440.  
  441.  
  442.      Shareware                                                            Page 8
  443.  
  444.  
  445.      Tab123 for AutoCAD                                User's Guide, version 1.0
  446.  
  447.  
  448.      Commercial users of Tab123 must register and pay for their copies of Tab123
  449.      within 30 days  of first use or  their license is withdrawn.   Site-License
  450.      arrangements may be made by contacting Mountain Software.
  451.  
  452.      Anyone distributing Tab123 for any  kind of remuneration must first contact
  453.      Mountain   Software  at   the  address   below   for  authorization.   This
  454.      authorization will be  automatically granted to distributors  recognized by
  455.      the (ASP)  as adhering  to its guidelines  for shareware  distributors, and
  456.      such distributors may  begin offering Tab123 immediately  (However Mountain
  457.      Software  must  still be  advised  so  that  the  distributor can  be  kept
  458.      up-to-date with the latest version of Tab123.).
  459.  
  460.      You  are encouraged  to pass  a copy  of Tab123 along  to your  friends for
  461.      evaluation.  Please encourage them to register their copy if they find that
  462.      they can use it. 
  463.  
  464.      Jerry Workman a member of the Association of Shareware Professionals (ASP).
  465.      ASP wants to make  sure that the shareware principle works for  you. If you
  466.      are unable  to resolve a  shareware-related problem with  an ASP member  by
  467.      contacting the member  directly, ASP may be able to help. The ASP Ombudsman
  468.      can help you resolve a dispute or problem with an ASP member, but does  not
  469.      provide technical  support for members'  products. Please write to  the ASP
  470.      Ombudsman  at 545  Grover Road, Muskegon  MI 49442,  or send a  message via
  471.      Compuserve mail to ASP Ombudsman 70007,3536
  472.  
  473.  
  474.      Trademark
  475.      ---------
  476.  
  477.      Mountain Software and Tab123 are trademarks of Mountain Software. MS-DOS is
  478.      a registered trademark  of Microsoft  Corporation. PC-DOS  is a  registered
  479.      trademark  of  IBM  Corporation.  AutoCAD  is  a  registered  trademark  of
  480.      AutoDesk. 123 and  Symphony are registered trademarks of  Lotus Development
  481.      Corporation
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.      Shareware                                                            Page 9
  504.  
  505.  
  506.      Tab123 for AutoCAD                                User's Guide, version 1.0
  507.  
  508.  
  509.      IV.  I n d e x
  510.  
  511.  
  512.                123 . . . . . . . . . . . . . . . . . . . . . .  3-5, 9
  513.                ACAD  . . . . . . . . . . . . . . . . . . . . . . . 3-6
  514.                ACAD.EXE  . . . . . . . . . . . . . . . . . . . . . . 3
  515.                ASP . . . . . . . . . . . . . . . . . . . . . . . . . 9
  516.                AutoCAD . . . . . . . . . . . . . . . . . . . 1, 3-5, 9
  517.                bulletin boards . . . . . . . . . . . . . . . . . . . 5
  518.                Command . . . . . . . . . . . . . . . . . . . . 3, 4, 6
  519.                Compuserve  . . . . . . . . . . . . . . . . . . .  5, 9
  520.                directory . . . . . . . . . . . . . . . . . . . .  3, 4
  521.                disk  . . . . . . . . . . . . . . . . . . . . . . . 6-8
  522.                DOS . . . . . . . . . . . . . . . . . . . . . .  3-6, 9
  523.                drawing editor  . . . . . . . . . . . . . . . . . . . 3
  524.                error . . . . . . . . . . . . . . . . . . . . . . . . 6
  525.                license . . . . . . . . . . . . . . . . . . . . . . 7-9
  526.                LISP  . . . . . . . . . . . . . . . . . . . . . . . . 5
  527.                Lotus . . . . . . . . . . . . . . . . . . . . . 3, 5, 9
  528.                shareware . . . . . . . . . . . . . . . . . . 1, 5, 7-9
  529.                SHELL . . . . . . . . . . . . . . . . . . . . . 3, 5, 6
  530.                SHROOM  . . . . . . . . . . . . . . . . . . . . .  5, 6
  531.                subdirectory  . . . . . . . . . . . . . . . . . . . . 3
  532.                ZIP . . . . . . . . . . . . . . . . . . . . . . . . . 7
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.      Index                                                               Page 10
  565.