Calculator Functionality

The CALCULATOR menu lets you calculate values that can be directly entered into the command line or the drawing itself. The calculator's logic system is based on the method called RPN (Reverse Polish Notation).

The CALCULATOR menu can be found in the MEASURE command block (or in MEASURE in the screen-only version) and works interactively with the application. For example, you can interrupt a pick sequence, make a calculation, and then use the answer for the next pick.

The calculator is useful for:

The functions do the following:

<=&      Deletes last integer
x< >y    Swaps the stack values
R_up     Rolls up the stack values
R_dn     Rolls down the stack values
CLR      Clears all the stacks of entries
Cl x     Clears the X-stack only
INT      Converts value to an integer (no rounding-up)
FRAC     Removes integer part
X**2     x to power of 2
SQRT     Square root
Y**X     y to power of x (Y-stack value to power of X-stack value)
1/x      Reciprocal of value in X-stack
R/P      Rectangular/polar coordinate conversion
P/R      Polar/rectangular coordinate conversion
mmIn     Converts mm to inches
Inmm     Converts inches to mm
STO      Stores the X-stack value in a register. Select registers by:

RCL      Recalls a value stored in the register

The following functions retrieve data from the drawing:

Num      Puts a value in the X-stack (after pressing Enter)
Rad      Determines radius of a circle and places it in the X-stack
Dist     Calculates the distance between two points
Area     Calculates the area below a curved element and places the
         calculated value in the X-stack
Vert     Calculates the vertical distance between two points
Horiz    Calculates the horizontal distance between two points
Lngth    Calculates the length of an element (straight lines and curved lines)
Ang      Calculates the angle between two lines

The second calculator menu contains the following:

Trigonometric Functions:

e**X     Natural antilog
ln       Natural log
10X      Common antilog
log      Common log
Pi       3.14159265358979
%        Calculates the percentage of the Y-stack value
n!       Factorial
n >n     Converts base-n systems (where n can be between 2 and 16)
         For example, you can convert a base-2 value to a base-16 value.

The bottom fields are:

PtIn     Inputs a point
PtOut    Outputs a point
I_ENV    INQ_ENV function for inquiring the code/index (value is placed in
         the X-stack)
I_EL     INQ_ELEM function for inquiring the code/index (value is placed in
         the X-stack)


See also


CALIBRATE_TABLET

---->(CALIBRATE_TABLET)-->|point1|-->|point2|-->|point3|-->

The CALIBRATE_TABLET command lets you calibrate your tablet overlay. Point1 to point3 are three calibration points on the tablet layout. Their position is described in the MI file OVL_HELP. This file can be loaded and then viewed or plotted to a plotting device.

After calibration, a file '.me10rc' is created in your HOME directory. This file is read during startup to re-calibrate your tablet overlay again.

NOTE:
For MS Windows, filename will be 'ME10.RC' and it will be created in MEDIR directory.


See also


CANCEL command

---->(CANCEL)---->

CANCEL cancels the current activity of the system and returns to the 'Enter command' prompt. Partially processed macros and input files are aborted. Any type-ahead is cleared. All memory used for temporary storage is released.

The CANCEL command is automatically executed whenever the STOP, ESC, or BREAK key is pressed.

NOTE:
In case of MS Windows, CANCEL command is automatically executed whenever the ESC or CTRL+BREAK key is pressed.

See also


CANCEL_EDIT_DIM_TEXT command

-->(CANCEL_EDIT_DIM_TEXT)----|point|--->

CANCEL_EDIT_DIM_TEXT undoes the result of EDIT_DIM_TEXT. It restores the identified dimension to its original state, where the value is automatically calculated from the attached geometry.


See also


CATALOG function

                         ,<---------------------------,
                         v                            ^
(CATALOG)-->|directory|->+--------------------------->+--->|output_spec|-->
                         |                            |
                         +->(DETAIL_INFO)------------>+
                         |                            |
                         +->(SORT)---------+->|item|->+
                         |                 |          |
                         +->(REVERSE_SORT)-'          |
                         |                            |
                         `->(SELECT)--|expression|--->'

|expression|

--->|item|-------+-------->+------>|value|------>
                 |         |
                 +->(=)--->+
                 |         |
                 +->(<>)-->+
                 |         |
                 +->(>)--->+
                 |         |
                 +->(<)--->+
                 |         |
                 +->(>=)-->+
                 |         |
                 `->(<=)-->'

CATALOG outputs a catalog listing of the named directory to the specified destination.

The options allow you to:

The following items are supported:

If you omit them, the format is the one defined by CATALOG_LAYOUT and DEFINE_CATALOG. The files are listed in alphabetical order. Every file in the directory is included.

Example:

        CATALOG 'dirname' SCREEN

With DETAIL_INFO, the normal format is not used. Instead, all information is listed for each file, one item of information per line.

Example:

        CATALOG 'dirname' DETAIL_INFO SCREEN

With SORT and REVERSE_SORT, you give an item name, and the listing is sorted on that item. The item name must be a string. You can use this option more than once; the second sort option then specifies the ordering of files that are alike under the first sort option, and so on. See DEFINE_CATALOG for the permissible item names.

Example:

        CATALOG 'dirname' SORT 'FILE_TYPE'
                          REVERSE_SORT 'MODIFY_DATE' SCREEN

With SELECT, you specify which files in the directory should appear in the listing. You do this by giving an item name, then specifying the values that item can take. For example:

        SELECT 'FILE_TYPE' 'Dir'

selects the directories. The item name must be a string. The value is a string, except for the items FILE_SIZE and NUM_ACCESS, where it is a number. For the items that are dates (CREATE_DATE, MODIFY_DATE, ACCESS_DATE), the value is normally in the form 'DD-Mmm-YY hh:mm:ss'. If you omit the year or month, you get the current one. If you omit the date, you get 1. If you omit the hh:mm:ss, you get midnight. The value can contain wildcards; thus:

        SELECT 'FILE_NAME' 'A*'

selects the files whose names begin with A. See SELECT (the entry in this help file for element selection) for a description of wildcards.

SELECT also allows a relational operator between the item name and the value. Thus:

        SELECT 'ACCESS_DATE' < '01-Jan-85'

selects the files not accessed in 1985 or later, and:

        SELECT 'FILE_SIZE' > 10240

selects files larger than 10KB. The operators can also be used with names. In the example above, < means "earlier in an alphabetical ordering".

You can use SELECT more than once. The resulting files satisfy all of the selection criteria.

CATALOG provides information about all items described in DEFINE_CATALOG. Because some information is not available from the host operating system, it must be maintained separately in a file named 'hp_catfile' ('hp_cat.fil' in case of MS Windows.) There is one such file in each directory where you have:

These files can usually be ignored. The exception is when they appear in spool directories. The spooler may try to print them, although they are not text files.


See also


CATALOG_LAYOUT command

                          ,--------<---------,
                          |                  |
---->(CATALOG_LAYOUT)---->+---->|string|---->+---->(END)---->

CATALOG_LAYOUT specifies the layout of the catalog information given by CATALOG.

The string defines the number of columns and the width of each column in the layout. Within the string, the columns are separated by bars (|). The width of each column is the same as the number of characters between the bars. The actual characters are irrelevant, and are usually blanks or numbers.

CATALOG_LAYOUT describes the layout for a single catalog entry (file). You can specify more than one string if you want more than one line of catalog information per file.

Example:

  CATALOG_LAYOUT  '12345678901|12345|123456|1234567890|1234567|1234' END

This defines a catalog format with 6 columns. The column widths are 11, 5, 6, 10, 7, and 4.


See also


CATCH function

            ,-->(PERMANENT)--,
            |                |
