0% found this document useful (0 votes)
94 views75 pages

25 - Inserting Report Commands

This document provides information on inserting various commands into the PC-DMIS Edit window to customize reports. It discusses commands related to the analysis window, inserting dimension and point info boxes, programmer comments, embedding reports, external objects, print commands, viewsets, forms, screen captures and snapshots. The analysis dialog box allows selecting dimensions to view graphically or textually in an analysis window, and includes options like a magnification multiplier. Viewing selected dimensions aids in determining sources of measurement errors or irregularities.

Uploaded by

sokaiya raman
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
Download as pdf or txt
0% found this document useful (0 votes)
94 views75 pages

25 - Inserting Report Commands

This document provides information on inserting various commands into the PC-DMIS Edit window to customize reports. It discusses commands related to the analysis window, inserting dimension and point info boxes, programmer comments, embedding reports, external objects, print commands, viewsets, forms, screen captures and snapshots. The analysis dialog box allows selecting dimensions to view graphically or textually in an analysis window, and includes options like a magnification multiplier. Viewing selected dimensions aids in determining sources of measurement errors or irregularities.

Uploaded by

sokaiya raman
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
Download as pdf or txt
Download as pdf or txt
You are on page 1/ 75

Table of Contents

Inserting Report Commands ........................................................................................... 1

Inserting Report Commands: Introduction ................................................................... 1

Inserting Commands Related to the Analysis Window ................................................ 2

Show All Arrows ....................................................................................................... 3

View Window............................................................................................................ 3

Inserting Dimension Info Boxes ................................................................................. 16

Dimension Info Creation Rules............................................................................... 17

Display Options ...................................................................................................... 18

Graphic Options ..................................................................................................... 20

Location Axes......................................................................................................... 23

Position Axes ......................................................................................................... 25

Delete Infos ............................................................................................................ 26

DIMINFO Command .............................................................................................. 26

Inserting Point Info Boxes .......................................................................................... 28

Delete Infos ............................................................................................................ 31

POINTINFO Command .......................................................................................... 32

Graphic Options ..................................................................................................... 33

Inserting Programmer Comments .............................................................................. 35

Operator ................................................................................................................. 37

Report .................................................................................................................... 38

Document............................................................................................................... 39

Input ....................................................................................................................... 40

i
Table of Contents

Yes / No ................................................................................................................. 42

Readouts................................................................................................................ 44

Display On Report .................................................................................................. 45

Auto-Continue Execution ....................................................................................... 45

Display Full Screen ................................................................................................ 46

Import Media .......................................................................................................... 47

Remove Media ....................................................................................................... 49

Comment Text........................................................................................................ 50

Inserting ASCII Characters .................................................................................... 50

Embedding Reports or Report Templates in a Measurement Routine....................... 51

The REPORT Command ....................................................................................... 52

Using the PARAM command to Map PC-DMIS Expressions to Object Properties. 55

Inserting External Objects.......................................................................................... 56

Inserting a Print Command ........................................................................................ 56

Understanding the Syntax for the PRINT/REPORT Command .............................. 57

Editing the PRINT/REPORT Command ................................................................. 62

Inserting a Form Feed Command .............................................................................. 63

Working with Viewsets ............................................................................................... 63

Inserting a FORM Command ..................................................................................... 65

Inserting Screen Captures ......................................................................................... 69

Inserting Snapshots ................................................................................................... 70

ii
Inserting Report
Commands
Inserting Report Commands:
Introduction
PC-DMIS allows you to insert a variety of commands into the Edit window that affect
how and what information gets displayed in reports. These commands, inserted by
selecting menu options from the Insert | Report Command sub menu, allow the
programmer to configure, view, print, and otherwise customize the appearance of the
Edit window.

The following topics are covered in this chapter.

• Inserting Commands Related to the Analysis Window


• Inserting Dimension Info Boxes
• Inserting Point Info Boxes
• Inserting Programmer Comments
• Embedding Reports or Report Templates in a Measurement Routine
• Inserting External Objects
• Inserting a Print Command
• Inserting a Form Feed Command
• Working with Viewsets
• Inserting a FORM Command
• Inserting Screen Captures
• Inserting Snapshots

1
Inserting Report Commands

Inserting Commands Related to the


Analysis Window

Analysis dialog box

The Insert | Report Command | Analysis menu option brings up the Analysis dialog
box. This dialog box sends the dimensional printout to an Analysis window in a format
suitable for close examination. From the Analysis window, you can insert an
ANALYSISVIEW command into the Edit window to include the analysis on the report.
For information on the Analysis window, see the "View Window" topic.

If this dialog box is open, you can click on a feature in the Graphic Display window to
automatically highlight dimensions using that feature in the Dimension List box.

The Analysis area of this dialog box allows you to choose to view the dimension(s)
selected from the Dimension List box in either a graphical or a textual readout.

2
Inserting Commands Related to the Analysis Window

By default the check boxes in the Analysis area are not selected. When you select
either the Textual or Graphical check box and click Apply, PC-DMIS will show the
selected dimensions in a textual format or a graphical image. It will not display any CAD
data.

It is helpful to have either the Graphical or Textual Analysis option on when having a
problem with a feature whose cause needs to be determined.

Suppose you are inspecting a plane for flatness, and you find it is out of
tolerance. Using the Graphical Analysis option will allow you to examine the plane and
determine if a specific area is bad or if the entire surface is irregular.

Graphical - If the Graphical check box is selected, PC-DMIS stores the dimension
information in a format to be viewed graphically.

Textual - If the Textual check box is selected, PC-DMIS stores the dimension
information in a format to be viewed textually.

Multiplier - The value in the Multiplier box is a scaling factor that magnifies the
arrow and tolerance zone for the graphical analysis mode. For example, if a value of 2.0
is entered, PC-DMIS will scale the arrow two times the graphical image. This option is
used for viewing purposes only, and is not reflected in the text printout.

Show All Arrows

The Show All Arrows button shows the graphical analysis arrows used to mark
deviation. These graphical analysis arrows can be hidden arrow by arrow. To do this,
press CTRL + SHIFT, and click the arrows to hide. Clicking the Show All Arrows
button re-displays the arrows. The graphical analysis arrows will then be reset for
display purposes.

View Window

From the Analysis dialog box, the View Window button displays the Analysis window.

3
Inserting Report Commands

You can use the Analysis window's menu bar to alter the graphical image, capture the
current graphics screen, or edit the selected dimension colors.

Analysis Window

To access this window:

1. Select Insert | Report Command | Analysis menu option to show the Analysis
dialog box.
2. From the Analysis dialog box:
• Select the dimension that needs to be examined in the Analysis window.
• In the Multiplier box, type a value to magnify the arrow and tolerance
zone.
3. Click View window button to open the Analysis window.

The menu bar on the Analysis Window provides these menus:

• File
• View
• Show
• Options

In order to determine the initial view of the graphical analysis in the Analysis Window,
PC-DMIS uses either the scan cut vector for profile dimensions of scans or the current
workplane for other dimensions. This view can be altered later.

4
Inserting Commands Related to the Analysis Window

File Menu
The Analysis window's File menu allows you to send the contents of the Graphics
Analysis window directly to the printer for printing purposes.

The Analysis window's View menu allows you to temporarily alter the graphics
displayed for the selected dimension. By rotating, scaling or changing the view you can
easily access the necessary dimensions.

This option is especially useful when viewing the profile error of a set of
points.

The View | Change menu option lets you create new views from a CAD file. This
function is useful when a 2D IGES file is used that contains several views of a part in
one plane and the views need to be associated with their correct orientation in the
Graphic Display window. See "Setting Up the Screen View" in the "Editing the CAD
Display chapter for more information on manipulating views.

The View | Scale To Fit menu option re-draws the part image to fit entirely within the
Graphic Display window. This function is useful whenever the image becomes too large
or small.

The View | Rotate menu option displays the Rotate dialog box allowing you to rotate
the part image in three dimensions.

The topic "Rotating the Drawing" in the "Editing the CAD Display" chapter describes
rotating in further detail.

5
Inserting Report Commands

Show Options dialog box

The Analysis window's Show | Show Options menu command displays the Show
Options dialog box. This dialog box allows you to choose what things you want
displayed in the Analysis window.

The Analysis window's Show | Show Dimensions Stats brings up the Edit Dimension
Info dialog box. This dialog box allows you to edit in depth the highlighted dimension.
See "Common Dimension Dialog Box Options" in the "Using Legacy Dimensions"
chapter and "Inserting Dimension Info Boxes" in this chapter for more information.

Show Statistics - Displays various statistics in the Analysis window. If the Show
Statistics check box is not selected, dimensional information text will not be displayed
(for any dimensions). See the Edit Dimension Info menu option to change the format
of the statistics displayed in the Analysis window.

Show Histogram - Displays a histogram of the deviations for each point. Histograms
can be moved to new locations within the Analysis window.

To move to a new location within the Analysis window:

1. Click on the desired histogram.


2. Drag the cursor to the desired location.
3. Release the mouse button.

Show Max/Min Deviations - Displays the maximum and minimum deviations indicated
with a '*+' or '*-' symbol.

Options Menu
The Analysis window's Options menu allows you to capture the current graphics screen
for later use. It also provides access to the Edit Color dialog box and sizing of the
Analysis window.

6
Inserting Commands Related to the Analysis Window

Create/Save Analysis View Command


The Analysis window's Options | Create Analysis View Command menu option uses
the dimensions, views, and rotations used in the Analysis window and inserts that
information into an ANALYSISVIEW command into the Edit window. When PC-DMIS
executes the ANALYSISVIEW command, the following occurs:

• PC-DMIS opens the Analysis window momentarily and then takes a screen
capture of its contents.
• PC-DMIS then displays this screen capture in the Report window. It automatically
sizes the screen capture to fit the Report window. It is inserted into the Report
window's underlying TextReportObject. For information on the TextReport object,
see the "TextReportObject" topic in the "Reporting Measurement Results:
Overview" chapter. It does not affect the AnalysisWindow object.

The Edit window command line for this option reads:


ANALYSISVIEW/D1,D2,D3,,

D1,D2,D3 = list of dimensions to be displayed.

There is no limit to the number of dimension parameters that can be used.

You can also type "ANALYSISVIEW" in the Edit window to creates an ANALYSISVIEW
command. Any dimensions that you select for analysis become parameters for this
command.

