GATHER command

	     ,----------------,
	     |                |
             v                ^
-->(GATHER)--+----------------+----+--------+--|name or pnt or box|--...
             |                |    |        |
             +-(COPY)---------+    +-(PART)-+
	     |                |
	     +-(KEEP_DATA)----+
             |                |
	     '-(KEEP_DISPLAY)-'


        ...--+----------------+-->
             |                |
             '--|pt1|--|pt2|--'

GATHER brings elements into the active part. The elements must already exist in another part.

The element is selected as follows. If you enter a name, the part with that name is gathered. If you identify a part box, that part is gathered. Otherwise, you identify an element that is not a part. In this case, if you use the PART option, the part containing this element is gathered; if not, you get the element itself. You can also identify a group of elements by entering the opposite corners of a box; this is possible only without the PART option.

Without the COPY option, the element selected is removed from its part, and inserted in the active part, without its location changing. You may not gather a part above the current part in this case.

With the COPY option, the selected element remains, and you get a copy of it in the active part. In this case, you must say where the copy is to be placed. For that purpose, you give a begin and end point of a translation vector, as with MOVE.

The current implementation is limited in the following ways. If you GATHER elements forming a hatch contour, the hatch is preserved only if you gather all the elements at once, in a box. These limitations do not apply when you GATHER entire parts.

The GATHER ELEMENT command has the options:


See also


GATHER_DIM command

	         ,-----------------,
	         |                 |
                 v                 ^
-->(GATHER_DIM)--+-----------------+--->
                 |                 |
	         +--|point on dim|-+
                 |                 |
	         +--(ALL_ABOVE)----+
                 |                 |
	         '--(ALL_BELOW)----'

GATHER_DIM brings dimension elements into the active part. The dimension must already exist in another part.

The dimension can selected by directly clicking on the element. With option ALL_ABOVE, all dimensions which lie in parts which are parents of the active part can be brought into the active part. With option ALL_BELOW, all dimensions which lie in sub-parts of the active part can be brought into the active part.

The element selected is removed from its part, and inserted in the active part, without its location changing.


See also


GEOM TYPE screen menu item

The GEOM TYPE menu button displays a menu of commands for adding and deleting geometry types to the current dimension selection filter.


GETENV string ===> string

Returns the contents of the named environment variable. If not set, GETENV returns a zero length string ("").


See also


GET_ELEM_INFO function

---->(GET_ELEM_INFO)---->|pnt on elem|---->

GET_ELEM_INFO changes the current info to be the same as the info of the identified element. The element need not be in the active part. The current info is the info added to every new element.


See also


GET_PID ===> number

Returns the process ID of the running program.


See also


GET_PROPERTIES function

---->(GET_PROPERTIES)---->|point on element|---->

GET_PROPERTIES changes the current properties to be the same as the properties of the identified element. The element need not be in the active part.

The current properties are the ones set by the following functions:

real geometry (not construction geometry)

      LINE  END
      LINE  END
      PENSIZE 
      LINESIZE 

construction geometry

      C_LINE  END
      C_LINE  END

hatch

      CURRENT_HATCH_PATTERN
      HATCH_ANGLE
      HATCH_DISTANCE
      HATCH_REF_PT

text

      TEXT  END
      CURRENT_FONT
      TEXT_ADJUST
      TEXT_ANGLE
      TEXT_FILL
      TEXT_FRAME
      TEXT_LINESPACE
      TEXT_RATIO
      TEXT_SIZE
      TEXT_SLANT
-------------------------------------------------------------------------------

GET_PROPERTIES changes only properties that the identified element has. For example, GET_PROPERTIES from a text leaves the current hatch information as it was.

The current properties are used for every new element of the corresponding type. They can also be assigned to existing elements with PUT_PROPERTIES.


See also


GETTEXT msg_id ===> string

GETTEXT arithmetic function returns a translation of 'msg_id' string using domain set by TEXTDOMAIN command.


See also


GET_TYPE token ===> qualifier

Returns the type of the token specified. The possible return values are:

        COMMAND
        FUNCTION
        QUALIFIER
	MACRO
        PSEUDO_COMMAND
      	ARITHM_FUNCTION
        SYMBOL
        STRING
        NUMBER
        PNT
        PNT3
        ILLEGAL

Note

Input should be given within parentheses. Only one parameter can be given as input, ie expressions are not allowed.

Examples:
	DISPLAY (GET_TYPE (10))    -----  Returns NUMBER

	LET A 1,1
	DISPLAY (GET_TYPE (A))     -----  Returns PNT.


See also


Goback_to_logfile_list_dhlc

The menu for reviewing the logfiles will be displayed.


GRID_FACTOR function

--->(GRID_FACTOR)--->|value|---->

GRID_FACTOR specifies the distance (in current units, of course) between grid points or ruler ticks. This function has no effect on the input coordinate system.


See also


HATCH command

         +-----------------------------------------------------==-----+
         |                                                            |
         | +----------+                                               |
         v |          v                                               |