-->(CATCH)--+------->--------+-->(ALL)--------------------------+-->
                             |                                  |
                             +-->(VERTEX)---------------------->+
                             |                                  |
                             +-->(ELEM)------------------------>+
                             |                                  |
                             +-->(INTERSECTION)---------------->+
                             |                                  |
                             +-->(CENTER)---------------------->+
                             |                                  |
                             +-->(OFF)------------------------->+
                             |                                  |
                             +-->(GRID)------------------------>+
                             |                                  |
                             | ,----->-----,                    |
                             | |           |                    |
                             +-+-(RANGE)->-+->|range|---------->+
                             |                                  |
                             `-->(NO_VIEWPORT_RANGE)-->|range|->'

The CATCH function sets the catching mode. This mode controls how input points are interpreted, and allows the user to select a point on the screen without having to put the cursor directly on that point. The system catches to a point only if it lies within the imaginary circle around the edges of the small cursor.

The catching mode is only set for the next pick. If option PERMANENT is selected, the chosen catch mode stays in effect until changed. The options RANGE and NO_VIEWPORT_RANGE, however, are not affected by PERMANENT. They always keep their range values until they are changed.

ALL is the default. It looks for a vertex, then for an intersection, then for a grid point, then for an element (point anywhere on an element). If it finds a vertex within the catch range, it catches to the closest such vertex; otherwise, it proceeds with intersections and so on similarly. Vertices are normally end points of arcs, splines, or straight elements, though with SHOW VERTEX ON you can see (and catch to) a few additional vertices. Intersections can be between any two elements, or between an element and the ruler. If the system can't find any of these, it uses the input point as given.

VERTEX, INTERSECTION, GRID, and ELEM allow you to say what kind of catching you want, saving some time over the more general ALL option. CENTER catches to the center of circles and arcs, and midpoints of lines; in this case, it is the element that you pick with the cursor, and not the midpoint. OFF turns off catching completely. These options are normally in force for only one catch, after which the mode switches automatically back to ALL. If you use the PERMANENT option, the selected catch mode stays in effect until you change it again.

OFF allows you to enter all points without any correction.

The definition of "grid points" varies, depending on the catch mode and whether you have a ruler, dot or line grid, or no grid at all. If the catch mode is GRID, the grid points are the ones you would see if you turned a grid on, whether you have actually done so or not. You are reminded of this by the x-y display in the status line, which hops from grid point to grid point as you move the cursor around. If the catch mode is ALL, then the grid points are only the ones you see. That is, if you have a line or dot grid on your screen, those are the grid points; if you have a ruler, the grid points are only the ticks on the axes; if you have neither grid nor ruler, there are no grid points.

It is an error (beep) to set the catch mode to INTERSECTION, VERTEX, GRID, CENTER or ELEM, and then try to catch to something else.

The RANGE option allows you to change the catch range. The argument is the size of the new range in pixels. The small cursor changes to match this new range.

Normally there is no catching if points are read from the keyboard, from macros, or from files. With the option NO_VIEWPORT_RANGE you can specify the search- range in user units to allow catching on this kind of point entry.

Switching to the large cursor has no effect on the catch range or mode.

The catch mode (but not the range) is irrelevant when the digitized points are used to identify elements, as in DELETE, for example.


See also


CENTERLINE command

---->(CENTERLINE)--|elem|-->

This command lets you create a centerline for a circular element. The centerline becomes part of the circular element and is moved or deleted if the associated circular element is moved or deleted.

Create a circle and then enter the command CENTERLINE. Identify the circle.

See also the CL_ABS_OFFSET and CL_REL_OFFSET functions on how to set the centerline offset.

The CENTERLINES qualifier can be used with the SELECT command.


See also


CHAMFER command

             ,-----------------------------------------------------------,
             |                                                           |
             |  ,-------------------------------------,                  |
             v  v                                     |                  |
-->(CHAMFER)-+--+-->(TWO_PTS)-+------>|pnt1|-->|pnt2|-+------------------+->
             |  |             ^                                          ^
             |  '-------------'                                          |
             |                                                           |
             |           ,---------------------------------,             |
             |           v                                 |             |
             +->(VERTEX)-+->|distance|-+--->|vertex point|-+------------>|
             |           |             ^                                 |
             |           '-------------'                                 |
             |              ,------------------------------------,       |
             |              v                                    |       |
             +->(DIST_DIST)-+-|dist1|--|dist2|-+-|elem1|-|elem2|-+------>|
             |              |                  ^                         |
             |              '------------------'                         |
             |             ,-------------------------------------------, |
             |             v                                           | |
             '->(DIST_ANG)-+->|distance|-|angle|-+->|elem1|->|elem2|---+-'
                           |                     ^
                           '---------------------'

CHAMFER creates a chamfer. Internally, all chamfers are just lines.

TWO_PTS creates a chamfer at the two given points, each of which must lie on a line, arc, circle, or fillet.

DIST_ANG creates a chamfer that begins at the given distance from the corner, at the given angle with respect to the first element. The first element must be a line; the second may be a line, arc, circle, or fillet.

VERTEX creates a chamfer across a vertex. The 'distance' parameter tells how far from the vertex the chamfer should be along each line. The vertex point must be a place where two lines end.

DIST_DIST accepts two distances, then two elements. The chamfer begins on the first element and ends on the second. The distance from the element intersection point to the chamfer beginning is 'dist1', and the distance to the chamfer end is 'dist2'. The elements must be lines.

Once you enter a distance (VERTEX), two distances (DIST_DIST), or a distance and an angle (DIST_ANG), these values are remembered as defaults, even after you have left the command.


See also


CHANGE_COLOR command

                                 .----------------.
                                 v                |
--->(CHANGE_COLOR)--->|color|--->+--->|select|--->+--->

CHANGE_COLOR changes the color of the selected elements. You cannot change the color of parts, though you can change the color of elements within a part. See color functions for the possible colors.


See also


CHANGE_CURRENT_INFO function

---->(CHANGE_CURRENT_INFO)---->|old string|---->|new string|---->

CHANGE_CURRENT_INFO looks at all strings in the current info, and changes any that match 'old_string' into 'new_string'. 'Old_string' may contain wildcards (see SELECT for a list). If 'new_string' is empty, the matched strings are deleted.

The current info is the info added to every newly created element, this includes the layer number of the element. Therefore this command may be used to change from one layer to another.


See also


Change_current_url

---->(Change_current_url)----->|old string|---->|new string|---->

Change_current_url looks at all current URLs info texts and changes any that match 'old_string' into 'new_string'. 'Old_string' may contain wildcards (see SELECT for a list). If 'new_string' is empty, the matched strings are deleted.


See also


CHANGE_DIMLINE_ZERO_POINT_OFFSET command

                                        +----|offset|->-|dimension|----+
                                        |                              |
-->(CHANGE_DIMLINE_ZERO_POINT_OFFSET)->-+                              +--->
                                        |                              |
                                        +-|dimension|->-|dim_line_loc|-+

CHANGE_DIMLINE_ZERO_POINT_OFFSET changes the position of the beginning of the dimension (dimension groups) line for dimensions created with HIDDEN_ZERO_POINT.

Note
Only dimensions in the current part can be selected.


See also


CHANGE_DIM_ARROW command

                        +-------<-------+--------<--------+
                        |               |                 |
-->(CHANGE_DIM_ARROW)->-+->----{1}------+->-|selection|---+-->

{1}-+------->-------+-+------->---------+-+----->------+----{2}----->
    |               | |                 | |            |
    +-(BOTH_ARROW)--+ +-(ARROW_TYPE)----+ +-(FILL_ON)--+
    |               | |                 | |            |
    +-(FIRST_ARROW)-+ +-(DOT_TYPE)------+ +-(FILL_OFF)-+
    |               | |                 |
    +-(SEC_ARROW)---+ +-(SLASH_TYPE)----+
                      |                 |
                      +-(JIS_TYPE)------+
                      |                 |
                      +-(TRIANGLE_TYPE)-+
                      |                 |
                      +----(NONE)-------+

{2}-+---------->----------+--+---------->------+---->
    |                     |  |                 |
    +-(RELATIVE)-|factor|-+  +-(ARROW_AUTO)----+
    |                     |  |                 |
    +-(ABSOLUTE)-| size |-+  +-(ARROW_INSIDE)--+
                             |                 |
                             +-(ARROW_OUTSIDE)-+

CHANGE_DIM_ARROW changes the current dimension line terminator. RELATIVE controls the size of the terminator relative to the main (first) dimension character size. ABSOLUTE allows you to set the terminator size in current units. FILL controls the filling of arrows in all dimensions. AUTO, INSIDE, and OUTSIDE control the placement of arrows with regard to extension lines. ARROW_AUTO is the default.

Note
Only dimensions in the current part can be selected.


See also


CHANGE_DIM_COLOR command

                         ,----------------+---------------,
                         |                |               |
-->(CHANGE_DIM_COLOR)----v-|new_color|----v--|selection|--+---->

CHANGE_DIM_COLOR changes the color of the extension- and dimension lines of the selected dimensions. See COLOR for a list of colors.

Note
Only dimensions in the current part can be selected.


See also


CHANGE_DIM_FORMAT command

                       +-----------------+------------------+---------------+
                       |                 |                  |               |
->(CHANGE_DIM_FORMAT)--v-+-------------+-v-+-------------+--v--|selection|--+-->
                         |             |   |             |
                         +-(DIM_ALL)---+   +--|string|---+
                         |             |   |             |
                         +-(MAIN_ALL)--+   +--|number|---+
                         |             |
                         +-(MAIN_NUM)--+
                         |             |
                         +-(MAIN_TOL)--+
                         |             |
                         +-(SEC_ALL)---+
                         |             |
                         +-(SEC_NUM)---+
                         |             |
                         +-(SEC_TOL)---+

CHANGE_DIM_FORMAT allows you to change the format of an existing dimension. The type of value can be selected (default MAIN_NUM). For string and number definition see DIM_FORMAT.

Note
Only dimensions in the current part can be selected.


See also


CHANGE_DIM_FRAME command

                       +-------------------+-------------+
                       |                   |             |
-->(CHANGE_DIM_FRAME)--v--+---(OFF)------+-v-|selection|-+----->
                          |              |
                          +---(BOXED)----+
                          |              |
                          +--(BALLOONED)-+
                          |              |
                          +--(FLAGGED)---+

CHANGE_DIM_FRAME allows you to change the type of the identified frames.

Note
Only dimensions in the current part can be selected.


See also


CHANGE_DIM_OFFSET_LINE command

                              ,----------------+---------------,
                              |                |               |
-->(CHANGE_DIM_OFFSET_LINE)---v--|new_offset|--v--|selection|--+---->

CHANGE_DIM_OFFSET_LINE changes the offset of the dimension extension line from the dimension line of the selected dimensions.

Note
Only dimensions in the current part can be selected.


See also


CHANGE_DIM_OFFSET_PNT command

                             ,----------------+---------------,
                             |                |               |
-->(CHANGE_DIM_OFFSET_PNT)---v--|new_offset|--v--|selection|--+---->

CHANGE_DIM_OFFSET_PNT changes the space to geometry of the selected dimensions.

Note
Only dimensions in the current part can be selected.


See also


CHANGE_DIM_PENSIZE command

                            ,-------------------+---------------,
                            |                   |               |
-->(CHANGE_DIM_PENSIZE)-----v--|new_pensize|----v--|selection|--+---->

CHANGE_DIM_PENSIZE changes the pensize of the extension and dimension lines of the selected dimensions.

Note
Only dimensions in the current part can be selected.


See also


CHANGE_DIM_PLACES command

                         '--------------+-------<----------+---------------,
                         |              |                  |               |
--->(CHANGE_DIM_PLACES)--v-+-(PLUS)--+--v--+-(MAIN_NUM)-+--v--|selection|--+-->
                           |         |     |            |
                           +-(MINUS)-+     +-(SEC_NUM)--+

CHANGE_DIM_PLACES changes the number of significant digits in the main or secondary number of selected dimensions. Use the PLUS option to add a decimal place or the MINUS option to remove one.


See also


CHANGE_DIM_TEXTS command


--->(CHANGE_DIM_TEXTS)--+------------+--+-(FONT)----|font|----v-|selection|-+->
                        |            |  |                     |
                        |            |  + (FONT_2BYTE)-|font|-+
                        |            |  |                     |
                        +-(DIM_ALL)--+  +-(ABSOLUTE)-|size|---+
                        |            |  |                     |
                        +-(MAIN_ALL)-+  +-(RELATIVE)-|factor|-+
                        |            |  |                     |
                        +-(MAIN_NUM)-+  +-(RATIO)----|ratio|--+
                        |            |  |                     |
                        +-(MAIN_TOL)-+  +-(SLANT)----|slant|--+
                        |            |  |                     |
                        +-(SEC_ALL)--+  +-(BRACKETS)-|on/off|-+
                        |            |  |                     |
                        +-(SEC_NUM)--+  +---|color|-----------+
                        |            |
                        +-(SEC_TOL)--+
                        |            |
                        +-(PREFIX)---+
                        |            |
                        +-(POSTFIX)--+
                        |            |
                        +-(SUBFIX)---+
                        |            |
                        +-(SUPERFIX)-+

CHANGE_DIM_TEXTS function allows you to change the attributes for existing dimension texts. First the kind of dimension text (for example, prefix or tolerance) is selected (default DIM_ALL) then dimension font, text size (ABSOLUTE and RELATIVE), text ratio, text slant and bracketing can be set. Finally, standard selection is used to define the dimensions to be changed.

FONT option allows you to set 1 byte font for new dimension text.

FONT_2BYTE option allows you to set 2 byte font for new dimension text.

RELATIVE controls the size of the dimension text relative to the main (first) character size. ABSOLUTE allows the setting of the (dim_) text size in current units.

Settings for MAIN_NUM, DIM_ALL and MAIN_ALL should always be absolute.

Note
Only dimensions in the current part can be selected.


See also


CHANGE_DIM_TEXT_LOCATION command

					        +---------------+
                                                |               |
-->(CHANGE_DIM_TEXT_LOCATION)-----+---(ABOVE)---+--|selection|--+----->
                                  |             |
                                  +---(ON)------+
                                  |             |
                                  +---(BELOW)---+

CHANGE_DIM_TEXT_LOCATION changes the location of the selected dimension texts. The new location may be above, on or below the dimension line.


See also


CHANGE_DIM_TEXT_ORIENTATION command

							  +---------------+
                                                          |               |
-->(CHANGE_DIM_TEXT_ORIENTATION)----+---(HORIZONTAL)------+--|selection|--+---->
                                    |                     |
                                    +---(VERTICAL)--------+
                                    |                     |
                                    +---(PARALLEL)--------+
                                    |                     |
                                    +---(PERPENDICULAR)---+

CHANGE_DIM_TEXT_ORIENTATION changes the orientation of the selected dimension texts. The new dimension text orientation may be horizontal, vertical, parallel or perpendicular.


See also


CHANGE_DIM_VERTEX command

                                   +-----------------------+--------------+
                                   |                       |              |
-->(CHANGE_DIM_VERTEX)--+--------+-v-|dim id|--|old|--|new|-+--------------+--->
                        |        |                         |              |
                        +-(MOVE)-+                         +-|location|---+

CHANGE_DIM_VERTEX allows you to connect an extension line of a dimension to another geometry element, i.e lets you switch a dimension to a vertex of another element.

If MOVE has been selected, you have to enter a new dimension text location. CANCEL during MOVE cancels only the MOVE not the CHANGE_DIM_VERTEX command.

Note
Only dimensions in the current part can be selected.


See also


CHANGE_ELEM_INFO command

                                                       ,-------<-------,
                                                       |               |
--->(CHANGE_ELEM_INFO)-->|old string|-->|new string|-->+-->|select|--->+-->

CHANGE_ELEM_INFO looks at all info of the selected elements, and changes strings that match old_string into 'new_string'. 'Old_string' may contain wildcards (see SELECT for a list). If 'new_string' is empty, the matching strings are deleted.

This command may be used to move elements from one layer to another, since the layer number of an element is represented as info.

Note that, CHANGE_ELEM_INFO function does not guarantee that the INFO elements will be ordered in any way.


See also


Change_elem_url

                                                       ,-------<-------,
                                                       |               |
--->(Change_elem_url)--->|old string|-->|new string|-->+-->|select|--->+-->

Change_elem_url looks at all URLs of the selected elements and changes URLs that match old_string into 'new_string'. 'Old_string' may contain wildcards (see SELECT for a list). If 'new_string' is empty, the matching strings are deleted.


See also


CHANGE_FILLET command

                                   ,-------------,
                                   v             ^
-->(CHANGE_FILLET)-->|new radius|--+-->|select|--+-->

CHANGE_FILLET changes the radius of the selected fillets. If 'new_radius' is 0, the fillet is removed and the corner reconstructed.

The new radius also becomes the default fillet radius for the creation of a new fillet (see FILLET command).

Before CHANGE_FILLET can do its work, it must be able to recognize the geometry attached to the fillet. If you have deleted or otherwise disturbed one of the tangential elements, the command may report a failure. In this case, you must manually remove the fillet, reconstruct the corner, then use FILLET with the new radius.


See also


CHANGE_GLOBAL_INFO function

---->(CHANGE_GLOBAL_INFO)---->|old string|---->|new string|---->

CHANGE_GLOBAL_INFO is like CHANGE_ELEM_INFO, except that the requested change is applied to every element in memory.

Note that, CHANGE_GLOBAL_INFO function does not guarantee that the INFO elements will be ordered in any way.


See also


Change_global_url

--->(Change_global_url)--->|old string|-->|new string|---->

Change_global_url checks in the global list all URLs and changes those that match old_string into 'new_string'. 'Old_string' may contain wildcards (see SELECT for a list). If 'new_string' is empty, the matching strings are deleted.

Current URLs are not changed. The function is faster than change_elem_url '...' '...' all. Element info lists are stored in the same piece of memory as the global info list. One change in global info list thus affects all the element info lists.


See also


CHANGE_HATCH_ANGLE command

                                        ,-------------,
                                        v             ^
---->(CHANGE_HATCH_ANGLE)---->|number|--+-->|select|--+-->

CHANGE_HATCH_ANGLE changes the angle of the selected hatch. See HATCH_ANGLE.


See also


CHANGE_HATCH_COLOR command

                                        ,--------------,
                                        v              ^
---->(CHANGE_HATCH_COLOR)----->|color|--+-->|select|---+-->

CHANGE_HATCH_COLOR changes the color of the selected hatch. See CURRENT_HATCH_PATTERN.

Examples for |select|

   SELECT "color"
   e.g. CHANGE_HATCH_COLOR GREEN
	SELECT HATCHING WHITE
	CONFIRM

   SELECT "linetype"
   e.g. CHANGE_HATCH_COLOR GREEN
	SELECT HATCHING SOLID
	CONFIRM

   SELECT "color" ADD "linetype"
   e.g. CHANGE_HATCH_COLOR GREEN
	SELECT HATCHING WHITE
	ADD SOLID CONFIRM


See also


CHANGE_HATCH_DIST command

                                       ,-------------,
                                       v             ^
---->(CHANGE_HATCH_DIST)---->|number|--+-->|select|--+-->

CHANGE_HATCH_DIST changes the distance of the selected hatch. See HATCH_DISTANCE.


See also


CHANGE_HATCH_LINETYPE command

                                              ,--------------,
                                              v              ^
---->(CHANGE_HATCH_LINETYPE)----->|linetype|--+-->|select|---+-->

CHANGE_HATCH_LINETYPE changes the linetype of the selected hatch. See CURRENT_HATCH_PATTERN.


See also


CHANGE_HATCH_PATTERN command

                            ,---------------,
                            v               |
->(CHANGE_HATCH_PATTERN)--+-+->|offset|     |
                          |        v        |
                          |     | dist |    |
                          |        v        |
                          |     |angle |    |
                          |        v        |
                          |     |color |    |
                          |        v        |
                          |     |linetype|->+-->(CONFIRM)-,
                          |                               | ,-----------,
                          |                               v v           ^
                          '-------------->|point|---------+-+->|select|-+->

CHANGE_HATCH_PATTERN changes the pattern of the selected hatch (see CURRENT_HATCH_PATTERN). You can specify the pattern directly, with one or more repetitions of the five hatch pattern parameters, or you can pick a point on an existing hatch, in which case you get the pattern there.


See also


CHANGE_HATCH_REF_PT command

                                        ,-------------,
                                        v             ^
---->(CHANGE_HATCH_REF_PT)---->|point|--+-->|select|--+-->

CHANGE_HATCH_REF_PT changes the reference point of the selected hatch. See HATCH_REF_PT.


See also


CHANGE_LEADER_ARROW command

                                                 +----------------+
                                                 v                |
-->(CHANGE_LEADER_ARROW)--->+-(ARROW_TYPE)----+--+--|selection|-->+---->
                            |                 ^
                            +-(DOT_TYPE)------+
                            |                 |
                            +-(SLASH_TYPE)----+
                            |                 |
                            +-(TRIANGLE_TYPE)-+
                            |                 |
                            +-(JIS_TYPE)------+
                            |                 |
                            `-(NONE)----------'