Save Graphics to Report


The image will remain on the clipboard until another screen is captured, or the measurement
routine is closed.

The Analysis window's Options | Save Graphics To Report menu option captures the
view in the Analysis window and stores it in a DISPLAY/METAFILE command. When
executed this in turn sends the capture into the inspection report.

PC-DMIS does not have the ability to edit or format the captured image. The graphics
will be displayed at the cursor's location.

7
Inserting Report Commands

This DISPLAY/METAFILE command differs from the DISPLAY/METAFILE command


generated from the main menu in these ways:

• It takes the screen capture of the view in the Analysis window when you select
the menu item, not the Graphic Display window.
• The screen capture does not get retaken during execution, it is a static image.

See "Create Analysis View Command" for creating a screen capture that automatically
updates itself upon execution.

See "Screen Captures" in the "Using the Edit Window" chapter for additional information
on the DISPLAY/METAFILE command.

Edit Dimension Colors


The Analysis window's Options | Edit Dimension Colors menu option allows you to
set the color for a specified tolerance range. Select this option to display the Edit
Dimension Colors dialog box.

Edit Dimension Colors dialog box

8
Inserting Commands Related to the Analysis Window

For instructions on how to use this dialog box to change dimension colors for a
tolerance, see the "Editing Dimension Colors" topic in the "Editing the CAD Display
Options" chapter.

Dimension Options
This Graphical Analysis dialog box determines the information that gets displayed in
the Analysis window.

9
Inserting Report Commands

Graphical Analysis dialog box

To access this dialog box:

1. Select Insert | Report Command | Analysis from the menu to show the
Analysis dialog box.
2. From the Analysis dialog box, from the Dimension list box, select the
dimension.
3. Click View Window to show the Analysis window.

10
Inserting Commands Related to the Analysis Window

4. From the Analysis window's menu, select Options | Dimension Options to


show the Graphical Analysis dialog box.

The dialog box contains two tabs:

• An Analysis Options tab - For a description of the items on this tab, see
"Analysis Options tab" below.
• A Display Options tab - For a description of the items on this tab, see the
"AnalysisWindow Object" topic in the "Reporting Measurement Results" chapter
where it covers the Reporting Options tab.

Analysis Options tab

Show arrow heads - This shows arrow heads on the deviation lines.

Show lines between measured hits - This shows lines between the measured
hits.

Show lines between nominals - This draws lines drawn between the nominal
values.

Show tolerance lines - This displays the acceptable tolerances for the
dimension.

Show max/min deviations - This allows the maximum and minimum deviations
to be indicated with a *+ or *- symbol.

Show grid - This displays a 3D grid-like backdrop for the graphical analysis.
Enabling the grid may help you better visualize rotated items. It also enables the
Grid Options button.

11
Inserting Report Commands

Sample graphical analysis with the grid enabled

Grid Options - This displays the Analysis Grid Options dialog box. You can use
this dialog box to define your grid.

Analysis Grid Options dialog box

The dialog box contains these options:

Automatically Size - This automatically sizes the grid based on the number
of objects specified in the X, Y, and Z fields.

Specified Size - This enables the Maximum Boundary and Minimum


Boundary boxes, which let you type specific sizes for the maximum and
minimum boundaries.

Number of Elements - This defines the number of divisions that will be


drawn on the analysis grid.

12
Inserting Commands Related to the Analysis Window

Maximum Boundary - This defines upper limits of the analysis grid


coordinates.

Minimum Boundary - This defines the lower limits of the analysis grid
coordinates.

Multiplier - This lets you type a scaling factor that magnifies the deviation arrows
and tolerance zone for the graphical analysis mode. If a value of 2.0 is entered,
PC-DMIS will scale the arrows two times the calculated deviation for each feature
hit.

This option is used for viewing purposes only and is not reflected in the
text-only printout.

Show Diameters - This shows the diameters of the available Position dimensions.

Show Best Fit Diameter, Max Inscribed Diameter, Min Circumscribed


Diameter - These check boxes show the diameters for the Circularity dimension.
These diameters represent the average, maximum, and minimum deviations for a
round feature.

Show Contour Plot - This option only works for Profile dimensions applied to
patch scans. The contour plot uses the patch scan's points to create a mesh. It
then shades the mesh with the colors related to the profile deviations from each
hit.

PC-DMIS can also display the contour plot on the CAD model in the Graphic
Display window itself. For information, see "Displaying Surface Profile Contour
Plots" in the "Using Legacy Dimensions" chapter.

Show Color Interpolation Between Hits - This inserts colors between hits. This
option is available for Profile dimensions.

Show Arrows - This shows arrows for each point's deviation. This option is
available for Profile dimensions.

Arrow Density - This slider changes the density of arrows for the points displayed
in any dimension in the entire measurement routine that uses Graphical Analysis.

13
Inserting Report Commands

This differs from the Arrow Density functionality in the Reporting tab of the
XactMeasure GD&T dialog box. The setting in the Reporting tab only affects that
specific dimension. See "Reporting Tab" in the "Using Feature Control Frames:
Introduction" chapter.

Worst - This box defines the number of worst deviations for which to display
arrows. The following examples show all arrows on the left and the three worst
arrows on the right:

Best - This box defines the number of best deviations for which to display arrows.

Example of All The Deviations (100% arrow density)

14
Inserting Commands Related to the Analysis Window

Example of 3 Worst Deviations

Size Options

Analysis Size Options dialog box

The Analysis Size Options dialog box allows you to determine how the Analysis
window will be displayed. These options also allow you to set your ANALYSISVIEW
command so that PC-DMIS takes the screen capture in one of these selected modes
during execution. (See "Create Analysis View Command".)

You can select the following options:

15
Inserting Report Commands

Portrait
This option sizes the Analysis window so that it matches the standard Portrait
page size.

Landscape
This option sizes the Analysis window so that it matches the standard Landscape
page size.

Scale to fit whole page


This check box scales the window so it would fit an entire printed page.

Inserting Dimension Info Boxes

Edit Dimension Info dialog box

The Insert | Report Command | Dimension Info menu option brings up the Edit
Dimension Info dialog box. This dialog allows you to create a DIMINFO command that
displays selected dimensional information in the Graphic Display window. See
"DIMINFO Command" for information on editing a DIMINFO command in the Edit
Window.

16
Inserting Dimension Info Boxes

Sample Dimension Info box