->(HATCH)+-+>(AUTO)---+-----|pnt in face |-------------------+        |
         |                                                   |        |
         |           +---------------------------------+     |        |
         |           |                                 |     |        |
         |           +--------------(UNDO)-------------+     |        |
         |           |                                 |     |        |
         |           |          ,------------,         |     |        |
         |           v          v            |         ^     v        ^
         +->(MANUAL)-+->|point|-+-->|point|--+-->(END)-+>--+-+>-------+--->
         |                      |            ^             | v        ^
         |                      |-->(UNDO)---|             | |        |
         |                      |            |             ^ +-(UNDO)-+
         |                      +-->(VERTEX)-+             |
         |                                                 |
         +-(EQUIDISTANT)->-|distance|--{1}--+-->--+-|side|-+
                                            |     |
                                            +-{2}-+


                                    +->(SPLITPOINT)->-|endpt|-+
                                    |                         |
{1}->-+------->-------+-+-|startpt|-+->-|element|-+->(END)->--+-->
      |               | |           |             |           |
      +->(SPLITPOINT)-+ |           +------<------+           |
                        ^           |             |           v
                        |           +-<-(UNDO)-<--+           |
                        |                                     |
                        +-----------<---(UNDO)----<-----------+

      +------------<-------------+
      |                          |
{2}->-+->(MIN_RADIUS)->-|number|-+-->
      |                          |
      +->(MAX_RADIUS)->-|number|-+
      |                          |
      +->(MIN_LENGTH)->-|number|-+
      |                          |
      +->-|resolution|-----------+

HATCH creates hatches, possibly with inner contours.

With AUTO (the default), you indicate a point inside the outer contour but not in any inner contour. The inner contours are found automatically. Automatic hatch functions only if:

With MANUAL, you specify the points on the hatch boundaries yourself -- first the outer contour, then the inner ones. To include an element in a contour, identify an end point, then a point in the middle. To include further (connected) elements, identify each one in the middle. The system will allow you to skip elements along a contour, as long as you do not skip more than one element past any branch points. The included elements must be in the active part. Enter END when all hatch boundaries, outer and inner, are defined.

With EQUIDISTANT, you select an open or closed contour as for the EQUIDISTANCE command. Use SPLITPOINT to split an existing contour at the start and end points of the selection. The hatch is made as if a contour equidistant to the selected one were used for part of the hatch boundary. The precision of the boundary can be set using the resolution parameters, like for CONVERT_SPLINE.

UNDO works as follows: In the AUTO option it removes the last hatch. In the MANUAL and EQUIDISTANT options, it removes points when creating a contour. Finally, once you have ENDed a hatch, using UNDO removes the entire hatch.

Use VERTEX to make clear, that you do not want to include an element in the contour, but specify a hatch boundary point on an element.

If you change a contour of a hatched face by inserting new components, the hatch is not necessarily updated. In this case, you need to delete the old hatch and create a new one. Example: create a rectangle an hatch it. Insert a line which splits the rectangle to two rectangles. Hatch the rectangle again with a different angle. The hatch will follow the old contour, not the new contour.


See also


HATCH_ANGLE function

-->(HATCH_ANGLE)---->|value|---->

HATCH_ANGLE sets the current hatch angle. This angle is used for all new hatches, and is the angle between the X axis and the hatch pattern.


See also


HATCH_COLOR function (OLD)

-->(HATCH_COLOR)--+-->(BLACK)---->+-->
                  |               ^
                  |-->(BLUE)----->|
                  |               |
                  |-->(CYAN)----->|
                  |               |
                  |-->(GREEN)---->|
                  |               |
                  |-->(MAGENTA)-->|
                  |               |
                  |-->(RED)------>|
                  |               |
                  |-->(WHITE)---->|
                  |               |
                  '-->(YELLOW)----'

HATCH_COLOR sets the current hatch color, which is used for all new hatches.

Use HATCH |color functions| END for new macros.


See also


HATCH_DIST function

-->(HATCH_DIST)---->|value|---->

HATCH_DIST sets the current hatch distance. This distance is usually the distance between hatch lines, but see also CURRENT_HATCH_PATTERN. This affects new hatches.


See also


HATCH_LINETYPE function (OLD)

-->(HATCH_LINETYPE)--+-->(SOLID)------------->+-->
                     |                        |
                     |-->(DASHED)------------>|
                     |                        |
                     |-->(LONG_DASHED)------->|
                     |                        |
                     |-->(DOT_CENTER)-------->|
                     |                        |
                     |-->(DASH_CENTER)------->|
                     |                        |
                     |-->(PHANTOM)----------->|
                     |                        |
                     |-->(CENTER_DASH_DASH)-->|
                     |                        |
                     `-->(DOTTED)------------>'

HATCH_LINETYPE sets the current hatch linetype, which is used for new hatches.

Use HATCH |linepattern functions| END for new macros.


See also


HATCH_REF_PT function

-->(HATCH_REF_PT)---->|point|---->

HATCH_REF_PT sets the current hatch reference point. Normally, a line of the hatch pattern passes through the reference point. See also CURRENT_HATCH_PATTERN.


See also


HELP function

                ,---->|empty string|---->,
                |                        |
---->(HELP)---->+                        +---->
                |                        |
                `------->|keyword|------>'

The HELP function displays the manual page describing the required 'keyword'. If an empty string is given instead of a keyword, then the manual page describing the current command/function (if any) is selected. Manuals are available in the form of HTML files and are opened in the available HTML browser (Netscape/MS Interenet Explorer)