CHANGE_LEADER_ARROW changes the terminators of the selected leader lines.


See also


CHANGE_LEADER_ARROW_SIZE command

                                                +----------------+
                                                v                |
-->(CHANGE_LEADER_ARROW_SIZE)---->|number|----->+--|selection|-->+---->

CHANGE_LEADER_ARROW_SIZE changes the size of the selected leader-line terminators.


See also


CHANGE_LINESIZE command

                                         .----------------.
                                         v                |
--->(CHANGE_LINESIZE)--->|linesize|----->+--->|select|--->+--->

CHANGE_LINESIZE changes the linesize of selected elements. Applies to geometry only and not to construction geometry or POINT symbols.

This command can be applied to geometry with a pensize or a linesize.


See also


CHANGE_LINETYPE command

                                       .----------------.
                                       v                |
--->(CHANGE_LINETYPE)--->|linetype|--->+--->|select|--->+--->

CHANGE_LINETYPE changes the line type of selected elements, which may be construction geometry or real geometry. See LINEPATTERN functions for the possible linetypes.


See also


CHANGE_LOCALE function

---->(CHANGE_LOCALE)---->|locale|---->

CHANGE_LOCALE function changes current locale for messages localization. All user interface elements are re-localized.

"de" German
"es" Spanish
"fr" Franch
"it" Italian
"ja" Japanese
"en" English