The dimension list inside the dialog box will show an asterisk (*) if the dimension
already contains a DIMINFO text box and it will show a number sign (#) if the DIMINFO
text box is hidden from view in the Graphic Display window.

Sample dimension list showing existing and hidden DIMINFO boxes

The Auto check box (under the Dimension Info Format area of this dialog)
automatically determines the appropriate dimension output format to display, based on
the type of dimension that was selected. To override this option, select the desired
Dimension Info format check box(es). PC-DMIS will indicate the order of the output
selections by displaying a number to the left of the check box. This allows the order of
the format to be altered to meet individual needs. You can clear a check box by simply
selecting it a second time.

If this dialog box is open, you can click on a feature in the Graphic Display window to
automatically highlight dimensions using that feature in the Dimension List box.

This Edit Dimension Info dialog box allows you to edit the dimension information being
displayed. The following paragraphs describe the commands and options available to
this dialog box.

Dimension Info Creation Rules


When you create a DIMINFO box in the Edit Dimension Info dialog box, the
Dimension List box only displays those dimensions that exist above the cursor's
current position.

When you create DIMINFO boxes in Text Box mode and box-select inside the Graphic
Display window, PC-DMIS does not create a DIMINFO box for every selected feature. It
only creates them for features that exist above the cursor's current position.
17
Inserting Report Commands

If the measurement routine has multiple viewsets, the DIMINFO box only appears in the
viewset that contains the corresponding dimension and lower. For example, suppose
that your measurement routine has these commands:

VIEWSET1
F1 = FEAT
VIEWSET2
VIEWSET3
D1 = DIMENSION
VIEWSET4

You could only add a DIMINFO box for feature F1 if the insertion point existed below
D1. Once the DIMINFO box is created, PC-DMIS shows it in VIEWSET3 and 4, but not
in VIEWSET1 and 2.

Display Options

The Display Options area allows different display possibilities for each dimension
within the Graphic Display window.

The following options available are:

Show Icon check box


This check box toggles the displays the appropriate dimension icon in the header
portion of the Dimension Info box.

Show Dimension ID check box


This check box toggles the ability to display the ID for the dimension within the
Graphic Display window.

Show Feature ID check box


This check box toggles the ability to display the ID for the feature whose
dimensions are being measured.

18
Inserting Dimension Info Boxes

Show Headings check box


This check box toggles the display of row and column headings in the Dimension
Info box.

Show Vertical Lines check box


This check box toggles the display of the vertical lines between columns inside the
Dimension Info box.

Show Horizontal Lines check box


This check box toggles the display of the horizontal lines between rows inside the
Dimension Info box.

The Graph Options area allows for graphical display of the dimension percentage in
the Dimension Info box.

No Graph - Select this option if you do not want to display a graph in the Dimension
Info box.

Graph Worst Axis - Select this option to display a graph at the top of the Dimension
Info box. Only the worst dimension percentage will be used for the graph.

Graph Each Axis - Select this option to display a dimension percentage graph for every
axis in the Dimension Info box.

Dimension Info box

19
Inserting Report Commands

Graphic Options

The Graphic Options area allows you to determine the background color and line color
of the current Dimension Info box displayed in the Graphic Display window. You can
also determine whether or not PC-DMIS displays a shadow around the border of the
Dimension Info box.

To change the graphic options for the Dimension Info box, select the desired option
from this area and click Create or OK.

You can also set the default graphic options for newly created Dimension Info boxes. To
do this, select the desired options and then click the Default button in the Dimension
Info Format area.

This topic only applies to legacy feature labels. You can enable legacy feature
labels from the Use legacy graphic labels check box on the Feature Appearance
dialog box. If you clear that check box and use the newer feature labels, this area
doesn't affect those. For more information, see "Editing Feature Appearance" topic of
the "Editing the CAD Display" chapter.

20
Inserting Dimension Info Boxes

The check boxes in the Dimension Info Format area allow you to select the type of
information displayed in the Graphic Display window for each dimension. When the
Display check box is selected from within a dimension's dialog box, PC-DMIS displays
the information in the Graphic Display window.

Dimensional Data Displayed for Feature CIR1 in the Graphic Display window.

The available check boxes in the Dimension Info area of the dialog box are:

Auto
The Auto check box automatically displays the following information: Measured,
Nominal, Tolerances, Deviation, MaxMin, OutTol.

Measured
This check box displays the actual measured dimensions.

Nominal
This check box displays the theoretical values for the dimension.

Tolerances
This check box displays the acceptable tolerance levels either greater than or less
than the nominal.

21
Inserting Report Commands

Deviation
This check box displays the deviation of the measured value from the nominal.

MaxMin
This check box displays the maximum and minimum deviation values from the
points that make up the dimension. While you can mark this for any dimension, it
only makes sense for Line Profile and Surface Profile dimensions. For an example
of this, see the "Parameter Settings: Dimension tab" topic of the "Setting Your
Preferences" chapter.

OutTol
This check box displays how far out of tolerance the measured value is from the
nominal and tolerance values.

Mean
This check box displays the average of all the deviations for the dimension.

StdDev
This check box displays the standard deviation of all the deviations for the
dimension.

Number of Points
This check box displays the number of points used to measure the feature of the
dimension.

The command buttons are:

Recall - Recalls the set default.

Default - Sets the current selection of check boxes as the default.

Reset - Clears out any check marked boxes in this section and selects the Auto
check box.

22
Inserting Dimension Info Boxes

Location Axes

This table describes the available Location Axes and their functions that you can
choose from while editing dimension information.

The following options are available:

Worst check box


This option uses the axis that gives the worst out of tolerance condition. PC-DMIS
searches through the available axes and selects the one that gives the worst case
scenario for the dimension.

Use Dim Axes check box


This option simply uses the axes that were previously defined in the dimension's
dialog box.

X check box
Displays the X axis value.

Y check box
Displays the Y axis value.

Z check box
Displays the Z axis value.

Prad check box


Prad stands for Polar Radius. This option selects Polar coordinates.

Pang check box


Pang stands for Polar Angle. This option selects Polar coordinates.

Area check box


Displays the area of a selected Blob feature. It appears as AR in the DIMINFO box
and in the report. (PC-DMIS Vision uses Blob features.) Legacy reports only show

23
Inserting Report Commands

this information if you also mark the Use dim axes check box from the Position
area. For information on Use dim axes, see "Position Axes".

D check box
Displays Diameter value.

R check box
Displays the Radius (half of Diameter) value.

A check box
Displays the Angle (for cones) value.

L check box
Displays the Length (used for cylinders, slots, cones, and ellipses).

H check box
Displays the height.

V check box
Displays the vector location.

T check box
Displays error along approach vector (for points on curved surfaces).

RT check box
Displays the deviation along the report vector.

S check box
Displays the deviation along the surface vector.

RS check box
Displays the deviation along the surface report vector.

PD check box
Displays the diameter of a circle (perpendicular to the pin vector).

Form check box


Displays the integrated form dimension for the feature. See "Default Axes for
Location Dimensions" in the "Using Legacy Dimensions" chapter.

24
Inserting Dimension Info Boxes

Position Axes

This table describes the available Position Axes and their functions that you can
choose from while editing dimension information.

The following options are available:

Worst check box


This check box uses the axis that gives the worst out of tolerance condition. PC-
DMIS searches through the available axes and selects the one that gives the
worst case scenario for the dimension.

Use Dim Axes check box


This check box simply uses the axes that were previously defined in the
dimension's dialog box.

X check box
This check box displays the X axis value.

Y check box
This check box displays the Y axis value.

Z check box
This check box displays the Z axis value.

Prad check box


Prad stands for Polar Radius. This option selects Polar coordinates.

Pang check box


Pang stands for Polar Angle. This check box selects Polar coordinates.

DF check box
This check box displays diameter of the feature.

TP check box
This check box displays the position tolerance and its associated deviation.

25
Inserting Report Commands

D1 check box
This check box displays the diameter/width value of the first datum.

D2 check box
This check box displays the diameter/width value of the second datum.

D3 check box
This check box displays the diameter/width value of the third datum.

Form check box


This check box displays the integrated form dimension for the feature. See
"Default Axes for Position Dimensions" in the "Using Legacy Dimensions" chapter.

Delete Infos

The Delete Infos button removes all POINTINFO commands from the measurement
routine.

DIMINFO Command
The DIMINFO command is created by the Edit Dimension Info dialog box (Insert |
Report Command | Dimension Info).

When a DIMINFO command has been inserted in the measurement routine, the
dimension data is displayed in the Graphic Display window. The DIMINFO command
can be modified in the Edit window. The command line for the DIMINFO command
reads:

DIMINFO/Dim ID ;ICON,DIMID,FEATID,VERT,HORIZ; HEADINGS,


"GRAPH OPTION";"DIMENSION OUTPUT”, ,$
"AXES OUTPUT"

Dim ID - The ID of the dimension selected to be displayed.

ICON - A toggle string that shows a blank when it is OFF, and "ICON" when it is
ON. When it is ON, the DIMINFO will display the dimension or feature ID with the
appropriate icon.

26
Inserting Dimension Info Boxes

DIMID - A toggle string that shows a blank when it is OFF, and "DIMID" when it is
ON. When it is ON, the DIMINFO will display the dimension ID with the
dimensional information.

FEATID - A toggle string that shows a blank when it is OFF, and "FEATID" when it
is ON. When it is ON, the DIMINFO will display the ID of the dimension’s first
feature with the dimensional information.

VERT - A toggle string that shows a blank when it is OFF, and "VERT" when it is
ON. When it is ON, the DIMINFO will display with the vertical lines between the
columns.

HORIZ - A toggle string that shows a blank when it is OFF, and "HORIZ" when it is
ON. When it is ON, the DIMINFO will display with the horizontal lines between the
rows.

HEADINGS - A toggle string that shows a blank when it is OFF and "HEADINGS"
when it is ON. When it is ON, the column and row headers will be displayed in the
Dimension Info box.

GRAPH OPTION - The graph option for graphical display of the dimension
percentage in the Dimension Info box. Possible toggle values are GRAPH
WORST and GRAPH AXIS. When the toggle string shows a blank, no graph will
be show in the box.

DIMENSION OUTPUT - The format of the dimension information that will be


displayed based on the order of selection. Available output options are MEAS,
NOM, TOL, DEV, MAXMIN, OUTTOL, MEAN, STDDEV, and NUMPTS. Options
cannot be duplicated.

AXES OUTPUT - The format of the dimension axes that will be displayed based
on the order of selection. Available axes depend upon the dimension type and
include all location and position axes. If USEDIM is toggled in the first axis
position, the DIMINFO will display the axes that have been specified in the
dimension. If WORST is toggled in any axis position, the axis that produced the
largest out-of-tolerance value is displayed. This output is not available for
dimensions that are not location or position dimensions. Axes cannot be
duplicated.

27
Inserting Report Commands

Inserting Point Info Boxes

Edit Point Info dialog box

The Insert | Report Command | Point Info menu option brings up the Edit Point Info
dialog box. This dialog box creates a POINTINFO command that displays information
boxes in the Graphic Display for individual points. Each information box may display the
hit number, the XYZ position, the IJK vector, and the deviation related to a particular hit.
For information on the POINTINFO command in the Edit Window, see the "POINTINFO
Command" topic.

Point Info box showing the first hit in a circle feature

To insert point information in the Graphic Display window:

1. Choose Insert | Report Command | Point Info to open the Edit Point Info
dialog box.
2. From the Feature list or the Dimension list, select at least one feature or
dimension. The individual points associated with the item you choose appear in
the Hits List box. If you choose more than one dimension or feature, the Hit list
does not appear, and all the points from the dimensions or features appear in the
information box.

28
Inserting Point Info Boxes

3. From the Hit List box, select one or more points that you want to show.
4. From the Point info format area, mark the items you want to show. Any
numbers that appear next to check boxes indicate the row order.
5. Click the OK button to create the information boxes in the Graphic Display
window.

You can save, change, and move the formats similar manner to the Dimension Info
box formats. For information on Dimension Info boxes, see "Inserting Dimension Info
Boxes".

This portion of the dialog box allows you to determine the type of information displayed
in the Graphic Display area next to a feature or dimension. The check boxes in this
section must be used in conjunction with the Create (Apply when editing) or the OK
button to either select or remove information to display. Any numbers that appear next
to check boxes indicate the row order.

Hit Number - This check box displays the hit sequence of a point on a feature.

If a circle generally takes four hits, and one of the hits used to measure that
circle was selected, this option displays a number (one through four) indicating when
that hit was taken in the sequence: 1st, 2nd, 3rd, or 4th.

Point - This check box displays the X, Y, and Z point location of the hit selected.

Vector - This check box displays the IJK vector of the hit selected.

Deviation - This check box displays the deviation of the point from the nominal.

• For features the point deviation is the distance between the measured hits and
the actual hits.

29
Inserting Report Commands

• For dimensions the point deviation is related to the dimension type and is the
same as the deviation displayed for the individual points in the textual analysis of
the dimension.

Show Icon - This check box displays the feature's icon in the header portion of the
Point Info box.

Show ID - This check box allows you to display the ID of a particular feature or
dimension.

Show Type - This check box allows you to display the type of feature or dimension
displayed.

Show Headings - This check box allows you to display the row headers in the Point
Info box.

Show Graph - This check box allows you to display the dimension percentage graph in
the Point Info box.

Show Vertical Lines - This check box allows you to display or hide the vertical lines
inside the Point Info box.

Show Horizontal Lines - This check box allows you to display or hide the horizontal
lines inside the Point Info box.

The Hit List box contains a list of all the hits associated with a particular feature or
dimension. Simply select the hits whose information you would like to view.

30
Inserting Point Info Boxes

The Feature List box contains a list of all the features associated with a particular
measurement routine. Select the feature whose hit information you would like to view.
The hits associated with that feature will be displayed in the Hit List box.

The Dimension List box contains a list of all the dimensions associated with a
particular measurement routine. Select the dimension whose hit information you would
like to view.

The hits associated with that dimension will be displayed in the Hit List box.

Delete Infos

The Delete Infos button removes all DIMINFO commands from the measurement
routine.

31
Inserting Report Commands

POINTINFO Command
The POINTINFO command is created by the Edit Point Info dialog box (Insert | Report
Command | Edit Point info).

When a POINTINFO command has been inserted in the measurement routine, a Point
Info box is displayed in the Graphic Display window. The POINTINFO command can be
modified in the Edit window. The command line for the POINTINFO command reads:

POINTINFO/Dim ID or Feat ID; FILTER FILTER_TYPE


FILTER_NUM;ICON,ID,TYPE,VERT,HORIZ; HEADINGS, GRAPH; ”OUTPUT
FORMAT” ,$
"HIT NUMBERS"

Dim ID or Feat ID - The ID of the dimension or feature to be displayed.

FILTER_TYPE - A toggle string that shows the filter option of NONE, INTERVAL,
WORST, DEVIATION, or OUTTOL.

FILTER_NUM - A number field available when the filter option is INTERVAL,


WORST, or DEVIATION.

ICON - A toggle string that shows a blank when it is OFF, and "ICON" when it is
ON. When it is ON, the POINTINFO will display the dimension or feature ID with
the appropriate icon.

ID - A toggle string that shows a blank when it is OFF, and "ID" when it is ON.
When it is ON, the POINTINFO will display the dimension or feature ID with the
point information.

TYPE - A toggle string that shows a blank when it is OFF, and "TYPE" when it is
ON. When it is ON, the POINTINFO will display feature or dimension type (i.e.
CIRCLE, POINT, ROUNDNESS, LOCATION) with the point information.

VERT - A toggle string that shows a blank when it is OFF, and "VERT" when it is
ON. When it is ON, the POINTINFO will display with the vertical lines between the
columns.

HORIZ - A toggle string that shows a blank when it is OFF, and "HORIZ" when it is
ON. When it is ON, the POINTINFO will display with the horizontal lines between
the rows.

HEADINGS - A toggle string that shows a blank when it is OFF and "HEADINGS"
when it is ON. When it is ON, the row headers will be displayed in the Point Info
box.

32
Inserting Point Info Boxes

GRAPH - A toggle string that shows a blank when it is OFF and "GRAPH" when it
is ON. When it is ON, the dimension percentage will be graphically displayed in
the Point Info box.

OUTPUT FORMAT - The format of the point information that will be displayed
based on the order of selection. Available output options are HIT, PT, V, and DEV.
Options cannot be duplicated.

HIT NUMBERS - The hit numbers are the specific numbered hits that are
controlled by this particular POINTINFO command. Multiple hits can be displayed
using the same POINTINFO command. Each field in the hit numbers is a toggle
string. When a hit is ON, the string in the number position is the hit number (1,2,3,
etc.). When a hit is OFF, the toggle string displays a blank.

Graphic Options

Graphic Options area

The Graphic Options area allows you to determine the background color and line color
of the current Point Info box. You can also determine whether or not PC-DMIS displays
a shadow around the border of the Point Info box.

To change the graphic options for the Point Info box, select the desired option from this
area and click Create or OK.

You can set the default graphic options for newly created Point Info boxes by simply
selecting the desired options and then clicking the Default button in the Point Info
Format area.

This topic only applies to legacy feature labels. You can enable legacy feature
labels from the Use legacy graphic labels check box on the Feature Appearance
dialog box. If you clear that check box and use the newer feature labels, this area
doesn't affect those. For more information, see "Editing Feature Appearance" topic of
the "Editing the CAD Display" chapter.

33
Inserting Report Commands

Filters area

The Filters area allows you to set filter options to be used when displaying individual
point information.

None Used - This tells PC-DMIS not to use any filtering for the POINTINFO command.
All hits selected will be displayed with the POINTINFO command.

Hit Interval - This checks the integer value in the box to its right, and only displays the
particular hit interval chosen with the POINTINFO command. For example, if 2 were
chosen, then every 2nd hit would be displayed, if 3, then every 3rd hit, if 4 then every
4th hit, etc.

Worst - This checks the integers value in the box to its right, and only displays the hits
that give the worst deviations for the dimension. For example, if you type 3 in the box,
the POINTINFO command only displays the three worst deviations.

Deviation Above - This checks the integer value in the box to its right, and only
displays the hits that give the worst deviations for the dimension. For example, if you
type 3 in the box, the POINTINFO command only displays the three worst deviations.

Out of Tolerance - This only displays the hits that have deviations that are out of
tolerance. For hits related to features (not related to dimensions), only those hits with
deviations larger than the Show Deviations Tolerance on the Setup Options dialog
box's General tab are displayed. (See "Show Deviations Tolerance" in the "Setting Your
Preferences" chapter.)

Min/Max - This only shows those hits that are the maximum and minimum deviation
values for the dimension. For an example of MaxMin values, see the "Parameter
Settings: Dimension tab" topic of the "Setting Your Preferences" chapter.

34
Inserting Programmer Comments

Inserting Programmer Comments

Comment dialog box

The Insert | Report Command | Comment menu option allows you to add operator
notes, instructions, or supported media files into the Edit window that will be displayed
in a message box when the measurement routine is executed or when the inspection
report is printed. There is no limit to the length of the comment text; however, in
Command mode only 255 characters will fit per line. When the text reaches the right
side of the Edit window, press the Enter key. (This allows the entire text to be viewed in
the Comment Text box.) To create a new line, place the cursor in the desired location
of the Comment Text box and press the Enter key.

Typing Comments

You can also type a comment into the Edit window in Command mode. To do this, type
COMMENT, press the Tab key on your keyboard, and then type the comment type you
want: such as OPERATOR or REPORT and so forth. Press Tab to accept the command or
to move to the field containing the comment text.

35
Inserting Report Commands

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.

Using Variables in Comment Strings

Suppose you want to concatenate, or add, a variable to an existing comment string. You
can do this in two ways. First, you can press Enter, and type the variable on a new
comment line, like this:

C1 =COMMENT/INPUT,NO,Full Screen=YES,Auto-Continue=NO,
Type your variable
ASSIGN/V1=C1.INPUT
COMMENT/OPER,NO,Full Screen=YES,Auto-Continue=NO,
Your V1 variable is
V1

Second, you can place variables and your comment string on the same line by placing
quotation marks around the non-variable string and using the plus sign operator to add
the variable to the string, like this:

COMMENT/OPER,NO,Full Screen=YES,Auto-Continue=NO,
"Your V1 variable is "+V1

Changing Comment Color

You may want your comments to stand out more. You can do this by changing your
comment color.

• To change them in the Edit window, see "Defining Edit Window Colors".
• To change comment colors for comments that appear in the Report window,
change the Colors property of the TextReportObject in the in the Report
Template Editor.

36
Inserting Programmer Comments

Another way to change a comment's color in the report is to insert this special
prefix directly in front of the comment text:

~~#

This tells the comment to use the defined text color for Marked, Unmarked, Step Mode,
or Error found in the Edit Window Colors dialog box.

For # you would type 01, 02, 03, or 04; these four numbers stand for the Unmarked,
Marked, Step Mode, or Error colors respectively.

So, if you want to display some comment text in the text color assigned to Error, your
command would look like this:

COMMENT/rept, ~~04 Some Comment Text

Operator

The Operator option displays the comment text to the operator when the software
executes the comment command.

To use Operator option:

1. Place the cursor in the Edit window where you want to insert the comment
command.
2. Select the Insert | Report Command | Comment menu option to open the
Comment dialog box.
3. From the Comment dialog box, select the Operator option.
4. In the Comment Text box, type the comment text.
5. Click the OK button to close the dialog box and insert the comment.

The Edit window command line for this option reads:


COMMENT/OPER,TOG1,FULL SCREEN=TOG2,AUTO-CONTINUE=TOG3,
comment text

37
Inserting Report Commands

TOG1 - This YES/NO field allows you to specify whether or the comment shows
up in the inspection report.

TOG2 - This YES/NO field determines whether or not the comment will be
displayed to fill the entire screen.

TOG3 - This YES/NO field determines whether or not the comment will use a
countdown timer and automatically continue execution once the timer reaches
zero. When the countdown timer reaches zero, PC-DMIS will continue as if you
had clicked the OK button.

How it Works

When PC-DMIS executes the measurement routine, a message box will display the
appropriate comments just under the Execution dialog box.

A Sample PC-DMIS Message dialog box

PC-DMIS will not allow you to edit this message. Click on the OK button to continue
execution. Click Cancel to cancel measurement routine execution.

Report

The Report option sends text to the inspection report.

To use the Report option:

38
Inserting Programmer Comments

1. Place the cursor in the Edit window where you want to insert the comment
command.
2. Select the Insert | Report Command | Comment menu option to open the
Comment dialog box.
3. From the Comment dialog box, select the Report option.
4. In the Comment Text box, type the comment text.
5. Click the OK button to close the dialog box and insert the comment.

When PC-DMIS executes the measurement routine, these messages are not viewed.
PC-DMIS does, however, send these comments to the inspection report when it is
printed.

The Edit window command line for this option reads:


COMMENT/REPT,
comment text

If dashes (or other characters) need to be incorporated underneath text in the


inspection report, use a second comment line to create the additional line of characters.

For example:

COMMENT/REPT,
Inspection Report Comment
COMMENT/REPT,
-----------------------------------

This set of command lines creates an Inspection Report Comment line in the inspection
report.

Document

The Document option adds text to the internal measurement routine. Its only use is to
store programmer notes. It does not appear in the inspection report (unless you mark
Display On Report), nor does it display anything when executed.

To use the Document option:

39
Inserting Report Commands

1. Place the cursor in the Edit window where you want to insert the comment
command.
2. Select the Insert | Report Command | Comment menu option to open the
Comment dialog box.
3. From the Comment dialog box, select the Document option.
4. In the Comment Text box, type the comment text.
5. Click the OK button to close the dialog box and insert the comment.

The Edit window command line for this option reads:

$$ TOG1,
Please Edit Comment Text!

TOG1 = This YES/NO field allows you to specify whether or the comment shows up in
the inspection report.

If your measurement routine contains unsupported commands, (perhaps from


a newer version of PC-DMIS) when you open the measurement routine, PC-DMIS
converts them to this comment type. For more information, see "Save As" in the "Using
Basic File Options" chapter.

Input

The Input option is similar to the Operator option in that it allows you to display text
when executing a measurement routine. In addition to displaying a message box with
the previously entered text, a comment box will appear. This allows you to enter
numerical information that will be written to the inspection report.

This option is extremely helpful to users wishing to enter a part number or serial
number while executing the measurement routine.

To use the Input option:

1. Place the cursor in the Edit window where you want to insert the comment
command.
2. Select the Insert | Report Command | Comment menu option to open the
Comment dialog box.

40
Inserting Programmer Comments

3. From the Comment dialog box, select the Input option.


4. In the Comment Text box, type the comment text.
5. Click the OK button to close the dialog box and insert the comment.

The Edit window command line for this option reads:


comment ID=COMMENT/INPUT,TOG1,Full Screen=TOG2,
comment text

TOG1 = This YES/NO field allows you to specify whether or the comment shows
up in the inspection report.

TOG2 = This YES/NO field allows you to specify whether or not the comment fills
the entire screen when displayed.

The input is assigned to the variable specified on the left hand side of the command.
The variable is coerced to be of type string. This variable can then be used anywhere
an expression is allowed by using this syntax <COMMENT ID>.INPUT. For example if
your comment ID is C1, you can pass that variable into another variable like this:

C1 = COMMENT/INPUT,NO,Full Screen=NO,

"Please type your name:"

ASSIGN/V1=C1.INPUT

How it Works

During execution, the message box displays the prompt to enter the necessary number
(such as a serial number) and then it displays this value in the inspection report. This
prompt appears on top of the Execution dialog box:

A sample Input Comment dialog box

Once the operator types his text and clicks OK, PC-DMIS stores it in the comment's
variable. The variable is ID.INPUT (by default the ID for the variable is C1 for the first

41
Inserting Report Commands

Input comment, C2 for the second, and so on. If the operator clicks Cancel, it stops
execution.

Yes / No

The Yes / No option functions similarly to the Operator option in that it allows you to
display text when you execute a measurement routine. In addition, Yes, No and Cancel
buttons appear at the bottom of the dialog box of the PC-DMIS Message dialog box;
this enables the operator to answer yes or no to simple questions.

To use the Yes / No option:

1. Place the cursor in the Edit window where you want to insert the comment
command.
2. Select the Insert | Report Command | Comment menu option to open the
Comment dialog box.
3. From the Comment dialog box, select the Yes / No option.
4. In the Comment Text box, enter the comment text.
5. If you do not click Yes or No on the PC-DMIS Message dialog box and you want
the measurement routine to auto-execute after a set time, select the Auto-
continue execution check box. You can then enter the number of seconds for
the delay in the Execution delay (in seconds) box. For details, see "Auto-
Continue Execution".
6. Click the OK button to close the dialog box and insert the comment.

The Edit window command line for this option reads:


comment ID = COMMENT/YESNO,TOG1,FULL SCREEN=TOG2,AUTO-
CONTINUE=TOG3,

comment text

TOG1 - This YES/NO field allows you to specify whether or not the comment
shows up in the inspection report.

TOG2 - This YES/NO field allows you to specify whether or not the comment fills
the entire screen when displayed.

TOG3 - This YES/NO field determines whether or not the comment will use a
count-down timer and automatically continue execution once the timer reaches
zero. If the operator does not click a button by the time 0 is reached, the

42
Inserting Programmer Comments

measurement routine execution continues with the assumption that the operator
clicked the Yes button.

How it Works

During execution, the PC-DMIS Message dialog box appears below the Execution
dialog box. This enables the operator to click Yes, No, or Cancel:

Sample PC-DMIS Message dialog box with buttons

Execution pauses until the operator clicks a button. A variable stores the answer. The
variable is C1.INPUT.

The answer the operator selects is accessible using expressions with the ID of the
comment.

Example 1: If the comment has an ID of C1 and the operator clicks the Yes button, the
expression "C1.INPUT" contains the value "YES". If the operator clicks the No button,
the expression "C1.INPUT" contains the value "NO". This option is useful to users who
want to branch or loop on a "YES" or "NO" string response.

43
Inserting Report Commands

Example 2: If the comment has an ID of C1 and the operator clicks the Yes button, the
expression "C1.INPUTVALUE" contains the value 1. If the operator clicks the No button,
the expression "C1.INPUTVALUE" contains the value 2. This option is useful to users
who want to branch or loop on a 1 or 2 integer response.

In either case, if the operator clicks Cancel, the measurement routine execution is
canceled.

When you use a conditional branching statement to test for the value of a YES /
NO comment using the .INPUT expression, be aware that your test must look for an
uppercase "YES" or "NO" value. A lowercase "Yes" or "No" does not work. For
information on measurement routine branching, see the "Branching by Using Flow
Control" chapter.

Readouts

The Readouts option displays the comment text at the bottom of the Probe Readouts
window. You must select the Display prompt history check box on the Probe
Readouts Setup dialog box for this to work.

To use the Readouts option:

1. Place the cursor in the Edit window where you want to insert the comment
command.
2. Select the Insert | Report Command | Comment menu option to open the
Comment dialog box.
3. From the Comment dialog box, select the Readouts option.
4. In the Comment Text box, type the comment text.
5. Click the OK button to close the dialog box and insert the comment.

The Edit window command line for this option reads:


COMMENT/READOUTS,TOG1,
comment text

TOG1 = This YES / NO field allows you to specify whether or the comment shows
up in the inspection report.

For more information on setting up this option, see "Setting Up the Probe Readouts
Window" in the "Setting Your Preferences" chapter.
44
Inserting Programmer Comments

For more information on the Probe Readouts window, see "Using the Probe Readouts
Window" in the "Using Other Windows, Editors, and Tools" chapter.

Display On Report

This check box allows you to determine whether or not your comment and any
submitted text (if using an Operator comment, for example) appear in the final report
generated in the Report window. If selected, the comment's YES/NO toggle field, which
specifies whether or not a comment shows up in the report, is set to YES.

This check box is hidden if you select the Report comment type.

The Edit window command line for this option reads:


COMMENT/TOG1,TOG2,
comment text

TOG1 = Any comment type except Report.

TOG2 = This YES/NO field allows you to specify whether or the comment shows up in
the inspection report.

Auto-Continue Execution

Auto-continue execution: This check box determines whether a comment that PC-
DMIS displays during execution closes itself after a specified number of seconds. By
default, this check box is not selected.

Operators may find this useful when they use a measuring device that is not near the
computer, and they want the execution to continue after a certain amount of time. If you
select this check box, the Execution delay (in seconds) box becomes available.

Execution delay (in seconds): This box defines the number of seconds to delay
execution while PC-DMIS displays the comment. You can specify any number of
seconds from 1 to 600, inclusive.

• If you use an execution delay with a movie file and the movie's play time exceeds
the delay value, PC-DMIS waits until the movie finishes playing before
continuing.

45
Inserting Report Commands

• If your movie value is shorter than the specified execution delay, the comment
displays until the execution delay counts down to zero.

During execution, the software displays a count-down timer on the Operator comment
type's OK button inside parentheses:

For the Yes / No comment type, it appears on the Yes button.

Once the timer reaches zero:

• For an Operator comment, execution continues as if the operator clicked the OK


button.
• For a Yes / No comment, execution continues as if the operator clicked the Yes
button.

Display Full Screen


This check box determines whether or not your comment's text is displayed in an
enlarged size that fills the entire screen once the command is executed. This functions
with Input, Yes / No, and Operator comments. If you select other comment types, PC-
DMIS disables this check box. Also, with this check box marked, you have the option to
display certain media (images or movies) within the displayed comment. In that case,
the Import Media and Remove Media buttons become enabled. For information on
those buttons, see "Import Media" or "Remove Media".

The Edit window command line for this option reads:


COMMENT/TOG1,TOG2,Full Screen=TOG3,
comment text

TOG1 = An INPUT, YESNO or OPERATOR comment.

TOG2 = This YES/NO field allows you to specify whether or not the comment shows up
in the inspection report.

TOG3 = This YES/NO field allows you to specify whether or not the comment fills the
entire screen when displayed.

46
Inserting Programmer Comments

Sample image showing a comparison of a full screen Input comment (A) and a normal
sized comment (B).

Import Media

To import this button, you must first mark the Display Full Screen check box.

The Import Media button lets you browse to a valid media file and import that file into
your measurement routine. PC-DMIS then displays it within a full-screen comment when
the measurement routine executes that comment. When you click OK, the file is

47
Inserting Report Commands

imported into the measurement routine and becomes a component of the measurement
routine. This makes it so you don't need to remember to move image and video files
when you move the measurement routine to another computer system or directory.
However, it can also make your measurement routine size quite large, depending on the
type and number of media files you choose to include.

The chosen file appears in the box to the right of the Import Media button.

Valid image file types include the following:

• .bmp
• .png
• .jpg

Valid move file types include the following:

• .avi

About the Media Container

When PC-DMIS executes a comment containing a media file, it sizes the displayed
media to fit within a portion of the full-screen comment called a "container". This means
PC-DMIS sizes the image or movie to fit within the container.

48
Inserting Programmer Comments

This sized image shows a full-screen Operator comment. Notice that the media
container in the top portion of the comment contains a movie sized to fit within that
container.

(A) - Take four hits on the top of the part, as shown in the video above.

The horizontal slider below the container displays the current progression of a loaded
movie file. You can drag the slider to jump to different spots along the movie's timeline.

This icon stops a movie file from playing.

This icon resumes playing a stopped movie file.

Remove Media

49
Inserting Report Commands

This becomes enabled if you first mark the Display Full Screen check box.

The Remove Media button removes the media from the comment. While this removes
the media from the measurement routine, be aware that due to limitations with the
Windows file system, you may still see a file size higher than it was originally before you
imported the media. In these cases, you can always do a File | Save As and save the
measurement routine to a different file name to get a measurement routine with its
original file size.

Comment Text

The Comment Text box contains the text you wish to display in conjunction with the
Comment Type options as shown here:

• Operator
• Report
• Input
• Document
• Yes / No
• Readouts

Inserting ASCII Characters

ASCII Character button set

These buttons on the Comment dialog box insert some commonly used ASCII
characters into the Comment Text box.

50
Embedding Reports or Report Templates in a Measurement Routine

Embedding Reports or Report


Templates in a Measurement Routine
You can embed these reports into your measurement routine:

• Legacy report (HyperView report)


• Report template
• Custom report
• Label template

When PC-DMIS executes the embedded code, it launches the report or template. You
can then print it, view it, and pass values to and from the embedded item.

Legacy reports are older reports that use the HyperView report editor. PC-
DMIS versions 3.0, 3.2, 3.25, 3.5, or 3.7 used this editor. For information on these
reports, see "Working with Legacy (HyperView) Reports".

To embed a report or template:

1. Make sure the Edit window is in Command Mode.


2. Select Insert | Report Command, and then choose one of these menu items.
• Custom Report
• Template Report
• Legacy Report
• Report Label

A dialog box appears allowing you to select your report or template.

3. Select the report or template you want to embed in the Measurement Routine.
4. Click the Open button to insert the command.

PC-DMIS inserts one of the following commands into the Edit window at the cursor
position:

• REPORT/CUSTOM
• REPORT/TEMPLATE
• REPORT/LEGACY
• REPORT/LABEL

51
Inserting Report Commands

The REPORT Command


The Report command object is identified with the REPORT command in the Edit window.

The REPORT Command Syntax

A REPORT command has the following syntax in the Edit window in Command mode:

<ID> =REPORT/<TOG1>, FILENAME= <PATHWAY>,


AUTOPRINT=<TOG2>, INLINE REPORT=<TOG3>,
Section=<NUM1>,REPORTMODE=<MODE>
PARAM/=
ENDREPORT/

<ID>
This is the ID for the REPORT command.

REPORT/<TOG1>
This changes the type of REPORT command. It can be CUSTOM, LEGACY,
TEMPLATE, or LABEL.

FILNAME=<PATHWAY>
This determines the report or template to load. <PATHWAY> is the full file name
path that points to the desired file. If you only use the name of the report or
template, PC-DMIS looks in the default Reporting directory.

AUTOPRINT =<TOG2>
<TOG2> can switch between PRINT and PDF and NO. It only applies to
REPORT/LEGACY commands.

Setting AUTOPRINT=PRINT prints the HyperView report to the default printer


after it loads and executes. The report closes immediately after the print job has
spooled and execution of the measurement routine resumes.

Setting AUTOPRINT=PDF prints the HyperView Report to a Portable Document


Format (PDF) file. The following rules apply:

• The name of the generated PDF file has the same base name as the
report or template file name appended by a numerical index and
extension.
• The generated file is located in the same directory as the Report file.
• If a file exists with the same name as the generated file name, the index
automatically increments itself until a unique file name is found.

52
Embedding Reports or Report Templates in a Measurement Routine

Setting AUTOPRINT=NO does not print anything during execution of this


command.

INLINE REPORT=<TOG3>
This is only used with Legacy (HyperView) Reports that have AUTOPRINT set to
PDF. It determines if HyperView report information appears in line with the other
generated data from the Report window in a PDF output.

<TOG3> switches between ON and OFF.

ON - When this command executes, and the Output Configuration dialog


box generates a PDF automatically by the Overwrite, Auto, or Append
options, the data from the specified legacy (HyperView) report appears in
line with the other normal report output in the PDF file.

If the Prompt option is used, and this is set to ON, then multiple PDFs are
generated, one for the HyperView report and additional PDFs as needed to cover
the rest of the Report window's content.

OFF - Data from the HyperView report appears in its own PDF file based off
the name of the HyperView report. It is not included in the PDF generated
from the Output Configuration dialog box.

Be aware that this option overrides the AUTOPRINT option for HyperView
commands.

For more information on legacy HyperView reports, see "Working with Legacy
(HyperView) Reports".

Section=<NUM>
<NUM> determines the section into which the report or template is inserted. This
item does NOT apply to label templates.

If you type -1 or a value greater than the number of sections in the default
template, the report gets inserted at the end.

REPORTMODE=<MODE>
When a measurement routine executes and a default report template is specified,
it starts to generate the report using the default report template. Once it reaches

53
Inserting Report Commands

the REPORT command, the generation changes based on the specified report
mode:

<MODE> - This can either be SWITCH or INSERT. This mode only applies
to the REPORT/TEMPLATE commands.

SWITCH - This switches the report template to use the one in this command
until another REPORT command is encountered or until the end of the
measurement routine.

INSERT - This generates report data for previously-executed commands. It


uses the template in this command. When this REPORT command finishes,
PC-DMIS returns to using the default report template to generate the rest of
the report data.

PARAM/
The PARAM/ option allows you to map PC-DMIS expressions to a report or a
report template's variables or properties. This option does not apply to
REPORT/LABEL commands.

The syntax of the PARAM/ option is:

PARAM/{object or variable name}={PC-DMIS expression}

If you have a Global Variable in a report named NumBoltHoles. The


following PARAM/ option would map the PC-DMIS expression to NumBoltHoles:
PARAM/NumBoltHoles=360.0/angle

Changes to the variable in the editor can also change the PC-DMIS variable.

Using the following PARAM/ option, the variable NumBoltHoles is set


equal to the variable numBolts. Any changes within the HyperView report to the
HyperView variable NumBoltHoles are reflected in the PC-DMIS variable
numBolts:
PARAM/NumBoltHoles=numBolts

54
Embedding Reports or Report Templates in a Measurement Routine

After execution, any objects you changed by passing parameters into a


Report template or a HyperView report revert to what they had been before
execution if you redraw or modify the report in any way. This means if you want to
retain the results of passing a parameter to your template or report, you need to
first print the report before you make modifications. You can do this using the
AUTOPRINT parameter or by printing directly from the Report window.

See "Using the PARAM command to Map PC-DMIS Expressions to Object


Properties" for additional information on using parameters.

You can press F9 on a REPORT/CUSTOM command to open the custom report in


the Custom Report Editor.

REPORT/TEMPLATE Report Generation

PC-DMIS generates the default report as usual until it reaches this command. When it
executes this command, PC-DMIS utilizes the specified template and generates a
separate report for all the measurement routine commands in a new section within the
current report. After PC-DMIS generates this new report section, it switches back to the
previous report and continues to generate commands in the original report from that
point forward.

Using the PARAM command to Map PC-DMIS


Expressions to Object Properties
PC-DMIS expressions can be mapped to property objects using the PARAM/ command
in the Edit window. The syntax for mapping a PC-DMIS expression to an object property
is:

PARAM/{object code}.{property name}={PC-DMIS expression}

The following PARAM/ option changes the BorderStyle property of the object,
Text1: PARAM/Text1.BorderStyle=1

55
Inserting Report Commands

Inserting External Objects


To add external objects to your report, select the Insert | Report Command | External
Object menu item. For more information, see the "Adding External Elements" chapter.

Inserting a Print Command


When PC-DMIS executes a PRINT/REPORT command, it sends the measurement
results up to that point in the measurement routine to the defined output destination
(printer or file). After PC-DMIS executes the command, it clears the contents of the
Report window, and only the remaining measurement results appear in the Report
window. However, you can always click the View Report Mode icon on the
Reporting toolbar to view the full report.

To insert a PRINT/REPORT command into the Edit window, do the following:

1. If the Edit window isn't already visible, choose View | Edit Window to open the
Edit window.
2. Choose View | Command Mode to place the Edit window into Command mode.
3. Select the Insert | Report Command | Print Command menu option (or type
PRINT at the desired location and press Tab). PC-DMIS inserts a
PRINT/REPORT command with various options you can configure.
4. To configure the command, press F9 on the command and use the Output
Configuration dialog box. For more information, see "Editing the
PRINT/REPORT Command".

The PRINT/REPORT command controls the printing of reports from within the
measurement routine. When PC-DMIS executes this command, a report is generated
and sent to the specified output destination.

To control how PC-DMIS handles a report header after a PRINT/REPORT command,


see "Header after Print Command" area in the "Edit Text Reporting" topic of the
"Reporting Measurement Results" chapter.

Related Topics:

Using the Print Command in a Loop

56
Inserting a Print Command

Understanding the Syntax for the PRINT/REPORT


Command
The syntax of the command is as follows:

PRINT/REPORT,EXEC MODE=END,$
TO_FILE=OFF,TOG1,AUTO OPEN=OFF,$
TO_PRINTER=OFF,COPIES=,$
TO_DMIS_REPORT=OFF,FILE_OPTION=TOG2,FILENAME=,$
REPORT_THEORETICALS=ALL,REPORT_FEATURE_WITH_DIMENSIONS=Y
ES,$
TO_EXCEL=OFF,TOG3, AUTO OPEN=OFF,$
PREVIOUS_RUNS=DELETE_INSTANCES

EXEC MODE = Because DMIS and PC-DMIS manage report data differently, this
option controls how and when the software sends report data to DMIS and PC-
DMIS output files. DMIS requires that the output filenames and other printing
parameters be defined first before the routine is executed. PC-DMIS, on the other
hand, waits until after the measurement routine is executed before deciding where
to dump the report data. With this option, you can support both formats. It takes
one of two values, either START or END.

START
This tells PC-DMIS to begin printing when it either encounters the end of
routine or another PRINT/REPORT command. If you import a DMIS file, and
it has a print report command, it uses START as its initial value.
END
This tells PC-DMIS to print everything already executed up to this
PRINT/REPORT command. If you don't import a DMIS file with a print report
command, but instead insert your own PRINT/REPORT command from
within PC-DMIS, it has END as its initial value.

57
Inserting Report Commands

If your measurement routine contains more than one PRINT/REPORT


command, be aware that PC-DMIS may not print some commands. For example,
if your first PRINT/REPORT command uses END and your second print report
command uses START, then PC-DMIS does not print everything in between.

Also if a PRINT/REPORT command uses START and then your very next print
report command uses END, the second printing is empty, because the first print
report command has cleared the report buffer.

TO_FILE= Use this option to indicate whether the printed report should be sent to
a file (ON) or not (OFF).

TOG1 This value controls the action taken when sending the print output to an .rtf,
.pdf, or .txt file. The options available are APPEND / OVERWRITE / AUTO /
PROMPT. Depending on the option selected, different information may appear.

APPEND
Use this option to append report information to the specified filename. When
the APPEND option is selected, this keyword is followed by a filename field,
for example, APPEND=D:\REPORTS\FILE001.RTF. Note that the complete
path must be specified; otherwise, PC-DMIS assumes the same directory as
the measurement routine. Also, if the file does not exist, it is created when
the PRINT/REPORT command is executed.
OVERWRITE
Use this option to overwrite report information to the specified filename.
When the OVERWRITE option is selected, this keyword is followed by a
filename field, for example, OVERWRITE=D:\REPORTS\FILE001.RTF. If
the file does not exist, it is created when the PRINT/REPORT command is
executed. If you don't provide a pathway, it defaults to the measurement
routine's folder. If there is no path in this field, you can set this to a variable
name (see the example below).
AUTO
Use this option to have PC-DMIS generate the report filename automatically.
When the AUTO option is selected, this keyword is followed by a numeric
field, for example, AUTO=10. The name of the generated filename has same
name as the measurement routine, appended by the numerical index and an
.rtf extension. Also, the generated file is sent to the same directory as the
measurement routine. If a file exists with the same name as the generated
filename, AUTO increments the index until a unique filename is found.
PROMPT
Use this option to cause a Save As dialog box to appear that asks the
operator for the filename to which the report information is be written.

58
Inserting a Print Command

AUTO OPEN= Use this option to determine whether PC-DMIS opens the
generated .rtf, .pdf, or .txt file after the PRINT/REPORT command executes. This
can be ON or OFF.

TO_PRINTER= Use this option to indicate whether to send the report to the printer
(ON) or not (OFF).

COPIES= This value determines the number of report copies to send to the
printer.

TO_DMIS_REPORT= Use this option to determine whether or not PC-DMIS


sends the report to a DMIS Output file (.dmo) specified in FILENAME. This can be
ON or OFF.

FILENAME= Use this option to specify a DMIS output directory location and
filename. If TO_DMIS_REPORT is set to ON then PC-DMIS stores the report data
in the file specified. For example, if
FILENAME=D:\PCDMISREPORTS\MYDMIS.DMO, PC-DMIS causes the report
data to be saved in the MYDMIS.dmo file in a PCDMISREPORTS folder on drive
D. If you don't provide a pathway, it defaults to the measurement routine's folder. If
there is no path, you can set this to a variable name.

FILE_OPTION=TOG2 You can set TOG3 to the following file options for your
DMIS file output:

APPEND
This appends the report data to the end of the DMIS file specified in
FILENAME.

OVERWRITE
This overwrites the DMIS file specified in FILENAME with the latest report
data.

INDEX
This appends to the DMIS filename specified in FILENAME a numerical
value that increments on subsequent measurement routine executions. For
example, if FILENAME=MYDMIS.DMO, on the next execution the filename
increments by one, becoming mydmis001.dmo, mydmis002.dmo,
mydmis003.dmo, and so on, similar to the AUTO= option.

REPORT_THEORETICALS= This tells how PC-DMIS reports theoretical values in


the DMIS output file.

ALL
PC-DMIS outputs all theoretical values along with the measured values to
the output DMIS file.

59
Inserting Report Commands

NONE
No theoretical values are included in the report.
IMPORT_SETTINGS
Only those theoretical values explicitly output by the original DMIS file are
output in the report.

REPORT_FEATURE_WITH_DIMENSIONS= This determines whether or not PC-


DMIS keeps the measured features and associated tolerances together in the
output file. It takes either YES or NO.

YES
In the DMIS report file, PC-DMIS writes the measurement results
immediately before their associated tolerance results for each dimension
associated to the feature itself. If a feature is not associated with any
tolerance, PC-DMIS does not generate any output.
NO
In the DMIS report file, PC-DMIS writes the measurement results exactly
when the feature is measured, but not later when PC-DMIS executes the
associated dimensions.

TO_EXCEL= This determines whether or not PC-DMIS sends the output to a


Microsoft Excel file. It takes either ON or OFF.

ON
An Excel file is generated for all the items in the measurement routine to this
point.

OFF
No Excel file is generated by this print command.

To modify Excel output options, press F9 on this command and modify the
options in the Excel tab.

Additional Notes:

• If this is set to ON, but the measurement routine's Output


Configuration dialog box has the Excel output check box cleared,
PC-DMIS generates the Excel for this specific command only.
• If this is set to OFF, but the measurement routine's Output
Configuration dialog box has the Excel output check box marked,
an Excel file is generated at the very end of the execution.
• If this is set to ON, and the measurement routine's Output
Configuration dialog box has the Excel output check box also

60
Inserting a Print Command

marked, you may end up with two generated output files, one for
each. In this case, dimensions that follow a PRINT/REPORT
command are generated in a different file.
• Looping is supported with the Excel output. If you run the
PRINT/REPORT command through a loop and the Excel output is
set to append, it generates the content as additional worksheets
inside the Excel file.
• To change the number of decimal places for the Excel output file
output, you can insert a DISPLAYPRECISION command just before
the PRINT/REPORT command.

TOG3= This value controls the action taken when sending the print output to an
Excel file (.xls, .xlsx, csv). For information on the toggle options, refer to the similar
TOG1 item above.

FILENAME= Use this option to specify the output directory location and filename
for the Excel file. If TO_EXCEL_OUTPUT is set to ON, then PC-DMIS stores the
report data in the file specified. For example, if
FILENAME=D:\PCDMISREPORTS\MYEXCEL.XLS, PC-DMIS causes the report
data to be saved in the MYEXCEL.xls file in a PCDMISREPORTS folder on drive
D. If you don't provide a pathway, it defaults to the measurement routine's folder. If
there is no path in this field, you can set this to a variable name (see the example
below).

AUTO OPEN= Use this option to determine whether PC-DMIS opens the
generated Excel file (.xls, .xlsx, .csv) after the PRINT/REPORT command
executes. This can be ON or OFF.

PREVIOUS_RUNS= Use this with a PRINT/REPORT command from within a loop.


When a feature is measured more than once in a single execution, previous
instances of that feature's measured data are saved. You can choose to delete
(DELETE_INSTANCES) or keep (KEEP_INSTANCES) these instances.

Variable for FILENAME

In this example, a variable of V1 takes the value of the Input comment stored
in C1.INPUT. Then the FILENAME statement for the Excel output uses the value of
variable V1 for the Excel file's folder and filename:

C1=COMMENT/INPUT,YES,FULL SCREEN=NO,
Type your Excel report pathway and file name:

61
Inserting Report Commands

ASSIGN/V1=C1.INPUT
PRINT/REPORT,EXEC MODE=END,$
TO_FILE=OFF,AUTO=1,AUTO OPEN=OFF,$
TO_PRINTER=OFF,COPIES=1,$
TO_DMIS_REPORT=OFF,FILE_OPTION=INDEX,FILENAME=,$
REPORT_THEORETICALS=NONE,REPORT_FEATURE_WITH_DIMENSIONS=NO,$
TO_EXCEL=ON,OVERWRITE,FILENAME=V1,AUTO OPEN=ON,$
PREVIOUS_RUNS=DELETE_INSTANCES

For example, if the operator typed D:\Temp\MyReport.xls in the Input comment, PC-
DMIS would save the excel data to that directory and report name.

Editing the PRINT/REPORT Command


You can edit the PRINT/REPORT command's options in its Output Configuration
dialog box.

1. Place the cursor over the PRINT/REPORT command line.


2. Press F9.
3. Make any changes.
4. Click OK.

PC-DMIS updates the command to match your change. You may not always see a
visual indication in the command text itself of the change.

Understanding the Different Output Configuration Dialog Boxes

Note that PC-DMIS uses the Output Configuration dialog box in these locations:

From File | Printing | Report Window Print Setup

The main Output Configuration dialog box from that menu does not insert or modify
the PRINT/REPORT command. Instead, it controls the overall printing defaults for the
report. Unlike the PRINT/REPORT command, the main dialog box only affects printing
when the measurement routine has completed execution. For information on the options
in this dialog box, see "Printing the Report Window" in the "Using Basic File Options"
chapter.

62
Inserting a Form Feed Command

For Each PRINT/REPORT Command

When you press F9 on one of these commands, its specific Output Configuration
dialog box opens.

• You can use the PRINT/REPORT command more than once in the measurement
routine.
• Each PRINT/REPORT commands can have different outputs.
• Each PRINT/REPORT command is a unique instance of the information
contained in the main Output Configuration dialog box. Therefore, options that
are selected from the main dialog box are independent of any PRINT/REPORT
command.

Inserting a Form Feed Command


PC-DMIS lets you insert a FORMFEED command into the Edit window. This command
causes the printed page of a report to be ejected from the printer when the FORMFEED
command has been marked and executed. The FORMFEED command has no effect
when printing to a file.

To insert a FORMFEED command in to the Edit window:

1. Open the Edit window (View | Edit Window).


2. Click the Command Mode icon from the Edit window toolbar, placing PC-DMIS
into Command Mode.
3. Select the Insert | Report Command | Form Feed menu option (or type
FORMFEED at the desired location and press Tab). PC-DMIS displays the
FORMFEED command.

Working with Viewsets


You can create and save different Graphic Display window views (termed "viewsets")
that you can later recall by using a command that gets inserted into your measurement
routine. Viewsets store the CAD model's orientation, ID label visibility and position, and
shading. The Create Viewset menu option allows you to create an unlimited number of
viewsets in your measurement routine. You can recall multiple viewsets as often as
desired.

63
Inserting Report Commands

To Create a Viewset:

1. Set up the view as desired. Select Edit | Graphic Display Window | View Setup
and use the View Setup dialog box to modify the zoom and rotation of the part in
the Graphic Display window. For information on how to do this, see "Setting Up
the Screen View" in "Editing the CAD Display".
2. Select Insert | Report Command | Create Viewset, or from the Graphic Modes

toolbar, choose Create Views ( ). A small Viewset dialog box opens with
the prompt "Type view name to save." This dialog box contains a default name
starting with VIEWSET1 and then it increments the number for subsequent
viewsets (VIEWSET2, VIEWSET3, and so on):

Viewset dialog box with a default name

3. In the box, type in the desired name (19-character limit) for the view.
4. Click the OK button or press Enter. PC-DMIS sets the current viewset equal to
the name you chose by inserting a <NAME>=VIEWSET command, where
<NAME> is the defined viewset name.

To Recall a Viewset:

To recall the created viewset, do one of the following:

• From the Settings toolbar, select the Views list.

• From the PC-DMIS portable QuickMeasure toolbar, select Recall Views ( ).


• From the menu bar, choose Insert | Report Command | Recall Viewset.

Select the viewset you want to recall. This option inserts a RECALL/VIEWSET,<NAME>
command into the Edit window.

When your cursor is on or under the RECALL/VIEWSET,<NAME> command in the Edit


window, PC-DMIS displays the created viewset in the Graphic Display window. If you
mark and execute this command, PC-DMIS displays the saved view in the Graphic
Display window during measurement routine execution as well.

64
Inserting a FORM Command

Additionally, recalled viewsets appear in your final report if the Report Window uses a
template or custom report that displays a CADReportObject. Viewsets in reports appear
on a new page for each RECALL/VIEWSET command.

To Update a Viewset:

You can also quickly modify an existing viewset. From the Edit window, select the
RECALL/VIEWSET,<NAME>, modify the Graphic Display window as desired for that
view, and then select the Insert | Report Command | Save Viewset menu option. Or

from the Graphic Modes toolbar, select the Save Viewset icon ( ).

If you just want to change and then save the current viewset without creating a
new viewset, select the Save Viewset menu option instead.

Inserting a FORM Command


The Insert | Report Command | Form menu item lets you insert a predefined .FORM
file into your measurement routine. When you select this menu item, an Insert Form
dialog box appears.

Insert Form dialog box

Navigate to the .FORM file, select it, and click Open. PC-DMIS will insert a
FORM/FILENAME command similar to the following into the Edit window:

65
Inserting Report Commands

CS1=FORM/FILENAME=C:\PCDMIS40RELEASE\REPORTING\TESTFORM.FORM

PARAM/=

ENDFORM/

FILENAME = This defines the location of the .FORM file to load.

PARAM/ - This lets you send information to the form. For example using a PARAM
statement of PARAM/Text1.Text=C1.INPUT will send the value of the comment
C1.INPUT and send it to the control.

Alternately, you can type FORM and press TAB to insert the FORM/FILENAME
command into the measurement routine, and then manually type the path to load the
desired form.

When PC-DMIS executes this command, it will launch the defined form, and then pass
any defined parameters to the controls in the form.

Communicating between the FORM and the Measurement Routine

You can pass values to and from a form by using a combination of ASSIGN and
PARAM statements. This lets you establish useful two-way communications between
the form and the measurement routine.

ASSIGN Statements - You can initialize values for a form's controls through ASSIGN
statements. These statements also create variables that can later receive updated
values from the form when the form closes.

For example, suppose you have a form that has four unnamed check boxes, like this:

66
Inserting a FORM Command

However, you want the measurement routine to give them names and values
dynamically. In the Edit window, you can use the ASSIGN statements to name and
initialize the check boxes as follows:

ASSIGN/CHECK1VALUE=0
ASSIGN/CHECK1TEXT="Point"
ASSIGN/CHECK2VALUE=1
ASSIGN/CHECK2TEXT="Line"
ASSIGN/CHECK3VALUE=0
ASSIGN/CHECK3TEXT="Circle"
ASSIGN/CHECK4VALUE=1
ASSIGN/CHECK4TEXT="Sphere"

PARAM Statements - Now that you have several variables, you can use the PARAM
statements to establish the connection between the variables and the form itself, like
this:

CS1=FORM/FILENAME=
C:\PCDMIS40RELEASE\REPORTING\TESTFORM.FORM
PARAM/CHECKBUTTON1.VALUE=CHECK1VALUE
PARAM/CHECKBUTTON1.TEXT=CHECK1TEXT
PARAM/CHECKBUTTON2.VALUE=CHECK2VALUE

67
Inserting Report Commands

PARAM/CHECKBUTTON2.TEXT=CHECK2TEXT
PARAM/CHECKBUTTON3.VALUE=CHECK3VALUE
PARAM/CHECKBUTTON3.TEXT=CHECK3TEXT
PARAM/CHECKBUTTON4.VALUE=CHECK4VALUE
PARAM/CHECKBUTTON4.TEXT=CHECK4TEXT
PARAM/=
ENDFORM/

When the form loads, CHECKBUTTON1 is unchecked, and its text label displays
"Point"; CHECKBUTTON2 is checked, and its text label is "Line"; CHECKBUTTON3 is
unchecked, and its text label is "Circle"; and CHECKBUTTON4 is checked, and its text
label is "Sphere", like this:

With the form loaded, you can select or clear the check boxes to something different.
When you close the form, the variables that initially set the state of the checked state
(CHECK1VALUE, CHECK2VALUE, CHECK3VALUE, and CHECK4VALUE ) now hold
the current values of the check boxes.

68
Inserting Screen Captures

Inserting Screen Captures

This topic details the old way to add screen captures. It remains for backwards
compatibility. Try out the new Snapshot menu option instead; it has more functionality.
For information, see "Inserting Snapshots" in this chapter.

You can use the Insert | Report Command | Screen Capture menu item to display
screen captures of the part in your report. This menu option places a
DISPLAY/METAFILE command in the Edit window. When this command is marked and
executed, PC-DMIS automatically refreshes the screen capture and displays it in the
report.

Command line in the Edit window:


DISPLAY/METAFILE,"___",TOG1,TOG2

___ = This field will allow you to enter a description of the captured screen. The
maximum text is 255 characters.

TOG1 = This field determines the size of the screen capture. You can toggle
between the following: 25%, 50%, 75%, 100%, TO FIT.

TOG2 = This field determines the quality of the screen capture. You can toggle
between the following: HIGH, GOOD, LOW

For this to appear in the Report window, right-click on some text within the
Report window, select Edit, and when the Report dialog box appears, select the Show
Screen Capture check box.

This command is similar to the ANALYSISVIEW command and the


DISPLAY/METAFILE command that are created in the Analysis Window. For more
information on the Analysis Window, see "Analysis area" in this chapter.

69
Inserting Report Commands

A True Type Font for text in the Graphic Display window gives the best
results when capturing the image.

Inserting Snapshots
You can use the Insert | Report Command | Snapshot menu item to display screen
captures of the part in your report.

When you select the menu item, a Snapshot dialog box opens so you can type the
snapshot name:

Snapshot dialog box

The Insert Snapshot button ( ) on the Graphic Modes toolbar also opens
this dialog box.

Once you define a name, PC-DMIS then inserts a SNAPSHOT command with that name
in the Edit window. When this command is marked and executed, PC-DMIS
automatically refreshes the screen capture and displays it in the report.

In the Edit window in Command mode, you can also manually type SNAPSHOT and
press Tab. When you press Tab, PC-DMIS stores the properties for the state of the
Graphic Display window in the command. During execution, PC-DMIS inserts the
capture into the report the moment the software executes the command.

Command line in the Edit window:


TOG1 =SNAPSHOT/

TOG1 = This field holds the name of the snapshot.

70
Inserting Snapshots

Differences from the DISPLAY/METAFILE Command

The SNAPSHOT command provides better screen captures than the


DISPLAY/METAFILE command. While the snapshot functionality is similar to
DISPLAY/METAFILE, it has these differences:

• A SNAPSHOT command updates the various analysis-related items you see on


the Graphic Display window in the screen capture. These analysis items include
graphical analysis, pointcloud color maps, dimension info labels, scan arrows
with deviation colors, and so on. DISPLAY/METAFILE results in a much more
static image.
• A SNAPSHOT command saves your screen orientation and zoom level.
• A SNAPSHOT command works with multiple views.

Default Snapshot Names

If you don't type a snapshot name, the default names follow this pattern SNAPSHOT1,
SNAPSHOT2, SNAPSHOT3... and so on.

If you first select a CAD model view from the list on the CAD Setup toolbar and then
access the Snapshot dialog box, the default pattern follows the name of the current
model view.

Suppose you have a CAD model view with the name of Right to show the
right side of your part. If you select Right from the list and then access the Snapshot
dialog box, the snapshot name shows to "Right1". If you do it again, the next snapshot
name shows "Right2", and so on.

Inserting a Snapshot Command

1. In the Graphic Display window, pan, zoom, and rotate your part to the way you
want it.

2. From the Graphic Modes toolbar, click Insert Snapshot ( ) to show a


Snapshot dialog box.
3. In the Snapshot dialog box, type a name for the screen capture.
4. Click OK to insert the SNAPSHOT command at the selected spot in the Edit
window.

71
Inserting Report Commands

5. If PC-DMIS cannot insert at the current position, it shows a message box that
asks how you want to handle the insertion. You can choose one of these three
items on the message box:
• Next Position - This inserts the command at the next valid position.
• End of Program - This inserts the command at the end of the
measurement routine.
• Don't Insert - This does not insert the command.

Viewing the Snapshot in the Graphic Display Window

1. Select the SNAPSHOT command in the Edit window.


2. Press Ctrl + E to execute only that command. This shows the snapshot in the
Graphic Display widow.

Updating a Snapshot Command from the Graphic Display Window

1. From the Edit window, select the SNAPSHOT command you want to update.
2. Press F9 to open its Snapshot dialog box. The Graphic Display window loads
the view stored in the snapshot.
3. In the Graphic Display window, pan, zoom, and rotate your part to the way you
want it for the updated snapshot.
4. If you like, modify the name.
5. Click OK to update that snapshot with the new Graphic Display window
properties.

Updating a Snapshot Command from Your Report

1. Execute the routine and then select View | Report Window to access the report
in the Report window.
2. From the Report window, double-click on the snapshot image to convert it into a
CADReportObject (CRO).
3. Pan, zoom, and rotate on the part model in the CRO to modify it. For information
on working with the CRO, see "CadReportObject" in the "Reporting
Measurement Results" chapter.
4. Double-click outside of the CRO to accept your CRO changes to the report. PC-
DMIS applies these same CRO changes to your SNAPSHOT command in the Edit
window. Subsequent executions of that command use the updated SNAPSHOT
command.

72
Inserting Snapshots

Adding Snapshots into Custom Reports

1. In the Report window, edit a custom report, or create a new custom Report. (For
information on custom reports, see "Creating Custom Reports" in the "Reporting
Measurement Results" chapter.)
2. From the Edit window in Summary mode, select the snapshot command you
want in your report.
3. Drag and drop it into the custom report to see the screen capture.

Deleting Referenced Commands

Any command in the Edit window that creates a visible element in the Graphic Display
window (such as a Dimension Info box) is considered a referenced command by the
snapshot command. This means that the snapshot command needs that referenced
command to create its screen capture. Snapshot commands cannot reference
commands that don't exist. Therefore, if you delete any of these referenced commands,
PC-DMIS asks if you want to also delete the associated snapshot commands.

73

You might also like