See also


HIDDEN-2D-CAPABILITIES

Description:

The 2D HIDDEN-LINE module is used during the creation of an assembly drawing to automatically generate lines indicating hidden drawing features.

To create an assembly drawing the surfaces of the assembly must be defined. Each such surface has to have a logical level. This level is called a z-value and can be thought of as the absolute position of the surface in the z-direction. Faces can partially obscure or completely cover other faces depending upon their z-values. In simple terms, faces can be imagined as infinitely thin pieces of paper, laid one on top of another.

Individual geometry elements can also be assigned a z-value. Therefore they can be (partially) covered by faces with a greater z-value. Construction geometry, texts, dimensions and leader lines cannot get assigned a z-value by the hidden line assignment commands and are therefore always visible. Geometry elements without z-value are automatically positioned below the lowest z-value of the assembly drawing. Parts cannot normally be assigned a z-value (the exception being shared parts). The absolute z-value for elements of shared parts is computed as the sum of the relative z-value of their shared parent parts and their own relative z-value.

Hatches are treated as surfaces. They might have a z-value that defines their absolute position in the z-direction. Therefore hatches that are partially covered are displayed as expected, that is, partially hidden. Hatches with a greater z-value might cover other faces or hatches with a lower z-value.

Note
that z-values have no units. They remain unaffected by changes in the system units.

If the 2D HIDDEN LINE module is enabled, a "current z-value" is added to the current info. Therefore each newly generated element is automatically assigned a z-value (the current z-value). This value can be changed interactively. The z-value of an element may also be changed or set explicitly.

Two modes are used to produce an assembly drawing: the view mode and the hidden line generation mode.

View mode shows a hidden line display of the assembly on the screen without computing the hidden lines. It does not change the geometry or the parts structure. Therefore it is possible to assign and to change z-values of elements during construction time. Modifications are possible at any time and are displayed by the next redraw.

The hidden line generation mode is designed for finishing. In contrast to the view mode, geometry is modified (for example, elements will be split) and the parts structure is completely smashed. Shared parts will be unshared. The linetype and color of the hidden elements is user definable.

Remark
2D HIDDEN LINE and display lists

Simultaneous use of 2D HIDDEN LINE view mode and 2D display lists in the same viewport is not possible.


HIGHLIGHT_LTAB function

--->(HIGHLIGHT_LTAB)-|ltab_name|-+--|row|-----|column|--+--+-(ON)---+---->
				 |			|  |	    |
				 +--(ROW)-----|number|--+  +-(OFF)--+
				 |			|  |	    |
				 +--(COLUMN)--|number|--+  +-(MARK)-+
				 |			|
				 +--(ALL)---------------+
				 |			|
				 +--(TITLE)-+-|number|--+
					    |		|
					    +-(ALL)-----+

Change the highlight state of the indicated position in the data area of the named user table.

ON indicates that the element will be highlighted (inverse video);

OFF indicates it will not be highlighted.

MARK indicates it will be marked with an inner box.

|row| & |column| specify a single element.

ROW & number specify an entire row.

COLUMN & number specify an entire column.

ALL specifies all elements in the table.

TITLE allows a cell containing a title string to be highlighted. If a cell has more than one title string displayed, the highlight state from the last title string is taken. ALL will highlight all cells displaying title strings.

HIGHLIGHT_LTAB may be used with tables secured against writing (SECURE_LTAB READ_ONLY).


See also


HL_CHANGE_COLOR function

->(HL_CHANGE_COLOR) --- |color| -->

HL_CHANGE_COLOR changes the color for all hidden lines computed using the HL_GENERATE_HIDDEN command. If no hidden lines exist, this command has no effect. See COLOR for a list of colors.


HL_CHANGE_LTYPE function

->(HL_CHANGE_LTYPE) --- |linetype| -->

HL_CHANGE_LTYPE changes the linetype for all hidden lines computed by the HL_GENERATE_HIDDEN command before. If no hidden lines exist, this command has no effect. See LINEPATTERN for the possible linetypes.


HL_CHANGE_PENSIZE function

->(HL_CHANGE_PENSIZE) --- |pensize| -->

HL_CHANGE_PENSIZE changes pensize for all hidden lines.


See also


HL_DEFAULT_FACE_COLOR function

->(HL_DEFAULT_FACE_COLOR) --+-|color|--+-->
                            v          ^
                            +->(RESET)-+

This function sets the default face color; this is the color that is assigned as face color to faces generated afterwards. See COLOR for a list of colors.

With option RESET the default face color is reset, this means no face color is assigned to the faces generated afterwards.


See also


HL_DELETE_FACE command

                      +------------------------------+
                      | +--------(UNDO)----------+   |
                      | |                        |   |
                      v v                        ^   ^
->(HL_DELETE_FACE) ---+-+-+-->| pnt in face |--+-+---+-->
                          v                    ^
                          +-->(ALL)------------+

HL_DELETE_FACE deletes covering faces. The faces selected must be in the current part and they must be without hatch.

With option ALL, all covering faces in the current part without hatch are deleted.

A covering face with a hatch in it can be deleted with DELETE_HATCH.


See also


HL_GENERATE_FACE command

                                       +------------------------------------+
                                       |                                    |
                                       | +---------(UNDO)--------+          |
                                       v v                       ^          ^