Note, that the system defaults to "en" (English) locale, if there is no corresponding catalogs or the function parameter locale contains some unsupported language ID.


See also


CHANGE_PART_REF_PT function

---->(CHANGE_PART_REF_PT)---->|point|---->

CHANGE_PART_REF_PT changes the reference point of the active part. The reference point is used in three places. First, when you LOAD a drawing as a subpart, you choose a location point for the subpart. The subpart's reference point is placed at that location. Second, when a part is a symbol, the reference point is the point that remains fixed relative to the geometry when you change the drawing scale. Third, when you bring a part into the active part with GATHER, you are sometimes asked for a location point. In this case, as with LOAD, it is the reference point that goes there.

Before you change the part reference point, it is the lower left corner of the part box. If you change the part reference point, then delete all elements in the part, your change is forgotten.


See also


Change_part_url

                                                       ,-------<-------,
                                                       |               |
--->(Change_part_url)--->|old string|-->|new string|-->+-->|select|--->+-->

Change_part_url looks at all URLs of the selected parts and changes URLs that match old_string into 'new_string'. 'Old_string' may contain wildcards (see SELECT for a list). If 'new_string' is empty, the matching strings are deleted.


See also


CHANGE_PENSIZE command

                                       .----------------.
                                       v                |
--->(CHANGE_PENSIZE)--->|pensize|----->+--->|select|--->+--->

CHANGE_PENSIZE changes the pensize of selected elements. Applies to geometry only and not to construction geometry or POINT symbols.

This command can be applied to geometry with a pensize or a linesize.


See also


CHANGE_TEXT command

                                  ,------------,
                                  v            |
