Returns date and time in the following format: '26-Oct-85 10:26:58'.
-->(DA_DB_ADD)---|part name|---(CONFIRM)--->
DA_DB_ADD inserts a new part into the dimensioning database. Identify the part to be added by a pick or by its part name.
-->(DA_DB_DELETE)---|part name|---(CONFIRM)--->
The DA_DB_DELETE command removes a selected entry from the dimension database. The table entry is selected by picking or by entering its name.
-->(DA_DB_EXPORT)---|part name|---(CONFIRM)--->
The DA_DB_EXPORT command copies a selected entry from the dimensioning database into the current drawing. The copied entry becomes a new part in the current drawing.
A common application for DA_DB_EXPORT is to edit an entry in the dimensioning database. To edit a database entry, export it into the current drawing, edit the exported geometry, then ADD it back into the database.
--->(DA_DB_INQ)------>
DA_DB_INQ is used with the INQ function to return information about the dimension database. This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not recommended for interactive use.
DA_DB_INQ sets the following values in the INQ system array. The inquiry code must be 1.
+-------------------------------------------------------------------------+ || | result | |------------+-------------+----------------------------------------------| | 1 | 1 | assignment style: copy (1) or current (0) | | | 2 | port number of dimension database viewport | | | 301 | name of the dimension database top part | +-------------------------------------------------------------------------+
--->(DA_DB_LOAD)---|filename|--->
DA_DB_LOAD loads a dimension database from the named file into memory. The file must be an MI-format file, and should have been created with the STORE option on the DIMENSION 2 screen menu of the dimension advisor.
--->(DA_DB_LOC_SCALE)--+--|ON|--+--->
| |
+--|OFF|-+
DA_DB_LOC_SCALE enables/disables scaling of dimension geometry during dimensioning assignment from the dimensioning database.
When set ON (the default), dimension geometry is scaled as necessary to maintain the same relative dimensioning distances (offsets, extension-line lengths, etc.) in the drawing as are found in the database entry. When set OFF, dimensioning distances are not scaled, so the distances used in the database entry will be assigned to the drawing.
+---------------------<---------------------+
| |
--->(DA_DB_MATCH)--+-->|part name|---|ref_pnt|---|target_pnt|--+-->
DA_DB_MATCH transfers dimensioning from a part in the dimensioning database to the current drawing. The part name must refer to a part that is included in the dimensioning database. The ref_pnt identifies an element on this part, and the target_pnt identifies a topologically analogous part on the current drawing. Once the target_pnt is given, the dimensioning on the database part is transferred to the current drawing.
The overall topology and part structure of the database part and the current drawing must be similar or unexpected results may occur.
Once a reference element has been selected and matched, it cannot be used for further matching operations for the duration of the command.
Before adding the drawing to the database make sure that
If you select a reference and the element you should select left or right side of it and not the vertex.
-->(DA_DB_STORE)---|filename|---(CONFIRM)--->
DA_DB_STORE saves the current dimension database to a named file.
--->(DA_DB_UNLOAD)---|confirm|--->
DA_DB_UNLOAD unloads the current dimensioning database from memory. This function requires confirmation.
--->(DA_DB_WIN_CREATE)--->
DA_DB_WIN_CREATE creates a viewport to display the dimensioning dbase. The window is created at size and location given by DA_DB_WIN_LOC.
This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
--->(DA_DB_WIN_LOC)---|corner point|---|opposite corner point|--->
DA_DB_WIN_LOC sets the location for the dimension database window in the dimension advisor module.
This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
The DA_DIMENSION keyword allows you to browse the system help file for information about the commands and functions of the dimension advisor module. To browse for information on the standard dimensioning commands and functions use HELP DIMENSION.
For help with dimensioning, use HELP with a specific command, or HELP DA_DIMENSION, which brings you to this entry in the help system, followed by the N (Next) command, which will take you to related commands.
A dimension is always associated with one or more ELEMENTS (such as lines or arcs) and NEVER to VERTICES only. Picking a vertex directly causes the dimension to be associated randomly to one of the ELEMENTS at the vertex. If any of the ELEMENTS a dimension is associated with is removed through deletion or modification, then the dimension will also be deleted. When the ELEMENTS are modified, the dimension value automatically adjusts to reflect the modification. The location of the dimensions is always indicated in the middle of their text box.
+-----------------------------<---------------------------+
| |
->(DA_DIM_ANGLE)-+-+-+--+-(DIRECT)-+--+--|line1|-|line2|--{1}-+-+--------+-+-->
| | v ^ | | | |
| | '---->-----' | | +-(UNDO)-+
| | | |
| +---(OPPOSITE)---+ |
| | | |
| +-(ADJACENT_POS)-+ |
| | | |
| +-(ADJACENT_NEG)-+ |
| |
| |
+-+-(MANUAL)-+-------|select|-------{1}----+
| v ^ |
| '---->-----' |
| |
+---(AUTO)-----------|select|--------------+
{1}-->--+------------+--|loc_pnt|-->
| |
+-|snap_pnt|-+
DA_DIM_ANGLE creates angle dimensions. To dimension a single pair of lines, you identify each line, then give a location point for the dimension text. The lines must not be parallel and the location point must not be at the intersection of the two lines.
To specify how the two arms of an angle should be dimensioned use the following options:
DIRECT OPPOSITE ADJACENT_POS ADJACENT_NEG
The four different positions are:
DIRECT
\ /
.2 .1
\ /
\ /
ADJACENT_POS \ / ADJACENT_NEG
\/
OPPOSITE
Multiple line-pairs may be selected for dimensioning via the SELECT option or by boxing. Two restrictions apply when multiple line-pairs are selected:
1. Only line-pairs that intersect will be selected.
2. Only direct dimensioning can be used when multiple line-pairs are selected.
If another angle dimension already exists in the drawing, you can identify a snap-point to help locate subsequent angle dimensions. The snap-point identifies an existing angle dimension with which subsequent dimensions can be aligned.
While assigning an angle dimension in MANUAL mode, place the snap_pnt on the text of an existing angle dimension; the dimension you are currently assigning will now be constrained to be either stacked atop that dimension (much like a datum stack), or to stay in the same circle as that dimension (much like a circular chain dimension). The snap_pnt feature works best if the angle dimension you identify shares the same intersection point as the angle dimension you are assigning.
+--------------------------------------------------------+
| |
-->(DA_DIM_ARC)--v--+----|elem_1|-----|elem_2|--|loc_pnt|--+--+--------+--+-->
| | | |
+--+-(MANUAL)-+---|select|--|loc_pnt|--+ +-(UNDO)-+
| v ^ |
| '---->-----' |
| |
+----(AUTO)-------|select|-------------+
DA_DIM_ARC creates arc dimensions.
To dimension a single arc, you identify its end points, then indicate a point for the dimension text. To dimension multiple arcs at one time, choose MANUAL or AUTO mode, then select the arcs to dimension. In MANUAL mode (the default), the dimension text for the selected arcs is placed manually, relative to loc_pnt. In AUTO mode the dimension text is placed automatically.
--->(DA_DIM_AUTO_LOC)----+--|ABOVE|--+--->
| |
+--|BELOW|--+
Determines the placement of dimensioning elements when AUTO placement mode is being used. ABOVE sets dimension placement above horizontal elements and to the right of vertical elements, BELOW sets dimension placement below horizontal elements and to the left of verticals. ABOVE is the default.
--->(DA_DIM_AUTO_STRATEGY)---|check_level|--->
When auto placement mode is used to position dimensioning elements, the system can perform intersection testing to help ensure that new or repositioned dimensioning will not overlap existing drawing elements.
DA_DIM_AUTO_STRATEGY specifies the level of intersection checking that is done by the system. "check_level" can have a value of 0, 1, 2, or 3:
0: Disables intersection testing.
1: Ensure that the center and ends of the text box for the dimension being
placed do not intersect with other geometry at the proposed location.
2: Perform the level 1 check, then at the suggested location, re-check for
intersections with other geometry along the measure direction of the
new dimension. If an intersection is found, try a new location and
re-check.
3: Perform the level 2 check, then at the suggested location, check that
text box of the proposed dimension does not intersect the dimension
lines or extension lines of other dimensions. If an intersection is
found, try a new location and re-check. Level 3 is the default.
The accuracy of the check -- and the time needed for checking -- increases at each level.
+--------------------------------------------+
| |
-->(DA_DIM_CHAIN)-----v------{1}----+----{2}--+-------+--------+---+-->
| | | |
+----{3}--+ +-(UNDO)-+
{1}--->--------------------------------+---->
| |
+->-(HORIZONTAL)-----------------+
| |
+->-(VERTICAL)-------------------+
| |
+->-(PARALLEL)-------------------+
| |
+->-(PERPEND_TO_LINE)---|line|---+
| |
+->-(PARALLEL_TO_LINE)--|line|---+
{2}-->-+(AUTO)+-|beg_elem|-+-|end_elem|--|loc_pnt|-+----+------->-------+-->
v ^ | | v ^
'------' +-|select|->-|refline*|-+ | +-----<-----+ |
| | | |
+-+->|select|-+-+
{3}->(MANUAL)--|beg_elem|-+-|end_elem|-+-|loc_pnt|-+------------>------------+->
,____| |_____, v ^
| | | +----------<----------+ |
+-|select|->-|refline*|-+ | | | |
+-+->|select|-|loc_pnt|-+-+
DA_DIM_CHAIN creates chain dimensioning.
The dimension between any two points may be horizontal, vertical, parallel to the direction specified between beg_elem and end_elem, or perpendicular/parallel to a reference line. The default is PARALLEL. Orientation can be specified before the first element, before the second element or before the location point. UNDO removes the dimension element most recently created.
With both MANUAL and AUTO, beg_elem and end_elem are the begin and end points of the dimension, and loc_pnt is the location of the dimension line. With AUTO (the default), you give loc_pnt only once; the system then automatically chooses the loc_pnt for subsequent dimensions. With MANUAL, you give an loc_pnt for each dimension. It is possible to mix AUTO and MANUAL within the same command.
After selecting beg_elem, multiple drawing elements may be selected for dimensioning, either with SELECT or by enclosing them in a box. In this case, the system generates dimensions for all the selected elements at once. If AUTO is active, the system automatically places dimensions for the selected elements. If MANUAL is active, dimensions for the selected elements are all placed relative to a single loc_pnt.
+----------------------<------------------------------+
| |
-->(DA_DIM_CHAMFER)--v--+----|chamfer|---|loc_pnt|-----------+--+--------+-+-->
| | | |
+--+-(MANUAL)-+--|select|-|loc_pnt|--+ +-(UNDO)-+
| v ^ |
| '---->-----' |
| |
+----(AUTO)------|select|------------+
DA_DIM_CHAMFER creates chamfer dimensions.
To dimension a single chamfer, identify it and then indicate a point for the dimension. The chamfer dimension is preceded by the character C. (The chamfer dimension meets JIS standards and the text orientation is always parallel.) To dimension several chamfers at once, choose MANUAL or AUTO mode, then select the chamfers to dimension. In MANUAL mode (the default), the dimension text for the selected chamfers is placed manually, relative to loc_pnt. In AUTO mode the dimension text is placed automatically.
The DA_DIM_CHAMFER command only applies to chamfers that have an angle of 45 degrees with adjacent lines, or blended with single 45-degree arcs or fillets.
+--------------------<---------------+
| |
-->(DA_DIM_COORD)----{1}--v---{2}--+--{3}--+------+--------+---+-->
| | | |
+--{4}--+ +-(UNDO)-+
{1}--->-----------------+---->
| |
+-(ANSI)----------+
| |
+-(DIN)-----------+
| |
+-(ISO)-----------+
| |
+-(JIS)-----------+
| |
+-(NO_STANDARD)---+
{2}--->--------------------------------+---->
| |
+-(HORIZONTAL)-------------------+
| |
+-(VERTICAL)---------------------+
| |
+-(PARALLEL)---------------------+
| |
+(PERPEND_TO_LINE)---|line|------+
| |
+(PARALLEL_TO_LINE)--|line|------+
{3}-->-+(AUTO)+-{5}-+-|end_elem|--|loc_pnt|-+--{6}--+------->-------+-->
v ^ | | v ^
'------' +-|select|->-|refline*|-+ | +-----<-----+ |
| | | |
+-+->|select|-+-+
{4}->(MANUAL)--{5}-+-|end_elem|-+-|loc_pnt|--{6}--+------------>------------+->
,____| |_____, v ^
| | | +----------<----------+ |
+-|select|->-|refline*|-+ | | | |
+-+->|select|-|loc_pnt|-+-+
{5}->-+-------------|beg_elem|------------+->
| |
+-(HIDDEN_ZERO_POINT)->-|start_loc|-+
{6}->-+------->---------+->
| |
+-|dim_line_loc*|-+
DA_DIM_COORD creates coordinate dimensioning.
The dimension between any two points may be horizontal, vertical, parallel to the direction specified between beg_elem and end_elem or perpendicular/parallel to a reference line. The default is PARALLEL. Orientation can be specified before the first element, before the second element or before the location point. See also DIM_DATUM_STEP to define the datum step. Use MANUAL to locate the dimension texts manually (default is AUTO).
With both MANUAL and AUTO, beg_elem and end_elem are the begin and end points of the dimension, and loc_pnt is the location of the dimension line. With AUTO (the default), you give loc_pnt only once; the system then automatically chooses the loc_pnt for subsequent dimensions. With MANUAL, you give an loc_pnt for each dimension. It is possible to mix AUTO and MANUAL within the same command.
After selecting beg_elem, multiple drawing elements may be selected for dimensioning, either with SELECT or by enclosing them in a box. In this case, the system generates dimensions for all the selected elements at once. If AUTO is active, the system automatically places dimensions for the selected elements. If MANUAL is active, dimensions for the selected elements are all placed relative to a single loc_pnt.
A standard style for coordinate dimensioning can be selected:
You can change the arrows by the SELECT_DIM_ARROW function as long as the DIM_COORD command is active. The system keeps the arrow setting for coordinate dimensions independent of the arrows set for the other dimension types.
The HIDDEN_ZERO_POINT qualifier changes the behaviour of the coordinate dimensions so that they don't have to start on an existing element. Insted, start_loc specifies the coordinates of the "virtual" point where the dimensioning starts. The dimension values are calculated as if an element existed at that point.
Such dimensions have some additional features:
+-------------------<-----------+
| |
->(DA_DIM_DATUM_LONG)---v--->-{1}-+-{2}-+--+--------+---+-->
| | | |
+-{3}-+ +-(UNDO)-+
{1}--->--------------------------------+---->
| |
+->-(HORIZONTAL)-----------------+
| |
+->-(VERTICAL)-------------------+
| |
+->-(PARALLEL)-------------------+
| |
+->-(PERPEND_TO_LINE)---|line|---+
| |
+->-(PARALLEL_TO_LINE)--|line|---+
+-----------------------<--------------------+
| |
{2}-->-+-(AUTO)-+-|beg_elem|--v--+----------+---+-|end_elem|-|loc_pnt|--+--+-->
v ^ | | | |
'--------' +-(CENTER)-+ +-|end_elem|------>-----+
| | | |
+-(ALIGN)--+ +-|select|->-|refline*|-+
| |
+-|select|-------->-----+
+------------------------<-----------------------+
| |
{3}-->(MANUAL)-|beg_elem|-v-+--------+---+-|end_elem|----------+-|loc_pnt|-+-->
| | | |
+(CENTER)+ +-|select|-|refline*|-+
| | | |
+(ALIGN)-+ +-|select|------------+
* refline only required for PARALLEL option.
DA_DIM_DATUM_LONG creates datum dimensioning with long base lines.
The dimension between any two points may be horizontal, vertical, parallel to the direction specified between beg_elem and end_elem or perpendicular/parallel to a reference line identified. The default is PARALLEL. Orientation can be specified before the first element, before the second element or before the location point.
Beg_elem and end_elem are the begin and end points of the dimension, and loc_pnt is the location of the dimension line. With AUTO (the default), you give loc_pnt only once; the system then automatically chooses the loc_pnt for subsequent dimensions. With MANUAL, you give an loc_pnt for each dimension. It is possible to mix AUTO and MANUAL within the same command.
After selecting beg_elem, multiple drawing elements may be selected for dimensioning, either with SELECT or by enclosing them in a box. In this case, the system generates dimensions for all the selected elements at once. If AUTO is active, the system automatically places dimensions for the selected elements. If MANUAL is active, dimensions for the selected elements are all placed relative to a user-supplied loc_pnt.
The relative position of dimension text for the selected elements can be set with the CENTER and ALIGN options. If CENTER is selected, dimension texts are centered on their respective dimension lines. If ALIGN is selected, dimension texts are left-aligned with one another. CENTER and ALIGN only apply to groups of elements identified with SELECT or by boxing. CENTER is the default mode.
The syntax of DA_DIM_DATUM_LONG_SYM is equivalent to that of DA_DATUM_LONG.
DA_DIM_DATUM_LONG_SYM creates symmetry-style datum dimensioning with long base lines. The first dimension point is assumed to be on a symmetry line. No extension line or line terminator is drawn for that element, and the dimension text value is doubled to indicate that the dimension represents both sides of the symmetry line.
For example:
|
------- 10 ------>|
|
|
| |
-------------------|-------------------
| | |
| | <- symmetry line |
| | |
| | |
-------------------|-------------------
|
+----------------------------<----------------+
| |
-->(DA_DIM_DATUM_SHORT)----v-------{1}----+----{2}--+-------+--------+---+-->
| | | |
+----{3}--+ +-(UNDO)-+
{1}--->--------------------------------+---->
| |
+->-(HORIZONTAL)-----------------+
| |
+->-(VERTICAL)-------------------+
| |
+->-(PARALLEL)-------------------+
| |
+->-(PERPEND_TO_LINE)---|line|---+
| |
+->-(PARALLEL_TO_LINE)--|line|---+
+--------<--------------------+
| |
{2}-->-+-(AUTO)-+-|beg_elem|--v--+-|end_elem|-|loc_pnt|--+--+-->
v ^ | |
'--------' +-|end_elem|------>-----+
| |
+-|select|->-|refline*|-+
| |
+-|select|-------->-----+
+------------<-------------------------+
| |
{3}-->--(MANUAL)--|beg_elem|--v--+-|end_elem|----------+--|loc_pnt|--+-->
| |
+-|select|-|refline*|-+
| |
+-|select|------------+
* refline only required for PARALLEL option.
DIM_DATUM_SHORT creates datum dimensioning with short base lines. The dimension between any two points may be horizontal, vertical, parallel to the direction specified between beg_elem and end_elem or perpendicular/parallel to a reference line identified. The default is PARALLEL. Orientation can be specified before the first element, before the second element or before the location point. See also DIM_DATUM_STEP to define the datum step. Use MANUAL to locate the dimension texts manually (default is AUTO).
With both MANUAL and AUTO, beg_elem and end_elem are the begin and end points of the first dimension segment, and loc_pnt is the location of the dimension line. With AUTO (the default), you give loc_pnt only once; the system then automatically chooses the loc_pnt for subsequent dimensions. With MANUAL, you give an loc_pnt for each dimension. It is possible to mix AUTO and MANUAL within the same command.
After selecting beg_elem, multiple drawing elements may be selected for dimensioning, either with SELECT or by enclosing them in a box. In this case, the system generates dimensions for all the selected elements at once. If AUTO is active, the system automatically places dimensions for the selected elements. If MANUAL is active, dimensions for the selected elements are all placed relative to a single loc_pnt.
+-----------<-----------+
| |
--->(DA_DIM_DELETE)----+--|NO_CHECK|--+---+-|select|--+--------+--+--->
| | | |
+---|CHECK|----+ +-(UNDO)-+
DA_DIM_DELETE deletes selected dimensioning elements. It can also delete individual segments from an existing datum or chain dimension, adjusting the stack or chain spacing as needed.
The datum stack or chain spacing will be adjusted to account for the removed segment. If CHECK is selected, an interference check is performed to ensure that the new spacing does not cause the dimension to intersect with existing geometry. By default, no interference check is performed (NO_CHECK).
+----------------------<--------------------+
| |
-->(DA_DIM_DIAMETER)--v--+--------------------+--{1}--+--------+--+--->
| | | |
+-(CENTER_LINE)----+ +-(UNDO)-+
| |
+-(NO_CENTER_LINE)-+
{1}-->--+----|elem|-----------------|loc_pnt|--+--->
| |
+--+-(MANUAL)-+---|select|--|loc_pnt|--+
| v ^ |
| '---->-----' |
| |
+----(AUTO)-------|select|-------------+
DA_DIM_DIAMETER creates a diameter dimension.
First identify a circle, arc, or fillet, then indicate the dimension text location. If multiple drawing elements are selected, MANUAL mode allows the dimension texts for all these elements to be placed manually, relative to loc_pnt. AUTO mode causes the dimension texts to be placed automatically. Option CENTER_LINE (and NO_CENTER_LINE respectively) allows the dimension line to be drawn fully across the circular element or not. The 'loc_pnt' must not be at the center of the circular element. Default is CENTER_LINE.
+---------------------<--------------+
| |
--->(DA_DIM_DTAN)------v----{1}---{2}--+-{3}-+--+--------+---+--->
| | | |
+-{4}-+ +-(UNDO)-+
{1}--->------------------------------+---->
| |
+-(INCLINED)-----|inclination|-+
| |
+-(HORIZONTAL)-----------------+
| |
+-(VERTICAL)-------------------+
| |
+-(PERPEND_TO_LINE)---|line|---+
| |
+-(PARALLEL_TO_LINE)--|line|---+
| |
+-(PARALLEL)-------------------+
{2}--->---------------------+---->
| |
+-(EXTENSION_LINE)----+
| |
+-(NO_EXTENSION_LINE)-+
{3}->-+(MANUAL)+---+---->---|first_elem|--->---|second_elm|--->---|loc_pnt|--+-->
v ^ | |
'--->----' +--->--->|selection|----------------------->|loc_pnt|-----+
{4}->--(AUTO)-----+--->--->|first_elem|--->--->|second_elm|--->---------------+-->
| |
+--->--->|selection|----------------------------------------+
DA_DIM_DTAN creates one or more tangential dimensions on circles, arcs and fillets. One circular element can be replaced by a line.
If two elements are selected by clicking, the tangential dimension between them may be horizontal, vertical, inclined to horizontal plane, perpendicular/parallel to a identified reference line or parallel to the line through centers of both elements. The default orientation is INCLINED. If INCLINED is specified before both elements are specified, inclination is specified as number. If INCLINED is specified after both elements are specified or taken by default, inclination can also be specified using feedback. The dimension text is placed at 'loc_pnt'.
If multiple drawing elements are selected for dimensioning (either with SELECT or by boxing), dimensions are created between circular elements. Dimension between two elements is created if line through both centers is parallel to the measuring direction. The orientation options affect the position of all these dimensions. The dimension text for all elements will be placed automatically if AUTO is selected. If MANUAL is selected, the text for all dimensions will be placed relative to 'loc_pnt'.
+------------------<------------------+
| |
-->(DA_DIM_GEO_SENSE)--+-----{1}----|select|-----+--------+--+--->
| |
+-(UNDO)-+
{1}-->--+---------------+--+-----------------+----------------------+--->
| | | | | |
+-(NO_ARC_DIMS)-+ +-(RADIUS_DIMS)---+ +-(NO_CHAMFER_DIMS)-+
| | | | | |
+-(ARC_DIMS)----+ +-(DIAMETER_DIMS)-+ +-(CHAMFER_DIMS)----+
DA_DIM_GEO_SENSE assigns dimensions to a selected group of geometric elements. The type and location of the dimensions is determined automatically by the system. If the ARC_DIMS option is set, arc dimensions will be generated for any arc elements, including fillets, found in the selection set. By default, arc dimensions are not generated for these elements (NO_ARC_DIMS).
If the CHAMFER_DIMS option is set, chamfer dimensions will be generated for chamfers found in the selection set. By default, chamfer dimensions are not generated for these elements (NO_CHAMFER_DIMS).
Circular elements found in the selection set will be given radius or diameter dimensions depending on whether RADIUS_DIMS or DIAMETER_DIMS is selected. RADIUS_DIMS is the default.
-->(DA_DIM_HOLE_INSERTION)----+--(ON)---+---->
| |
+--(OFF)--+
This switch is important if a new dimension is created, where its dimension text is located inside a hatched area. If DA_DIM_HOLE_INSERTION is ON, a hole will be automatically created, i.e. the dimension will become an inner contour of the hatch. If you do not want creation of holes, switch DA_DIM_HOLE_INSERTION to OFF.
-->(DA_DIM_INCLINE)---->----(selection)---->
Using this command a dimension with HORIZONTAL or VERTICAL attribute, can be changed to a INCLINE type. This facilitates rotation of a dimension, without changing the dimension values.
+---------------------<--------------------+
| |
--->(DA_DIM_INSERT)---v--+--+-|NO_CHECK|-+--+--|id_pnt|--|elem|--+--->
| v ^ |
| '----->------' |
| |
+-----|CHECK|------+
DA_DIM_INSERT inserts a new dimension point into an existing datum or chain dimension, adjusting the stack or chain spacing as needed.
First identify the datum stack or chain by picking the dimension text of any one of its members, then identify the new dimension point.
The datum stack or chain spacing will be adjusted to accommodate the new segment. If CHECK is selected, an interference check is performed to ensure that the new spacing does not cause the dimension to intersect with existing geometry. By default, no interference check is performed (NO_CHECK).
+--------------<--------------+
| |
--->(DA_DIM_LINE)---{1}--------v--{2}--+-{3}-+--+--------+---+--->
| | | |
+-{4}-+ +-(UNDO)-+
{1}--->------------------------------+---->
| |
+-(HORIZONTAL)-----------------+
| |
+-(VERTICAL)-------------------+
| |
+-(PARALLEL)--+---->------+----+
| | | |
| +->-|angle|-+ |
| |
+-(PERPEND_TO_LINE)---|line|---+
| |
+-(PARALLEL_TO_LINE)--|line|---+
{2}--->---------------------+---->
| |
+-(EXTENSION_LINE)----+
| |
+-(NO_EXTENSION_LINE)-+
{3}->-+(MANUAL)+--+-+->-+->|beg_elem|-+->-+->|end_elm|-+->-+->|loc_pnt|--+-->
v ^ | | | | | | | |
'--->----' | +{5}+ +{5}+ +{5}+ |
| |
+-+->-+->|selection|----------------------->|loc_pnt|--+
| |
+{5}+
{4}->--(AUTO)-----+-+->-+->|beg_elem|-+->-+->|end_elm|-+->-+->|loc_pnt|--+-->
| | | | | | | |
| +{5}+ +{5}+ +{5}+ |
| |
+-+->-+->|selection|-----------------------------------+
| |
+{5}+
{5}----->(PROJ_ANGLE)--->|angle|----->
DA_DIM_LINE creates one or more single-line dimensions.
If two dimension points are selected, the dimension between them may be horizontal, vertical, parallel to the direction specified between 'beg_elem' and 'end_elem' or perpendicular/parallel to a reference line identified. The default is PARALLEL. The dimension text is placed at 'loc_pnt'.
If multiple drawing elements are selected for dimensioning (either with SELECT or by boxing), a dimension is created for each selected element. The orientation options affect the position of all these dimensions. The dimension text for all elements will be placed automatically if AUTO is selected. If MANUAL is selected, the text for all dimensions will be placed relative to 'loc_pnt'.
The angle value at the PARALLEL option is used to turn the extension lines (for example, when dimensioning isometric drawings).
EXTENSION_LINE and NO_EXTENSION_LINE control whether or not extension lines are created for each new linear dimension. Extension lines are created by default.
The syntax of DA_DIM_LINE_SYM is equivalent to that of DA_DIM_LINE.
DA_DIM_LINE_SYM creates one or more single symmetry-style dimensions. The first dimension point is assumed to be on a symmetry line. No extension line or line terminator is drawn for that element, and the dimension text value is doubled to indicate that the dimension represents both sides of the symmetry line.
For example:
|
------- 10 ------>|
|
|
| |
-------------------|-------------------
| | |
| | <- symmetry line |
| | |
| | |
-------------------|-------------------
|
+------------------------<---------------------+
| |
-->(DA_DIM_PD_SCAN)--+--+-----------------+---|select|--+--------+--+-->
| | | |
+-(RADIUS_DIMS)---+ +-(UNDO)-+
| |
+-(DIAMETER_DIMS)-+
DA_DIM_PD_SCAN assigns dimensions to a selected group of geometric elements. The type and location of the dimensions are determined from parametric constraints currently assigned to the selected elements. If no constraints are present, dimensions will not be generated.
Circular elements found in the selection set will be given radius or diameter dimensions depending on whether RADIUS_DIMS or DIAMETER_DIMS is selected. RADIUS_DIMS is the default.
+-----------------------------------------+
| |
-->(DA_DIM_RADIUS)--v--+------------------+--{1}--+--------+--+--->
| | | |
+-(CENTER_LINE)----+ +-(UNDO)-+
| |
+-(NO_CENTER_LINE)-+
{1}-->--+----|elem|-----------------|loc_pnt|--+--->
| |
+--+-(MANUAL)-+---|select|--|loc_pnt|--+
| v ^ |
| '---->-----' |
| |
+----(AUTO)-------|select|-------------+
DA_DIM_RADIUS creates radius dimensions.
First identify an arc, circle, or fillet, then indicate the dimension text location. If multiple drawing elements are selected, MANUAL mode allows the dimension texts for all these elements to be placed manually, relative to loc_pnt. AUTO mode causes the dimension texts to be placed automatically. Option CENTER_LINE (and NO_CENTER_LINE respectively) allows dimension lines to be connected to the center point or not. The loc_pnt must not be at the center of circular elements. Default is CENTER_LINE.
--->(DA_DIM_SHORT_SPACE)---|number|--->
DA_DIM_SHORT_SPACE sets the length of the dimension line for new datum short dimensions.
Example:
|
|
60 ----------->|
^ ^
"short space"
--->(DA_FILTER_ACTIVATE)--+--|ON|--+--->
| |
+--|OFF|-+
Turns the dimensioning selection filter ON or OFF. When DA_FILTER_ACTIVATE is ON, the current selection filter (see DA_FILTER_ADD) will be applied whenever multiple drawing elements are selected for dimensioning. Elements that meet the criteria of the filter will _not_ be selected. When DA_FILTER_ACTIVATE is OFF, no selection filtering is performed.
-->(DA_FILTER_ADD)---+-{1}----------------------------------------+--->
| |
+-{2}----------------------------------------+
| |
| +----<----+ |
| | | |
+-(DA_COLOR)-------+-|color|-+---------------+
| |
| +---------<-----------+ |
| | | |
+-(DA_ORIENTATION)-+-+-|lo|--|hi|------+-+---+
| | | |
| +-(DA_HORIZONTAL)-+ |
| | | |
| +-(DA_VERTICAL)---+ |
| |
| +------<-----+ |
| | | |
+-(DA_PENSIZE)-----+-|lo|--|hi|-+------------+
| |
| +------<-----+ |
| | | |
+-(DA_LINESIZE)----+-|lo|--|hi|-+------------+
+--------<-------------+
| |
{1}-->(DA_GEOTYPE)--+-+-(DA_NOT)---------+-+--->
| |
+-(DA_POINT)-------+
| |
+-(DA_LINE)--------+
| |
+-(DA_ARC)---------+
| |
+-(DA_FILLET)------+
| |
+-(DA_CIRCLE)------+
| |
+-(DA_TEXT)--------+
| |
+-(DA_SPLINE)------+
| |
+-(DA_BSPLINE)-----+
+-----------<---------------+
| |
{2}-->(DA_LINETYPE)--+-+-(DA_NOT)--------------+-+--->
| |
+-(DA_SOLID)------------+
| |
+-(DA_DASHED)-----------+
| |
+-(DA_LONG_DASHED)------+
| |
+-(DA_DOT_CENTER)-------+
| |
+-(DA_DASH_CENTER)------+
| |
+-(DA_PHANTOM)----------+
| |
+-(DA_CENTER_DASH_DASH)-+
| |
+-(DA_DOTTED)-----------+
DA_FILTER_ADD adds new entries into the dimension selection filter. This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not recommended for interactive use.
--->(DA_FILTER_CLEAR_GEOTYPES)--->
DA_FILTER_CLEAR_GEOTYPES removes all geometry-type entries from the current dimension selection filter.
--->(DA_FILTER_CLEAR_LINETYPES)--->
DA_FILTER_CLEAR_LINETYPES removes all linetype entries from the current dimension selection filter.
--->(DA_FILTER_DEL_COLOR)--+--|loc_pnt|---------+--->
| |
+->(ALL)--(CONFIRM)--+
Removes the selected color entries from the current dimension selection filter.
--->(DA_FILTER_DEL_LINESIZE)-+--|loc_pnt|---------+--->
| |
+->(ALL)--(CONFIRM)--+
Removes the selected line size entries from the current dimension selection filter.
--->(DA_FILTER_DEL_ORIENT)--+--|loc_pnt|---------+--->
| |
+->(ALL)--(CONFIRM)--+
Removes the selected orientation entries from the current dimension selection filter.
--->(DA_FILTER_DEL_PENSIZE)--+--|loc_pnt|---------+--->
| |
+->(ALL)--(CONFIRM)--+
Removes the selected pen size entries from the current dimension selection filter.
--->(DA_FILTER_INQ)---+-(DA_GEOTYPE)--------------------+---->
| |
+-(DA_LINETYPE)-------------------+
| |
+-(DA_ORIENTATION)---|entry_num|--+
| |
+-(DA_PENSIZE)-------|entry_num|--+
| |
+-(DA_LINESIZE)------|entry_num|--+
| |
+-(DA_COLOR)---------|entry_num|--+
| |
+-(DA_NUM_ENTRIES)----------------+
| |
+-(DA_FILTER_ACTIVE)--------------+
| |
+-(DA_FILTER_NAME)----------------+
DA_FILTER_INQ is used with the INQ function to return information about the dimension selection filter. This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not recommended for interactive use.
Depending on the supplied inquiry code and filter entry number (if needed), DA_FILTER_INQ can set the following information in the INQ system array:
+---------------------------------------------------------------------------+ || | result | +-----------------+---------+-----------------------------------------------+ | DA_LINETYPE | 2 | Solid linetype filter off(0) or on(1) | | | 3 | Dotted linetype filter off(0) or on(1) | | | 4 | Dashed linetype filter off(0) or on(1) | | | 5 | Long-dashed linetype filter off(0) or on(1) | | | 6 | Dot-center linetype filter off(0) or on(1) | | | 7 | Dash-center linetype filter off(0) or on(1) | | | 8 | Phantom linetype filter off(0) or on(1) | | | 9 | Center-dash-dash linetype filter off(0)/on(1) | +-----------------+---------+-----------------------------------------------+ | DA_GEOTYPE | 2 | Point geotype filter off(0) or on(1) | | | 3 | Line geotype filter off(0) or on(1) | | | 4 | Arc geotype filter off(0) or on(1) | | | 5 | Fillet geotype filter off(0) or on(1) | | | 6 | Circle geotype filter off(0) or on(1) | | | 7 | Text geotype filter off(0) or on(1) | | | 8 | Spline geotype filter off(0) or on(1) | | | 9 | Bspline geotype filter off(0) or on(1) | +-----------------+---------+-----------------------------------------------+ |DA_ORIENTATION | 2 | Lower bound for the given filter entry | | | 3 | Upper bound for the given filter entry | +-----------------+---------+-----------------------------------------------+ |DA_PENSIZE | 2 | Lower bound for the given filter entry | | | 3 | Upper bound for the given filter entry | +-----------------+---------+-----------------------------------------------+ |DA_LINESIZE | 2 | Lower bound for the given filter entry | | | 3 | Upper bound for the given filter entry | +-----------------+---------+-----------------------------------------------+ |DA_COLOR | 201 | RGB color vector for the given filter entry | +-----------------+---------+-----------------------------------------------+ |DA_NUM_ENTRIES | 2 | Number of entries in the DA_ORIENTATION filter| | | 3 | Number of entries in the DA_PENSIZE filter | | | 4 | Number of entries in the DA_COLOR filter | | | 5 | Number of entries in the DA_LINESIZE filter | +-----------------+---------+-----------------------------------------------+ |DA_FILTER_ACTIVE | 2 | Selection filtering off(0) or on(1) | +-----------------+---------+-----------------------------------------------+ |DA_FILTER_NAME | 301 | Current selection filter name | +---------------------------------------------------------------------------+
--->(DA_FILTER_REFRESH_LINESIZE)--->
DA_FILTER_REFRESH_LINESIZE updates the contents of the linesize selection filter table in the dimension advisor module. This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
--->(DA_FILTER_REFRESH_ORIENT)--->
DA_FILTER_REFRESH_ORIENT updates the contents of the orientation selection filter table in the dimension advisor module. This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
--->(DA_FILTER_REFRESH_PENSIZE)--->
DA_FILTER_REFRESH_PENSIZE updates the contents of the pensize selection filter table in the dimension advisor module. This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
--->(DA_FILTER_SET_NAME)---|string|--->
DA_FILTER_SET_NAME assigns a name to the current dimensioning selection filter.
--->(DA_FILTER_STORE)---|filename|--->
DA_FILTER_STORE writes out the current dimension selection filter to a named file. The filter is written out as a collection of macros. Use INPUT to load in the file and restore the filter.
+---------------------<----------------------------+
| |
--->(DA_MOVE_DIMENSION)-+->-+->-----------+-+-|id_pnt|--|ref_dim/move_pnt|-+-->
| | | |
+-(ALL)-------+ +-|select|--|move_pnt|---------+
| |
+-(TEXT_ONLY)-+
| |
+-(RESET)-----+
The DA_MOVE_DIMENSION is used to move one or more dimension lines and text.
If ALL is selected, dimension lines and text are moved together. If TEXT_ONLY is selected, then the dimension lines are retained in their current position but the text is moved to a point defined by the user. If RESET is chosen, selected dimension text items that have previously been moved away from their dimension lines are restored to their original positions.
A single dimension element can be selected by picking on the dimension text. The selected entities of the dimension can be moved to a point or aligned to an existing dimension.
Multiple dimensions can be selected by enclosing them in a box. In this case they can be moved to another point only, no alignment with existing dimension is allowed.
Alignment is not supported for Radius, Diameter, Chamfer and Arc dimensions.
--->(DA_NULL)--->
DA_NULL does nothing. This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
+-------<-------+
| |
--->(DA_STYLE_APPLY)---+-+-(NO_KEEP)-+-+--->
| |
+-(KEEP)----+
| |
+-|select|--+
DA_STYLE_APPLY applies the current dimensioning style settings to the selected dimensioning elements. If the KEEP option is set, any prefix, postfix, or tolerance on the selected dimensioning will be kept intact. The default (NO_KEEP), is to replace all dimensioning style settings, including the prefix, postfix, and tolerance settings with the current style.
--->(DA_STYLE_DEFER_UPDATE)--->
DA_STYLE_DEFER_UPDATE prevents the contents of the dimension style display window from updating.
This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
--->(DA_STYLE_ENABLE_UPDATE)--->
DA_STYLE_ENABLE_UPDATE enables updates of the dimensioning style display window.
This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
+----<-----+
| |
--->(DA_STYLE_GET)---+-|select|-+--->
DA_STYLE_GET updates the current dimensioning style settings to match the settings of a selected dimensioning element.
--->(DA_STYLE_INQ)------>
DA_STYLE_INQ is used with the INQ function to return information about the dimension style viewport. This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not recommended for interactive use.
DA_STYLE_INQ sets the following values in the INQ system array. The inquiry code must be 1.
+-------------------------------------------------------------------------+ || | result | |------------+-------------+----------------------------------------------| | 1 | 1 | port number of dimension style viewport | +-------------------------------------------------------------------------+
--->(DA_STYLE_TYPE)---|type|--->
Sets the type of geometry to appear in the style display window. "type" is a number that refers to the geometry type.
This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
--->(DA_STYLE_UPDATE)--->
DA_STYLE_UPDATE updates the contents of the style display window to reflect the current dimensioning style.
This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
--->(DA_STYLE_WIN_CREATE)--->
DA_STYLE_WIN_CREATE either creates the dimension style display window if it doesn't already exist, or pops it, if it is simply obscured by another viewport or menu.
This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
--->(DA_STYLE_WIN_LOC)---|corner point|---|opposite corner point|--->
DA_STYLE_WIN_LOC sets the location for the dimension style display window in the dimension advisor module.
This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
--->(DA_STYLE_WIN_RAISE)--->
Pops the dimension style display window.
This function is intended primarily to support the screen menu interface of the dimension advisor module. It is not intended for interactive use.
--->(DA_WRITE_DIM_SETTINGS_MACRO)---|filename|---|macro_name|--->
DA_WRITE_DIM_SETTINGS_MACRO writes out all the current dimensioning parameters in the form of a macro. This macro is given the name specified in "macro_name" and written to the file specified by "filename."
The DB MATCH button displays the dimension database menu. The commands on this menu allow you to create a database of commonly-used drawings that can be used as templates to speed up the dimensioning process for new drawings.
-->(DB_LOAD)->+------------>+-+-------------+--{element id)->-+---------+->
v | v | v |
+->(RESERVE)->+ +->(SUBPART)->+ +->{loc}->+
{loc}
->-+--->(ABSOLUTE)----->+-->
v |
+->|location point|->+
{element id}
-->|element name|--+----------(CONFIRM)------------------------------------+-> v | +->(SEL_OLD)--+->|revision string|->|version number|-+->+ | | +->|revision string|------------------>+ | | +->|version number|------------------->+
DB_LOAD loads a drawing as a subpart of the current part or as the current part if no parts are loaded. The named element may be of the class ASSEMBLY or DRAWING, or of a part class. When the specified element is a part or assembly, CoCreate/DMS checks for drawings of that part/assembly. If only one drawing exists, this drawing is loaded automatically. If more than one exists, the list of drawings is displayed and the user can select one to load.
If several revisions/versions of the drawing or part exist, the newest one is loaded if CONFIRM is given. The SEL_OLD option allows the user to select an older revision/version of the drawing or part. In this case the current revision/version is prompted as default.
DB_LOAD searches for a file related to the specified drawing which has the same name as the drawing itself and which has the file description Model.MI.
SUBPART means that the new part is to be a subpart of the active part. Otherwise, DB_LOAD automatically chooses one of the following options:
Except for the first case, you must specify where the new part is to be positioned geometrically. You do this by either saying ABSOLUTE, which says that the new part should have the same location as it did when you stored it, or by indicating a location point. If you indicate a location point, the part reference point (see CHANGE_PART_REF_PT) is placed there.
If you load a part directly into the top part, the drawing scale is taken from the drawing scale of the loaded part. Otherwise, the loaded part is adapted to the current drawing scale.
RESERVE reserve for UPDATing. The status of the specified drawing file is changed to "reserved". Only one user may reserve a specific drawing at a time. Default is READ_ONLY.
security: READ-access for the drawing is needed to load it and WRITE-access for the drawing is needed to load and reserve it.
-->(DB_SET_DEFAULT)-+->(AREA)-------->|area name|-------> | +->(REVISION)---->|revision string|-> | +->(PERMISSIONS)->|permission mask|->
Command to set some system defaults.
security: command may only be invoked by PRIV 1 users
Syntax:
-->(DB_STORE)-+-->(ALL)------+-+--------->+-+--------+->{drawing id}-->
| ^ | ^ | |
+-->|partname|-+ +->{scan}->+ +-{sta}->+
{scan}
--+->(SCAN_PART)->+->+-----------------+-> v | v | +->(SCAN_ALL)-->+ +->(DETAIL_INFO)->+
{sta}
-->(AREA)--->|area name|--->
{drawing id}
--+->(CURRENT)------------------------------------------------------+-->
| |
+->|drawing name|-->------------+-+->--------------+--+->-------+-+
v | v | v |
+->|rev string|-+ +->|vers number|-+ +->{att}->+
Revision string and version number have to be specified if the class 'drawings' is defined with REVISIONING and VERSIONING. Otherwise only one of them or none has to be specified, depending on how the class 'drawings' was defined.
CURRENT can be specified if you want to store the drawing with its original name.
{att}
+<---------------------------------------+ v | +->|attribute name|-+->|attribute value|-+ | | ^ | +->(NULL)----------->+ v | -+----------------------------------------+-->(CONFIRM)-> | | | | +<-------------------+ | v | +->(PROMPT)-+->|attribute value|-+-------------------> | | +->(NULL)----------->+
Command, which provides:
options:
security: The command may not be invoked by users, who only have read-permission.
Syntax:
->(DB_STORE_LAYOUT)->{drawing id}-+--------+-{element id}->
| |
+-{sta}->+
{sta}
-->(AREA)--->|area name|--->
{drawing id}
-->|drawing name|-+->------------------+-+->-----------------+->+-------->+-->
v | v | v |
+->|revision string|-+ +->|version number|-+ +->{att}->+
Revision string and version number have to be specified, if the class 'drawings' is defined with REVISIONING and VERSIONING. Otherwise only one of them or none has to be specified, depending on, how the class 'drawings' was defined.
{element id}
-+->|model name|-+-+-------------------------------------------------------+-> v | v | +->|part name|--+ +->(SEL_OLD)--+->|revision string|->|version number|-+->+ | | +->|revision string|------------------>+ | | +->|version number|------------------->+
{att}
+<---------------------------------------+ v | +->|attribute name|-+->|attribute value|-+ | | ^ | +->(NULL)----------->+ v | -+----------------------------------------+-->(CONFIRM)-> | | | | +<-------------------+ | v | +->(PROMPT)-+->|attribute value|-+-------------------> | | +->(NULL)----------->+
Command, which provides the storage of a 2D-Layout for a given part or model. This includes:
security: The command may not be invoked by users, who only have read-permission.
---->(DDE_ADD_TOPIC)---->|topic|---->
DDE_ADD_TOPIC adds a new topic string to the list of recognized DDE topics. Initially, the list contains the topic GENERAL.
---->(DDE_CLOSE)---->|dde_conversation_handle|---->
DDE_CLOSE closes the indicated DDE conversation and returns success or failure. The dde_conversation_handle is the token returned by DDE_INITIATE.
---->(DDE_ENABLE)---->+--->(ON)---->+----> | | +--->(OFF)--->+
DDE_ENABLE enables ME10 to act as a DDE server. While disabled, no new conversations can be created. In existing conversations, the client can request data. However, if the client attempts to execute ME10 commands, a negative acknowledgement is returned.
--->(DDE_EXECUTE)--->|dde_conversation_handle|---|command|--->
DDE_EXECUTE sends the given command string to the application indicated by the dde_conversation_handle for execution. BUSY, NO_ERROR, or ERROR will be returned.
--->(DDE_INITIATE)--->|application|---|topic|--->
DDE_INITIATE initiates a DDE conversation for the indicated application and topic. If successful, a dde_conversation_handle is returned. Otherwise, ERROR is returned. You must specify dde_conversation_handle in subsequent DDE macros.
The application string specifies the application with which you wish to begin a DDE session. Consult the application's documentation for instructions on how to specify it. The application must be running before DDE_INITIATE is called. You can use WINEXEC to start it.
---->(DDE_REMOVE_TOPIC)---->|topic|---->
DDE_REMOVE_TOPIC removes the specified topic string from the list of recognized DDE topics. It does not affect DDE conversations already initiated using this topic. No error is generated if the topic string is not in the list.
--->(DDE_REQUEST)--->|dde_conversation_handle|---|data_item|--->
DDE_REQUEST gets the string value of the indicated data_item from the application indicated by dde_conversation_handle. Refer to the application's documentation for information on which data items may be requested.
DDE_REQUEST returns either the value of data_item, BUSY, or ERROR.
-->(DDE_SEND_ACK)-->|dde_conversation_handle|--|status|--|ack_result|-->
DDE_SEND_ACK sends a DDE acknowledgement message for the indicated conversation if it was withheld subsequently by DDE_WITHHOLD_ACK and returns NO_ERROR. If the conversation handle is not found or is not withholding an acknowledgement, ERROR is returned.
The status flag indicates the type of acknowledgement to be sent: POSITIVE (success), NEGATIVE (failure or cancel), or BUSY.
ack_result is the string assigned to the ACK_RESULT data item, which can then be requested by the client application to provide additional information.
If there should be a need to reset, the dde_conversation_handle can be set to 0 to indicate that the acknowledgement message should be sent to all conversations withholding an acknowledgement.
---->(DDE_WITHHOLD_ACK)---->
After the execution of action text during a DDE conversation, an acknowledgement message is normally sent back to the client application. This generally causes control to return to client application. This function withholds the sending of the DDE acknowledgement message and returns the active DDE conversation handle. Later, the acknowledgement can be explicitly sent using the DDE_SEND_ACK with the handle.
| v (DEFINE) | v |macro name| | v +---------------<-----------------, | | v | +-->(PARAMETER)-->|param. name|-->' | v +----------------<-----------------, | | v | +-->(LOCAL)-->|local macro name|-->' | v +-----<-------, | | v | +-->|token|-->' | v (END_DEFINE) | v
DEFINE (re)defines the named macro. See NAME for a description of permissible macro names. The same rules apply for names used with PARAMETER and LOCAL.
You invoke a macro without parameters by simply entering its name. The computer then evaluates the macro body. The body can be any series of tokens that makes sense in the context where the macro is used. It might be a list of commands, as in this example:
DEFINE Quit
STORE ALL DEL_OLD 'workfile'
EXIT CONFIRM
END_DEFINE
Or it might be a token that makes sense only in a larger context:
DEFINE P
100,100
END_DEFINE
A macro body can also invoke other macros, or even (re)define them.
Within a macro body INPUT should be used with IMMEDIATE option.
A macro body should NOT contain calls to TINPUT. The system will not complain about such macros, but they will not behave as you expect.
A macro with parameters is invoked by giving the macro name, then the values of the named parameters. These values may be expressions. An example:
definition:
DEFINE Double
PARAMETER p
(PNT_XY p p)
END_DEFINE
invocation:
LINE Double 0 Double 100
This example defines a macro "Double" which takes a number as parameter, and whose evaluation produces a point with that number as both X and Y coordinate. Parentheses are required either in the definition or in the invocation, because "PNT_XY p p" is an expression that is being used where a token is required.
A macro with parameters is normally used only within files or within other macros. It is possible to invoke such macros from the keyboard, in which case the system prompts the user for each parameter. But usually, if a macro is to get input from the user, it uses the READ function instead of the parameter mechanism, both because of READ's extra flexibility, and because READ always reads from the user, regardless of the macro context.
Parameters and names declared LOCAL are visible only within the current macro. All other names are global. Parameters and local names do not conflict with global macros having the same name.
The other functions that define macros are LET and READ.
,-------->---------,
| |
| |
-->(DEFINE_CATALOG)---+-->|display_text|-+->|item_name|-->,
|
,-----------------<----------------'
|
`-->|row|---->|column|------->
DEFINE_CATALOG defines information to be printed by CATALOG. The number of columns, their width, and their assignment to rows must already have been specified with CATALOG_LAYOUT. DEFINE_CATALOG tells CATALOG how to fill these fields.
The display text (a string) is the text printed at the top of the listing above the field with the given row and column number. Both row and column number refer to the format for a single entry determined by CATALOG_LAYOUT, and not to row and column numbers of the catalog listing itself. The item name defines what should be printed in the specified field. Item names are strings, and must be one of the following:
FILE_NAME
PHYS_NAME
FILE_SIZE
CREATE_DATE
MODIFY_DATE
ACCESS_DATE
NUM_ACCESS
FILE_TYPE
PROG_NAME
PROG_REV
FILE_DESC
If the display text is omitted, the item name is used as the display text.
FILE_NAME is the name given by the user when the file was created.
PHYS_NAME is the name of the file used by the host operating system. These are normally the same, but can be different if the user creates a file using a name not acceptable to the host. Within ME Series programs this difference should be invisible, but when you look at the directory from another program, you of course see the physical name.
FILE_SIZE is the size of the file in bytes.
CREATE_DATE, MODIFY_DATE, and ACCESS_DATE are the dates when the file was created, last modified, and last accessed, respectively. The output is in the form '01-Jan-85 06:35:22'.
NUM_ACCESS records how many times the file has been accessed. When the file is created, NUM_ACCESS is 0.
FILE_TYPE gives the type of file, as seen by the operating system. The possibilities are:
Block Block special file
Char Character special file
Dir Directory
Fifo Fifo
Netw Network
Reg Regular file
Srm Shared Resource Manager
? Anything else
PROG_NAME and PROG_REV give the name and revision of the program that generated the file.
FILE_DESC describes the type of information in the file. The possibilities are:
Bitmap from BITMAP_TO_FILE
Catalog from CATALOG
Data from OPEN_OUTFILE
Echo from ECHO
Env from SAVE_ENVIRONMENT
Font.BI from STORE_FONT
Font.IL from SAVE_FONT
Gdump from DUMP_SCREEN (Not in MS Windows)
HPGL from PLOT (Not in MS Windows)
HPGL2 from PLOT (Not in MS Windows)
PS from PLOT (Not in MS Windows)
log from LOAD and STORE of binary and MI files in case of
errors
Macro.BI from STORE_MACRO
Macro.IL from SAVE_MACRO
Menu from SAVE_MENU
Model.IL from SAVE
Model.MI from STORE and STORE MI
Part.lst from PARTS_LIST
Query from QUERY, STRUCTURE, WHERE_USED (ME Data Management
System)
Sys.cat additional catalog information [hp_catfile (hp_cat.fil in MS Windows)]
Techo from TECHO
Text from EDIT_FILE
Tmenu from SAVE_TMENU
Trace from TRACE
Viewport from SAVE_VIEWPORT
+<-------------(NEXT)-----------------------------+
| |
| +<--------------+ +<--------+ |
| v | v | ^
-(DEFINE_CLASS)-+----------+>|name|-+---------------+-+---------+-+->(CONFIRM)->
v | v | | |
+->(PART)->+ +>(REVISIONING)>+ +->{att}->+
| |
+>(VERSIONING)->+
| |
+>(RELEASABLE)->+
{att}
-+->|attribute name|-+-----------+->|attribute type|--+--> v | +->(INDEX)->+
New classes of elements are defined. All class names must be unique.
Two categories of classes may be specified, part classes and non-part classes.
Part classes are defined when the option PART is given. To define a part_class means, that all elements of the defined class are basically parts, which are classified through the defined class.
A variable amount of attributes of different types may be defined for each class. Which attribute-types are supported depends on the database used.
For HPSQL/300, ALLBASE or ORACLE, the supported types are:
CHAR(n) Character string of fixed length n where n is an integer from 1 to 255.
VARCHAR(n) Character string of variable length no greater than n, where n must be an integer from 1 to 255.
DECIMAL(p[,s]) Fixed-point decimal number with a precision (maximum number of digits excluding sign and decimal point) no greater than p, where p is 1 through 15, and a scale (number of digits to the right of the decimal) of s, where s is from 0 through p. E and L notation are not allowed in the specification of a decimal value.
FLOAT Long floating point number. The range of negative numbers that can be represented is -1.797E+308 to -2.225E-308. The range of positive numbers that can be represented is 2.225E-308 to 1.797E+308. E notation may be used to specify FLOAT values.
INTEGER Integer in the range of -2147483647 to 2147483647
SMALLINT Integer in the range of -32768 to 32767
DATE ALLBASE: (transformed by CoCreate/DMS to the ALLBASE DATETIME datetype) String of the form 'YYYY-MM-DD HH:MI:SS.FFF' where YYYY represents the calendar year, MM is the month, and DD is the day of the month, HH the hour, MI the minute, SS the second, FFF is thousandths of a second. The range is from 0000-01-01 00:00:00.000 to 9999-12-31 23:59:59.999.
ORACLE: Character and number data consisting of Century, Year, Month, Day, Hour, Minute, and Second. See the ORACLE SQL syntax manual for complete formatting, date arithmetic and Julian date methods.
The qualifier INDEX may be specified for each attribute. It allows an index to be created for that attribute. If an index is created for a specific attribute, the performance of queries accessing this attribute is considerably increased.
Since each element is identified through its name, the attribute "NAME" is automatically added to the attribute list. It is defined as a 255 character string.
The other system-defined attributes are:
The options REVISIONING and VERSIONING define whether revisioning and/or versioning for the elements of that class have to be allowed and supported.
With the option RELEASABLE it can be specified whether elements of that class can be released.
security: command can be invoked by PRIV 1 users if and only if no other users are connected.
---->(DEFINE_FONT)--->|string|--->|underlength|--->|height|--->|width|---->
DEFINE_FONT defines a new font with the given name. It becomes the current font. Characters are specified with the CHAR_LAYOUT command, on an imaginary 250 x 250 grid, with the origin at the lower left. In conventional fonts, underlength is the distance on this grid from 0 to the bottom of a capital letter. This is the length of descenders, as in "g" or "j". Height is the height of capital letters, and width the default width, both specified in grid units.
A typical font might have an underlength of 6, and height and width both 20. In this case, CHAR_LAYOUT would specify that "A" began at 0,6. X values would range from 0 to 20, and y values from 0 to 26.
A font need not contain letters; it may contain symbols, for example. Thus, the real significance of underlength, height, and width have nothing to do with letters. Underlength specifies the text baseline, which is used for positioning the reference point with respect to the grid (see TEXT_ADJUST). Height and width specify the mapping from grid units to user units. Vertically, height grid units are mapped to the text size (specified by TEXT_SIZE). Horizontally, width grid units are mapped to the text width (specified by TEXT_SIZE and TEXT_RATIO).
---->(DEFINE_KEY)--+---->|number|----+--+------------------+--+--------------+-->|string|---->
| | | | | |
+->|"F1" - "F12"|-+ +----->|PLAIN|-----+ +-->|EXECUTE|--+
| | | |
+-->|"a" - "z"|---+ +----->|SHIFT|-----+
| | | |
+-->|"A" - "Z"|---+ +------>|ALT|------+
| | | |
+-->|"0" - "9"|---+ +---->|CONTROL|----+
| |
+-->|ALT_CONTROL|--+
DEFINE_KEY defines a Special Function Key (other terms are Soft Key or Function
Key). Number is the key number and must be in the range from 1 to 8 or from 1
to 12, depending on your keyboard.
"F1"-"F12" is string that represents the Function Key.
Keywords PLAIN and SHIFT are valid only for function keys.
Keywords ALT, CONTROL, ALT_CONTROL are valid for function keys and Alpha-Numerical keys.
Keyword EXECUTE executes the string immediately, without putting it in the
command line and waiting for Enter key.
String is the string constant or string expression that is to be substituted
for each activation of the Special Function Key.
Example:
DEFINE_KEY '1' CONTROL EXECUTE 'LINE'
A common use for this function is to define the special function keys as the degree, diameter and plus/minus signs. These three characters are supplied in most text fonts as the following characters:
UNIX MS Windows
degree (#14"0"#15) #242
diameter (#14"1"#15) #243
plus/minus (#14"2"#15) #254
Therefore to define the special function keys f1, f2 and f3 as the three characters, you must enter:
UNIX MS Windows
DEFINE_KEY 1 (#14"0"#15) #242
DEFINE_KEY 2 (#14"1"#15) #243
DEFINE_KEY 3 (#14"2"#15) #254
You can now press the appropriate key to add the respective dimension symbol to your drawing's text when using the SCREEN text option. See the TEXT command for more details on the special characters.
Note:
ALT-"F4", CONTROL "C" and CONTROL "M" are locked because these key combinations
are reserved for Windows.
DEFINE_KEY function for other operating systems are not fully executable.
+<-----------------+
v |
---->(DEFINE_MOUSE_KEY)--+----->|1-3|-----+------------------+--+---->|string|---->
| |
+----->|PLAIN|-----+
| |
+----->|SHIFT|-----+
| |
+------>|ALT|------+
DEFINE_MOUSE_KEY defines a mouse key. Number is the key number and must be in the range from 1 to 3. String is the string constant or string expression that is to be substituted for each activation of the mouse key.
If the string is followed by a #M character, then it is executed immediately after the mouse key press, otherwise it is transfered to the command line. After that, it can be modified or executed by pressing ENTER key on the keyboard. There are three qualifiers which can be used with DEFINE_MOUSE_KEY command. SHIFT is the default qualifier which means that in order to do mouse key substitions a SHIFT key must be pressed. The PLAIN qualifier allows substitions to be made directly to the mouse key, but this is not true for the left mouse key. ALT qualifier defines that ALT key must be pressed to do mouse key substition.
Note: The ALT qualifier can be used on Windows platforrm.
Examples:
define_mouse_key 3 shift "line" define_mouse_key 3 shift "version"#M
+<---------------+ v | -->(DEFINE_RELATION)-+->|parent class|-+-+->|child class|-+->(CONFIRM)----> | | | ^ +--->(PART)------>+ +-->(PART)------>+
Command to specify valid relations among classes. Only if a relation on class level is defined, a relation on element level can be created.
If the qualifier PART is given, all part classes are considered.
Example:
DEFINE_RELATION PART 'drawings' CONFIRM
defines a relationship between all part classes and drawings, so that drawings may be related to all part elements.
security: Command can be invoked by PRIV 1 users if and only if no other users are connected
+<------------------+
| |
--->(DEFINE_TREE)-->|tree name|--+-------------------+-->(CONFIRM)--->
| |
+->{attribute def}--+
{attribute def}
-->|attribute name|-->+-----------+--->|attribute type|---> | | +->(INDEX)--+
Creates a new classification tree in the system. The newly created tree becomes the current tree for any subsequent node operations. Also, a top node of the tree is created by the system which has the same name as the tree. All tree names in the system must be unique.
Two attributes, NAME and TYPE are defined by the system for all newly created nodes in the tree. Any additional attributes can be created by giving unique attribute name and one of the database supported attribute types. See DEFINE_CLASS for supported attribute types.
These attributes are assigned to the nodes during the creation time and initial attribute values are set to NULL.
Option INDEX can be used to create a database index on the attribute to speed up the queries using that attribute. However, indexing consumes more disc space in the database.
A classification privilege of 1 is required to use this command.
,<-----(M_UNDO)-------,
| |
|<--------------------|
v |
-->(DELETE)--+--+------|select|-------+--+-->
| ^
'--->(ALL)-->(CONFIRM)------'
DELETE deletes the selected element(s). Construction lines and construction circles are deleted only if you did not select any text or other geometry (such as lines, arcs, or circles) together with the construction geometry elements.
DELETE ALL CONFIRM deletes all elements in the active part. Also all the existing pixmaps will be deleted.
The DELETE button allow you to delete one entry or ALL entries in the table.
+---------+ v | -->(DELETE_CLASS)-+->|name|-+-(CONFIRM)---->
One or more existing class definition are deleted.
security: Command can be invoked by PRIV 1 users if and only if no other users are connected
-->(DELETE_CURRENT_INFO)-->
DELETE_CURRENT_INFO deletes the current info. The current info is that added to each new element.
-->(Delete_current_url)-->
Delete_current_url deletes all the current URLs. Until next change new elements will contain no URL info texts.
The function delete_current_url has the same effect as the sequence change_current_url '*' ''.
+------<------+
| |
-->(DELETE_DIM_POSTFIX)->-+-|selection|-+--->
DELETE_DIM_POSTFIX allows you to delete an identified postfix.