->(HL_GENERATE_FACE)----+-+->(AUTO)-+--+-+--->| pnt in face |----+----------+-+
                        v v         ^                                         |
                        | +---------+                                         |
                        |                                                     |
                        |            +--------------------------------------+ |
                        |            |                                      | |
                        |            | +-----------(UNDO)-----------------+ | |
                        |            | |                                  | | |
                        |            | |          +------------+          | | |
                        |            v v          v            |          ^ ^ |
                        +->(MANUAL)--+-+->|point|-+-->|point|--+-->(END)--+-+-+
                        |                         |            ^              |
                        |                         +-->(UNDO)---+              |
                        |                         v            ^              |
                        |                         +-->(VERTEX)-+              |
                        |                                                     |
                        |                                                     |
                        +->(ALL)--------------------------------------------+-+
                        |                                                     |
                        +->(HOLES)--------------------------------------------+
                                        				      |
  +---------------------------------------------------------------------------+
  |
  | +---------------+
  | ^               v
  +-+->{z_location}-+--->

{z_location}

----+----------+->|z_value|---------------+-->
    v                                     ^
    +->(ABOVE)-+--+-->|face with z-value|-+
    |          |  v                       ^
    +->(BELOW)-+  +-->|elem with z-value|-+
    |          |  |                       |
    +->(SAME)--+  +-->|reference z-value|-+

This command is used to specify covering faces. A covering face covers all geometry with a lower z-value. The covering face is given a default face color as set by HL_DEFAULT_FACE_COLOR. This color may be changed using the HL_SET_FACE_COLOR command. Since hatches are treated in the same way as covering faces, it is impossible to specify a face at a location where a hatch is already defined. In a viewport where the hidden line redraw mode is on (see HL_REDRAW_MODE) the user gets visual feedback about the newly created covering faces.

With AUTO, a point inside a face must be specified. The inner contours are found automatically. Automatic face selection works only if :

Using MANUAL, the points of the face boundaries can be specified manually. First the outer contour has to be specified, then the inner contours. The points selected do not have to lie on any geometry elements. In order to build up a contour with elements, a vertex of an element must be specified first. Thereafter, the elements making up the contour can be selected by a simple pick. The system allows skipping elements along a contour as long as not more than one element after any branch point is skipped. All elements must be in the active part. With the END command the definition of the face is finished. It is used when all face boundaries (that is, the outer contour and all inner contours are defined).

The ALL option is used to generate faces automatically in the current part. The algorithm tries to find a maximum number of faces in the current part but ignores different z-values if they exist. Therefore this option should be used only in parts where all elements have the same z-value.

The HOLES option is also used to generate faces automatically in the current part. The algorithm differs from the ALL option search algorithm by generating only faces that have no contour forming the inner contour of another face. The algorithm ignores different z-values if they exist. Therefore this option should only be used in parts where all elements have the same z-value.

Note
The algorithm to find all faces (with holes) in a part delivers the result expected if:

If these prerequisites are not fulfilled the results are not predictable. In this case the use of the HL_GENERATE_FACE command with options AUTO or MANUAL is recommended.

UNDO works as follows :

The z_location defines a specific z-value which is assigned to each newly created face. There are three ways to specify this z-value:


See also


HL_GENERATE_HIDDEN command

ME10 Only

->(HL_GENERATE_HIDDEN) --+--------------+->(CONFIRM)--->
                         v              ^
                         +->(NO_BACKUP)-+

This command causes transition to the hidden line generation mode. In this mode the hidden lines are computed. To generate hidden lines, geometry is modified by splitting the geometry elements and inserting new elements (according to the z-value information of faces and geometry). Additionally, shared parts are unshared, and polylines are smashed. The 2D parts tree, starting at the current part, will be completely smashed. To make the hidden lines invisible, a function is available to allow you to turn on or off the hidden lines (see HL_SHOW_HIDDEN function).

HL_GENERATE_HIDDEN is not reversible.

First, a backup of the complete 2D-drawing is made and stored in "workfile.hid" (compressed MI). If the backup fails, the process described above is not done.

The qualifier NO_BACKUP suppresses this automatic backup.

MEVIEW Only HL_GENERATE_HIDDEN command

->(HL_GENERATE_HIDDEN) --->(CONFIRM)--->

This command causes transition to the hidden line generation mode. In this mode the hidden lines are computed. To generate hidden lines, geometry is modified by splitting the geometry elements and inserting new elements (according to the z-value information of faces and geometry). Additionally, shared parts are unshared, and polylines are smashed. The 2D parts tree, starting at the current part, will be completely smashed. To make the hidden lines invisible, a function is available to allow you to turn on or off the hidden lines (see HL_SHOW_HIDDEN function).

HL_GENERATE_HIDDEN is not reversible.


See also


HL_GEN_ALL_PART command

                                  +---------------------------+
                                  v                           ^
->(HL_GEN_ALL_PART)--+->(HOLES)-+-+->|select|--->{z_location}-+-->
                     v          ^
                     +->(ALL)---+

{z_location}

----+----------+->|z_value|---------------+-->
    v                                     ^
    +->(ABOVE)-+--+-->|face with z-value|-+
    |          |  v                       ^
    +->(BELOW)-+  +-->|elem with z-value|-+
    |          |  |                       |
    +->(SAME)--+  +-->|reference z-value|-+