-->(CHANGE_TEXT)--+-->|new line|-+-+->|select|--+-->
                  |              ^
                  `--->(SCREEN)--'

CHANGE_TEXT changes one or more existing texts to new text. Single line and multi-line text are possible.


See also


CHANGE_TEXT_ADJUST command

                                    ,-------------,
                                    v             |
-->(CHANGE_TEXT_ADJUST)-->|number|--+-->|select|--+-->

CHANGE_TEXT_ADJUST changes the adjust parameter of a selected text. The range for the adjust number is [1...9] (see TEXT_ADJUST).


See also


CHANGE_TEXT_ANGLE command

                                            ,-------------,
                                            v             |
-->(CHANGE_TEXT_ANGLE)-+->|number|--------->+-->|select|--+-->
                       |                    ^
                       |                    |
                       +->|point|-->|point|-+

CHANGE_TEXT_ANGLE changes the angle of the selected text (see TEXT_ANGLE). The angle is specified by a value or by two points.


See also


CHANGE_TEXT_FILL command

                                  ,-------------,
                                  v             |
-->(CHANGE_TEXT_FILL)--+-->(ON)-->+-->|select|--+---->
                       |          ^
                       '-->(OFF)--'

CHANGE_TEXT_FILL turns filling of the selected text on or off. See TEXT_FILL.


See also


CHANGE_TEXT_FONTNAME command

                                             +------------------+
                                             v                  |
---->(CHANGE_TEXT_FONTNAME)---->|string|---->+---->|select|---->+---->

CHANGE_TEXT_FONTNAME changes 1 byte font of the selected text. If the font is not loaded, it is loaded from absolute path or current directory or MEDIR. Only 1 byte fonts can be loaded.


See also


CHANGE_TEXT_FONTNAME_2BYTE command

                                                   +------------------+
                                                   v                  |
---->(CHANGE_TEXT_FONTNAME_2BYTE)---->|string|---->+---->|select|---->+---->

CHANGE_TEXT_FONTNAME changes 2 byte font of the selected text. If the font is not loaded, it is loaded from absolute path or current directory or MEDIR. Only 2 byte fonts can be loaded.


See also


CHANGE_TEXT_FRAME command

                                       ,-------------,
                                       v             |
-->(CHANGE_TEXT_FRAME)--+-->(OFF)------+-->|select|--+---->
                        |              ^
                        |-->(BOX)----->|
                        |              |
                        +-->(BALLOON)->+
                        |              |
                        +-->(FLAG)---->+

CHANGE_TEXT_FRAME changes the frame of the selected text.


See also


CHANGE_TEXT_LINESPACE command

                                       ,-------------,
                                       v             |
-->(CHANGE_TEXT_LINESPACE)-->|number|--+-->|select|--+-->

CHANGE_TEXT_LINESPACE changes the spacing factor between lines of the selected multi-line text. The distance between the baselines of the text is linespace * size.


See also


CHANGE_TEXT_RATIO command

                                   ,-------------,
                                   v             |
-->(CHANGE_TEXT_RATIO)-->|number|--+-->|select|--+-->

CHANGE_TEXT_RATIO changes the ratio between character width and height in the selected text. The height remains constant, and the width changes to fit this new ratio.


See also


CHANGE_TEXT_SIZE command

                                  ,-------------,
                                  v             |
-->(CHANGE_TEXT_SIZE)-->|number|--+-->|select|--+-->

CHANGE_TEXT_SIZE changes the character size of the selected text. The number given is the new text height. The text width is updated according to the element's text ratio (see TEXT_RATIO).


See also


CHANGE_TEXT_SLANT command

                                   ,-------------,
                                   v             |
-->(CHANGE_TEXT_SLANT)-->|number|--+-->|select|--+-->

CHANGE_TEXT_SLANT changes the slant of the selected text. The new slant must be between -80 and 80 degrees. See TEXT_SLANT.


See also


CHANGE_VIEWPORT_COLOR function

-->(CHANGE_VIEWPORT_COLOR)->--+------------>|background color|----->------+-->
                              |                                           |
                              |                                           |
     ,-----------<------------'                                           ^
     |                                                                    |
     +->-(CURRENT)->-,   ,--------------------<------------------,        |
     |               |   |                                       |        |
     +->-|number|-->-+->-+------------>-----------+->|new color|-+->(END)-'
     |               |   |                        |
     +->-|pnt_2d|-->-'   v                        ^
     |                   |                        |
     `------->-----------+->-(BACKGROUND_COLOR)->-+
                         |                        |
                         +->---(BORDER_COLOR)--->-+
                         |                        |
                         +->----(TEXT_COLOR)---->-+
                         |                        |
                         `->---(CURSOR_COLOR)--->-'

CHANGE_VIEWPORT_COLOR changes the background color of the current viewport. See COLOR for a list of colors.

CHANGE_VIEWPORT_COLOR has two different modes of operation:

If background color is entered directly after invocation of the function, the system will set the background color of the viewport to that color and will set the other viewport colors to defaults depending on the viewport background color. This behavior is maintained for compatibility with previous revisions.

If you either select a viewport or enter one of the qualifiers mentioned above, the system will allow you to enter the different colors individually. Colors that you do not change explicitly, will keep their values. (Example : CHANGE_VIEWPORT_COLOR CURSOR_COLOR WHITE END will set the cursor color to white and will leave all other colors unchanged).

CURRENT indicates that you want to change color(s) of the current viewport. You can use this qualifier to indicate that you want to use the second mode of operation. You can also select a viewport by picking or by entering the viewport number.

Use the qualifiers BACKGROUND_COLOR, BORDER_COLOR, TEXT_COLOR or CURSOR_COLOR to indicate which particular color you want to change. If you do not use one of these qualifiers, the system will allow you to enter the colors in turn, until you have completed you input by entering END or you enter any new command. Use CANCEL to abort the function, leaving all viewport colors unchanged.

Note
If you enter a new background color in the second mode of operation, there will be NO automatic calculation of the other colors as this is done in the first mode. Example: If you have a cursor color of WHITE and you change the background color to WHITE, the system will not adjust any of the colors, so you will get a WHITE cursor on a WHITE background.


See also


CHANGE_VIEWPORT_SIZE function

-->(CHANGE_VIEWPORT_SIZE)-->|new corner point|-->|new opposite corner point|-->

CHANGE_VIEWPORT_SIZE changes the size of the current viewport. The new corner points may be specified in the display pixel coordinate system (origin lower left, each pixel one unit), or may be digitized on the screen. This function tries to keep the current window settings, but minor changes are necessary if the aspect ratio is changed. See CREATE_VIEWPORT for more information.


See also


CHAR_LAYOUT command

                   +<------------------------------------------+
                   |                                           ^
                   |              ,--------------,             |
                   v              v              |             |
-->(CHAR_LAYOUT)-->+-->|string|---+-->|point|--+-+------------>+-->(END)-->
                                  |            ^ |             ^
                                  '-->(BREAK)--' '-->|number|--'

CHAR_LAYOUT (re)defines the character(s) of the current font. The character strokes are defined in terms of an imaginary grid measuring 250 x 250 units, whose origin is the lower left corner.

String describes the character to be defined. For 8 bit fonts, the character range is from #0 to #255.

Point describes a point on the grid. Its range is integer 0...250,0...250.

BREAK is an option to lift the pen and move it to next point.

Number gives the real width of the character including the space to the next character. It is in grid units with the integer range 0...250. Default value is width parameter of the DEFINE_FONT function.

A maximum of 250 points or BREAKs are accepted per character.

If you use characters of a font which have not been previously defined the system will display them as boxes.

See DEFINE_FONT for the mapping of grid units to user units.


See also


CHECKIN command

-->(CHECKIN)->|source name|-+--------+-->+
			    |	     v	 |
			    +<-{sel}-+	 |
					 v
		 +<----------------------+
		 |
		 +>+----------+-+---------+-+-+----------------+-+->(CONFIRM)->
		   v	      | v	  | | v		       | v
		   +->(KEEP)->+ +->{sta}->+ | +->{element id}->+ +->(SCREEN)-->
					    |
					    +>{create}----------------->

{sel}--->(SELECT)--->|expr|--->

|expr|

--->|item|-------+-------->+------>|value|------>
		 |	   |
		 +->(=)--->+
		 |	   |
		 +->(<>)-->+
		 |	   |
		 +->(>)--->+
		 |	   |
		 +->(<)--->+
		 |	   |
		 +->(>=)-->+
		 |	   |
		 +->(<=)-->+

{sta}

-->(AREA)--->|area name|--->

{create}

-->(AS)->|class name|-+
		      |
     +----------------+
     |
     +--+---------------+--+-----------------+--+-(CONFIRM)->+-+->{att}->
	v		|  |		     |	|	     | |
	+->|rev string|-+  +->|vers number|->+	+-(SCREEN)-->+ +-------->

{att}

  +<---------------------------------------+
  v					   |
  +->|attribute name|-+->|attribute value|-+
  |		      |			   ^
  |		      +->(NULL)----------->+
  v					   |
--+----------------------------------------+-->(CONFIRM)->
  |
  |
  |
  |	      +<-------------------+
  |	      v			   |
  +->(PROMPT)-+->|attribute value|-+------------------->
	      |			   |
	      +->(NULL)----------->+

{element id}

-->|element name|--+-------------------------------------------------------+->
		   v							   |
		   +->(SEL_OLD)--+->|revision string|->|version number|-+->+
				 |					|
				 +->|revision string|------------------>+
				 |					|
				 +->|version number|------------------->+

A set of files may be specified to be checked in. This means the files are stored in one of the storage areas and the information about it is stored in the database.

If a corresponding hp_catfile entry exists for a file, the info available in the hp_catfile is stored in the database. If no hp_catfile entry exists, only the file info, available from the operating system, is stored in the database.

The user may specify an element to which files should be related.

Note
It is recommended that a file be related to one and only one element and vice-versa. See the RELEASE command for more information.

To checkin a file and relate it to an element is possible only if the element is not archived.

Element-selection:

File-selection:

With SELECT, you can choose which files in the directory should be checked in. You do this by giving an item name, then saying what values that item should match.

For example,

	SELECT 'FILE_TYPE' 'Model.MI'

selects the MI files. The item name must be a string. The value is a string, except for the items FILE_SIZE and NUM_ACCESS, where it is a number. For the items that are dates ( CREATE_DATE, MODIFY_DATE, ACCESS_DATE), the value is normally in the form 'DD-Mmm-YY hh:mm:ss'. If you omit the year or month, you get the current one. If you omit the date, it defaults to 1. If you omit the hh:mm:ss, it defaults to midnight. The value may contain wildcards; thus

	SELECT 'FILE_NAME' 'A*'

selects the files whose names begin with 'A'. See SELECT (the entry in this help file for element selection ) for a description of wildcards.

SELECT also allows a relational operator between the item name and the value. Thus

	SELECT 'ACCESS_DATE' < '01-Jan-85'

selects the files whose ACCESS_DATE string is less than '01-Jan-85'.

	SELECT 'FILE_SIZE' > 10240

selects files larger than 10Kb. The operators can also be used with names; here '<' means 'earlier in an alphabetical ordering', etc.

You can use SELECT more than once. The resulting files satisfy all of the selection criteria.

The items you can select on 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

The option 'SCREEN' enters the built-in editor (see EDITOR) and allows you to verify the list of selected files; any changes in the screen are ignored. With an unsuccessful exit (STOP/BREAK) from the editor nothing is checked-in.

security: Command may not be invoked by PRIV 4 users. To checkin files related to a specific element, WRITE-permission for this element is required.


See also


CHECKOUT command

-->(CHECKOUT)-->{sel}--+-------------+--+-------------+-->|location|-->
		       v	     |	v	      |
		       +->(RESERVE)->+	+->(DEL_OLD)->+

{sel}

-->+->(FILE)->|file name|------------------>+-->
   |					    |
   +->{element id}->+---------------------->+
		    |			    |
		    +->(FILE)->|file name|->+

{element id}

-->|element name|--+-------------------------------------------------------+->
		   v							   |
		   +->(SEL_OLD)--+->|revision string|->|version number|-+->+
				 |					|
				 +->|revision string|------------------>+
				 |					|
				 +->|version number|------------------->+

Command to get local copies of the specified files.

The selected files are copied to the specified "location" directory.

element options:

file options:

Note
It's only possible to checkout files of an element if the element is not archived.
Note
If a file is related to an element, you MUST specify the element FIRST and then the file name in order for the system to properly identify the file to be checked out. Refer to the following diagram:

 -------------				  In order to determine which "myfile"
|  myfile | 0 |				  to CHECKOUT, an element name MUST be
 -------------				  specified in order to checkout the
					  second or the third "myfile".	 If
 -------------		 -------------	  no element name is given then the
|  myfile | 1 |---------| myelement_a |	  first "myfile" is checked out as it
 -------------		 -------------	  has no relationships to any elements.

 -------------		 -------------
|  myfile | 3 |---------| myelement_b |
 -------------	   |	 -------------
		   |	 -------------
		   -----| myelement_c |
		   |	 -------------
		   |	 -------------
		   -----| myelement_d |
			 -------------

security:

READ access is required for the element if it is related to the file to be checked out.

WRITE access is needed to reserve it.


See also


CHECK_3D_GEO_MODIFY function

->(CHECK_3D_GEO_MODIFY)---->--+---OFF ---+-->
                              |          |
                              +--WARNING-+

While using the commands MODIFY, DRAWING_SCALE or PART_DRW_SCALE to modify elements coming from a SolidDesigner layout a warning will appear that you should modify views and geometry within those views only with the specific view modification commands in the ASSOCIATIVE DOCUMENTATION UPDATE menu. Otherwise the geometry will lose associativity with the SolidDesigner geometry.

CHECK_3D_GEO_MODIFY OFF allows you to switch this warning off.

Default setting is WARNING.


See also


CHECK_BREAK function

---->(CHECK_BREAK) ---> number

Returns 1 if BREAK key was pressed and IGNORE_BREAK was active.


See also


CHECK_DIM_DETAIL function

-->--(CHECK_DIM_DETAIL)-->--+-->----(WARNING)----->--+---------->
                            |                        |
                            +-->----(ON)---------->--+
                            |                        |
                            +-->----(OFF)--------->--+

The CHECK_DIM_DETAIL function enables/disables the built-in dimension checking mechanism. By default a warning is displayed if a geometrical element in a detail part is dimensioned from the parent part. A detail part created with a scale factor can only be dimensioned correctly with the corresponding detail part scale, if it is the active part. If the parent part is the active part, the dimension value uses the parent part scale and not the detail scale.

WARNING (default) enables the dimension checking mechanism. If the user tries to dimension an element in a detail part when the parent part is the active part, the system will display a warning, which has to be acknowledged. This may abort a running macro. However, there are only a few cases where this type of dimensioning is used.

ON enables the dimension checking mechanism. If the user tries to dimension an element in a detail part when the parent part is the active part, this is an error. The element will not be accepted. No warning will be displayed.

OFF disables the dimension checking mechanism. So no warning is displayed if elements in a detail part are dimensioned while the parent part is active and macros are not aborted.


See also


CHECK_DIM_DRWSCALE function

-->--(CHECK_DIM_DRWSCALE)-->--+-->----(WARNING)----->--+---------->
                              |                        |
                              +-->----(ON)---------->--+
                              |                        |
                              +-->----(OFF)--------->--+

The CHECK_DIM_DRWSCALE function enables/disables the built-in dimension checking mechanism. By default a warning is displayed if a geometrical element is dimensioned from above and the active part has not the same scale as the element. The dimension value will reflect the different drawing scales.

WARNING (default) enables the dimension checking mechanism. If the user tries to dimension an element that has not the same drawing scale as the active part, the system will display a warning, which has to be acknowledged. This may abort a running macro. However, there are only a few cases where this type of dimensioning is used.

ON enables the dimension checking mechanism. If the user tries to dimension an element that has not the same drawing scale as the active part, this is an error. The element will not be accepted. No warning will be displayed.

OFF disables the dimension checking mechanism. Dimension at elements that have not the same drawing scale as the active part can be done without getting any warning and macros are not aborted.


See also


CHECK_DIM_SYMBOL function

-->--(CHECK_DIM_SYMBOL)-->--+-->----(WARNING)----->--+---------->
                            |                        |
                            +-->----(ON)---------->--+
                            |                        |
                            +-->----(OFF)--------->--+

The CHECK_DIM_SYMBOL function enables/disables the built-in dimension checking mechanism. By default a warning is displayed if a geometrical element in a symbol part is dimensioned or if the user tries to dimension from within a symbol part. A symbol part has always the drawing scale 1 and its own coordinate system. The dimension value will reflect this special symbol functionality.

WARNING (default) enables the dimension checking mechanism. If the user tries to dimension an element in a symbol part or if the active part is a symbol, the system will display a warning, which has to be acknowledged. This may abort a running macro. However, there are only a few cases where this type of dimensioning is used.

ON enables the dimension checking mechanism. If the user tries to dimension an element in a symbol part or if the active part is a symbol part, this is an error. The element will not be accepted. No warning will be displayed.

OFF disables the dimension checking mechanism. Dimension above or in symbol parts can be done without getting any warning and macros are not aborted.


See also


CHECK_DIM_TEXT function

-->--(CHECK_DIM_TEXT)---->--+-->----(WARNING)----->--+---------->
                            |                        |
                            +-->----(ON)---------->--+
                            |                        |
                            +-->----(OFF)--------->--+

The CHECK_DIM_TEXT function enables/disables the built-in dimension checking mechanism. By default a warning is displayed if a text is dimensioned because dimensioning a text may cause later data corruption after STORE and LOAD.

WARNING (default) enables the dimension checking mechanism. If the user tries to dimension a text the system will display a warning which has to be acknowledged. This may abort a running macro. However, there are only a few cases where this type of dimensioning is used.

ON enables the dimension checking mechanism. If the user tries to dimension a text this is an error. The element will not be accepted. No warning will be displayed.

OFF disables the dimension checking mechanism. Dimension a text can be done without getting any warning and macros are not aborted.


See also


CHECK_ERROR ===> number

Returns 1 if one or more errors were trapped since the last TRAP_ERROR function call, otherwise returns 0. CHECK_ERROR also resets error handling back to the default behavior (stopping in case of errors).


See also


CHECK_FONT_FILLABLE function

---->(CHECK_FONT_FILLABLE)---->|output_specification|---->

With the CHECK_FONT_FILLABLE function characters of the current font are written to the selected output specification which cannot be filled.

|output_specification| See OUTPUT_SPEC


See also


CHECK_WINDOW function

-->--(CHECK_WINDOW)-->--+-->----(ON)----->--+---------->
                        |                   |
                        +-->--(WARNING)-->--+
                        |                   |
                        +-->----(OFF)---->--+

The CHECK_WINDOW function enables/disables the built-in window check mechanism which (by default) rejects extremely large or small window settings. CHECK_WINDOW applies for both the WINDOW and RENOVATE function.

ON (default) enables the window check mechanism. If the user tries to set an extremely large or extremely small window, the system will BEEP and reject to set the window. This may abort a running macro. However, in most practical drawing and designing techniques, the user will not reach this limit.

WARNING also enables the window check mechanism, but extreme windows as mentioned above will not be rejected by the system. The system will only BEEP to inform you that you are leaving the safe window area, and that you might get unpredictable drawing results on the screen.

OFF disables the window check mechanism. The system will accept any window without a BEEP, however the system may report an integer overflow or floating point exception error due to software and hardware limitations. You should be able to recover from such a situation by resetting the window to practical values.


See also


CHG LINES screen menu item

The CHG LINES screen menu contains options for changing the style of existing dimension lines in your drawing.


CHG TEXTS screen menu item

The CHG TEXTS screen menu contains options for changing the style of existing dimension text items in your drawing.


CHG_CENLINE command

                 +----------------------------------------+
                 v                                        ^
-->(CHG_CENLINE)-+->+->+----------+-->-(pnt1)-->-(pnt2)---+-->
                    |  |          |                       |
                    |  +-(EXTEND)-+                       |
		    |                                     |
		    +-(ROTATE)-->(pnt1)-->+-(pnt2)--+-----+
					  |         |
					  +-(angle)-+

With CHG_CENLINE, you can either extend the crosslines of a centerline (option EXTEND) or rotate the centerline around its center (option ROTATE) by a specified angle.


See also


CHG_PIXEL_COLOR command

----->(CHG_PIXEL_COLOR)--------+----->|pnt|------+----+-----------------+--+
                               |                 |    |                 |  |
                               +--->|string|-----+    +--->|to color|---+  |
                                                                           |
  ,<-----------------------------------------------------------------------'
  |
  |
  |
  `-+---->(BOX)------------>|pnt1|---->|pnt2|-----------+------------------>
    |                                                   |
    |                                ,------------,     |
    |                                v            |     |
    +---->(POLY)---->|start point|---+-->|point|--+---->+
    |                                                   |
    |                    ,------------,                 |
    |                    v            |                 |
    `---->(BRUSH)--------+-->|point|--+-----------------+
    |                                                   |
    |                                                   |
    `---->(SET_COLOR)------->|point|--------------------+

