home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0010 - 0019 / ibm0010-0019 / ibm0010.tar / ibm0010 / CADKEY_C.ZIP / CADKEY13.ZIP / README35.DOC
Encoding:
Text File  |  1989-06-24  |  38.1 KB  |  1,086 lines

  1.  
  2.         ****  Welcome to the CADKEY CADL Utilities Diskette  ****
  3.  
  4.                 Version Date 6/22/89
  5.  
  6.     This diskette contains several useful construction utilities, examples
  7.     of applications, and outlines of command usage.  Each utility and 
  8.     application program is described in the following text.  Each descrip-
  9.     tion contains an outline of the task which is performed, as well as a
  10.     set of instructions relating to the operation of the program.
  11.  
  12.     The purpose of CADL is to allow you to do things with the data base,
  13.     graphics, and construction capabilities available in CADKEY 3.  CADL
  14.     allows you to use all these capabilities in ways that CADKEY 3 was
  15.     never designed to do itself.
  16.  
  17.     One of the programs on this diskette of miscellaneous utilities
  18.     demonstrates how to communicate bidirectionally between a CADL
  19.     program and macros, so that the macros function as if they were
  20.     subroutines of the CADL program.  See STARTEX1.TXT for this
  21.     extremely useful tool.
  22.  
  23.     You can use CADKEY 3 to fill gaps in CADL or to speed things up.
  24.     You can also use EXEC to leave CADKEY 3 temporarily, and go to
  25.     DOS if you need additional capabilities not available in CADKEY 3
  26.     or in CADL.  If you need even more computing power, you can use
  27.     EXEC to go to specialized routines in Fortran, Basic or C that you
  28.     may have written for your own needs.  Thanks to the AUTOSWAP
  29.     program, you can use routines as large as 500K and even larger.  
  30.  
  31.         ************************************************
  32.  
  33.         You should note, that this is a utility disk
  34.         which may be used as a tool for performing tasks
  35.         or as reference for generating additional pro-
  36.         grams.  You should also note that the programs
  37.         contained in these disks are from various sources
  38.         and that support for these programs is limited.
  39.  
  40.         *************************************************
  41.  
  42.  
  43.         -------------------------------------------------
  44.         |                        |
  45.         |             WARNING!!            |
  46.         |                        |
  47.         -------------------------------------------------
  48.  
  49.         Before running these programs, run CONFIG.  In the
  50.         programming options (Option 6),
  51.  
  52.         1.    Set the number of CADL labels to 120 or more.
  53.         2.    Set the number of register variables to 180 or
  54.             more.
  55.  
  56.         If you run very long CADL programs, set the number
  57.         of CADL labels and register variables even higher.
  58.  
  59.  
  60.         SHAPES and UTILITY are designed to run ONLY in a
  61.         single viewport configuration.  Running them in
  62.         multiple viewports will cause strange results and
  63.         possible system crashes.
  64.  
  65.         ***************************************************
  66.         * This diskette includes some text files that are *
  67.         * macros.  You should load them into the macro    *
  68.         * library using the TXT-IN command.               *
  69.         ***************************************************
  70.  
  71.         We plan to update many of these CADL programs during
  72.         the year.  You will find the updates available through
  73.         your CADKEY dealer, in 3-D WORLD or in the CADKEY Forum
  74.         on the CompuServe Information Service.
  75.  
  76.     You can make a CADL program run much faster if you compile it before
  77.     you use it.  CADKEY will publish an updated CADL Programmer's Guide
  78.     in the Fall 1989 which will include program hints and examples.
  79.  
  80.     Several of the programs contained on this disk, have associated files.
  81.     Some of these associated files are in the form of executable programs,
  82.     while others are data files accessed or created by the program.  These
  83.     files, similiar to the CADL programs, must be copied into there appro-
  84.     priate directories if the main programs are to run correctly.  The file
  85.     scheme for these programs are shown in the following outline.
  86.  
  87.  
  88.         File type        Description        Directory
  89.         ---------        -----------        ---------
  90.  
  91.         xxx.CDL            CADL pgms        \cadkey\cdl
  92.         
  93.         xxx.COM            Executable pgms        \cadkey
  94.         xxx.EXE
  95.  
  96.  
  97.  
  98.         -------------------------------------------------
  99.         |                        |
  100.         |        ADDITIONAL WARNING!!        |
  101.         |                        |
  102.         -------------------------------------------------
  103.  
  104.     Some of the CADL and executable programs use scratch or data files
  105.     that are "hard coded" to access the \cadkey\cdl\ directory.  If 
  106.     errors ocurr in these programs, you should check to see if these
  107.     programs/files are in the proper location and/or directories. 
  108.  
  109.     Also, please note that the executable programs require at least 28K
  110.     in order to run correctly.  It is suggested that the DOS memory be 
  111.     set to 50K in order to allow these programs to operate.
  112.     
  113.  
  114.     -------------------------------------------------------------------
  115.  
  116.     This diskette also contains a CADL program called "utility" which will
  117.     display a menu of user selectable CADL programs found on the disk.
  118.  
  119.  
  120.     NOTE:        You can run most, but NOT ALL, of the programs on this
  121.             diskette through "utility."
  122.  
  123.  
  124.     Once the files have been copied to their appropriate directories, this
  125.     program may be accessed through the FILES - CADL - EXECUTE menu in 
  126.     CADKEY.  Executing the program "utility" will display of menu of 
  127.     selectable CADL utility programs.  Selecting one of the choices with
  128.     the cursor will activate the particular program.
  129.  
  130.     Also contained as a menu option, are two additional choices; Help and
  131.     Next page.  By indicating "HELP," a description of the programs dis-
  132.     played on the current page are shown.  By selecting the option "Next
  133.     page", the present list of program is erased and the next available
  134.     page of CADL programs is displayed for selection.
  135.     
  136.     You can also imbed a CADL program in a macro and attach the macro to
  137.     a keystroke or to the menu structure.
  138.  
  139.  
  140. --------------------------------------------------------------------------------
  141.                 2dxform.cdl
  142. --------------------------------------------------------------------------------
  143.  
  144. Task:            This program performs a transformation (copy)
  145.             that combines the translation and rotation of
  146.             one or more entities in x and y coordinates.
  147.  
  148.             The program prompts you to enter a base point and
  149.             an orientation of the entities.  It then prompts
  150.             you to indicate a new position for the base point
  151.             and a new orientation.
  152.  
  153. How to use:        FILES - CADL - EXECUTE,  enter:  2dxform
  154.  
  155.             You can specify the level on which you want the new
  156.             geometry to be created.
  157.  
  158.             The program displays a menu allowing you to select
  159.             entities individually ("SINGLE") or in groups ("CHAIN"
  160.             or "WINDOW").  Choose the desired option, and select
  161.             the entities to be translated and rotated into a new
  162.             x,y position.              
  163.  
  164.             Indicate the entity's old base point and old main
  165.             direction point (orientation).  
  166.  
  167.             Indicate the new base point and the new main
  168.             direction point into which the entity is to
  169.             be copied.
  170.  
  171.             After the entity has been copied into its new x,y
  172.             position, you can continue to place it into other new
  173.             positions by specifying other new base points and new
  174.             orientations. To stop the program and return to the
  175.             CADL menu, press <ESC> or F10. 
  176.  
  177.             Before leaving 2dxform, the program asks you if you
  178.             want to delete the original entities that you selected.
  179.  
  180.             It is not possible to tilt entities using 2dxform. 
  181.  
  182.  
  183. --------------------------------------------------------------------------------
  184.                 3dxform.cdl
  185. --------------------------------------------------------------------------------
  186.  
  187. Task:            This program performs a transformation (copy)
  188.             that combines the translation and rotation of
  189.             one or more entities in x, y and z coordinates.
  190.  
  191.             The program prompts you to enter a base point and
  192.             a primary and secondary orientation of the entities.
  193.             It then prompts you to indicate a new position for
  194.             the base point and new primary and secondary
  195.             orientations.
  196.  
  197.             It is possible to tilt entities using 3dxform.
  198.  
  199. How to use:        FILES - CADL - EXECUTE,  enter:  3dxform
  200.  
  201.             You can specify the level on which you want the new
  202.             geometry to be created.
  203.  
  204.             The program displays a menu allowing you to select
  205.             entities individually ("SINGLE") or in groups ("CHAIN"
  206.             or "WINDOW").  Choose the desired option and    select
  207.             the entities to be translated and rotated into a new
  208.             x,y,z position.  
  209.  
  210.             Indicate the entity's old base point, old main
  211.             direction point (primary orientation), and old
  212.             secondary direction point (secondary orientation).
  213.  
  214.             Indicate the entity's new base point, new main
  215.             direction point, and new secondary direction point.
  216.  
  217.             After the entity has been copied into its new x,y,z
  218.             position, you can continue to place it into other
  219.             new positions by specifying other new base points,
  220.             new primary orientations, and new secondary
  221.             orientations.  To stop the program and return to the
  222.             CADL menu, press <ESC> or F10.
  223.  
  224.             Before leaving 3dxform, the program asks you if you
  225.             want to delete the original entity or set of entities
  226.             that you selected.
  227.  
  228.  
  229. --------------------------------------------------------------------------------
  230.                 3drot.cdl
  231. --------------------------------------------------------------------------------
  232.  
  233. Task:            This program allows you to copy and rotate an entity
  234.             or a set of entities about two positions which
  235.             represent a rotation axis.
  236.  
  237.             This utility may be used in any view.  The user has the
  238.             option of using single, chain, or window selection to
  239.             specify the entities to be copied.
  240.  
  241. How to use:        FILES - CADL - EXECUTE,  enter:  3drot
  242.  
  243.             You can specify the level on which you want the
  244.             entities to be constructed.  
  245.  
  246.             The next step involves selecting the entities which will
  247.             be rotated about an axis.  The selection menu will allow
  248.             you to choose between SINGLE, CHAIN, or WINDOW.  Select
  249.             the desired option and indicate the entities to
  250.             transform.
  251.  
  252.             Using the Position Menu, indicate the two positions
  253.             which will represent the rotation axis.  
  254.  
  255.             After indicating the axis, enter the angle of rotation
  256.             to be applied and the number of copies to be created.
  257.  
  258.             The entities selected will be copied based on the
  259.             rotation angle and number of copies specified.  
  260.  
  261.             After the construction, you have the option of deleting
  262.             the original entities which were rotated.
  263.  
  264.  
  265. --------------------------------------------------------------------------------
  266.                 gmupdate.cdl
  267. --------------------------------------------------------------------------------
  268.  
  269. Task:            This program redefines points, lines and arcs by
  270.             updating the data in the part file's data base.
  271.  
  272.             If the entity selected is a point, the system
  273.             displays a set of menus that allow you to update
  274.             the view or world coordinates of the point.
  275.  
  276.             If the entity selected is a line, the system
  277.             displays a set of menus that allow you to update
  278.             the view or world coordinates of the end points of
  279.             the line.
  280.  
  281.             If the entity selected is an arc, the system
  282.             displays a set of menus that allow you to update
  283.             the view or world coordinates of the center of
  284.             the arc, as well as the arc's start and end angles
  285.             and its radius.
  286.  
  287.             In each case the entity is recreated using the new
  288.             data.
  289.  
  290. How to use:        FILES - CADL - EXECUTE,  enter:  gmupdate
  291.  
  292.             Select the entity to update.
  293.  
  294.  
  295. --------------------------------------------------------------------------------
  296.                 ptsurf.cdl
  297. --------------------------------------------------------------------------------
  298.  
  299. Task:            This program projects points onto a three-sided
  300.             polygonal surface in the direction of the current
  301.             view.
  302.  
  303. How to use:        FILES - CADL - EXECUTE,  enter:  ptsurf
  304.  
  305.             Enter the level on which you want to store the new
  306.             points.
  307.  
  308.             Indicate twice the point to project.  The first pick
  309.             selects the point.  The second pick selects the
  310.             polygon to which the point is to be projected.
  311.  
  312.  
  313. -------------------------------------------------------------------------------
  314.                 2ptfil.cdl
  315. -------------------------------------------------------------------------------
  316.  
  317. Task:            This program creates a fillet between two points with a
  318.             given radius.  It creates the arc counterclockwise (CCW)
  319.             from the first point selected to the second point.
  320.  
  321. Notes:            Points must be at the same depth in the view in which
  322.             you select the first point, or with respect to an
  323.             active construction plane.
  324.  
  325.             The distance between the points must not be larger
  326.             than twice the radius of the fillet.
  327.  
  328. How to use:        FILES - CADL -  EXECUTE,  enter:  2ptfil
  329.  
  330.             Enter the fillet's radius.
  331.  
  332.             Indicate the first and second points.
  333.  
  334.  
  335. --------------------------------------------------------------------------------
  336.                 twoptsvw.cdl
  337. --------------------------------------------------------------------------------
  338.  
  339. Task:            This program creates a line-of-sight view along two
  340.             given points.  The positive side of the view is the
  341.             side of the first point that you select.
  342.  
  343. How to use:        FILES - CADL - EXECUTE,  enter:  twoptsvw
  344.  
  345.             Indicate the first and second points.
  346.  
  347.             A new view is created and added to the data base.
  348.  
  349.  
  350. --------------------------------------------------------------------------------
  351.                 lnptang.cdl
  352. --------------------------------------------------------------------------------
  353.  
  354. Task:            This program creates a line at a user-specified angle
  355.             to an existing line which passes through a selected
  356.             point.
  357.  
  358. Note:            This program works in any view, and the line
  359.             constructed exists on the plane determined by the
  360.             point and line selected.
  361.  
  362. How to use:        FILES - CADL - EXECUTE,  enter:  lnptang
  363.  
  364.             Indicate the a line to serve as the base line.
  365.             Entering a <return> designates the x-axis as the
  366.             base line.
  367.  
  368.             Indicate the base position.
  369.  
  370.             Enter the angle from the base line.
  371.  
  372.  
  373. --------------------------------------------------------------------------------
  374.                 lnpartan.cdl
  375. --------------------------------------------------------------------------------
  376.  
  377. Task:            This program creates a line tangent to an arc or
  378.             circle and parallel to another existing line.
  379.  
  380. Note:            This program works in any view.
  381.  
  382. Restriction:        The arc/circle (with which the new line will be
  383.             tangent) and the line (with which the new line will
  384.             be parallel) must be coplanar.
  385.  
  386. How to use:        FILES - CADL - EXECUTE,  enter:  lnpartan
  387.  
  388.             Indicate the line to which the new line will be
  389.             parallel.
  390.  
  391.             Indicate the arc or circle to which the new line
  392.             will be tangent.
  393.  
  394.             After the line appears, you can continue selecting
  395.             additional arcs or circles to create additional lines.
  396.  
  397.             
  398. --------------------------------------------------------------------------------
  399.                 lnpptan.cdl
  400. --------------------------------------------------------------------------------
  401.  
  402. Task:            This program creates a line tangent to an arc or circle
  403.             and perpendicular to another line.
  404.  
  405. Note:            This program works in any view.
  406.  
  407. Restriction:        The arc/circle (with which the new line will be
  408.             tangent) and the line (with which the new line will
  409.             be perpendicular) must be coplanar.
  410.  
  411. How to use:        FILES - CADL - EXECUTE,  enter:  lnpptan
  412.  
  413.             Indicate the line to which the new line will be
  414.             perpendicular.
  415.  
  416.             Indicate the arc or circle to which the new line will
  417.             be tangent.
  418.  
  419.             After the line appears, you can continue selecting
  420.             additional arcs or circles to create additional lines.
  421.  
  422.  
  423.  
  424. --------------------------------------------------------------------------------
  425.                 cincispl.cdl
  426. --------------------------------------------------------------------------------
  427.  
  428. Task:            This program creates three types of parabolic
  429.             splines (using a quadratic equation as opposed to a
  430.             cubic equation) as well as a linear representation.
  431.             The program stores these parabolic splines inside
  432.             the CADKEY spline entity.  CADKEY 3 uses this new
  433.             entity as if it were a normal spline.
  434.  
  435. Note:            This program gives you the following options:
  436.  
  437.                 CINCI
  438.                 FORWARD
  439.                 BLEND
  440.                 LINEAR
  441.  
  442. How to use:        FILES - CADL - EXECUTE,  enter:  cincispl
  443.  
  444.             Select the spline interpolation type.
  445.  
  446.             Using the position menu, indicate the points of the
  447.             spline.
  448.             
  449.             The spline will then be constructed.
  450.  
  451.             Use <ESC> to exit the program, F10 to backup to the
  452.             interpolation menu, or select additional positions
  453.             to create another spline.
  454.  
  455.  
  456. --------------------------------------------------------------------------------
  457.                 cirlnend.cdl
  458. --------------------------------------------------------------------------------
  459.  
  460. Task:            This program will a circle at the endpoints of an
  461.             existing line.  The arcs will be constructed
  462.             perpendicular to the vector formed by the existing
  463.             line.  The arcs will represent a cylinder with the
  464.             line as the axis.
  465.  
  466.  
  467. How to use:        FILES - CADL - EXECUTE,  enter:  cirlnend
  468.  
  469.             Select the desired axis line.
  470.  
  471.             Enter the radius of the arcs to be constructed.
  472.  
  473.             The arcs will then be constructed at both ends of
  474.             the axis line, and you can continue to select
  475.             additional lines.
  476.  
  477.  
  478. --------------------------------------------------------------------------------
  479.                 lntanang.cdl
  480. --------------------------------------------------------------------------------
  481.  
  482. Task:            This program creates a line tangent to an arc, at a
  483.             given angle from a user-specified base line.  The line
  484.             and arc must be coplanar.
  485.  
  486. How to use:        FILES - CADL - EXECUTE,  enter:  lntanang
  487.  
  488.             Indicate the a line to serve as the base line.
  489.             Entering a <return> designates the x-axis as the
  490.             baseline.
  491.  
  492.             Enter the angle from the base line.
  493.  
  494.             Indicate the arc or circle to which the new line will
  495.             be tangent.
  496.  
  497.  
  498. --------------------------------------------------------------------------------
  499.                 cylint.cdl
  500. --------------------------------------------------------------------------------
  501.  
  502. Task:            This program will construct a spline which represents
  503.             the intersection of two cylinders.
  504.  
  505. Note:            Each cylinder for this program must be represented by
  506.             two circles.  All together this program requests that
  507.             four circles be selected.
  508.  
  509. How to use:        FILES - CADL - EXECUTE,  enter:  cylint
  510.  
  511.             Cursor-indicate the first circle representing the
  512.             first cylinder.
  513.  
  514.             Indicate the second circle representing the first
  515.             cylinder.
  516.  
  517.             Indicate the first circle representing the second
  518.             cylinder.
  519.  
  520.             Indicate the second circle representing the second
  521.             cylinder.
  522.  
  523.             The program will transfer control to an executable
  524.             program in the DOS shell.
  525.  
  526.             When the operation is complete, press <return> to
  527.             re-enter CADKEY, and the intersection(s) will be
  528.             created.
  529.  
  530.  
  531. --------------------------------------------------------------------------------
  532.                 splpar.cdl
  533. --------------------------------------------------------------------------------
  534.  
  535. Task:            This program creates a 2-D or 3-D cubic spline offset
  536.             from an existing spline.
  537.  
  538. Notes:            This program mathematically offsets the nodes (or knot
  539.             points) of a new spline from the nodes of the original
  540.             spline.
  541.  
  542.             The new spline's offset is mathematically correct only
  543.             at the nodes.
  544.  
  545.             The new spline itself is not necessarily parallel to the
  546.             original spline.  The number of nodes in the original
  547.             spline determines how closely parallel the new offset
  548.             spline will be to the original spline.  The more nodes
  549.             there are in the original spline, the more truly
  550.             parallel the offset spline will be.
  551.  
  552.             SPLPAR.CDL works correctly for 2-D splines and for 3-D
  553.             splines in which at least one of the coordinates of
  554.             every node (x, y or z) is constant in a single plane.
  555.  
  556.             SPLPAR.CDL does not work for 3-D splines in which all
  557.             three coordinates of a node (x, y and z) can be on
  558.             different planes.
  559.  
  560. How to use:        FILES - CADL - EXECUTE,  enter:  splpar
  561.  
  562.             Select the spline that you want to offset.
  563.  
  564.             Enter the desired offset.
  565.  
  566.             The program identifies the type of spline that you have
  567.             selected.
  568.  
  569. Credit:            SPLPAR.CDL was designed and written by Haig Saadetian
  570.             of Carr-Sawyer Systems, Inc., Weston, Ontario, Canada.
  571.  
  572.  
  573. --------------------------------------------------------------------------------
  574.                 postrim.cdl
  575. --------------------------------------------------------------------------------
  576.  
  577. Task:            This program will allow you to trim or extend an
  578.             existing line to an indicated position.
  579.  
  580.  
  581. How to use:        FILES - CADL - EXECUTE,  enter:  postrim
  582.  
  583.             Select the line to trim or extend.
  584.  
  585.             Using the position menu, indicate a position to which
  586.             you want to trim or    extend the line.
  587.  
  588.             The line will be reconstructed to the new position.
  589.  
  590.  
  591.  
  592. --------------------------------------------------------------------------------
  593.                 ptvector.cdl
  594. --------------------------------------------------------------------------------
  595.  
  596.  
  597. Task:            This program allows you to create a point based on a
  598.             selected vector defined by a line and a direction, and
  599.             a specified distance.
  600.  
  601.             This function can also be used as a more flexible
  602.             version of creating a point along a line.
  603.  
  604. Note:            This program is view independant.
  605.  
  606. How to use:        FILES - CADL - EXECUTE,  enter:  ptvector
  607.  
  608.             Indicate a line which will represent the 3D vector to
  609.             be used for the point construction.
  610.  
  611.             Indicate a position to designate the direction where
  612.             the point will be created.
  613.  
  614.             Indicate a base point or position for the
  615.             transformation.
  616.  
  617.             Enter the delta distance from the base point.
  618.  
  619.             A point will be created at the specified distance from
  620.             the base point using the 3D vector for direction.
  621.  
  622.  
  623. --------------------------------------------------------------------------------
  624.                 cline.txt
  625. --------------------------------------------------------------------------------
  626.  
  627. Task:            This program is a macro to insert a centerline into an
  628.             arc or a circle.
  629.  
  630. How to use:        FILES - MACROS - LIBRARY - TXT-IN,  enter:  cline
  631.             FILES - MACROS - LIBRARY - LST/EXE,  select:  cline
  632.  
  633.      or:        CTRL-E,  enter:  cline
  634.  
  635.             Select an arc or circle for inserting a centerline.
  636.  
  637.             The centerline is proportioned to the size of the arc
  638.             or circle.
  639.  
  640.             You can continue select arcs or circles, one at a
  641.             time, until you stop the macro.
  642.  
  643.  
  644. --------------------------------------------------------------------------------
  645.                 startex1.txt
  646. --------------------------------------------------------------------------------
  647.  
  648. Task:            This macro sets system parameters (level, color,
  649.             view, mask, pen, line type, line width, text, note
  650.             height, aspect, angle, dimension height, dimension
  651.             scale) according to a user-selected example entity.
  652.  
  653.             This macro executes its task in association with the
  654.             following files:
  655.  
  656.                         ex1.txt
  657.                         dimchg.txt
  658.                         dimht.txt
  659.                         dimscl.txt
  660.                         endex1.txt
  661.                         exampl1.cdl
  662.  
  663.             This set of programs shows a technique of how to
  664.             communicate bidirectionally between CADL programs
  665.             and macros.
  666.  
  667.             In essence, this demonstrates CADL's ability to use 
  668.             macros as if they were subroutines -- an extremely
  669.             useful tool!            
  670.  
  671. How to use:        FILES - MACROS - LIBRARY - TXT-IN,  enter:  startex1
  672.             FILES - MACROS - LIBRARY - LST/EXE,  select:  startex1
  673.  
  674.     or:        CTRL-E,  enter:  startex1
  675.  
  676.             Select the example entity.
  677.  
  678.  
  679. --------------------------------------------------------------------------------
  680.                 tbox.cdl
  681. --------------------------------------------------------------------------------
  682.  
  683. Task:            This program allows you to write text into pre-defined
  684.             locations in a title block.  To do this, you create a
  685.             template file that defines the field name, text size,
  686.             text height, aspect ratio, font, and pen number for
  687.             each one of the fields in the title block.  The
  688.             template file is an ASCII file stored in the CADKEY's
  689.             main directory.  
  690.  
  691.             This program displays a menu that allows you to select: 
  692.  
  693.             1. Create Template:    Allows you to define the
  694.                         field positions, widths,
  695.                         and text attributes.
  696.  
  697.             2. Append Field:    Allows you to append new
  698.                         fields to a template file.
  699.  
  700.             3. Modify Field:    Allows you to modify
  701.                         parameters in a single field
  702.                         of a template file.
  703.  
  704.             4. Write Field:        Allows you to write a
  705.                         single field to the
  706.                         title block.
  707.  
  708.             5. Write Template:    Writes the entire title
  709.                         block using the default
  710.                         text in each one of the
  711.                         fields of the template file.
  712.  
  713.             An efficient way to use this program is to edit
  714.             the default text fields in the template file, and
  715.             then to write the entire title block using the
  716.             Write Template option.
  717.  
  718. How to use:        FILES - CADL - EXECUTE,  enter:  tbox
  719.  
  720.  
  721. --------------------------------------------------------------------------------
  722.                 winmgr.cdl
  723. --------------------------------------------------------------------------------
  724.  
  725. Task:            This program allows you to create and manage (add
  726.             or delete) additional view-dependent windows of a
  727.             part in CADKEY 3 beyond the capability of two windows
  728.             that you can currently create using ALT-W and ALT-B.
  729.  
  730. Note:            This program, along with its accompanying macro
  731.             PICT1.TXT, is particularly useful for large part
  732.             files.  It eliminates the need to change view,
  733.             autoscale, and window to create a new window of
  734.             a section of the part.  The macro PICT1.TXT can
  735.             be used as an immediate mode command.  To increase
  736.             speed, bind PICT1.TXT to a keystroke.
  737.  
  738. How to use:        FILES - CADL - EXECUTE,  enter:  winmgr
  739.  
  740.             Select the window-manager option:
  741.  
  742.                 ADD
  743.                 DELETE
  744.                 INITIAL (Initialize)
  745.  
  746.             Suggested procedure for use:
  747.  
  748.             Step 1.        Select INITIAL to clear the stack of
  749.                     windows.
  750.  
  751.             Step 2.        Select ADD to create and store new
  752.                     windows.
  753.  
  754.             Step 3.        To use the windows, use the immediate-
  755.                     mode command CTRL-E, and enter PICT1.
  756.                     Then, enter the desired window number.
  757.  
  758. Credit:            WINMGR.CDL and PICT1.TXT were designed and written
  759.             by Robert Bean of Baystate Technologies, Worcester,
  760.             Massachusetts.
  761.  
  762.  
  763. --------------------------------------------------------------------------------
  764.                 sc.cdl
  765. --------------------------------------------------------------------------------
  766.  
  767. Task:            This program sets all the CADKEY view ports to the
  768.             same scale, and it centers the part displayed in
  769.             each view port. 
  770.  
  771. How to use:        FILES - CADL - EXECUTE,  enter:  sc
  772.  
  773.             Enter the scale factor for the view ports.
  774.  
  775.  
  776. --------------------------------------------------------------------------------
  777.                 tubecl.cdl
  778. --------------------------------------------------------------------------------
  779.  
  780. Task:            This program allows you to define the 3-D centerline
  781.             of a tube through a set of user-specified control
  782.             points and bend radii.  You can choose to specify a
  783.             bend radius that will be common to all bends in the
  784.             tube, or to specify each bend radius individually.
  785.  
  786. Note:            You can indicate the control points on the screen with
  787.             the position menu and cursor, or by reading them from
  788.             an ASCII file.
  789.  
  790.             If all the bends have a common radius, the format of
  791.             the file is:
  792.  
  793.                            X1, Y1, Z1
  794.                            X2, Y2, Z2
  795.                            Xn, Yn, Zn
  796.  
  797.             If the bends have different radii, the file format is:
  798.  
  799.                            X1, Y1, Z1
  800.                            X2, Y2, Z2
  801.                         R1,     X3, Y3, Z3
  802.                         R2,     X4, Y4, Z4
  803.                         R(n-2), Xn, Yn, Zn
  804.  
  805.             The centerline proceeds in a linear progression from
  806.             its starting point to its ending point.  This means
  807.             that the end-point of any entity (line or arc) in the
  808.             centerline coincides with the start-point of the
  809.             following entity, except for the last entity.
  810.  
  811.             TUBECL.CDL was originally donated as free-of-charge
  812.             shareware to the CADKEY Forum on the CompuServe (R)
  813.             Information Service.
  814.  
  815.  
  816. How to use:        FILES - CADL - EXECUTE,  enter:  tubecl
  817.  
  818.  
  819. --------------------------------------------------------------------------------
  820.                 cstube.cdl
  821. --------------------------------------------------------------------------------
  822.  
  823. Task:            This program creates a CADL file that serves as
  824.             input to CADKEY SOLIDS which creates a solid
  825.             representation of the tube.
  826.  
  827. Note:            The centerline created by TUBECL.CDL serves as the
  828.             input to CSTUBE.CDL.  The chain of the centerline's
  829.             lines and arcs that you specify in CSTUBE must start
  830.             at the same point and proceed in the same sequence as
  831.             it was created by TUBECL.
  832.  
  833.             CSTUBE.CDL was originally donated as free-of-charge
  834.             shareware to the CADKEY Forum on the CompuServe (R)
  835.             Information Service.
  836.  
  837.  
  838. How to use:        FILES - CADL - EXECUTE,  enter:  cstube
  839.  
  840.  
  841. --------------------------------------------------------------------------------
  842.                 tubedge.cdl
  843. --------------------------------------------------------------------------------
  844.  
  845. Task:            This program generates an edge view of a tube.
  846.  
  847. Note:            Creating this edge view is quite complex, especially
  848.             for inside bends.
  849.  
  850.             The centerline created by TUBECL.CDL serves as the input
  851.             to TUBEDGE.CDL.  The chain of the centerline's
  852.             lines and arcs that you specify in TUBEDGE must start
  853.             at the same point and proceed in the same sequence as
  854.             it was created by TUBECL.
  855.  
  856. WARNING:        STORE YOUR PART FILE BEFORE RUNNING TUBEDGE.  TUBEDGE
  857.             is still in development and may contain errors.
  858.  
  859.             TUBEDGE.CDL was originally donated as free-of-charge
  860.             shareware to the CADKEY Forum on the CompuServe (R)
  861.             Information Service.
  862.              
  863. How to use:        FILES - CADL - EXECUTE,  enter:  tubedge
  864.  
  865.  
  866. --------------------------------------------------------------------------------
  867.                 shapes.cdl
  868. --------------------------------------------------------------------------------
  869.  
  870. Task:            SHAPES is a group of CADL programs that allows you
  871.             to create shapes parametrically in a CADKEY part
  872.             file.
  873.  
  874. Notes:            Icons help you to select the specific CADL program
  875.             that will generate the desired shape.  Icons also
  876.             display the variables (dimensions) that you must
  877.             supply to the CADL program to create the shape.
  878.  
  879.             SHAPES was originally donated as free-of-charge
  880.             shareware to the CADKEY Forum on the CompuServe (R)
  881.             Information Service.
  882.  
  883. Introduction:        SHAPES is a framework that you may take as an example
  884.             of how to integrate CADL programs into a single
  885.             structure.  You may also adapt SHAPES to their own
  886.             needs.  All of the shapes currently available in
  887.             SHAPES are two-dimensional.  However, SHAPES can
  888.             easily be extended into three dimensions to create
  889.             such shapes as bolts, nuts, clamps, etc.
  890.  
  891.             SHAPES is essentially composed of a main file,
  892.             SHAPES.CDL, and two subroutine files, SH_SCRN.CDL and
  893.             RESTORE.CDL, plus a variety of CADL icon files which
  894.             define the shapes that they represent.
  895.  
  896.             SHAPES provides two levels of icons for creating each
  897.             geometric shape, an icon for the SHAPES menu and an
  898.             icon that identifies the parameters that you must
  899.             specify in order to create the shape in a part file.
  900.  
  901.             SHAPES.CDL displays icons on the screen and calls a
  902.             specific, shape-defining CADL file when you select a
  903.             particular icon with the cursor.  The CADL file that
  904.             corresponds to the selected icon will actually create
  905.             the shape once you have entered the necessary
  906.             parameters.
  907.  
  908. Example:        If you are designing a part in CADKEY 3 and need to
  909.             create an oval, SHAPES can help you.  Using the
  910.             command sequence, FILES, CADL, EXECUTE, the screen
  911.             prompts you for a file name.  Enter SHAPES.
  912.  
  913.             The screen displays the SHAPES icon menu.  One of the
  914.             icons that you see is an oval.  Select this icon with
  915.             the cursor. The screen displays that icon by itself
  916.             with labels identifying the dimensions that you must
  917.             specify to enter the geometry represented by that
  918.             icon into your part file.
  919.  
  920.             The bottom of the screen also displays a prompt line
  921.             referring to the first dimension's name and giving a
  922.             default value for that dimension.  Enter the data
  923.             required for each dimension: length, width, radius
  924.             and angle.  The screen now prompts you for the
  925.             location in which you want the oval placed in your
  926.             part file.
  927.  
  928.             After you enter the required data, CADKEY creates the
  929.             oval in the location that you specified.
  930.  
  931.             You may choose to display the oval's center lines and
  932.             to enter that same geometry in another location.  If
  933.             you prefer to enter a different shape, use BACKUP
  934.             (F10) or <ESC> to exit from the CADL file for
  935.             defining an oval.  The screen displays the icon menu
  936.             again.  You can select another icon, activating the
  937.             CADL file that it represents to create and insert a
  938.             new shape into your part file, such as a rounded slot,
  939.             a radial slot, a sharp-cornered-rounded slot, or an
  940.             open-ended slot.  Or, you may use <ESC> to exit SHAPES
  941.             and return to your part file.
  942.  
  943.             This section of the README35.DOC file focuses on two
  944.             questions:
  945.  
  946.                     1. How does SHAPES work?
  947.                     2. How do I use SHAPES?
  948.  
  949. How it works:        SHAPES.CDL sets the initial variables for the icons
  950.             to be displayed, then displays the icon menu by
  951.             calling the subroutine SHSCREEN.CDL.  The icons that
  952.             are displayed represent shape-defining CADL files
  953.             which SH_SCRN.CDL calls as subroutines.  You can
  954.             customize SHAPES by adding your own, specific,
  955.             geometry-defining CADL file to the list of
  956.             subroutines in SH_SCRN.CDL, and by identifying in
  957.             SHAPES.CDL the menu position in which you want the
  958.             icon to be displayed.  RESTORE.CDL restores the
  959.             original variables defined by SHAPES.CDL.
  960.  
  961.             SHAPES' current icon menu is a matrix containing 16
  962.             squares.  (The number of squares in the menu can be
  963.             modified as needed.  The procedure for modifying the
  964.             menu will be described in the next paragraph.)  The
  965.             position of each square is identified by the column
  966.             and row in which it is located.  The columns are
  967.             numbered from left to right: 1, 2, 3, 4.  The rows
  968.             are numbered from bottom to top: 1, 2, 3, 4.  The
  969.             name of each square in the matrix is a combination of
  970.             that square's column number and row number, beginning
  971.             with "pos11" in the lower left corner, as illustrated
  972.             below:
  973.  
  974.                        ---------------------------------
  975.                        |       |       |       |       |
  976.                        | pos14 | pos24 | pos34 | pos44 |
  977.                        |       |       |       |       |
  978.                        |-------------------------------|
  979.                        |       |       |       |       |
  980.                        | pos13 | pos23 | pos33 | pos43 |
  981.                        |       |       |       |       |
  982.                        |-------------------------------|
  983.                        |       |       |       |       |
  984.                        | pos12 | pos22 | pos32 | pos42 |
  985.                        |       |       |       |       |
  986.                        |-------------------------------|
  987.                        |       |       |       |       |
  988.                        | pos11 | pos21 | pos31 | pos41 |
  989.                        |       |       |       |       |
  990.                        ---------------------------------
  991.  
  992. How to adapt        SHAPES' icon menu does not have to be a matrix of
  993. SHAPES to        four columns and four rows.  To change the matrix
  994. your needs:        of the icon menu requires three steps.  First, you
  995.             must define new values to replace the current
  996.             values specified in SHAPES.CDL for the number of
  997.             columns and for the number of rows in the matrix.
  998.             For example, if the number of columns were six, and
  999.             the number of rows were five, the icon menu's matrix
  1000.             would contain thirty squares into which you could
  1001.             display icons.  After you have changed the values
  1002.             for the number of columns and rows, you must adjust
  1003.             the number of positions in each column specified in
  1004.             SHAPES.CDL to reflect the new number of squares in
  1005.             each column of the matrix in which you may display
  1006.             an icon.  Then, you must change the scale factor in
  1007.             each of the CADL icon files that are already listed
  1008.             as subroutines in SH_SCRN.CDL so that each icon will
  1009.             be displayed properly in the modified icon-menu
  1010.             matrix.  (All the CADL files on this diskette whose
  1011.             names follow the pattern SH_xxx.CDL or I_xxx.CDL are
  1012.             subroutines of SHAPES.  The names of the icon files
  1013.             follow the pattern I_xxx.CDL.)  It is necessary to
  1014.             enter each icon file and change the scale factor
  1015.             individually because these icon files do not have the
  1016.             same scale factor for display.
  1017.  
  1018.             Some of the current CADL icon files listed in
  1019.             SH_SCRN.CDL are:
  1020.  
  1021.             I_OPNSL.CDL -        an open slot composed of two
  1022.                         parallel lines closed at one
  1023.                         end by an arc.
  1024.  
  1025.             I_RNDSL.CDL -        a round slot composed of two
  1026.                         parallel lines closed by two
  1027.                         arcs.
  1028.  
  1029.             I_SHRPSL.CDL -    a sharp-cornered slot composed
  1030.                         of two parallel lines closed
  1031.                         by two arcs.
  1032.  
  1033.             I_RADSL.CDL -        a radial slot composed of two
  1034.                         parallel arcs closed by two
  1035.                         arcs.
  1036.  
  1037.             I-OVAL.CDL -        an oval.
  1038.  
  1039. How to use:        FILES - CADL - EXECUTE,  enter:  shapes
  1040.  
  1041.             After the screen has displayed the SHAPES menu,
  1042.             select the icon that you want with the cursor.
  1043.             You may use a mouse or the arrow-direction keys on
  1044.             the keyboard to move the cursor into the square
  1045.             containing the desired icon.  As long as the cursor
  1046.             is inside the square, it will select the CADL file
  1047.             represented by the icon in that square.
  1048.  
  1049.             After you have selected the icon from the menu, the
  1050.             screen displays the icon with labels identifying the
  1051.             different dimensions that you must specify to enter
  1052.             the geometry represented by that icon into your part
  1053.             file.  The bottom of the screen also displays a
  1054.             prompt referring to the the dimension's name and
  1055.             giving a default value for that dimension.  Enter the
  1056.             required data.
  1057.  
  1058.             The screen prompts you for the location in which you
  1059.             want the geometry placed in your part file.  Enter
  1060.             the location.
  1061.  
  1062.             CADKEY creates the geometry in your part file in the
  1063.             location that you have specified.
  1064.  
  1065.             The screen now asks whether you want the geometry's
  1066.             centerlines.  The default answer is YES.
  1067.  
  1068.             After this, you can place this geometry in another
  1069.             location if you want to do so.
  1070.  
  1071.             If you prefer to enter a different shape into the
  1072.             part file, use BACKUP or ESCAPE to exit from the
  1073.             CADL file represented by the icon that you had
  1074.             selected.
  1075.  
  1076.             The screen displays the icon menu again.  You can
  1077.             select another icon, activating the CADL file that
  1078.             it represents, and repeat the process described
  1079.             above.
  1080.  
  1081.             Or, you can exit SHAPES.
  1082.  
  1083.             To exit SHAPES, use <ESC>.
  1084.  
  1085.             You are now back in your part file in CADKEY.
  1086.