This command allows easy z-value setting and face generation for a whole part.

The ALL option is used to generate faces automatically in the selected part. The algorithm tries to find the maximum number of faces in this part.

The HOLES option is also used to generate faces automatically in the selected part. The algorithm differs from the ALL option search algorithm by generating only faces that have no contour forming the inner contour of another face.

Note
The algorithm to find all faces (with holes) in a part delivers the result expected if:

If these prerequisites are not fulfilled the results are not predictable. In this case the use of the HL_GENERATE_FACE command with options AUTO or MANUAL is recommended.

The z_location defines a specific z-value which is assigned to each newly created face and to each geometry in the part. Specify this z-value in one of two ways:


See also


HL_INQ_CURR_Z_VALUE function

---->(HL_INQ_CURR_Z_VALUE)--->

This function returns the current z-value, which is assigned to each newly created element by default.

If the system is used interactively, the value is written into the keyboard input buffer so it can be used as input without retyping.

The returned z-value is also written into the system inquiry array. The data can then be retrieved with INQ (see INQ).

        +-----------------------------------------------------------+
        |    |  result                                   |
        +-----------------------------------------------------------+
        |    1          |  121 (implicit inquiry code)              |
        |               |                                           |
        |    2          |  current z-value                          |
        |               |                                           |
        +-----------------------------------------------------------+


See also


HL_INQ_FACE_COLOR function

---->(HL_INQ_FACE_COLOR)--->|point on face|--->

HL_INQ_FACE_COLOR returns the rgb - color - value (integer) of the specified face. If the face color has not been specified explicitly (i.e. the face color is equal to the viewport background color), a beep is returned.

If the system is used interactively, the value is written into the keyboard input buffer so it can be used as input without retyping.

The returned face color is also written into the system inquiry array. The data can then be retrieved with INQ (see INQ).

        +-----------------------------------------------------------+
        |    |  result                                   |
        +-----------------------------------------------------------+
        |    1          |  123 (implicit inquiry code)              |
        |               |                                           |
        |    2          |  rgb - color of selected face             |
        |               |                                           |
        +-----------------------------------------------------------+


See also


HL_INQ_LOAD_VALUE function

---->(HL_INQ_LOAD_VALUE)--->

This function returns the mode in which the load value / offset was specified and the value itself. The mode is also returned because the way the load offset value works depends on the mode (see HL_SET_LOAD_VALUE).

If the system is used interactively, the two values are written into the keyboard input buffer so they can be used as input without retyping.

The returned values are also written into the system inquiry array. The data can then be retrieved with INQ (see INQ).

        +-----------------------------------------------------------+
        |    |  result                                   |
        +-----------------------------------------------------------+
        |    1          |  122 (implicit inquiry code)              |
        |               |                                           |
        |    2          |  mode in which  load value was set (1..5) |
        |               |  1, if none load value / offset is set    |
        |               |  2, if a relative z-value for elements    |
        |               |     loaded afterwards was specified       |
        |               |  3, if option ABOVE and a load offset     |
        |               |     were specified                        |
        |               |  4, if option BELOW and a load offset     |
        |               |     were specified                        |
        |               |  5, if option SAME  and a load offset     |
        |               |     were specified                        |
        |               |                                           |
        |    3          |  current load value / offset              |
        |               |  ( for mode 3..4 value is the sum of the  |
        |               |    former specified load value and the    |
        |               |    value of the relation offset at time   |
        |               |    of setting )                           |
        |               |                                           |
        +-----------------------------------------------------------+


See also


HL_INQ_RELATION_OFFSET function

---->(HL_INQ_RELATION_OFFSET)--->

This function returns the current relation offset in the z-direction.

If the system is used interactively, the value is written into the keyboard input buffer so it can be used as input without retyping.

The returned z-value is also written into the system inquiry array. The data can then be retrieved with INQ (see INQ).

        +-----------------------------------------------------------+
        |    |  result                                   |
        +-----------------------------------------------------------+
        |    1          |  124 (implicit inquiry code)              |
        |               |                                           |
        |    2          |  current relation offset value            |
        |               |                                           |
        +-----------------------------------------------------------+


See also


HL_INQ_Z_VALUE function

                           +->(SHARED_PART)-+ +->(RELATIVE)-+
                           ^                v ^             v
---->(HL_INQ_Z_VALUE)---+->+----------------+-+-------------+->|elem|----+--->
                        v                                                ^
                        +------->(MINIMUM)-------------------------------+
                        |                                                |
                        +------->(MAXIMUM)-------------------------------+
                        |                                                |
                        +------->(RANGE)---------------------------------+
                        |                                                |
                        +------->(FIRST)---------------------------------+
                        |                                                |
                        +------->(NEXT)----------------------------------+

HL_INQ_Z_VALUE returns the absolute or relative z-value of the selected element, the minimum or maximum z-value of the entire assembly view (options MINIMUM, MAXIMUM) or the minimum, maximum and range of the entire assembly view (options RANGE, FIRST, NEXT).

If the specified element has not been assigned a z-value, or if the entire assembly has no z-value specification and the options MINIMUM, MAXIMUM, or RANGE are used, an error beep is returned.