CHG_PIXEL_COLOR modifies pixels inside a pixmap within the selected BOX,POLYGON or (continuous) BRUSH selection. The color of the selected region will be changed to the current pixel edit color.

By using the option SET_COLOR you can set all the pixels in the pixmap having color same as the picked point to current pixel editing color.

Current pixel edit color can be changed at any time, while in the midst of CHG_PIXEL_COLOR command. This can be specified as standard colors (WHITE, RED etc) or as RGB_COLOR/HSL_COLOR. By using 'to color' option, color can be specified by picking a point in the viewport. In that case the color of the pixel at the picked position will be taken. 'to color' has to be specified before selecting the change option.

To use CHG_PIXEL_COLOR, select the pixmap to be edited, specify a region selection type and then identify the region to be edited. When the option BRUSH is chosen, you can continuously edit portions of the pixmap by moving the mouse over the selected pixmap, while keeping the SHIFT button on the keyboard depressed.

The size of the 'brush' will be set to the current 'catch range'.

If the pixmap on which CHG_PIXEL_COLOR is to be used is covered by some other pixmap(s), it will be automatically brought 'To Front' before the editing.

Whenever two or more pixmaps are overlaping on one another and if you have picked a point in the overlaping area, it results in an ambigious pick. In such a case you will get an error message. Then pick in a non-ambigious portion of the pixmap or select by providing name of the pixmap.


