08 - Using The Edit Window
08 - Using The Edit Window
Deleting Commands............................................................................................... 11
Layout .................................................................................................................... 18
Constructed Features............................................................................................. 29
Dimensions ............................................................................................................ 29
i
Table of Contents
Alignment ............................................................................................................... 31
Hits ......................................................................................................................... 32
Probe ..................................................................................................................... 38
Comments.............................................................................................................. 39
Expressions............................................................................................................ 43
Inserting Groups..................................................................................................... 57
ii
Using the Edit Window: Introduction
iii
Using the Edit Window
Using the Edit Window: Introduction
One of the main tools that you can use to edit a measurement routine is the Edit
window. The Edit window houses all of the commands for the measurement routine.
You can perform editing operations such as cutting, copying, pasting, and modifying
existing text and commands. You can also use the Edit window to add new commands,
execute existing commands, display a command's information, and debug code.
To access the Edit window, select the View | Edit Window menu option.
This chapter covers the Edit window and how to edit measurement routines in general
in these topics:
1
Using the Edit Window
You can change the display of the Edit window by switching between different modes.
PC-DMIS enables the two most common modes by default. These are Command mode
and Summary mode. You can enable a third mode, called DMIS mode, from the Setup
Options dialog box (Edit | Preferences | Setup).
You can click the appropriate icon on the Edit Window toolbar to switch between these
different modes.
In each mode, you can work with existing commands and add new commands, although
the capabilities of each mode and the methods of working with commands differ.
Commands can have both editable and non-editable fields. Editable fields are fields that
take a value. Some editable fields are called toggle fields and allow you to switch
between a predefined set of acceptable values.
• If you're in Command mode or DMIS mode, press Tab to move the cursor to the
next editable field. You know that you're on an editable field when the value is
highlighted in the highlight color (the default is yellow).
• If you're in Summary mode, right-click on an editable item, and from the shortcut
menu, select Edit and then Value/Expression Text. You can then type a new
value or select a value from a list.
The Edit Window toolbar lets you perform operations on your measurement routine
and switch between the different Edit window modes. For information on this toolbar,
see the "Edit Window Toolbar" topic in the "Using Toolbars" chapter.
To move the cursor to a specific feature's location in the Edit window, click on that
feature in the Graphic Display window while you hold down the Ctrl key.
2
Understanding Core Concepts
PC-DMIS uses different background colors, command text colors, and text characters to
offset information in Command and DMIS modes. This coloring and text formatting may
seem somewhat confusing at first, especially if you are used to previous versions of PC-
DMIS and are suddenly barraged with a myriad of colors. However, rest easy; if you
don't like them, you can easily revert PC-DMIS to its coloring scheme used in previous
versions. For information on how to do this, see "Defining Edit Window Colors" in the
"Setting Your Preferences" chapter.
However, the colors and formatting are valuable tools that can increase your
productivity. The following describes these tools.
Background Colors
Different background colors help you know what commands are marked, unmarked,
have errors, are active, or are being stepped through. You can find the definitions for
these background colors in the Color Editor dialog box (Edit | Preferences | Edit
Window Colors) for the Edit window.
3
Using the Edit Window
Edit window background color information in the Edit window's Color Editor
4
Understanding Core Concepts
A - A light-green background means the command has been marked for execution.
B - The light-blue background means the command has not yet been marked for
execution.
C - A slightly darker background color (either darker green for marked commands or
darker blue for unmarked commands) shows the current active command.
Black text - Any non-editable command text. You cannot change this text.
Red text - For non-dimension commands, this indicates an error in the command text.
The command is skipped during measurement routine execution. Errors come from
unsupported commands, unsupported probe types, and syntax errors (usually while
working with expression or scripting commands). For dimension commands, red text
indicates that the dimension is out of tolerance.
When you move your mouse over a command block, or command blocks that are
grouped together, the entire command block, or the entire group, is highlighted with a
slightly darker background color (see item C in the example above). This helps you
immediately see the extents of an entire command block. Doing this also makes the
command "active". This means you don't need to click on the command to operate on it.
For example, you can hover your mouse over a command and press F9. The
associated dialog box appears if one exists. To delete the command, you don't need to
select the entire command, just hover your mouse over it until it becomes active, and
press Delete. When editing large measurement routines, shaving off a mouse click here
and there can increase your productivity.
5
Using the Edit Window
The "<" and ">" characters group like values together, thereby more easily delineating
the different fields for various X, Y, Z and I, J, K values. These characters show where
these pairs begin and end. This enhances readability and makes it much easier to
locate needed values.
While you can cycle through a list of available commands on a toggle field, you can also
hover your mouse over the darker blue text for a moment, and the background color
takes on a button-like quality. Click on the button to show a drop-down list from which
you can select the desired value for that toggle field.
Certain fields take filename values. If the file moves to a new location, there's an easier
way to update it than arduously retyping a long directory pathway. Instead, hover your
mouse over the field; the filename turns into a button. Clicking it displays a File Open
dialog box, allowing you to locate and update the file's location.
6
Understanding Core Concepts
Inserting Commands
In many cases, commands are automatically inserted when you take measurements or
when you use dialog boxes to enter information. However, you can also add commands
directly from within the Edit window. Depending on what mode you're in, PC-DMIS gives
you different options:
• If you're in Command mode, you can type the first few letters of the command
and press Tab or Enter to insert new commands.
• If you're in Summary mode, you can right-click and select Add Command from
the shortcut menu to insert new commands. PC-DMIS displays a list of the
commands that you can add.
• If you're in DMIS mode, you can press Enter on a line to insert new commands. A
list appears from which you can select the appropriate DMIS command to add.
Indenting Commands
To improve the Edit window's readability, PC-DMIS automatically performs an indent
inside of supported code blocks, loops, and flow control pairs. This occurs whenever
you insert these types of commands into the Edit window.
Summary mode uses a fixed indent value. Command mode and DMIS mode use a two-
character default for the indent. You can modify the number of spaces with the
EWGroupIndent registry entry in the PC-DMIS Settings Editor.
Supported Commands
7
Using the Edit Window
The following examples show how nested indents appear in each Edit window mode
(Summary mode, Command mode, and DMIS mode):
8
Understanding Core Concepts
The Edit window can display a maximum of 256 characters on a single line,
including white space. This means many levels of nested commands can push the
innermost commands so far to the right that the Edit window cannot display their text.
• If you're in Command or DMIS mode, press TAB to go to the editable field you
want to change. Either type in a new value or press F7 or F8 to cycle forward or
backward through a list of available values. You can also hold you mouse over a
toggle field and click the drop-down arrow to select from a pop-up list of available
values.
• If you're in Summary mode, right-click on the line you want to edit. PC-DMIS
displays a list from which you can choose a preexisting value or shows an edit
box into which you can type a new value.
If you edit a feature or dimension's ID using the Edit window, PC-DMIS asks if you want
to make this ID the default for that same feature or dimension type. If you click Yes,
9
Using the Edit Window
features or dimensions of that same type, when created later, will use the new ID as the
default. If you click No, then future IDs continue to use the current default value.
Selecting Commands
You can select most commands in any mode in PC-DMIS.
The Edit | Select All menu option selects the entire window's contents for editing
purposes.
As you select feature commands, PC-DMIS highlights those features in the Graphic
Display window in a light blue color. Also, in Command mode, this happens if you click
anywhere in a feature command. To change the highlight color, see "Highlight" under
"Changing Screen Colors" in the "Editing the CAD Display" chapter. Auto Plane features
also highlight the entire surface.
Repositioning Commands
You can reposition many commands in PC-DMIS. If you're in Summary, Command, or
DMIS mode, do the following to reposition a command:
You can also use the Edit | Copy menu option to make a copy of a command and store
it in the Clipboard until you decide to paste the copy into another location.
For information on these and other standard edit commands, see "Using Standard Edit
Commands" in the "Editing a Measurement Routine" chapter.
10
Understanding Core Concepts
Deleting Commands
To delete a command from the Edit window, select the command and press Delete.
You can restore any deleted command if you immediately click the Undo icon on the
Edit Window toolbar or if you press Alt + Backspace.
On some commands, you can press F9 to access the dialog box only if PC-DMIS is in
Command mode.
You can edit the Edit window's header or footer by making and saving changes to these
text files using a standard text editor (such as Notepad).
11
Using the Edit Window
To modify the header or footer of a generated report, not the Edit window's
header, you have these options that the "Reporting Measurement Results" chapter
covers:
1. Modify templates to control what gets displayed in the Report window. (See
"Modifying the Report's Header".)
2. Use LOGO.DAT, HEADER.DAT, and ELOGO.DAT files to a limited extent. (See
"Using .DAT Files in Generated Reports".)
LOGO.DAT – This file defines the header for the very first page of the Edit window. You
can define a bitmap with your company's logo as well as specific date and time formats
for the first page.
12
Understanding Core Concepts
That PART NAME, REV NUMBER, SER NUMBER, and STATS COUNT are static
fields and cannot be changed in the LOGO.DAT file.
HEADER.DAT – This file is used to format page headers for all other pages.
13
Using the Edit Window
#DATE
Inserts the current date.
#TIME
Inserts the current time.
#PAGE
Inserts the current page number. This is ideal for use in the HEADER.DAT file.
#TRn
Inserts both the name and the value of trace field n, where n is the trace field number.
#PARTN
Inserts the measurement routine name.
#DRWN
Inserts the revision number.
#SERIALN
Inserts the serial number.
#SEQUENCE
Inserts the sequence number.
#SHRINK
Inserts the scale factor.
#NMEAS
Inserts the total number of dimensions.
#NOUT
Inserts the total number of dimensions that are out of tolerance.
#ELAPSTIM
Inserts the time elapsed between start and end of execution. This is ideal for use in the
FOOTER.DAT file.
14
Understanding Core Concepts
#BMP=bitmappath
Inserts a bitmap where bitmappath represents the full path pointing to the bitmap file (for
example, D:\Files\Bmp\Pcdhead.bmp).
For more information on the elogo.dat, logo.dat, and header.dat files, and where to find
them, see the "Understanding Data Files" topic in this chapter.
The following example shows how you can use expressions and tracefields to change
the format of your date on the Edit window.
This gives V1 the string value of your current date (for example, "May 05,
2018").
TRACEFIELD/DISPLAY,LIMIT=15;DATE:V1
2. Assuming this is the first tracefield in your measurement routine, open up your
logo.dat file inside a text editor and modify the DATE= field so that it looks like
this:
DATE=#TR1
Notice that DATE field now references the first trace field by using #TR1.
15
Using the Edit Window
You can use trace fields and expressions to give you greater control over what you see
in the Edit window.
For information on trace fields, see the "Using Trace Fields" topic in the "Tracking
Statistical Data" chapter.
For information on expressions, see the "Using Expressions and Variables" chapter.
For information on modifying your report's headers or footers using .DAT files,
see "Using .DAT Files in Generated Reports".
For information on using templates and rules to modify your report, see "Modifying the
Report's Header".
To place the Edit window in Summary mode, select View | Summary Mode from the
menu, or from the Edit Window toolbar, click the Summary Mode icon .
16
Working in Summary Mode
To place the Edit window in Summary mode (Preview), select View | Summary Mode
(Preview) from the menu, or from the Edit Window toolbar, click the Summary Mode
(Preview) icon .
Summary mode also appears when you create or edit a custom report. For more
information on custom reports, see "Creating Custom Reports" in the "Reporting
Measurement Results" chapter.
17
Using the Edit Window
You can customize the main display of the Summary mode to show your features' XYZ
information in the header line. To do this, access the PC-DMIS Settings Editor, expand
the Option section, and set the ShowAdvancedSummaryText registry entry to 1. PC-
DMIS then displays the commands similar to the following:
For information on the Settings Editor, see the "Modifying Registry Entries" topic.
Layout
PC-DMIS's Summary mode layout is in the form of pieces of data. At the top level, PC-
DMIS displays command objects.
You can expand a group to view its data items by clicking the plus sign (+) to the left of
the group command. You can collapse a group by clicking the minus sign (-). You can
also expand and collapse a group by pressing the Right Arrow and Left Arrow keys,
respectively.
18
Working in Summary Mode
PC-DMIS displays most measurement routine commands at the top level. Some
commands, such as basic hits, location dimensions, and certain alignment commands,
appear under their parent object. Also:
• Each command has a unique icon associated with it to help you quickly identify
needed commands.
• If the command has an ID, PC-DMIS displays the ID before the command's
description.
• The Peek window displays a command's complete information.
• Commands that are marked to execute are black.
• Commands that are not marked to execute are gray.
19
Using the Edit Window
Groups appear with a folder icon in the Edit window. They are composed of a
command's similar data items.
Selecting Commands
To select a command, either left-click with the mouse or use the Up and Down Arrow
keys to navigate to it.
• To select multiple commands, hold down the Ctrl key while you left-click.
• To select a group of items at once, select the first item in the block of objects,
hold down the Shift key, and select the last item in the block.
Adding Commands
In Summary mode, you can add commands to the measurement routine by using PC-
DMIS's standard menu options or a special shortcut menu.
20
Working in Summary Mode
2. From the shortcut menu, select Add Command. A scrollable list appears:
3. Select the command to add. Once you click it, the pop-up list disappears, and
PC-DMIS inserts the command into the Edit window. If you want to close the list
without adding a command, press Esc on your keyboard until the list closes.
PC-DMIS generally inserts the new command after the currently-selected item
in the expandable/collapsible list.
Removing Commands
To remove a command from a measurement routine, select an object and press the
Delete key. If a group command contains any sub-commands, those commands are
also deleted.
21
Using the Edit Window
1. Select the command that precedes the command that you want to paste.
2. Choose the paste command from any of these locations:
22
Working in Summary Mode
• Unmarked - This icon indicates that the command is not marked for
execution. For example:
• - This icon indicates that a group command contains both marked and
unmarked commands. For example:
When you execute your measurement routine, PC-DMIS does the following:
23
Using the Edit Window
For help with executing a measurement routine, see the topics in the "Executing
Measurement Routines" chapter.
If you want to cancel the execution, select the Reset button. PC-DMIS replaces the
execution icon with a Marked or an Unmarked icon.
When the execution is finished, PC-DMIS remains in the execution state and displays
this message:
"To reset the execution status of all commands, click the Reset button."
To reset the execution status, click the message's OK button and then click the
Reset button in the Edit window ( ). (An informational flashing hand points to the
Reset button.) PC-DMIS then replaces the execution icon with a Marked or an
Unmarked icon.
PC-DMIS remains in the execution state until you click the Reset button.
For commands that do not use a dialog box, F9 does nothing, and Edit | Command is
unavailable for selection.
24
Working in Summary Mode
• Shift + Tab
Moves the insertion point up one line.
• Ctrl + Click on feature in Graphic Display window
Moves the insertion point to the corresponding command item in the Edit window.
• Ctrl + A
Selects all of the commands in the Edit window.
• Ctrl + C
Copies text or objects to the Clipboard.
• Ctrl + End
Moves the cursor to the end of the measurement routine.
• Ctrl + Home
Moves the cursor to the beginning of the measurement routine.
• Ctrl + Q
Displays the Execution dialog box and allows you to execute the measurement
routine.
• Ctrl + V
Pastes the Clipboard contents. If you selected a field that can take a value, it
pastes the text in that field. If a command has been cut or copied, it pastes the
command after the current selected command.
• Ctrl + X
Cuts any selected text from a field that can take a value and stores it in the
Clipboard. If you've selected a command, it cuts that command and stores it in
the Clipboard.
• Ctrl + Y
Displays the Execution dialog box and allows you to execute the measurement
routine at a specified location.
• Delete
Deletes any selected characters from a field that can take a value. If a command
or command block is selected, and you can normally delete it, this function
deletes it.
• Double-click
Double-click on a group item to display the Group dialog box.
• Down Arrow
Moves the insertion point down one line.
25
Using the Edit Window
• F3
Marks a single feature for execution. It also marks and unmarks multiple
selected commands.
• F9
Opens a dialog box for the currently selected command if a corresponding dialog
box exists for the command.
• Page Down
Moves the insertion point down one page.
• Page Up
Moves the insertion point up one page.
• Shift
Facilitates selecting a block of objects. Select something, hold Shift, and then
click again to select a range of objects.
• Tab
Moves the insertion point down one line.
• Up Arrow
Moves the insertion point up one line.
• Left Arrow
Collapses an expanded command or group.
• Right Arrow
Expands a collapsed command or group.
• Alt + Backspace
Undo. Undoes the last edit made.
• Shift + Backspace
Redo. Redoes the last undone edit.
The Peek window automatically updates with the properties of the command that you
point to. You do not need to click on the command to update the information in the Peek
window.
Hits do not appear for features in the Peek window. For a group, only the first line of the
commands in that particular group appears in the Peek window.
26
Working in Summary Mode
1. Access the Edit window. For help, see "Using the Edit Window: Introduction".
2. Place the Edit window in Summary mode or Summary mode (Preview). For help,
see "Working in Summary Mode".
3. To enable the Peek window, mark the Show Peek Window check box on the
General tab in the Setup Options dialog box. (The Peek window is enabled by
default.) For help, see "Show Peek Window".
In Summary mode (Preview), you can also select the Peek Window icon
( ) in the Edit window to enable the Peek window.
4. To use the Peek window, position your mouse pointer over a command. The
Peek window will align to the center of the command.
If you move the mouse pointer, the Peek window becomes transparent with no
text in it. The transparent Peek window enables you to see the application through
it. The transparent window follows the mouse up and down the commands in the
Edit window until you stop and hover over a command. At this point, the Peek
window becomes active again and displays the command's information.
• Select a command.
• Close the Edit window.
• Move your mouse pointer to another area in PC-DMIS.
• Press any sequence of keys.
• In Summary mode (Preview), select the Peek Window icon.
27
Using the Edit Window
The main features or commands that you can add to the Edit window include:
• Constructed Features
• Dimensions
• Statistical Data
• Alignment
• Measured Features
• Hits
• Motion Commands
• Move Commands
• Sheet Metal Measurements
• Probe
• Comments
• Trace Fields
• Expressions
28
Working in Command Mode
• Screen Captures
• Global Commands
• Command Mode Keyboard Functions
PC-DMIS also provides some keyboard functions that you can use while the Edit
window is in Command Mode. These are discussed in "Command Mode Keyboard
Functions". Similarly, you can access several shortcut menu items by right-clicking on
the commands within Command Mode. See "Command Mode Shortcut Menu" in the
"Using Shortcut Keys and Shortcut Menus" appendix.
You can also determine which commands get displayed in Command mode. See
"Command Mode Display Options" in the "Setting Your Preferences" chapter for
additional information.
Constructed Features
PC-DMIS allows you to create specified features from existing features. Additional
information including specific rules for constructing features can be found in the
"Constructing New Features from Existing Features" chapter.
• POINT
• CIRCLE
• ELLIPSE
• SPHERE
• LINE
• CONE
• CYLINDER
• PLANE
• SLOT
• CURVE
• SURFACE
• FEATURE SET
• GAUSSIAN FILTER SET
Dimensions
Dimension commands allow you to dimension features or the relationship between
features. Additional information regarding the calculation of dimensions can be found in
the "Using Legacy Dimensions" chapter.
29
Using the Edit Window
Dimension Format
Only if a dimension is marked for printing does the data appear on the inspection report.
The FORMAT command allows you to create more than one dimensional format within a
measurement routine. This allows you to show or hide the information that stored in any
dimension that follows the FORMAT command.
For example, for some dimensions, you may not want the nominals printed, such as
with certain types of zone tolerances that always have a nominal of zero. In these
cases, you can hide the NOM field. Later in the measurement routine you might want to
display the nominals for a different type of dimension, such as Location or Position. The
FORMAT command lets you control these manipulations.
The default FORMAT command prints out all of the columns and column headings. It
also creates the statistics XSTATS11.TMP file.
To hide an item, move your pointer over a field, once it turns into region you can
click, select the empty item at the bottom of the list of options.
To show an item, type it in the field and press Tab.
TEXT = This field controls whether or not additional text appears in the dimension's
command block.
HEADINGS = This field controls whether the dimensions that follow the FORMAT
command will have column headings above the numbers.
OPTIONS = This field controls whether or not option fields are displayed. These options
include the following:
30
Working in Command Mode
MULT = This sets the multiplier for deviation arrows and tolerance zone used
in the Graphic Display window. This is only used if GRAPH = YES.
SYMBOL = This field controls whether the deviation symbols will be printed. This field
can be toggled on or off. A blank field indicates that this command is off.
Available Dimensions
To edit these dimensions, view their individual sections in the "Using Legacy
Dimensions" chapter.
Analysis
To edit the Analysis information, see the "Inserting Report Commands" chapter.
Statistical Data
To include and edit statistical data, see the "Tracking Statistical Data" chapter.
Alignment
The Alignment option allows you to recall or create a new coordinate system.
31
Using the Edit Window
Alignment Commands
For more information on how to use these alignment commands in the Edit window, see
the individual topics in the "Creating and Using Alignments" chapter.
Equate Alignment
For more information on how to use Equate Alignment command in the Edit window,
see "Equating an Alignment" in the "Creating and Using Alignments" chapter.
Measured Features
You can insert commands that create the following measured features:
• Measured Point
• Measured Line
• Measured Plane
• Measured Sphere
• Measured Cylinder
• Measured Cone
• Measured Circle
These features, along with information about measured features in general, are
discussed in the "Creating Measured Features" chapter.
Hits
This command targets the location for actual touches by the probe.
32
Working in Command Mode
Basic Hit
HIT/BASIC,x,y,z,i,j,k,x,y,z,USE_THEO=YES/NO
This is the simplest hit format. See "Understanding the Command Format" in the
"Creating Measured Features" chapter for more information.
There are five available types of sheet metal hits. The Sheet Metal package must be
installed for this option to be available. (See "Sheet Metal Measurements".)
Motion Commands
The various Motion commands control the movement of the machine. All but the
FASTPROBEMODE command are discussed in greater detail in the "Parameter
Settings: Motion tab" and the "Parameter Settings: Optional Motion tab" topics of the
"Setting Your Preferences" chapter.
33
Using the Edit Window
This command allows you to select between manual and DCC mode.
Prehit Distance
PREHIT/nnn.nnnn
This command determines the distance away from the theoretical hit location on the
surface where PC-DMIS begins to search for the part. The machine travels at touch
speed while traversing this distance to search for the part.
For additional information, see the "Prehit Distance" topic in the "Setting your
Preferences" chapter.
Move Speed
MOVESPEED/nnn.nnnn
nnn.nnnn represents a number value for the speed. This command changes the point
to point positioning speed of the CMM. Depending on the state of the Display absolute
speeds check box in the Part/Machine tab of the Setup Options dialog box (Edit |
Preferences | Setup), this is either an absolute speed (mm/sec) or a percentage of the
machine's total speed capability.
Touch Speed
TOUCHSPEED/nnn.nnnn
nnn.nnnn represents a number value for the speed. This command changes the speed
at which the CMM takes hits. Depending on the state of the Display absolute speeds
check box in the Part/Machine tab of the Setup Options dialog box (Edit |
34
Working in Command Mode
Scan Speed
SCANSPEED/nnn.nnnn
nnn.nnnn represents a number value for the speed. This command changes the speed
at which the CMM scans the part. Depending on the state of the Display absolute
speeds check box in the Part/Machine tab of the Setup Options dialog box (Edit |
Preferences | Setup), this is either an absolute speed (mm/sec) or a percentage of the
machine's total speed capability.
Retract Distance
RETRACT/nnn.nnnn
nnn.nnnn represents a number value for the distance. This command determines the
distance the machine will move away from the actual hit location before going from
"Touch Speed" to "Move Speed".
Some controllers do not retract on their own. In these cases, PC-DMIS issues
the move to do the retract, and the distance is based on ball surface to the part's
theoretical hit location. If the controller does do the retract, the distance may be
calculated either from the ball surface or the ball center to either the theoretical or
measured hit location, depending on the particular controller.
Check Distance
CHECK/nnn.nnnn,p.pp
35
Using the Edit Window
nnn.nnnn:
This represents the check distance
p.pp:
This represents the percentage of the total check distance that PC-DMIS moves when
performing a Find Hole operation. The default value is 1 which means 100% of the
check distance. Thus .1=10%, .2=20%, .3=30% etc. This only functions with Find Hole
operations.
• If PC-DMIS finds a surface within the specified check distance, it takes a hit.
• If no surface is found, PC-DMIS displays an error message that it has encountered an
unexpected end of move.
For additional information, see the example in the "Check Distance" topic in the "Setting
your Preferences" chapter.
This probing mode applies to analog scanning probes when taking individual hits rather
than scanning. When it is ON, it provides a significant reduction in the time required to
take individual hits. The biggest reduction in time occurs when the probe retracts from
the part.
Some probe types (such as the SP25) do not support Fast Probe Mode. Some
machines do not support Fast Probe Mode regardless of the probe type. If you have a
measurement routine with the FASTPROBEMODE/ON command in it, but your probe type
or machine does not support it, the command does nothing.
36
Working in Command Mode
Move Commands
The commands listed below provide you with the ability to alter the movement of the
probe between hits.
MOVE/POINT
MOVE/INCREMENT
MOVE/CLEARPLANE
MOVE/CIRCULAR
MOVE/SYNC
MOVE/SWEEP
MOVE/ROTAB
MOVE/EXCLUSIVE_ZONE
37
Using the Edit Window
Probe
The following commands allow you to access options that affect the probe. These
commands allow you to change the active tip in a probe cluster or change the position
of the rotating probe head. Probe compensation can also be turned on or off as needed.
Load Probe
LOADPROBE/<probe name>
In the Load Probe command, <probe name> represents a user editable field that allows
you to load a file of qualified probe tips to be used within the measurement routine. For
example, LOADPROBE/TESASTAR loads a probe named TESASTAR.
Probe Comp
PROBECOM/ON (or OFF)
The Probe Comp command allows you to turn probe compensation on or off. It is
considered ON if the command is displayed in the Edit window.
Read Point
F_ID= FEAT/ POINT, TOG1
THEO/ x, y, z, i, j, k
ACTL/ x, y, z, i, j, k
READPOINT
The Read Point command creates a point feature at the current location of the probe.
PC-DMIS then stores the values of the point that is read.
38
Working in Command Mode
If you execute this type of point feature in Offline mode and the feature follows a
MODE/MANUAL command, it copies the theoretical vector and position to the measured
vector and position; otherwise, the value comes from the current probe position.
See "Creating a ReadPoint from the Probe's Position" in the "Creating Generic
Features" chapter for additional information.
Tip
The tip command tells PC-DMIS to use the specified probe tip.
The SHANKIJK is just another vector form of specifying the A and B angles for the
tip.
The ANGLE specifies the angle that the tip transformation matrix is rotated about the
shank vector.
Comments
This option allows you to display comments during the execution of the measurement
routine, or to send the comments to the inspection report. These comments are created
using the Insert | Report Command | Comment menu option. The Show
Comments option also allows you to add, edit, or delete operator notes and inspection
report comments within the Edit window. The COMMENT command switches between the
options OPER, REPORT, YESNO, $$, INPUT, and READOUTS.
When typing your comment text directly into the Edit window in Command mode,
PC-DMIS interprets the first Enter key that you press as an additional text line in your
comment. If you want to type a new command following your comment, press Enter
twice at the end of your comment text.
When you open a measurement routine that was saved from a later version, any
commands that are not supported in the current version will show up as DOC
comments.
For more information on comments, see the "Inserting Programmer Comments" topic in
the "Inserting Report Commands" chapter.
39
Using the Edit Window
Operator
This option displays a message to the operator when the measurement routine is
executed. Type the command COMMENT/OPER in the desired location of the Edit
window. Type in the desired text you want to display to the operator, and press Enter.
You can also access this option by selecting Insert | Report Command | Comment
from the menu bar to show the Comment dialog box. Then select Operator.
When the operator executes the measurement routine with this command, a message
displays the comment to the operator.
Pressing the F9 key while the cursor is in a COMMENT/OPER command line displays the
Comments dialog box allowing you to alter the displayed message.
For more information on comments, see the "Inserting Programmer Comments" topic in
the "Inserting Report Commands" chapter.
Report
This option sends text to the inspection report when the measurement routine is
executed. Type the command COMMENT/REPT in the desired location of the Edit
window. Type in the desired text, and press Enter. You can also access this option by
selecting Insert | Report Command | Comment from the menu bar to show the
Comment dialog box. Then select Report.
When the operator executes the measurement routine, these messages are not
displayed during execution. However, they are sent to the inspection report.
Pressing the F9 key while the cursor is in a COMMENT/REPT command line displays the
Comments dialog box allowing you to alter the displayed message.
For more information on comments, see the "Inserting Programmer Comments" topic in
the "Inserting Report Commands" chapter.
40
Working in Command Mode
Input
This option is similar to Operator in that it allows you to display text when executing a
measurement routine. In addition to displaying a message, a comment box appears so
the operator can type information that is then written to the inspection report.
Type the command COMMENT/INPUT in the desired location of the Edit window. Type
in the desired text. The input from the operator is assigned to the Comment ID and is
accessible via an expression reference (such as C1.INPUT for example).
You can also access this option by selecting Insert | Report Command | Comment
from the menu bar to show the Comment dialog box. Then select Report.
Pressing the F9 key while the cursor is in a COMMENT/INPUT command line displays
display the Comments dialog box, allowing you to alter the displayed message.
For more information on comments, see the "Inserting Programmer Comments" topic in
the "Inserting Report Commands" chapter.
$$ (Document)
This option provides you with the ability to document (add programmer comments to)
the internal measurement routine. It will not display any text when executing the
measurement routine. Visually, this command does not have the usual COMMENT
prefix to the command in the Edit window. This is done to help the comment stand out
inside the Edit window.
1. Type COMMENT and press Tab. PC-DMIS highlights the OPER field.
2. Type $$ and press Tab or Enter.
You can also access this option by selecting Insert | Report Command | Comment
from the menu bar to show the Comment dialog box. Then select Document.
41
Using the Edit Window
When you open a measurement routine that was saved from a later version into the
current version, any commands that are not supported in the current version show up as
DOC comments. See "Save As" in the "Using Basic File Options" chapter.
For more information on comments, see the "Inserting Programmer Comments" topic in
the "Inserting Report Commands" chapter.
Yes / No
This option displays message box with a question and YES / NO buttons when the
measurement routine is executed. Type the command COMMENT/YESNO in the desired
location of the Edit window. Type in the desired question you want to display to the
operator, and press Enter. You can also access this option by selecting Insert | Report
Command | Comment from the menu bar to show the Comment dialog box. Then
select Yes / No.
The response to the YES / NO question appears in the measurement routine. The text
'YES' or 'NO' is associated with the comment identification and is available in any
expression via a reference to the Comment ID (such as C1.INPUT for example).
For more information on comments, see the "Inserting Programmer Comments" topic in
the "Inserting Report Commands" chapter.
Readouts
This option allows you to display text inside the Probe Readouts window when the
measurement routine is executed. Type the comment COMMENT/READOUTS in the
desired location of the Edit window. Type in the desired text you want to display in the
Probe Readouts window, and press Enter. You can also access this option by selecting
Insert | Report Command | Comment from the menu bar to show the Comment
dialog box. Then select Readouts.
42
Working in Command Mode
For more information on comments, see the "Inserting Programmer Comments" topic in
the "Inserting Report Commands" chapter.
Trace Fields
PC-DMIS uses trace fields to send additional information into your statistical
database along with your measurement results. The Insert | Statistics Command |
Trace Field menu option opens the Trace Field dialog box.
For more information about the trace field, see "Using Trace Fields".
Expressions
You can insert expressions into most of PC-DMIS's editable fields. See the "Using
Expressions and Variables" chapter.
Screen Captures
You can insert a DISPLAY/METAFILE command to insert screen captures of the
Graphic Display window into your report. See the "Inserting Screen Captures" topic in
the "Inserting Report Commands" chapter.
Global Commands
The table below defines the list of global commands available in the Edit window. While
you cannot alter these commands, the Edit window does allow you to select the minor
commands following these major commands.
1. Press the Tab key to select the minor command in the Edit window.
2. Press F7 or F8. This toggles through the available choices.
This list serves as a comprehensive summary of the commands that can be added to a
measurement routine. See each specific section for more information as necessary.
43
Using the Edit Window
The maximum number of characters that PC-DMIS can manage within any
line of the Edit window is 280.
2DDISTANCE (see
M
"Dimensioning Distance")
3DDISTANCE (see
M
"Dimensioning Distance")
ANGULARITY (see
M
"Dimensioning Angularity")
ANALYSISVIEW (see
"Analysis area")
44
Working in Command Mode
AUTOTRIGGER (see
"Parameter Settings: Probe
Trigger Options tab")
CALCULATION
COLUMN132 (see
"Dimensions")
CONCENTRICITY (see
M
"Dimensioning Concentricity")
CIRCULARITY (see
"Dimensioning Circularity")
CYLINDRICITY (see
"Dimensioning Cylindricity")
45
Using the Edit Window
DEFAULT_CASE (See
"Default Case / End Default
Case")
END_DEFAULTCASE (see
"Default Case / End Default
Case")
EXTERNALCOMMAND (see
"Inserting External Objects")
46
Working in Command Mode
FLATNESS (see
M
"Dimensioning Flatness")
GO TO (see "Jumping to a
Label Using GoTo")
LEITZPROBE
47
Using the Edit Window
LOCATION (see
A, D, M, PA, PR, R, T, X, Y, Z
"Dimensioning Location")
OPTIONMOTION (see
"Parameter Settings: Probe
Options tab")
PARALLELISM (see
M
"Dimensioning Parallelism")
PD
PERPENDICULARITY (see
"Dimensioning M
Perpendicularity")
48
Working in Command Mode
RETROLINEARONLY (see
ON, OFF
"Location Options")
RS
RT
49
Using the Edit Window
STRAIGHTNESS (see
M
"Dimensioning Straightness")
SUBROUTINE (see
"Branching with Subroutines")
TEMPCOMP (see
"Compensating for
Temperature")
• Alt + F3
Displays the Search dialog box.
• Shift + Tab or Ctrl + Left Arrow
Moves the cursor backward to the last editable field.
• Ctrl
Hold Ctlr and click on a feature in the Graphic Display window to move the cursor
to the corresponding feature line in the Edit window. Hold Ctrl and double-click
on a feature to select the entire feature.
• Ctrl + A
Selects and highlights all the text in the Edit window.
50
Working in Command Mode
• Ctrl + C
Copies text or objects to the Clipboard. If you highlight text from a single field,
that text is copied to the Clipboard. If more than one field is highlighted, then the
entire object is copied to the Clipboard.
• Ctrl + E
Executes selected features (or the feature with the cursor).
• Ctrl + End
Moves the cursor to the end of the measurement routine.
• Ctrl + Tab
Minimizes or restores the Edit window.
• Ctrl + Home
Moves the cursor to the beginning of the measurement routine.
• Ctrl + Page Down
Moves the cursor to the end of the file.
• Ctrl + Page Up
Moves the cursor to the beginning of the file.
• Ctrl + Q
Displays the Execution dialog box so you can execute the measurement routine.
• Ctrl + T
Assigns the current command to the selected active arm.
• Ctrl + V
Pastes the Clipboard's contents at the insertion point. If you only copied text, this
attempts to paste the text. If you copied an entire object to the Clipboard, this
attempts to paste the entire object. In the latter case, if the insertion point is in the
first column of the Edit window on the first line of a command, the Clipboard
object is placed before this object. In all other cases, the insertion is after the
object.
• Ctrl + X
Cuts any highlighted characters.
• Ctrl + Y
Displays the Execution dialog box and resumes a paused execution.
• Delete or Backspace
Deletes any highlighted characters. If nothing is highlighted, then both keystrokes
function as in a normal editor.
• Double-click
Highlights the editable field that the cursor is on.
• Down Arrow
Moves the cursor down one line.
• F1
Displays the Help topic for the command.
51
Using the Edit Window
• F2
Inserts an expression.
• F3
Marks a single feature for execution. Multiple features can be marked
simultaneously by highlighting them before selecting this command.
• F4
Prints the entire contents of the Edit window.
• F5
Displays the Setup Options dialog box.
• F6
Displays the Change all the fonts dialog box.
• F7
If the cursor is placed in a toggle field, this key switches the entry in the field
forward to the next entry in the alphabetical list of allowed entries. If the end of
allowed entries is reached, it cycles to the beginning of the list.
• F8
If the cursor is placed in a toggle field, this key switches the entry in the field
backward to the previous entry in the alphabetical list of allowed entries. If the
beginning of allowed entries is reached, it cycles to the end of the list.
• F9
Opens the dialog box for the command on which the cursor is residing when the
you press this key.
• F10
Displays the Parameter Settings dialog box.
• F12
Displays the Fixture Setup dialog box.
• Left Arrow
Moves the cursor left one character.
• Page Down
Moves the cursor down one page.
• Page Up
Moves the cursor up one page.
• Right Arrow
Moves the cursor right one character.
• Shift
If you hold Shift and an arrow key is pressed, the text is highlighted as the cursor
moves. Holding Shift and double-clicking on a start block or end block selects the
entire command block.
• Shift + F10
Displays the Jump To dialog box.
52
Working in DMIS Mode
Most of the commands and features that you can add to your measurement routine from
Command mode, you can also add from DMIS mode. For information on how to insert
or edit commands in DMIS mode, see "Understanding Core Concepts".
Nominal values, basic hit values, and vector component values are not parameters;
therefore, you cannot copy and paste them.
Copying a Parameter
1. Use one of the following methods to select the parameter(s) that you want to
copy:
53
Using the Edit Window
Command mode
Summary mode
Command mode
• To select a complete feature to copy all of its parameters, hold down the
Ctrl key and then drag your mouse. For example:
54
Copying and Pasting Parameters
Command mode
Summary mode
Pasting a Parameter
1. Use one of the following methods to select the feature to paste the copied
parameter(s) to:
• To select a single feature, click anywhere on the feature or dimension.
• To select multiple, continuous features, click on the first feature and then
drag your mouse while holding the mouse button. For example:
Command mode
55
Using the Edit Window
Command mode
For example, suppose you have several hundred points in your measurement routine
from a scan that you want to hide to make the overall structure of the measurement
routine more visible and easier to work with. You can select all of the point commands
as long as they are all in one list, and then select the Insert | Group menu item to group
those commands together. In any mode of the Edit window, you can then show or hide
the commands inside of the group as needed.
56
Working with User-Defined Groups
For example, in the images below, the left Edit window shows a group with the points
expanded (A). The right Edit window shows a group with the points collapsed (B).
Groups appear in this format inside the Edit window in Command mode:
ENDGROUP/
SHOWALLPARAMS = This toggle field let you show or hide commands inside of
the group in Command mode or DMIS mode. By default, this command is set to
YES, which shows all of the commands within the group. If you set it to NO,
commands inside the group still exist, but are hidden.
Inserting Groups
When you insert your first group command into a measurement routine, PC-DMIS gives
the command a default name of "GRP1" in Command mode and DMIS mode, and
57
Using the Edit Window
"GRP1 = GROUP" in Summary mode. PC-DMIS then increments the number in the ID
for each additional group. To easily modify the name of the group to something more
descriptive, type a new ID in Command or DMIS mode, or press F9 and edit the
GROUP command that way.
There are several different ways to insert groups into a measurement routine:
• Insert | Group menu item - This menu item inserts the GROUP and ENDGROUP
commands. If you selected multiple commands before you selected this menu
item, they would be placed inside of the group. In Command and DMIS modes,
this means that the GROUP command would precede the very first selected
command, and the ENDGROUP command would follow the last selected
command. If you don't have any commands selected, PC-DMIS displays a dialog
box that asks if you want to insert the command pair without any features inside
it. This menu item works in any mode of the Edit window.
• Right-click shortcut menu - Right-click inside Command or DMIS mode, and
select Group from the shortcut menu. If you selected multiple commands before
you selected this menu item, they would be placed inside of the group. In
Command and DMIS modes, this means that the GROUP command precedes the
very first selected command, and the ENDGROUP command follows the last
selected command.
• Summary mode - Right-click inside Summary mode, and select Add Command.
From the list of commands that appears, select Group. This option inserts an
empty GROUP / ENDGROUP command pair. Groups appear as folders inside
Summary mode. Commands appear indented inside those folders. You can
expand or collapse these groups by clicking on the plus (+) and (-) buttons,
respectively. The ENDGROUP is hidden in Summary mode.
• Type the command - In Command or DMIS mode, type GROUP, and press Enter
or Tab. PC-DMIS inserts an empty GROUP / ENDGROUP command pair.
PC-DMIS makes the Group menu item unavailable for selection if you try to
group something that is not allowed, such as attempting to only group a portion of a
command's block.
If your PC-DMIS license is programmed with the Feature Based Measurement (FBM)
module, you will see an extended group command. For example:
58
Working with User-Defined Groups
PC-DMIS extends the GROUP command when you use the command with FBM. The
group header displays an additional choice for execution control. For complete
information, see "Using Feature Based Measurement".
Editing Groups
To edit a group in the Edit window, modify it directly in the Edit window directly. You can
also press F9 on the GROUP command, or double-click on the command, and use the
Group dialog box:
59
Using the Edit Window
Removing Groups
Removing Only Group Commands
To remove the GROUP / ENDGROUP commands, but retain the group's contents, do one
of the following:
• In the Edit window in Command mode, ensure that all the items in the group are
visible, select either the GROUP or ENDGROUP command (but not the entire
group), and press Delete on your keyboard.
• In the Edit window in Summary mode, expand the group, right-click on the GROUP
command, and either select Delete from the shortcut menu or press Delete on
your keyboard.
To remove the GROUP / ENDGROUP command and its contents, do one of the following:
• In the Edit window in Command mode, hide all of the features in the group, select
the GROUP and ENDGROUP commands (ensure that you select both commands),
and press Delete on your keyboard.
• In the Edit window in Summary mode, collapse the group, right-click on the
GROUP command, and either select Delete from the shortcut menu or press
Delete on your keyboard.
If the items in the group are visible, you need to select the entire GROUP / ENDGROUP
command block before you remove it.
60
Working with User-Defined Groups
If all the commands in a group are tied to one arm, the GROUP command also has the
same margin color markings. If you then change the arm mode of the GROUP command,
all commands inside switch their margin color markings to the other arm.
If one or more commands are tied to both arms, the GROUP command also has the
same margin color markings as both arms.
For information on Multiple Arm Mode, see the "Using Multiple Arm Mode" chapter.
61
Using the Edit Window
The various operations you can perform on a group are described in detail below. Most
are taken from the Command mode's shortcut menu. Right-click in the Command mode
to see this shortcut menu. This shortcut menu is discussed in the "Command Mode
Shortcut Menu" topic in the "Using Shortcut Keys and Shortcut Menus" chapter. The
information below only applies to how this menu works with GROUP commands or
features inside of groups.
• Select Command - When the group is collapsed and you choose Select
Command, PC-DMIS selects every command contained in the group as a block.
When the group is expanded, Select Command selects only the GROUP
command itself.
• Select Block - This menu item selects every command contained in the group as
a block, regardless of the expanded/collapsed state of the group.
• Execute From Cursor (Ctrl + U) - This doesn't change from the usual operation.
• Execute Block (Ctrl + L) - If you select a block, PC-DMIS only executes the
block. If you selected a group as the block, then PC-DMIS executes the group.
• Jump To (Ctrl + J) - This doesn't change from the usual operation.
• Jump Back (Alt + J) - This doesn't change from the usual operation.
• Edit (F9) - When the cursor is positioned on the GROUP command, a Group
dialog box appears. You can modify the group's ID and display state. If you
select Edit on the ENDGROUP command, nothing happens.
• Mark (F3) - If you place the cursor on the GROUP command and select this
menu item, all items contained within the group are Marked or Unmarked as a
whole. If you have any unmarked commands within the group when you select
this menu item, those commands become marked, and all other commands
remain marked. If all commands within the group are already marked when you
select Mark (F3), all commands become unmarked. The color of the GROUP
command reflects the marked state of the commands contained within the group.
If at least one command within the group is marked for execution, then the group
displays as marked for execution. If no command is marked, then the group
displays as unmarked.
• Delete - This menu item only appears on the Summary mode shortcut menu. If
you select a GROUP command and then select Delete, PC-DMIS deletes the
62
Using Feature Based Measurement
• File | Partial Execution | Execute Feature (Ctrl + E) - Selecting this menu item
while selecting the GROUP command executes all features inside the group.
• Flow Control Statements - The ID can be used to control the flow of
measurement routine execution, similar to how you can send execution flow to a
LABEL command. You can use GOTO or IF_GOTO flow control commands to
send the execution flow to a group based on defined conditions. For example:
or
GOTO/GRP1
Mini routines provide the user interface that enables you to execute a measurement
routine that you create with the FBM method. Sub mini routines provide the facility to
create the structure to measure tool-based, cell-based, and operation-based features
from the measurement routine.
63
Using the Edit Window
64
Using Feature Based Measurement
PC-DMIS extends the GROUP command when you use the command with FBM. For
example:
65
Using the Edit Window
The group header displays an additional choice for execution control. Three options are
available in the group control:
• ALL ALWAYS - PC-DMIS always marks and executes the entire group and its
nested subgroups. There may be several situations where the PC-DMIS
application programmer would like to always measure certain features.
• AS MARKED - The FBM marking method marks the commands in the
measurement routine to measure the selected dimensions. All parent features of
every dimension are selected, and any required alignment is marked. If you
select AS MARKED, PC-DMIS executes all of the marked features. PC-DMIS
skips all of the non-marked commands.
• FBM CHECK - At the time of execution, PC-DMIS determines if a feature or
dimension is marked in the group. If it finds a marked feature or dimension, it
executes the entire group according to its marking status. If PC-DMIS determines
that no feature or dimension is marked, it skips the entire group.
For information about inserting groups into a PC-DMIS measurement routine, see
"Inserting Groups".
FBM Concepts
Each group can measure features on a given face of a part. There may be move points
at the beginning of the group. These move points position the tip on top of the face of
interest. You can now use any method in PC-DMIS to measure all of the features on
this face. When all measurements are completed, the probe moves back to a position
from where it can safely move to any other group.
The move points at the beginning and end of the group compare to the entry and exit of
a car on a highway. Here we enter the group and position the tip for measurement of
any feature on that face, and after the measurement is complete, we position the tip
such that it can move to any other face or tool changer if required.
You can use nested groups in cases where additional move points may be required to
measure features without collision. For example:
66
Using Feature Based Measurement
To measure the planes on the V groove, you would create a nested group. This nested
group has an entry and exit move point in front of the V groove. This ensures collision-
free measurement of the planes in the groove.
You can create dimensions in the group where they are measured, or create them in a
separate group. You can also group dimensions according to an operation, cell, or
manufacturing tool. This may help you select a complete group of dimensions to
measure any operation.
If a tip or tool change is required for measurement, then they should be done within the
group. Each group should ensure that the required probe and tip are selected.
If datum feature reference letters are assigned to the datum features, that assignment
should be within the group that measures the features.
Alignment Concepts
Carefully consider how you create alignments. For FBM, you select a dimension to
report, and FBM marks the related features.
FBM marks all of the features that are required to create the appropriate alignment. In
PC-DMIS, alignments can be based on the recall of a previous alignment. In those
cases, FBM also looks at those alignment dependencies and marks everything that is
required to create the recalled alignment as well.
PC-DMIS may use variables to measure a family of parts. FBM supports variables.
67
Using the Edit Window
It is recommended that you define and use the variable in same group in which the
feature is measured.
If you need variables (character strings or numbers) for any reason, you may want to
define them in a START_GROUP command at the beginning of the measurement routine.
Mark this group as EXECUTION CONTROL=ALL ALWAYS. You can place anything that
must be executed (such as non-motion commands, trace fields, and generating strings
for output file names) in the START_GROUP command.
You can create commands outside of a group. Any command that exists outside of all
groups (that is, it does not belong to a group) has a "global scope". PC-DMIS always
executes these commands according to their marked status.
1. Create the mini routine with the required dimensions. For help, see "Mini
Routines".
2. Select FBM in the Mode list in the Mini Routines dialog box.
3. To mark the features and dimensions that will be measured, click the Show
Marked button. The features and dimensions will be marked in the Edit window.
4. To start the measurement, click the Execute button.
68
Using Feature Based Measurement
6. For groups for which the execution control is set to AS MARKED, PC-DMIS
completely executes the group according to the normal marking rule.
Important Notes
This functionality is provided for certain industries that may want to quickly re-
measure certain dimensions after they measure the complete part without moving
the part from its fixture.
• Any command that exists outside of all groups (that is, it does not belong to a
group) has a "global scope". PC-DMIS always executes these commands
according to their marked status.
• Nested groups follow the same execution rules. If an inner group contains a
measurement command, PC-DMIS also executes its outer group.
For example, suppose you have GROUP A and GROUP B. GROUP B is nested
inside GROUP A. If execution control is set to FBM CHECK for both GROUP
commands, but only GROUP B has features or a marked dimension, GROUP A
also executes its marked commands.
69