With option SHARED_PART, HL_INQ_Z_VALUE returns the z-value of the selected occurrence of a shared part.

With option RELATIVE, HL_INQ_Z_VALUE returns the relative z-value of the selected element or shared part.

With option RANGE, HL_INQ_Z_VALUE returns the absolute minimum and maximum z-value of the entire assembly drawing. This option also fills an internal data structure with all absolute z-values used in the whole drawing. Afterwards the user can access this internal data structure using HL_INQ_Z_VALUE together with the options FIRST (always returns the minimum z-value) and NEXT (returns all z-values from the successor of the minimum z-value to the maximum z-value). If you use option NEXT after the maximum z-value was returned, an error beep is returned.

If the system is used interactively, the returned z-values are written into the keyboard input buffer so can be used as input without retyping.

The returned z-value is also written into the system inquiry array. The data can then be retrieved with INQ (see INQ).

        +-----------------------------------------------------------+
        |    |  result                                   |
        +-----------------------------------------------------------+
        |    1          |  120 (implicit inquiry code)              |
        |               |                                           |
        |    2          |  mode of z-value inquiry ( 1..9 )         |
        |               |  1, if the absolute z-value of an element |
        |               |     is inquired                           |
        |               |  2, if the relative z-value of an element |
        |               |     is inquired                           |
        |               |  3, if the absolute z-value of a shared   |
        |               |     part is inquired                      |
        |               |  4, if the relative z-value of a shared   |
        |               |     part is inquired                      |
        |               |  5, if the minimum  z-value of the entire |
        |               |     assembly drawing is inquired          |
        |               |  6, if the maximum  z-value of the entire |
        |               |     assembly drawing is inquired          |
        |               |  7, if the absolute z-value range of a    |
        |               |     drawing is inquired (initialization). |
        |               |     As values the minimum and the         |
        |               |     maximum value are returned in inq -   |
        |               |     index 3 and 4.                        |
        |               |  8, if the absolute z-value range of a    |
        |               |     drawing was inquired before with mode |
        |               |     7 and now the first element of this   |
        |               |     list is inquired (the minimum z-value)|
        |               |  9, if the absolute z-value range of a    |
        |               |     drawing was inquired before with mode |
        |               |     7 and now all elements of this list   |
        |               |     are inquired one after the other      |
        |               |     (from successor of minimum to maximum)|
        |               |                                           |
        |    3          |  z-value corresponding to mode            |
        |               |                                           |
        |    4          |  z-value corresponding to mode            |
        |               |  (only used in case of mode 7)            |
        |               |                                           |
        +-----------------------------------------------------------+


See also


HL_REDRAW_MODE function

->(HL_REDRAW_MODE) ---+---(ON)---+---| viewport selection |--->
                      |          |
                      +---(OFF)--+

{viewport selection }

This function switches between the usual redraw mode and the special hidden-line redraw mode. If HL_REDRAW_MODE is turned ON, the redraw function uses the covering faces information and the z-value information and displays the drawing partially covered (depending on that z-value information). This means HL_REDRAW_MODE ON causes the transition to the view mode. If HL_REDRAW_MODE is turned OFF, the usual ME10/ME30 redraw is used. HL_REDRAW_MODE not only affects the redraw itself, but also all window functions (such as WINDOW FIT, and WINDOW PAN). To indicate hidden mode, an '- H -' is displayed after the part name in the viewports for which HL_REDRAW_MODE is turned ON.

Note
that it is not possible to use 2D display lists and HL_REDRAW_MODE ON in the same viewport.


See also


HL_SET_COLOR function

->(HL_SET_COLOR) -+--|color| --+->
                  v            ^
                  +->(RESET)---+

This function sets the color for the hidden lines created afterwards. HL_SET_COLOR only affects the HL_GENERATE_HIDDEN command. If not specified, the hidden lines are created in the same color as the original lines. See COLOR for a list of colors.

Option RESET resets the color setting to the default.


See also


HL_SET_CURR_Z_VALUE function

->(HL_SET_CURR_Z_VALUE) ---> {z_location} --->

{z_location}

----+----------+->|z_value|---------------+-->
    v                                     ^
    +->(ABOVE)-+--+-->|face with z-value|-+
    |          |  v                       ^
    +->(BELOW)-+  +-->|elem with z-value|-+
    |          |  |                       |
    +->(SAME)--+  +-->|reference z-value|-+

This function defines a specific z-value which is assigned to each newly created element by default. The default value of the current z-value is 0. Specify the current z-value in one of two ways:


See also


HL_SET_FACE_COLOR command

                       +------------------------------------------+
                       |                                          |
                       |              +-------------------------+ |
                       v              v                         ^ ^
->(HL_SET_FACE_COLOR) -+-+->|color|-+-+-+-->|face selection|--+-+-+->
                         v          ^ v                       ^
                         +->(NONE)--+ +-->(ALL)---------------+

HL_SET_FACE_COLOR sets or changes the (background) color of covering faces. See color functions for specifying the desired color.

Only if the hidden line redraw mode is turned on (see HL_REDRAW_MODE ON) is the color of the covering faces shown.

With option ALL, all covering faces in the current part (those without and with hatches) are given the new color.