See also


CHG_SYMLINE command

                 +<---------------------+
                 |                      |
-->(CHG_SYMLINE)-+->-(pnt1)-->-(pnt2)---+-->

With CHG_SYMLINE, you can extend (or shrink) the end position of a symmetry line by picking pnt1 and moving it to the new end position pnt2.


See also


CHR number ===> string

Returns a single character string which has an ordinal value defined by the argument.


See also


CIRCLE command

             ,-----------------------------------------------------------,
             |                                     ,---------------,     |
             v                                     v               |     |
-->(CIRCLE)--+--+-->(CENTER)----+-->|center point|-+-|per point|-+-+-----+->
             |  |               ^                  |             |       |
             |  `---------------'                  `--|radius|---'       |
             |                                                           |
             |                  ,------------------<-------------------, |
             |                  v                                      | |
             +------(DIAMETER)--+-->--|end point1|---|end point2|------+-+
             |                                                           |
             |                  ,------------------<-----------------,   |
             |                  v                                    |   |
             +-->(THREE_PTS)----+->|per pnt|-->|per pnt|-->|per pnt|-+-->+
             |                                                           |
             |                                     ,--------------------,|
             |                                     v                    ||
             +->(PARALLEL)->|pnt on exist. circ|-+->|pnt on new circ|-+-++
             |                                   v                    ^  |
             |                                   `-----|distance|-----'  |
             |                                                           |
             |            ,------------------------<-------------------, |
             |            v                                            | |
             +->(TAN2_PT)-+-|apptan pnt1|->-|apptan pnt2|-+--|radius|--+-+
             |                                            |            | |
             |                                            `-|position|-' |
             |                                                           |
             `->(ASSIST)-------------------------------------------------'

CIRCLE creates a circle.

TWO_PTS creates a circle with the given center and radius or center and peripheral point.

THREE_PTS creates a circle through the three given points.

PARALLEL makes a new circle parallel to the given circle/arc/fillet through the given point or at the given distance. Positive distances mean that the new circle will be outside the old one, and negative distances, inside.

TAN2_PT makes a circle tangential to two other elements, with the given radius or through the given peripheral point. The approximate tangent points are used both to identify the elements and to decide which of the possible tangential circles was intended. If the two elements are parallel lines, the systems asks for a peripheral point to determine which circle to create. If the two elements are concentric circles, arcs, fillets, or c_circles, the system asks for the angle formed by the center of the old circles and the center of the new.

The result of TAN2_PT depends on whether the third input is a radius or a peripheral point. With a peripheral point, the result is a circle. With a radius, the result is a circle if SPLITTING is off. If it is on, the result is a "split" circle, (two arcs forming a circle whose vertices are at the tangent points).

Because of limited accuracy in the algorithms that calculate tangents, the system occasionally announces that the requested tangent does not exist, when in fact it does. In these cases, try varying the input points or use another option to construct the circle.

The ASSIST qualifier switches on user assistance (COPILOT command). Additional graphical feedback and creation methods are then available. See the COPILOT command for more information.


See also


CLASSIFICATION menu

The CLASSIFICATION menu allow the user to access the CLASSIFICATION Application of CoCreate/DMS. CLASSIFICATION allows the user to build and search a class heirarchy. This enables faster searching for parts and easier differentiation among similiar parts.


See also


CLEANUP_DIMS command

-->--(CLEANUP_DIMS)-->--+-->(SYMBOL_DIM)--------+---(CONFIRM)------->
                        |                       |
                        +-->(DRWSCALE_DIM)------+
                        |                       |
                        +-->(TEXT_DIM)----------+
                        |                       |
                        +-->(DETAIL_DIM)--------+

The CLEANUP_DIMS command deletes meaningless dimensions of a special kind.

SYMBOL_DIM:   All dimensions in symbol parts and all dimensions at elements of
              symbol parts will be deleted.  These dimensions are affected by
              the special symbol functionality and may therefore often cause
              confusion.

DRWSCALE_DIM: All dimensions at elements of different drawing scale will be
              deleted. These dimensions are affected by the different
              drawing scales and may therefore often cause confusion.

DETAIL_DIM:   All dimensions at elements of a detail part that are located
              above the detail part will be deleted. These dimensions are
              affected by the different magnification factors and will therfore
              cause confusion.

TEXT_DIM:     All dimensions at texts will be deleted. These dimensions may be
              affected by slight inaccuracies during STORE and LOAD and may
              therefore cause LOAD problems.


See also


CLEAN_DRAWING command


                     +---------------------------------------------------------+
                     |                                                         |
                     |                                                         |
                     |                                                         |
                     |                            +-GLOBAL-+                   |
                     v                            v        |                   |
-->(CLEAN_DRAWING)---+-(CLEAN_CLOSE_POINTS)-------+--------+-|tol|---(CONFIRM)-+-->;
                     |                                     |
                     +-(CLEAN_DUPLICATE_GEOMETRY)----------+
                     |                                     |
                     +-(CLEAN_STAGGERED_GEOMETRY)----------+
                     |                                     |
                     +-(CLEAN_STACKED_GEOMETRY)------------+

This command is used to modify four geometrical situations which can cause inefficiency and confusion for parametric design, hatching and also for contours searching.

CLEAN_CLOSE_POINTS is used to merge points that are within the user specified distance of each other. For each set of two or more points which are to be merged, a new location is chosen to move the entire set of points to. The new location will be within the tolerance zone specified. To predict or control which elements will be adjusted one should use select functionality over smaller parts of the drawing and optionally cancel the automate adjustment in order to adjust manually in some other way. Command can be also used to remove elements smaller than a specified tolerance.

CLEAN_DUPLICATE_GEOMETRY is used to delete elements that are duplicates of other elements depending on the tolerance. If an element is smaller than the tolerance, it is also deleted. Circles and construction circles are determined to be duplicates if their center points match and their radii are within the specified tolerance. If the tolerance is zero, then geometry elements are found to be duplicates only if their model points match; for circles, including construction ones, the radii must also match.

CLEAN_STACKED_GEOMETRY is used to split overlapping lines, arcs and circles. The specified tolerance for this operation is a slope tolerance and can be used to split only lines that have slopes within the slope tolerance (this tolerance does not apply on arcs and circles and a complete match is required).

CLEAN_STAGGERED_GEOMETRY qualifier modifies drawing in a sense that merges partially or fully overlaped elements. In the first case, one of the elements is removed and the other is modified (stretched) in a way that the new end point matches the (farther) end point of the removed element. In the second case the smaller element gets removed. Note, that annotations are also removed with the removed elements.

Note: For arcs only concentric ones are treated as staggered, while for lines non-parallel ones are also treated as staggered. The tolerance value is applied on the distance between elements; for non-parallel lines the bigger distance is taken into account.

Notes
Each option can operate on the specified selection. By default it takes current part in a whole. Each option can operate through all the parts in the drawing if GLOBAL is used. In the cases where a cleanup is required the corresponding geometry is highlighted. The user is prompted for a confirmation before actually performing the modification. If no cleanup is necessary, then prompt this fact while asking for a new option. As an aid to the macro writer, a CONFIRM at this point will be ignored.


See also


CLEAR_KEYS function

 ---->(CLEAR_KEYS)--->

CLEAR_KEYS clears all defined Special Function Key and Alpha-Numerical key from memory.


See also


CLEAR_POSTFIX function

--->(CLEAR_POSTFIX)--->

By default, once a postfix string is defined for a dimension text, it is also automatically added to the text of all subsequently assigned dimensions.

CLEAR_POSTFIX clears the currently defined postfix string, if any.


See also


CLEAR_PREFIX function

--->(CLEAR_PREFIX)--->

By default, once a prefix string is defined for a dimension text, it is also automatically added to the text of all subsequently assigned dimensions.

CLEAR_PREFIX clears the currently defined prefix string, if any.


See also


CLEAR_SUBFIX function

--->(CLEAR_SUBFIX)--->

By default, once a subfix string is defined for a dimension text, it is also automatically added to the text of all subsequently assigned dimensions.

CLEAR_SUBFIX clears the currently defined prefix string, if any.


See also


CLEAR_SUPERFIX function

--->(CLEAR_SUPERFIX)--->

By default, once a superfix string is defined for a dimension text, it is also automatically added to the text of all subsequently assigned dimensions.

CLEAR_SUPERFIX clears the currently defined prefix string, if any.


See also


CLEAR_TOLERANCE function

--->(CLEAR_TOLERANCE)--->

By default, once a tolerance string is defined for a dimension text, it is also automatically added to the text of all subsequently assigned dimensions.

CLEAR_TOLERANCE clears the currently defined tolerance string, if any.


See also


CLIPBOARD_GLOBAL_SEL

-->(CLIPBOARD_GLOBAL_SEL)-->ON/OFF

CLIPBOARD_GLOBAL_SEL sets the behavior of ME10's cut/copy selection mechanism. With CLIPBOARD_GLOBAL_SEL set to ON, ME10 will select elements globally; that is within all subparts. With CLIPBOARD_GLOBAL_SEL off, ME10 will select elements only within the current part.


See also


CLIPBOARD_INVERSE_BW

-->(CLIPBOARD_INVERSE_BW)-->ON/OFF

CLIPBOARD_INVERSE_BW sets the behavior of ME10's cut/copy selection mechanism. With CLIPBOARD_INVERSE_BW set to ON, ME10 will convert black lines to white and vice versa within the enhanced metafile format, not within the ME10 native clipboard format. With CLIPBOARD_INVERSE_BW off, line colors will remain the same within both clipboard formats. This is designed to be used with other Windows applications which have backgrounds other than the ME10 default, black.


See also


CLIPBOARD_SIZE

-->(CLIPBOARD_SIZE)-->-(Xdimension)-->-(Ydimension)-->

CLIPBOARD_SIZE sets the plotting area for plots that are sent to the Windows Clipboard. Subsequent plots to the Clipboard will be clipped or fit into this plotting area, depending on the PLOT_SCALE setting. The CLIPBOARD_SIZE also sets the size of the Clipboard image that is pasted into a Windows application.

The X and Y dimensions that define the Clipboard size should be given in current user units.


See also


CLOSE_ALL_CONNECTIONS function

---->(CLOSE_ALL_CONNECTIONS)---->

The CLOSE_ALL_CONNECTIONS function closes current and pending HP InterLink connections. Any commands or data associated with the pending connections will be lost. CLOSE_ALL_CONNECTIONS does not prevent subsequent connections from being established. CLOSE_ALL_CONNECTIONS may be used to reset HP InterLink, should it appear to hang.


See also


CLOSE_CONNECTION function

---->(CLOSE_CONNECTION)---->

CLOSE_CONNECTION ends the current network connection to the ME System command line and moves to the next connection if one is waiting. Connections are handled on a first in, first out basis.


See also


CLOSE_FILE function

---->(CLOSE_FILE)---->|number|---->

CLOSE_FILE closes the specified file.


See also


CL_ABS_OFFSET function

    ---->(CL_ABS_OFFSET)---->

Use this function to set the absolute offset of the centerline when using the CENTERLINE command. The value is an absolute value. The total offset is given by the following:

     Total offset = (radius x CL_REL_OFFSET) + CL_ABS_OFFSET

                Example 1: radius = 5
                           CL_REL_OFFSET = 0.5
                           CL_ABS_OFFSET = 1
                           -------------------
                           Total offset  = 3.5

                Example 2: radius = 5
                           CL_REL_OFFSET = -0.4
                           CL_ABS_OFFSET =  0
                           --------------------
                           Total offset  = -2

When the offset is negative, the centerline is drawn inside the circle.


See also


CL_COLOR function

-->(CL_COLOR)---|color|--->

CL_COLOR lets you change the default color of a centerline. By default, a centerline is YELLOW. See COLOR for a list of colors.


See also


CL_LINETYPE function

-->(CL_LINETYPE)---|linetype|--->

CL_LINETYPE lets you change the default linetype of a centerline. By default, a centerline has linetype DASH_CENTER. See LINETYPE for a list of linetypes.


See also


CL_PENSIZE function

-->(CL_PENSIZE)---|pensize|--->

CL_PENSIZE let you change the default pensize of a centerline. By default, a centerline has no pensize.


See also


CL_REL_OFFSET function

    ---->(CL_REL_OFFSET)---->

Use this function to set the relative offset of the centerline when using the CENTERLINE command. The value is relative to the size of the radius. The total offset is given by the following:

     Total offset = (radius x CL_REL_OFFSET) + CL_ABS_OFFSET


See also


CMD_BG_COLOR function

-----(CMD_BG_COLOR)------->----|color|---->--

CMD_BG_COLOR sets the background color of the status line and the command line to the user specified color.


See also


CMD_TXT_COLOR function

-----(CMD_TXT_COLOR)------>----|color|---->--

CMD_TXT_COLOR sets the text color of the status line and the command line to the user specified color.


See also


CMP_ACCURACY function

->(CMP_ACCURACY)---->|value|--->

In version 06.10, the operator "=" applied to 2 numbers or points returned "1" if the 2 operands were equal within a range of 1E-12 (0.000000000001). This new behaviour caused compatibility problems.

Therefore from version 06.11 on there is a new function called CMP_ACCURACY that allows you to specify an accuracy value (within a range of 0 to 0.000001) for comparison of 2 operands on equality. By default, CMP_ACCURACY is set to 0 to be compatible with all versions up to 06.00. In general we recommend the use of the default.


See also


Color functions

---->+---->(RGB_COLOR)---+----->|red|------>|green|------>|blue|---->+---->
     |                   |                                           |
     |                   `-----------------|pnt_3d|----------------->+
     |                                                               |
     +---->(HSL_COLOR)---+-->|hue|--->|saturation|--->|luminosity|-->+
     |                   |                                           |
     |                   `-----------------|pnt_3d|----------------->+
     |                                                               |
     +---->(RED)---------------------------------------------------->+
     |                                                               |
     +---->(GREEN)-------------------------------------------------->+
     |                                                               |
     +---->(YELLOW)------------------------------------------------->+
     |                                                               |
     +---->(BLUE)--------------------------------------------------->+
     |                                                               |
     +---->(MAGENTA)------------------------------------------------>+
     |                                                               |
     +---->(CYAN)--------------------------------------------------->+
     |                                                               |
     +---->(WHITE)-------------------------------------------------->+
     |                                                               |
     `---->(BLACK)-------------------------------------------------->'

  red, green, blue, hue, saturation, luminosity:  number (0..1)

