home *** CD-ROM | disk | FTP | other *** search
Text File | 1989-06-24 | 38.1 KB | 1,086 lines |
-
- **** Welcome to the CADKEY CADL Utilities Diskette ****
-
- Version Date 6/22/89
-
- This diskette contains several useful construction utilities, examples
- of applications, and outlines of command usage. Each utility and
- application program is described in the following text. Each descrip-
- tion contains an outline of the task which is performed, as well as a
- set of instructions relating to the operation of the program.
-
- The purpose of CADL is to allow you to do things with the data base,
- graphics, and construction capabilities available in CADKEY 3. CADL
- allows you to use all these capabilities in ways that CADKEY 3 was
- never designed to do itself.
-
- One of the programs on this diskette of miscellaneous utilities
- demonstrates how to communicate bidirectionally between a CADL
- program and macros, so that the macros function as if they were
- subroutines of the CADL program. See STARTEX1.TXT for this
- extremely useful tool.
-
- You can use CADKEY 3 to fill gaps in CADL or to speed things up.
- You can also use EXEC to leave CADKEY 3 temporarily, and go to
- DOS if you need additional capabilities not available in CADKEY 3
- or in CADL. If you need even more computing power, you can use
- EXEC to go to specialized routines in Fortran, Basic or C that you
- may have written for your own needs. Thanks to the AUTOSWAP
- program, you can use routines as large as 500K and even larger.
-
- ************************************************
-
- You should note, that this is a utility disk
- which may be used as a tool for performing tasks
- or as reference for generating additional pro-
- grams. You should also note that the programs
- contained in these disks are from various sources
- and that support for these programs is limited.
-
- *************************************************
-
-
- -------------------------------------------------
- | |
- | WARNING!! |
- | |
- -------------------------------------------------
-
- Before running these programs, run CONFIG. In the
- programming options (Option 6),
-
- 1. Set the number of CADL labels to 120 or more.
- 2. Set the number of register variables to 180 or
- more.
-
- If you run very long CADL programs, set the number
- of CADL labels and register variables even higher.
-
-
- SHAPES and UTILITY are designed to run ONLY in a
- single viewport configuration. Running them in
- multiple viewports will cause strange results and
- possible system crashes.
-
- ***************************************************
- * This diskette includes some text files that are *
- * macros. You should load them into the macro *
- * library using the TXT-IN command. *
- ***************************************************
-
- We plan to update many of these CADL programs during
- the year. You will find the updates available through
- your CADKEY dealer, in 3-D WORLD or in the CADKEY Forum
- on the CompuServe Information Service.
-
- You can make a CADL program run much faster if you compile it before
- you use it. CADKEY will publish an updated CADL Programmer's Guide
- in the Fall 1989 which will include program hints and examples.
-
- Several of the programs contained on this disk, have associated files.
- Some of these associated files are in the form of executable programs,
- while others are data files accessed or created by the program. These
- files, similiar to the CADL programs, must be copied into there appro-
- priate directories if the main programs are to run correctly. The file
- scheme for these programs are shown in the following outline.
-
-
- File type Description Directory
- --------- ----------- ---------
-
- xxx.CDL CADL pgms \cadkey\cdl
-
- xxx.COM Executable pgms \cadkey
- xxx.EXE
-
-
-
- -------------------------------------------------
- | |
- | ADDITIONAL WARNING!! |
- | |
- -------------------------------------------------
-
- Some of the CADL and executable programs use scratch or data files
- that are "hard coded" to access the \cadkey\cdl\ directory. If
- errors ocurr in these programs, you should check to see if these
- programs/files are in the proper location and/or directories.
-
- Also, please note that the executable programs require at least 28K
- in order to run correctly. It is suggested that the DOS memory be
- set to 50K in order to allow these programs to operate.
-
-
- -------------------------------------------------------------------
-
- This diskette also contains a CADL program called "utility" which will
- display a menu of user selectable CADL programs found on the disk.
-
-
- NOTE: You can run most, but NOT ALL, of the programs on this
- diskette through "utility."
-
-
- Once the files have been copied to their appropriate directories, this
- program may be accessed through the FILES - CADL - EXECUTE menu in
- CADKEY. Executing the program "utility" will display of menu of
- selectable CADL utility programs. Selecting one of the choices with
- the cursor will activate the particular program.
-
- Also contained as a menu option, are two additional choices; Help and
- Next page. By indicating "HELP," a description of the programs dis-
- played on the current page are shown. By selecting the option "Next
- page", the present list of program is erased and the next available
- page of CADL programs is displayed for selection.
-
- You can also imbed a CADL program in a macro and attach the macro to
- a keystroke or to the menu structure.
-
-
- --------------------------------------------------------------------------------
- 2dxform.cdl
- --------------------------------------------------------------------------------
-
- Task: This program performs a transformation (copy)
- that combines the translation and rotation of
- one or more entities in x and y coordinates.
-
- The program prompts you to enter a base point and
- an orientation of the entities. It then prompts
- you to indicate a new position for the base point
- and a new orientation.
-
- How to use: FILES - CADL - EXECUTE, enter: 2dxform
-
- You can specify the level on which you want the new
- geometry to be created.
-
- The program displays a menu allowing you to select
- entities individually ("SINGLE") or in groups ("CHAIN"
- or "WINDOW"). Choose the desired option, and select
- the entities to be translated and rotated into a new
- x,y position.
-
- Indicate the entity's old base point and old main
- direction point (orientation).
-
- Indicate the new base point and the new main
- direction point into which the entity is to
- be copied.
-
- After the entity has been copied into its new x,y
- position, you can continue to place it into other new
- positions by specifying other new base points and new
- orientations. To stop the program and return to the
- CADL menu, press <ESC> or F10.
-
- Before leaving 2dxform, the program asks you if you
- want to delete the original entities that you selected.
-
- It is not possible to tilt entities using 2dxform.
-
-
- --------------------------------------------------------------------------------
- 3dxform.cdl
- --------------------------------------------------------------------------------
-
- Task: This program performs a transformation (copy)
- that combines the translation and rotation of
- one or more entities in x, y and z coordinates.
-
- The program prompts you to enter a base point and
- a primary and secondary orientation of the entities.
- It then prompts you to indicate a new position for
- the base point and new primary and secondary
- orientations.
-
- It is possible to tilt entities using 3dxform.
-
- How to use: FILES - CADL - EXECUTE, enter: 3dxform
-
- You can specify the level on which you want the new
- geometry to be created.
-
- The program displays a menu allowing you to select
- entities individually ("SINGLE") or in groups ("CHAIN"
- or "WINDOW"). Choose the desired option and select
- the entities to be translated and rotated into a new
- x,y,z position.
-
- Indicate the entity's old base point, old main
- direction point (primary orientation), and old
- secondary direction point (secondary orientation).
-
- Indicate the entity's new base point, new main
- direction point, and new secondary direction point.
-
- After the entity has been copied into its new x,y,z
- position, you can continue to place it into other
- new positions by specifying other new base points,
- new primary orientations, and new secondary
- orientations. To stop the program and return to the
- CADL menu, press <ESC> or F10.
-
- Before leaving 3dxform, the program asks you if you
- want to delete the original entity or set of entities
- that you selected.
-
-
- --------------------------------------------------------------------------------
- 3drot.cdl
- --------------------------------------------------------------------------------
-
- Task: This program allows you to copy and rotate an entity
- or a set of entities about two positions which
- represent a rotation axis.
-
- This utility may be used in any view. The user has the
- option of using single, chain, or window selection to
- specify the entities to be copied.
-
- How to use: FILES - CADL - EXECUTE, enter: 3drot
-
- You can specify the level on which you want the
- entities to be constructed.
-
- The next step involves selecting the entities which will
- be rotated about an axis. The selection menu will allow
- you to choose between SINGLE, CHAIN, or WINDOW. Select
- the desired option and indicate the entities to
- transform.
-
- Using the Position Menu, indicate the two positions
- which will represent the rotation axis.
-
- After indicating the axis, enter the angle of rotation
- to be applied and the number of copies to be created.
-
- The entities selected will be copied based on the
- rotation angle and number of copies specified.
-
- After the construction, you have the option of deleting
- the original entities which were rotated.
-
-
- --------------------------------------------------------------------------------
- gmupdate.cdl
- --------------------------------------------------------------------------------
-
- Task: This program redefines points, lines and arcs by
- updating the data in the part file's data base.
-
- If the entity selected is a point, the system
- displays a set of menus that allow you to update
- the view or world coordinates of the point.
-
- If the entity selected is a line, the system
- displays a set of menus that allow you to update
- the view or world coordinates of the end points of
- the line.
-
- If the entity selected is an arc, the system
- displays a set of menus that allow you to update
- the view or world coordinates of the center of
- the arc, as well as the arc's start and end angles
- and its radius.
-
- In each case the entity is recreated using the new
- data.
-
- How to use: FILES - CADL - EXECUTE, enter: gmupdate
-
- Select the entity to update.
-
-
- --------------------------------------------------------------------------------
- ptsurf.cdl
- --------------------------------------------------------------------------------
-
- Task: This program projects points onto a three-sided
- polygonal surface in the direction of the current
- view.
-
- How to use: FILES - CADL - EXECUTE, enter: ptsurf
-
- Enter the level on which you want to store the new
- points.
-
- Indicate twice the point to project. The first pick
- selects the point. The second pick selects the
- polygon to which the point is to be projected.
-
-
- -------------------------------------------------------------------------------
- 2ptfil.cdl
- -------------------------------------------------------------------------------
-
- Task: This program creates a fillet between two points with a
- given radius. It creates the arc counterclockwise (CCW)
- from the first point selected to the second point.
-
- Notes: Points must be at the same depth in the view in which
- you select the first point, or with respect to an
- active construction plane.
-
- The distance between the points must not be larger
- than twice the radius of the fillet.
-
- How to use: FILES - CADL - EXECUTE, enter: 2ptfil
-
- Enter the fillet's radius.
-
- Indicate the first and second points.
-
-
- --------------------------------------------------------------------------------
- twoptsvw.cdl
- --------------------------------------------------------------------------------
-
- Task: This program creates a line-of-sight view along two
- given points. The positive side of the view is the
- side of the first point that you select.
-
- How to use: FILES - CADL - EXECUTE, enter: twoptsvw
-
- Indicate the first and second points.
-
- A new view is created and added to the data base.
-
-
- --------------------------------------------------------------------------------
- lnptang.cdl
- --------------------------------------------------------------------------------
-
- Task: This program creates a line at a user-specified angle
- to an existing line which passes through a selected
- point.
-
- Note: This program works in any view, and the line
- constructed exists on the plane determined by the
- point and line selected.
-
- How to use: FILES - CADL - EXECUTE, enter: lnptang
-
- Indicate the a line to serve as the base line.
- Entering a <return> designates the x-axis as the
- base line.
-
- Indicate the base position.
-
- Enter the angle from the base line.
-
-
- --------------------------------------------------------------------------------
- lnpartan.cdl
- --------------------------------------------------------------------------------
-
- Task: This program creates a line tangent to an arc or
- circle and parallel to another existing line.
-
- Note: This program works in any view.
-
- Restriction: The arc/circle (with which the new line will be
- tangent) and the line (with which the new line will
- be parallel) must be coplanar.
-
- How to use: FILES - CADL - EXECUTE, enter: lnpartan
-
- Indicate the line to which the new line will be
- parallel.
-
- Indicate the arc or circle to which the new line
- will be tangent.
-
- After the line appears, you can continue selecting
- additional arcs or circles to create additional lines.
-
-
- --------------------------------------------------------------------------------
- lnpptan.cdl
- --------------------------------------------------------------------------------
-
- Task: This program creates a line tangent to an arc or circle
- and perpendicular to another line.
-
- Note: This program works in any view.
-
- Restriction: The arc/circle (with which the new line will be
- tangent) and the line (with which the new line will
- be perpendicular) must be coplanar.
-
- How to use: FILES - CADL - EXECUTE, enter: lnpptan
-
- Indicate the line to which the new line will be
- perpendicular.
-
- Indicate the arc or circle to which the new line will
- be tangent.
-
- After the line appears, you can continue selecting
- additional arcs or circles to create additional lines.
-
-
-
- --------------------------------------------------------------------------------
- cincispl.cdl
- --------------------------------------------------------------------------------
-
- Task: This program creates three types of parabolic
- splines (using a quadratic equation as opposed to a
- cubic equation) as well as a linear representation.
- The program stores these parabolic splines inside
- the CADKEY spline entity. CADKEY 3 uses this new
- entity as if it were a normal spline.
-
- Note: This program gives you the following options:
-
- CINCI
- FORWARD
- BLEND
- LINEAR
-
- How to use: FILES - CADL - EXECUTE, enter: cincispl
-
- Select the spline interpolation type.
-
- Using the position menu, indicate the points of the
- spline.
-
- The spline will then be constructed.
-
- Use <ESC> to exit the program, F10 to backup to the
- interpolation menu, or select additional positions
- to create another spline.
-
-
- --------------------------------------------------------------------------------
- cirlnend.cdl
- --------------------------------------------------------------------------------
-
- Task: This program will a circle at the endpoints of an
- existing line. The arcs will be constructed
- perpendicular to the vector formed by the existing
- line. The arcs will represent a cylinder with the
- line as the axis.
-
-
- How to use: FILES - CADL - EXECUTE, enter: cirlnend
-
- Select the desired axis line.
-
- Enter the radius of the arcs to be constructed.
-
- The arcs will then be constructed at both ends of
- the axis line, and you can continue to select
- additional lines.
-
-
- --------------------------------------------------------------------------------
- lntanang.cdl
- --------------------------------------------------------------------------------
-
- Task: This program creates a line tangent to an arc, at a
- given angle from a user-specified base line. The line
- and arc must be coplanar.
-
- How to use: FILES - CADL - EXECUTE, enter: lntanang
-
- Indicate the a line to serve as the base line.
- Entering a <return> designates the x-axis as the
- baseline.
-
- Enter the angle from the base line.
-
- Indicate the arc or circle to which the new line will
- be tangent.
-
-
- --------------------------------------------------------------------------------
- cylint.cdl
- --------------------------------------------------------------------------------
-
- Task: This program will construct a spline which represents
- the intersection of two cylinders.
-
- Note: Each cylinder for this program must be represented by
- two circles. All together this program requests that
- four circles be selected.
-
- How to use: FILES - CADL - EXECUTE, enter: cylint
-
- Cursor-indicate the first circle representing the
- first cylinder.
-
- Indicate the second circle representing the first
- cylinder.
-
- Indicate the first circle representing the second
- cylinder.
-
- Indicate the second circle representing the second
- cylinder.
-
- The program will transfer control to an executable
- program in the DOS shell.
-
- When the operation is complete, press <return> to
- re-enter CADKEY, and the intersection(s) will be
- created.
-
-
- --------------------------------------------------------------------------------
- splpar.cdl
- --------------------------------------------------------------------------------
-
- Task: This program creates a 2-D or 3-D cubic spline offset
- from an existing spline.
-
- Notes: This program mathematically offsets the nodes (or knot
- points) of a new spline from the nodes of the original
- spline.
-
- The new spline's offset is mathematically correct only
- at the nodes.
-
- The new spline itself is not necessarily parallel to the
- original spline. The number of nodes in the original
- spline determines how closely parallel the new offset
- spline will be to the original spline. The more nodes
- there are in the original spline, the more truly
- parallel the offset spline will be.
-
- SPLPAR.CDL works correctly for 2-D splines and for 3-D
- splines in which at least one of the coordinates of
- every node (x, y or z) is constant in a single plane.
-
- SPLPAR.CDL does not work for 3-D splines in which all
- three coordinates of a node (x, y and z) can be on
- different planes.
-
- How to use: FILES - CADL - EXECUTE, enter: splpar
-
- Select the spline that you want to offset.
-
- Enter the desired offset.
-
- The program identifies the type of spline that you have
- selected.
-
- Credit: SPLPAR.CDL was designed and written by Haig Saadetian
- of Carr-Sawyer Systems, Inc., Weston, Ontario, Canada.
-
-
- --------------------------------------------------------------------------------
- postrim.cdl
- --------------------------------------------------------------------------------
-
- Task: This program will allow you to trim or extend an
- existing line to an indicated position.
-
-
- How to use: FILES - CADL - EXECUTE, enter: postrim
-
- Select the line to trim or extend.
-
- Using the position menu, indicate a position to which
- you want to trim or extend the line.
-
- The line will be reconstructed to the new position.
-
-
-
- --------------------------------------------------------------------------------
- ptvector.cdl
- --------------------------------------------------------------------------------
-
-
- Task: This program allows you to create a point based on a
- selected vector defined by a line and a direction, and
- a specified distance.
-
- This function can also be used as a more flexible
- version of creating a point along a line.
-
- Note: This program is view independant.
-
- How to use: FILES - CADL - EXECUTE, enter: ptvector
-
- Indicate a line which will represent the 3D vector to
- be used for the point construction.
-
- Indicate a position to designate the direction where
- the point will be created.
-
- Indicate a base point or position for the
- transformation.
-
- Enter the delta distance from the base point.
-
- A point will be created at the specified distance from
- the base point using the 3D vector for direction.
-
-
- --------------------------------------------------------------------------------
- cline.txt
- --------------------------------------------------------------------------------
-
- Task: This program is a macro to insert a centerline into an
- arc or a circle.
-
- How to use: FILES - MACROS - LIBRARY - TXT-IN, enter: cline
- FILES - MACROS - LIBRARY - LST/EXE, select: cline
-
- or: CTRL-E, enter: cline
-
- Select an arc or circle for inserting a centerline.
-
- The centerline is proportioned to the size of the arc
- or circle.
-
- You can continue select arcs or circles, one at a
- time, until you stop the macro.
-
-
- --------------------------------------------------------------------------------
- startex1.txt
- --------------------------------------------------------------------------------
-
- Task: This macro sets system parameters (level, color,
- view, mask, pen, line type, line width, text, note
- height, aspect, angle, dimension height, dimension
- scale) according to a user-selected example entity.
-
- This macro executes its task in association with the
- following files:
-
- ex1.txt
- dimchg.txt
- dimht.txt
- dimscl.txt
- endex1.txt
- exampl1.cdl
-
- This set of programs shows a technique of how to
- communicate bidirectionally between CADL programs
- and macros.
-
- In essence, this demonstrates CADL's ability to use
- macros as if they were subroutines -- an extremely
- useful tool!
-
- How to use: FILES - MACROS - LIBRARY - TXT-IN, enter: startex1
- FILES - MACROS - LIBRARY - LST/EXE, select: startex1
-
- or: CTRL-E, enter: startex1
-
- Select the example entity.
-
-
- --------------------------------------------------------------------------------
- tbox.cdl
- --------------------------------------------------------------------------------
-
- Task: This program allows you to write text into pre-defined
- locations in a title block. To do this, you create a
- template file that defines the field name, text size,
- text height, aspect ratio, font, and pen number for
- each one of the fields in the title block. The
- template file is an ASCII file stored in the CADKEY's
- main directory.
-
- This program displays a menu that allows you to select:
-
- 1. Create Template: Allows you to define the
- field positions, widths,
- and text attributes.
-
- 2. Append Field: Allows you to append new
- fields to a template file.
-
- 3. Modify Field: Allows you to modify
- parameters in a single field
- of a template file.
-
- 4. Write Field: Allows you to write a
- single field to the
- title block.
-
- 5. Write Template: Writes the entire title
- block using the default
- text in each one of the
- fields of the template file.
-
- An efficient way to use this program is to edit
- the default text fields in the template file, and
- then to write the entire title block using the
- Write Template option.
-
- How to use: FILES - CADL - EXECUTE, enter: tbox
-
-
- --------------------------------------------------------------------------------
- winmgr.cdl
- --------------------------------------------------------------------------------
-
- Task: This program allows you to create and manage (add
- or delete) additional view-dependent windows of a
- part in CADKEY 3 beyond the capability of two windows
- that you can currently create using ALT-W and ALT-B.
-
- Note: This program, along with its accompanying macro
- PICT1.TXT, is particularly useful for large part
- files. It eliminates the need to change view,
- autoscale, and window to create a new window of
- a section of the part. The macro PICT1.TXT can
- be used as an immediate mode command. To increase
- speed, bind PICT1.TXT to a keystroke.
-
- How to use: FILES - CADL - EXECUTE, enter: winmgr
-
- Select the window-manager option:
-
- ADD
- DELETE
- INITIAL (Initialize)
-
- Suggested procedure for use:
-
- Step 1. Select INITIAL to clear the stack of
- windows.
-
- Step 2. Select ADD to create and store new
- windows.
-
- Step 3. To use the windows, use the immediate-
- mode command CTRL-E, and enter PICT1.
- Then, enter the desired window number.
-
- Credit: WINMGR.CDL and PICT1.TXT were designed and written
- by Robert Bean of Baystate Technologies, Worcester,
- Massachusetts.
-
-
- --------------------------------------------------------------------------------
- sc.cdl
- --------------------------------------------------------------------------------
-
- Task: This program sets all the CADKEY view ports to the
- same scale, and it centers the part displayed in
- each view port.
-
- How to use: FILES - CADL - EXECUTE, enter: sc
-
- Enter the scale factor for the view ports.
-
-
- --------------------------------------------------------------------------------
- tubecl.cdl
- --------------------------------------------------------------------------------
-
- Task: This program allows you to define the 3-D centerline
- of a tube through a set of user-specified control
- points and bend radii. You can choose to specify a
- bend radius that will be common to all bends in the
- tube, or to specify each bend radius individually.
-
- Note: You can indicate the control points on the screen with
- the position menu and cursor, or by reading them from
- an ASCII file.
-
- If all the bends have a common radius, the format of
- the file is:
-
- X1, Y1, Z1
- X2, Y2, Z2
- Xn, Yn, Zn
-
- If the bends have different radii, the file format is:
-
- X1, Y1, Z1
- X2, Y2, Z2
- R1, X3, Y3, Z3
- R2, X4, Y4, Z4
- R(n-2), Xn, Yn, Zn
-
- The centerline proceeds in a linear progression from
- its starting point to its ending point. This means
- that the end-point of any entity (line or arc) in the
- centerline coincides with the start-point of the
- following entity, except for the last entity.
-
- TUBECL.CDL was originally donated as free-of-charge
- shareware to the CADKEY Forum on the CompuServe (R)
- Information Service.
-
-
- How to use: FILES - CADL - EXECUTE, enter: tubecl
-
-
- --------------------------------------------------------------------------------
- cstube.cdl
- --------------------------------------------------------------------------------
-
- Task: This program creates a CADL file that serves as
- input to CADKEY SOLIDS which creates a solid
- representation of the tube.
-
- Note: The centerline created by TUBECL.CDL serves as the
- input to CSTUBE.CDL. The chain of the centerline's
- lines and arcs that you specify in CSTUBE must start
- at the same point and proceed in the same sequence as
- it was created by TUBECL.
-
- CSTUBE.CDL was originally donated as free-of-charge
- shareware to the CADKEY Forum on the CompuServe (R)
- Information Service.
-
-
- How to use: FILES - CADL - EXECUTE, enter: cstube
-
-
- --------------------------------------------------------------------------------
- tubedge.cdl
- --------------------------------------------------------------------------------
-
- Task: This program generates an edge view of a tube.
-
- Note: Creating this edge view is quite complex, especially
- for inside bends.
-
- The centerline created by TUBECL.CDL serves as the input
- to TUBEDGE.CDL. The chain of the centerline's
- lines and arcs that you specify in TUBEDGE must start
- at the same point and proceed in the same sequence as
- it was created by TUBECL.
-
- WARNING: STORE YOUR PART FILE BEFORE RUNNING TUBEDGE. TUBEDGE
- is still in development and may contain errors.
-
- TUBEDGE.CDL was originally donated as free-of-charge
- shareware to the CADKEY Forum on the CompuServe (R)
- Information Service.
-
- How to use: FILES - CADL - EXECUTE, enter: tubedge
-
-
- --------------------------------------------------------------------------------
- shapes.cdl
- --------------------------------------------------------------------------------
-
- Task: SHAPES is a group of CADL programs that allows you
- to create shapes parametrically in a CADKEY part
- file.
-
- Notes: Icons help you to select the specific CADL program
- that will generate the desired shape. Icons also
- display the variables (dimensions) that you must
- supply to the CADL program to create the shape.
-
- SHAPES was originally donated as free-of-charge
- shareware to the CADKEY Forum on the CompuServe (R)
- Information Service.
-
- Introduction: SHAPES is a framework that you may take as an example
- of how to integrate CADL programs into a single
- structure. You may also adapt SHAPES to their own
- needs. All of the shapes currently available in
- SHAPES are two-dimensional. However, SHAPES can
- easily be extended into three dimensions to create
- such shapes as bolts, nuts, clamps, etc.
-
- SHAPES is essentially composed of a main file,
- SHAPES.CDL, and two subroutine files, SH_SCRN.CDL and
- RESTORE.CDL, plus a variety of CADL icon files which
- define the shapes that they represent.
-
- SHAPES provides two levels of icons for creating each
- geometric shape, an icon for the SHAPES menu and an
- icon that identifies the parameters that you must
- specify in order to create the shape in a part file.
-
- SHAPES.CDL displays icons on the screen and calls a
- specific, shape-defining CADL file when you select a
- particular icon with the cursor. The CADL file that
- corresponds to the selected icon will actually create
- the shape once you have entered the necessary
- parameters.
-
- Example: If you are designing a part in CADKEY 3 and need to
- create an oval, SHAPES can help you. Using the
- command sequence, FILES, CADL, EXECUTE, the screen
- prompts you for a file name. Enter SHAPES.
-
- The screen displays the SHAPES icon menu. One of the
- icons that you see is an oval. Select this icon with
- the cursor. The screen displays that icon by itself
- with labels identifying the dimensions that you must
- specify to enter the geometry represented by that
- icon into your part file.
-
- The bottom of the screen also displays a prompt line
- referring to the first dimension's name and giving a
- default value for that dimension. Enter the data
- required for each dimension: length, width, radius
- and angle. The screen now prompts you for the
- location in which you want the oval placed in your
- part file.
-
- After you enter the required data, CADKEY creates the
- oval in the location that you specified.
-
- You may choose to display the oval's center lines and
- to enter that same geometry in another location. If
- you prefer to enter a different shape, use BACKUP
- (F10) or <ESC> to exit from the CADL file for
- defining an oval. The screen displays the icon menu
- again. You can select another icon, activating the
- CADL file that it represents to create and insert a
- new shape into your part file, such as a rounded slot,
- a radial slot, a sharp-cornered-rounded slot, or an
- open-ended slot. Or, you may use <ESC> to exit SHAPES
- and return to your part file.
-
- This section of the README35.DOC file focuses on two
- questions:
-
- 1. How does SHAPES work?
- 2. How do I use SHAPES?
-
- How it works: SHAPES.CDL sets the initial variables for the icons
- to be displayed, then displays the icon menu by
- calling the subroutine SHSCREEN.CDL. The icons that
- are displayed represent shape-defining CADL files
- which SH_SCRN.CDL calls as subroutines. You can
- customize SHAPES by adding your own, specific,
- geometry-defining CADL file to the list of
- subroutines in SH_SCRN.CDL, and by identifying in
- SHAPES.CDL the menu position in which you want the
- icon to be displayed. RESTORE.CDL restores the
- original variables defined by SHAPES.CDL.
-
- SHAPES' current icon menu is a matrix containing 16
- squares. (The number of squares in the menu can be
- modified as needed. The procedure for modifying the
- menu will be described in the next paragraph.) The
- position of each square is identified by the column
- and row in which it is located. The columns are
- numbered from left to right: 1, 2, 3, 4. The rows
- are numbered from bottom to top: 1, 2, 3, 4. The
- name of each square in the matrix is a combination of
- that square's column number and row number, beginning
- with "pos11" in the lower left corner, as illustrated
- below:
-
- ---------------------------------
- | | | | |
- | pos14 | pos24 | pos34 | pos44 |
- | | | | |
- |-------------------------------|
- | | | | |
- | pos13 | pos23 | pos33 | pos43 |
- | | | | |
- |-------------------------------|
- | | | | |
- | pos12 | pos22 | pos32 | pos42 |
- | | | | |
- |-------------------------------|
- | | | | |
- | pos11 | pos21 | pos31 | pos41 |
- | | | | |
- ---------------------------------
-
- How to adapt SHAPES' icon menu does not have to be a matrix of
- SHAPES to four columns and four rows. To change the matrix
- your needs: of the icon menu requires three steps. First, you
- must define new values to replace the current
- values specified in SHAPES.CDL for the number of
- columns and for the number of rows in the matrix.
- For example, if the number of columns were six, and
- the number of rows were five, the icon menu's matrix
- would contain thirty squares into which you could
- display icons. After you have changed the values
- for the number of columns and rows, you must adjust
- the number of positions in each column specified in
- SHAPES.CDL to reflect the new number of squares in
- each column of the matrix in which you may display
- an icon. Then, you must change the scale factor in
- each of the CADL icon files that are already listed
- as subroutines in SH_SCRN.CDL so that each icon will
- be displayed properly in the modified icon-menu
- matrix. (All the CADL files on this diskette whose
- names follow the pattern SH_xxx.CDL or I_xxx.CDL are
- subroutines of SHAPES. The names of the icon files
- follow the pattern I_xxx.CDL.) It is necessary to
- enter each icon file and change the scale factor
- individually because these icon files do not have the
- same scale factor for display.
-
- Some of the current CADL icon files listed in
- SH_SCRN.CDL are:
-
- I_OPNSL.CDL - an open slot composed of two
- parallel lines closed at one
- end by an arc.
-
- I_RNDSL.CDL - a round slot composed of two
- parallel lines closed by two
- arcs.
-
- I_SHRPSL.CDL - a sharp-cornered slot composed
- of two parallel lines closed
- by two arcs.
-
- I_RADSL.CDL - a radial slot composed of two
- parallel arcs closed by two
- arcs.
-
- I-OVAL.CDL - an oval.
-
- How to use: FILES - CADL - EXECUTE, enter: shapes
-
- After the screen has displayed the SHAPES menu,
- select the icon that you want with the cursor.
- You may use a mouse or the arrow-direction keys on
- the keyboard to move the cursor into the square
- containing the desired icon. As long as the cursor
- is inside the square, it will select the CADL file
- represented by the icon in that square.
-
- After you have selected the icon from the menu, the
- screen displays the icon with labels identifying the
- different dimensions that you must specify to enter
- the geometry represented by that icon into your part
- file. The bottom of the screen also displays a
- prompt referring to the the dimension's name and
- giving a default value for that dimension. Enter the
- required data.
-
- The screen prompts you for the location in which you
- want the geometry placed in your part file. Enter
- the location.
-
- CADKEY creates the geometry in your part file in the
- location that you have specified.
-
- The screen now asks whether you want the geometry's
- centerlines. The default answer is YES.
-
- After this, you can place this geometry in another
- location if you want to do so.
-
- If you prefer to enter a different shape into the
- part file, use BACKUP or ESCAPE to exit from the
- CADL file represented by the icon that you had
- selected.
-
- The screen displays the icon menu again. You can
- select another icon, activating the CADL file that
- it represents, and repeat the process described
- above.
-
- Or, you can exit SHAPES.
-
- To exit SHAPES, use <ESC>.
-
- You are now back in your part file in CADKEY.
-