With option NONE, the color of a covering face can be deleted so that afterwards the face is drawn in viewport background color.


See also


HL_SET_KEEP_COLOR function

->(HL_SET_KEEP_COLOR) -+--|color| --+->
                       v            ^
                       +->(RESET)---+

HL_SET_KEEP_COLOR affects only the HL_GENERATE_HIDDEN command.

Elements that have the same color as specified in the HL_SET_KEEP_COLOR function keep their color during the hidden line generation process independent of the setting of HL_SET_COLOR. The macros HL_CHANGE_COLOR, HL_CHANGE_LTYPE and HL_SHOW_HIDDEN do not affect elements set by HL_SET_KEEP_COLOR.

Option RESET resets the color setting to the default (the specification of HL_SET_COLOR).


See also


HL_SET_LINETYPE function

->(HL_SET_LINETYPE) --- |linetype| -->

This function sets the linetype for the hidden lines created afterwards. HL_SET_LINETYPE only affects the HL_GENERATE_HIDDEN command. If not specified, the default linetype for hidden lines is DASHED. See LINEPATTERN for the possible linetypes.


See also


HL_SET_LOAD_VALUE function

->(HL_SET_LOAD_VALUE) -+-> {z_location} -+->
                       v                 ^
                       +->(NONE)---------+

{z_location}

----+----------+->|z_value|---------------+-->
    v                                     ^
    +->(ABOVE)-+--+-->|face with z-value|-+
    |          |  v                       ^
    +->(BELOW)-+  +-->|elem with z-value|-+
    |          |  |                       |
    +->(SAME)--+  +-->|reference z-value|-+

Use this function to define a load offset in the z-direction or a z-value for elements that are loaded afterwards. As default, no load offset and no load z-value are specified.

Setting a load z-value might be done by specifying a number which becomes the new current load z-value. All elements loaded afterwards get assigned this z-value as their relative z-value.

Setting a load offset in the z-direction is done by specifying a relational option (ABOVE, BELOW or SAME) and a reference element/z-value. The new current load offset is computed by taking the absolute z-value of the reference element (option SAME) or adding (option ABOVE) the relation offset (see HL_SET_RELATION_OFFSET) to this value or subtracting (option BELOW) the relation offset from this value. All elements loaded afterwards and which have already been assigned a z-value are handled in the following way:

With option NONE, the user resets the load offset so that all elements that are loaded afterwards keep their original z-value.


See also


HL_SET_PENSIZE function

->(HL_SET_PENSIZE) --- |pensize| -->

HL_SET_PENSIZE specifies the current pensize for all new generated hidden lines. By default, the current pensize is 0.

The pensize of hidden lines will keep its value and look the same when they are scaled. The pensize attribute is therefore called "scale invariant".


See also


HL_SET_RELATION_OFFSET function

->(HL_SET_RELATION_OFFSET) --->|z_value|--->

This function defines an offset in the z-direction, which is used to compute a z-value specified as an ABOVE/BELOW/BETWEEN relation to another element. The relation offset value is added/subtracted from the absolute z-value of the reference element.


See also


HL_SET_Z_VALUE command

                       +------------+   +---------------------------+
                       ^            v   v                           ^
->(HL_SET_Z_VALUE) --+-+->(ELEMENT)-+-+-+->|select|-->{z_location}--+-->
                     v                ^
                     +->(SHARED_PART)-+

{z_location}

      +->(KEEP)-+
      ^         v
----+-+---------+->|z_value|---------------+-------------------------+-->
    v                                      ^                         |
    +->(NONE)------------------------------+                         |
    |                                      |                         |
    +->(ABOVE)-+--+-->|face with z-value|--+                         |
    |          |  v                        ^                         |
    +->(BELOW)-+  +-->|elem with z-value|--+                         |
    |          |  |                        |                         |
    +->(SAME)--+  +-->|reference z-value|--+                         |
    |                                                                |
    +->(BETWEEN)--+                                                  |
                  |                                                  |
    +-------------+                                                  |
    |                                                                |
    +-+->|face with lower z-value|-+-+->|face with upper z-value|-+-+
      v                            ^ v                            ^
      +->|elem with lower z-value|-+ +->|elem with upper z-value|-+
      |                            | |                            |
      +->|reference z-value|-------+ +->|reference z-value|-------+

Use this command to assign z-values to elements or shared parts or to change them. Construction geometry, texts, dimensions, and leaderlines cannot be assigned a z-value by HL_SET_Z_VALUE.

Assign z-values in one of two ways:

The elements to which a z-value is to be assigned are selected using the usual ME10/ME30 selection techniques.

With option ELEMENT (the default) a z-value is assigned to elements.

The option SHARED_PART assigns a z-value to an occurrence of a shared part. Unshared subparts cannot be assigned a z-value.

If a part is selected without using the option SHARED_PART, the z-value assignment is done to each element of that part. This process works recursively downwards.

The option NONE deletes a z-value of a elements or occurrence of a shared part.

The options SAME, ABOVE, and BELOW require the selection of a reference element.

Using option SAME without option SHARED_PART, the selected elements that already have a z-value at least get assigned the same z-value as the reference element. This means that the element with the smallest z-value of all selected elements gets the same z-value as the reference element, the other elements get a z-value so that their old z-value distance to the element with the lowest z-value is kept. If the option SHARED_PART is also specified, the z-value of the selected shared part is changed so that all elements belonging to that part and all elements in its subparts have the same z-value or higher as the reference element.