If the parameter pnt_3d is used, then the x,y,z values represent the three single numbers red(x), green(y), blue(z) or hue(x), saturation(y), luminosity(z).

The COLOR functions specify the color attribute used by all commands belonging to the same group as the currently active command. If the COLOR functions are used inside the LINE command, for example, they specify the color of all newly created geometric elements; if they are used during the DIM_LINE command, all future dimension elements will be affected. BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, and WHITE directly specify one of the eight primary colors; for any non-primary color use RGB_COLOR and specify the red, green, and blue intensity: (range 0...1) or use HSL_COLOR and specify the hue, saturation and luminosity (range 0...1).

The standard colors have the following rgb and hsl values:

            r g b     h  s l
            -----    -------
 BLACK    : 0 0 0     x  x 0     (x = don't care)
 RED      : 1 0 0     0  1 1
 GREEN    : 0 1 0    2/6 1 1
 YELLOW   : 1 1 0    1/6 1 1
 BLUE     : 0 0 1    4/6 1 1
 MAGENTA  : 1 0 1    5/6 1 1
 CYAN     : 0 1 1    3/6 1 1
 WHITE    : 1 1 1     x  0 1

RGB and HSL COLOR MENUS:

The RGB and HSL COLOR MENUS can be called from the COLOR command block on the tablet (or from the COLOR window in screen-only versions).

To specify a particular color, pick RGB COLOR in COLOR. The RGB COLOR MENU is displayed and you can specify the red, green, and blue intensities.

Each cell increases in steps of 0.04. You can increase the intensities by picking cells or picking the current intensity value and entering the desired value on the command line.

The functions do the following:

RECALL Recalls a color from the current color palette (not from a
       saved file):