home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / autocad / mklay30.arj / MKLAY.DOC < prev    next >
Text File  |  1991-06-27  |  12KB  |  286 lines

  1. MKLAY - Layer Utility Program
  2.  
  3. Version 3.0SW Jun 27 1991
  4.  
  5. By AZCAD
  6.    PO Box 254, Clifton Hill, Victoria, Australia, 3068
  7.    Tel: +61 3 481 2942
  8.    Fax: +61 3 489 4621
  9.    BBS: +61 3 481 6873 1200->14.4K HST DS
  10.    FidoNet: 3:632/320
  11.  
  12.  
  13. Distribution files:
  14.  
  15. MKLAY.EXE               MakeLayer program
  16. MKLAY.DOC               MakeLayer documentation
  17. LAYER.DBF               dBase compatible database template
  18. LAYER.WKS               Lotus 123 compatible spreadsheet template
  19. REGISTER.DOC            Registration form
  20.  
  21.  
  22. What Does MkLay Do?
  23.  
  24. MkLay enables a layer system defined and maintained in a spreadsheet or
  25. database program to be translated to a drawing in the AutoCAD Drawing Editor.
  26. MkLay can simplifies transposing entities from one layer to another.
  27.  
  28.  
  29. Why Use MkLay?
  30.  
  31. Complex and evolving layer systems are very easily created, maintained
  32. and referenced with database or spreadsheet programs. Such programs allow
  33. inserting, deletion, modification, sorting and reporting of layer definitions
  34. with much greater ease than is possible inside AutoCAD.
  35.  
  36. MkLay allows Layer data organised with databases or spreadsheets to be quickly
  37. and simply transferred to AutoCAD.
  38.  
  39. Drawings exchanged between sources that use layering conventions different
  40. in name, color or linetype waste time at all stages. By linking corresponding
  41. layer names in database or spreadsheet, MkLay can produce a script file that will transpose entities from one layer to another. The new layer can be defined or re-defined in the same process.
  42.  
  43.  
  44. How Does MkLay Work?
  45.  
  46. There are four simple steps to using MkLay;
  47.  
  48. 1. Define a layer system in a database or spreadsheet program.
  49. 2. Print the data to a file called LAYER.PRN.
  50. 3. Run MkLay to generate a script or LISP file to perform
  51.    the type of layer processing you require.
  52. 4. Start AutoCAD with a drawing and run your layer (re-)definition file.
  53.  
  54.  
  55. Operation
  56.  
  57. Start MkLay by entering MKLAY. MkLay expects to read a data file LAYER.PRN
  58. in Space Delimited Format (SDF). If you want to use Comma Delimited Format
  59. (CDF), you must use the /CDF command line switch. File formats are explained
  60. in detail below.
  61.  
  62. MkLay Version 3.x has a four choice menu.
  63. Options one and two create either a script file or an AutoLISP program
  64. to create or redefine layers.
  65. Option three creates a script file to transpose entities on an Old Layer Name
  66. to a New Layer name.
  67. Option four exits the program.
  68.  
  69. The data file LAYER.PRN must be correctly formatted (refer below) and in the
  70. current directory. MkLay writes .SCR and .LSP files to the current directory.
  71.  
  72. To start file generation press the Capital letter of a menu option.
  73. A "Working..." message will appear. A counter indicates the number of layer
  74. records processed.
  75.  
  76. Layer definitions based on numerical systems may include a decimal point to
  77. allow sub-grouping flexibility. The decimal point facilitates correct
  78. numerical sorting. However Layer names that contain a "." are not acceptable
  79. to AutoCAD. MkLay replaces occurrences in layer names of "." with "-".
  80.  
  81. MkLay skips sequential duplicate layer names and layer records without a state
  82. or color. MkLay indicates skipped records with a colored message.
  83. The color changes on each occurrence to indicate repeated errors.
  84.  
  85. Record skipping ensures that incomplete layer definitions are not processed 
  86. into script or LISP files. Leaving a LType field blank does not cause a
  87. skipped record. Provided the Name, State and Color fields are full the
  88. record will be processed and the LType will default to Continuous.
  89.  
  90. Record skipping enables Headings to be included in the layer definition
  91. spreadsheet. Including Headings makes the hardcopy printout easier to follow
  92. for operator reference. If you name layers in a way that enables them
  93. to be logically sorted, including a suitable layer name in the Heading record
  94. will assure that it will be correctly located after a sorting.
  95.  
  96.  
  97. Data File Formats
  98.  
  99. The data source used by MkLay is a file called LAYER.PRN. The format of
  100. information in this file is very important to the operation of the program.
  101. The default data file format is SDF.
  102.  
  103. Each field is assigned the following starting position and number of
  104. characters in a single line.
  105.  
  106. Data field                        Start     Length
  107. New Layer Name                                          1       32
  108. Description                                             33      31
  109. State                                                   64      2
  110. Color (numeric)                                         66      3
  111. LineType                                                69      2
  112. Old layer Name                                          71      32
  113.  
  114. Layer names may include a decimal point and these point will be translated
  115. to a hyphen to be compatible with AutoCAD.
  116.  
  117. Description is for documentary use only. It is useful on a hard copy of LAYER.PRN printed out for operator reference.
  118.  
  119. State is the usual visibility state of the layer and may be;
  120.  
  121.     Code    ACAD subcommand
  122.     ON      On
  123.     OF      Off
  124.     F       Frozen
  125.  
  126. Any two character code recognised by AutoCAD  is valid in this field.    
  127.  
  128. LineType is the linetype definition for the layer and coded as follows
  129. for the following AutoCAD linetypes;
  130.  
  131.     Code    ACAD LineType
  132.     C       Continuous
  133.     CL      Centerline
  134.     D       Dashed
  135.     DD      Dashdot
  136.     DI      Divide
  137.     DO      Dot
  138.     H       Hidden
  139.     P       Phantom
  140.  
  141. Any other code in the LType field, MkLay defaults to Continuous.
  142.  
  143. Old Layer name can be any layer name. Its purpose is to identify layer names
  144. in other drawings that have information that corresponds to an identifiable
  145. Telecom layer. By listing it here, you are able to use LAYER.PRN with MkLay
  146. to create a script file TRANS.SCR. Running TRANS.SCR in a "foreign" drawing
  147. will move all entities on the Old layer name to the defined layer name.
  148.  
  149. If the /CDF command line switch has been used, LAYER.PRN must be in CDF.
  150. In each line in a CDF file, the fields must be separated by a comma. Commas 
  151. may be part of the Description field only if the entire field is enclosed in
  152. quotes. Otherwise, fields may be either enclosed or not enclosed in quotes.
  153. At least the first four fields must be provided in each record line to be
  154. processed. The fifth (LType) and sixth (Old Layer Name) fields need not be
  155. provided if they are blank fields (blank LType defaults to Contiuous,
  156. remember).
  157.  
  158. MkLay does not check LAYER.PRN for file format or validity of data. You must
  159. ensure that LAYER.PRN is in a valid file format, with sufficient data in each
  160. record.
  161.  
  162. LAYER.PRN must be produced by another program such as a database manager or
  163. a spreadsheet. Two templates are provided as a kickstart. After modelling
  164. your database or spreadsheet on either of these templates, you must print
  165. the layer data to a file.
  166.  
  167. In dBase, enter the command
  168.                              COPY TO LAYER.PRN DELIMITED
  169. This will produce a satisafctory CDF file of all the layer data.
  170.  
  171. In Lotus 123 you must print a range containing all the layer fields to a file.
  172. This file will be a SDF file. Print a clean ASCII file, ie: no setup strings,
  173. no margin formatting, etc. Blanks lines at page breaks are OK, MkLay ignores
  174. them.
  175.  
  176. If in doubt, consult your database manager or spreadsheet manual. Look up
  177. Exporting Data.
  178.  
  179.  
  180. Using Files From MkLay
  181.  
  182. Script and Transpose menu options create LAYER.SCR and TRANS.SCR
  183. respectively. As AutoCAD script files, both these files can be from the
  184. Command: prompt in the AutoCAD Drawing Editor. Enter the command SCRIPT. when
  185. propmted for the script file name, enter LAYER or TRANS.
  186.  
  187. The AutoLISP option generates LAYER.LSP. This is an AutoLISP file that
  188. performs the same function as LAYER.SCR. Although it is much slower than
  189. the .SCR file, it can be run from script file during a batch processing run.
  190. At the AutoCAD Command: prompt enter (LOAD "LAYER"). Layer.Lsp will start
  191. running immediately.
  192.  
  193.  
  194. Registration
  195. This version of MkLay is NOT public domain or free software. It is shareware.
  196. You may try it out to see if it is useful for you. If you wish to continue to
  197. use MkLay you must register it by sending US$25 to AZCAD Software. You will
  198. receive the next major release free, mailed direct.
  199.  
  200. MkLay may be freely distributed (not sold) in the original archived format.
  201.  
  202. Non-registered users of this software have a limited 30 day license to make
  203. an evaluation copy for trial use to determine whether MkLay is suitable for
  204. their needs. After the end of this trial period, you should either register
  205. your copy, or stop using MkLay.
  206.  
  207. All users have a limited license to copy MkLay only for the trial use of
  208. others and subject to the above limitations. This license does NOT include
  209. distribution or copying of this software for use:
  210.  
  211. 1.   Combined with any other product or service.
  212. 2.   For general use within a company or institution.
  213. 3.   For distribution in modified form; i.e., this documentation MUST be
  214.      included.
  215.  
  216. Operators of electronic bulletin board systems (Sysops) may post MKLAYxx.ZIP
  217. for downloading by their users without charge.
  218.  
  219.  
  220. The Shareware Concept
  221.  
  222. Shareware distribution gives users a chance to try software before buying
  223. it. If you try a Shareware program and continue using it, you are expected
  224. to register. Copyright laws apply to both Shareware and commercial
  225. software, and the copyright holder retains all rights, with a few specific
  226. exceptions as stated below. Shareware authors are accomplished programmers,
  227. just like commercial authors, and the programs are of comparable quality.
  228. (In both cases, there are good programs and bad ones!) The main difference
  229. is in the method of distribution. The author specifically grants the right
  230. to copy and distribute the software, either to all and sundry or to a
  231. specific group.
  232.  
  233. Shareware is a distribution method, not a type of software. You should find
  234. software that suits your needs and pocket-book, whether it's commercial or
  235. Shareware. The Shareware system  makes fitting your needs easier, because
  236. you can try before you buy. Because the overhead is low, prices are low
  237. also. Shareware has the ultimate money-back  guarantee -- if you don't use
  238. the product, you don't pay for it.
  239.  
  240. MkLay is shareware and is provided to the user for evaluation. Feel free to
  241. share it with your friends, but please do not give it away altered or as part
  242. of another system. The essence of "user-supported" software is to provide
  243. personal computer users with quality software without high prices, and yet to
  244. provide incentive for programmers to continue to develop new products. 
  245.  
  246. Disclaimer
  247. MkLay is supplied as is. AZCAD Software disclaims all warranties, expressed
  248. or implied, including, without limitation, the warranties of merchantability
  249. and of fitness of this program for any purpose. AZCAD Software assumes no
  250. liability for direct or consequential damages which may result from the use
  251. of MkLay.
  252.  
  253.  
  254. Trademarks
  255. AZCAD Software and MkLay are trademarks of AZCAD.
  256. MS-DOS  is a  registered trademark  of Microsoft Corporation.
  257. AutoCAD is  a registered trademark of AutoDesk.
  258. dBase is a trademark of Ashton-Tate
  259. Lotus 123 is a trademark of Lotus Development Corp
  260.  
  261. Revision History
  262.  
  263. Version 1.0 (11/1/90)
  264. .    Original release
  265.  
  266. Version 2.0-2.5  4/1/91
  267. .    Added AutoLISP routine and Transpose routine
  268.  
  269. Version 3.0 6/25/91
  270. .    Added CDF command line option.
  271. .    Released as Shareware
  272. Other Products from AZCAD Software (all commercial releases)
  273.  
  274. SCRIPTmaker - Automatically Generate Script Files for Batch Processing
  275.               in AutoCAD. Can also create powerful batch files to process
  276.               multiple files automatically.
  277.  
  278. Drawing Libraries - Architectural Presentation Graphics for AutoCAD
  279.                     2D graphics for illustration purposes.
  280.                     Four Libraries:
  281.                     CARlib    Road Transport (cars, trucks, bikes)
  282.                     AQAlib    Marine craft (boats, ships)
  283.                     FLYlib    Aircraft (airliners, pleasure craft)
  284.                     FIGURES1  Human figures (male, female)
  285.  
  286.