Using option ABOVE without option SHARED_PART, the selected elements that already have a z-value get assigned a z-value equal to the z-value of the reference element plus the value of the relation offset (see HL_SET_RELATION_OFFSET). This means that the element with the smallest z-value of all selected elements gets the z-value of the reference element plus the value of the relation offset; the other elements get a z-value so that their old z-value distance to the element with the lowest z-value is kept. If option SHARED_PART is also specified, the z-value of the selected shared part is changed so that all elements belonging to that part and all elements in its subparts have a z-value equal to the z-value of the reference element plus the value of the relation offset.

Using option BELOW without option SHARED_PART, the selected elements that already have a z-value get assigned at most the z-value of the reference element minus the value of the relation offset (see HL_SET_RELATION_OFFSET). This means that the element with the biggest z-value of all selected elements gets the z-value of the reference element minus the value of the relation offset; the other elements get a z-value so that their old z-value distance to the element with the biggest z-value is kept. If option SHARED_PART is also specified, the z-value of the selected shared part is changed so that all elements belonging to that part and all elements in its subparts have at most the same z-value as that of the reference element minus the value of the relation offset.

Using option BETWEEN without option SHARED_PART, the selected elements that already have a z-value get assigned a z-value at least equal to the z-value of the reference element selected first plus the value of the relation offset and at most equal to the z-value of the reference element selected last minus the value of the relation offset (see HL_SET_RELATION_OFFSET). This option differs from option ABOVE in that the option BETWEEN checks if the element with the smallest and the one with the biggest z-value of all selected elements fit into the specified range. If option SHARED_PART is also specified, the z-value of the selected shared part is changed so that all elements belonging to that part and all elements in its subparts have at least the z-value of the reference element selected first plus the value of the relation offset and at most the z-value of the reference element selected last minus the value of the relation offset.

The option KEEP must be used if an already assigned z-value of an element is not to be overwritten (default: z-value is overwritten). It can only be used together with the specification of a relative z-value.


See also


Hl_show_hidden macro

->(Hl_show_hidden) ---+--> (ON) ---+--->
                      v            ^
                      +--> (OFF) --+

This macro shows the hidden lines computed with the HL_GENERATE_HIDDEN command (option ON) or makes them invisible (option OFF). By default, the hidden lines are visible.


HL_VISUALIZE function

---->(HL_VISUALIZE)---+-----------+------+----------+-------------------+
                      v           ^      v          ^                   |
                      +->(GLOBAL)-+      +->(FACES)-+                   |
                                        				|
  +---------------------------------------------------------------------+
  |
  +-+->|lower z-pos|-|upper z-pos|-+--+->|color|-+--->
    v                              ^  v          ^
    +-->(ALL)----------------------+  +->(ON)----+
                                      |          |
                                      +->(OFF)---+

{z_pos}

----+->|z_value|-----------+-->
    v                      ^
    +->|face with z-value|-+
    |                      |
    +->|elem with z-value|-+

The function HL_VISUALIZE allows you to view all elements selectively on certain z-values or to show faces on certain levels in different colors. Items that are turned off are not drawn on the screen and can therefore not be caught to or selected. Items set to a particular color are drawn in that color; they revert to their original color using the ON option (see also SHOW).

With the input of a lower and an upper absolute z-value limit, the user specifies the z-value range of the elements which should be colored or turned on/off.

The option GLOBAL specifies that the elements in all parts are to be considered. By default, only the elements in the current part are considered.

The option ALL refers to refer to all elements in the assembly drawing that have been assigned any z-value. For example, ALL together with ON shows the complete assembly drawing in the original colors. ALL together with OFF shows only those elements that have not been assigned a z-value.

The option FACES specifies that only faces should be colored or turned on/off.

Limitation: if the drawing contains shared parts with different z-values, the result of the HL_VISUALIZE might be incorrect: the show settings only refer to elements, not to parts. Imagine a face that has the relative z-value 0 and belongs to a shared part. Furthermore, there are two occurrences of this shared part: one with z-value 1 and one with z-value 6. Then the one view of the face lies on absolute z-value 1 and the other view of this face lies on absolute z-value 6. You will see both faces if you specify:

  HL_VISUALIZE  GLOBAL FACES 1 2.


See also


HP OpenSpool

HP OpenSpool is a standard distributed output management system that queues and sends your files to a plotter or printer. This software provides easy access to any printer or plotter configured on your network. It features a menu driven interface and a sophisticated online help system. This product is sold separately (Product Number B1900A).

HP OpenSpool offers many other helpful features such as:

For more information on HP OpenSpool refer to the manuals supplied with this product.


See also


Hyperbola macro

-->(Hyp_cfp)-->|center|--->|focus|-->|end of hyperbola|---->

-->(Hyp_ctf)-->|center|-->|tangential pnt|-->|focus|---->

With Hyp_cfp you indicate the center of the hyperbola, then the focus, and then the end of the hyperbola.

With Hyp_ctf, you indicate the center of the hyperbola, then a tangential point, and then the focus of the hyperbola.


See also