Hexagon PC Dmis 03 - Using Basic File Options
Hexagon PC Dmis 03 - Using Basic File Options
Save As .................................................................................................................... 5
Mirror........................................................................................................................ 8
Copy....................................................................................................................... 12
Delete..................................................................................................................... 12
Rename ................................................................................................................. 13
Setting Output and Printer Options for the Graphic Display Window ..................... 16
Setting Output and Printer Options for the Report Window .................................... 19
i
Table of Contents
ii
Using Basic File Options
Using Basic File Options: Introduction
PC-DMIS provides you with many options to manipulate measurement routines and
manage your essential files. As with most Windows-based programs, you can perform
basic file management using standard Windows dialog boxes; these include creating,
opening, copying, renaming, and deleting files. Additionally, through PC-DMIS you can
perform more advanced operations, such as importing and exporting CAD data, or
executing completed measurement routines.
This chapter specifically deals with Basic File Options. For more advanced options, see
the "Using Advanced File Options" chapter.
The options discussed in this chapter include:
• Creating New Measurement Routines
• Opening Existing Measurement Routines
• Saving Measurement Routines
• Working with Measurement Routine Archives
• Performing File Operations
• Connecting to Teamcenter
• Changing the Language
• Printing the Graphic Display Window
• Printing the Report Window
• Closing or Quitting a Measurement Routine
• Exiting PC-DMIS
1
Using Basic File Options
Here you can create a new measurement routine. You are prompted to enter a part
name, serial number, revision number, interface type, and units of measurement type.
The CMM interface type is also chosen here. Once you click OK, the measurement
routine is created, but it is only in memory until you choose File | Save to save the
measurement routine.
PC-DMIS only requires the Part Name box to have a value in order to create a
new measurement routine. Information entered in the Revision Number and Serial
Number boxes is optional.
This dialog box is a standard Windows Open dialog box with the following additions:
2
Using Basic File Options
A. Preview - This area of the dialog box shows the CAD image for the last view of
your part in the Graphic Display window (without labels). If your part doesn't have
the CAD data, the image displays measured geometry. This area also displays
the name, date, and time of the measurement routine. The date and time
indicates the last modification of the measurement routine.
B. Include CAD - This check box determines whether to load the CAD model when
you open the measurement routine. If a CAD model is part of the measurement
routine you're opening, click the Include CAD check box. If you clear the check
box, PC-DMIS does not load the CAD model when you open the measurement
routine.
C. Interface - This list displays the online machines in your system as well as an
Offline option.
• If PC-DMIS is running in Online mode, you can select the machine
interface to use for this measurement routine (if you have multiple CMMs).
3
Using Basic File Options
• If PC-DMIS is running in Offline mode, you can select the Offline machine
option.
The Open dialog box automatically opens each time you start PC-DMIS so that
you can open an existing measurement routine. However, if you want to turn off this
feature, you can clear the Show Startup Dialog check box on the General tab of the
Setup Options dialog box.
Subroutine Names
If you open a measurement routine from a previous version that contains a subroutine
with a name greater than 180 characters, the name of the subroutine is automatically
shortened to the first 180 characters.
4
Using Basic File Options
Save As
When you select the File | Save As option or save a measurement routine for the first
time, the Save As dialog box appears. You can use the File name option in this dialog
box to save the current measurement routine under a new file name. You can also save
the measurement routine under an older version of PC-DMIS.
To save the measurement routine, click Save. To close the dialog box without saving
the measurement routine, click Cancel.
5
Using Basic File Options
You must click OK to acknowledge that you have noted this message.
If the SaveAsWarningLogEnabled registry entry is enabled, PC-DMIS automatically
creates a log file that contains the contents of the message. The log file is named:
<name>_Save_As_Log_<YYYYMMDDHHMMSS>.log
Where <name> is the name of the measurement routine, and
<YYYYMMDDHHMMSS> is the date and time.
YYYY is the year.
MM is the month.
DD is the day.
HH is the hour.
MM are the minutes.
SS are the seconds.
The log file is located in the same folder as the measurement routine.
You can disable the creation of the log file. For help, see the
"SaveAsWarningLogEnabled" topic in the Settings Editor documentation.
6
Using Basic File Options
7
Using Basic File Options
The above backup PRG~ and PRG^ files have the hidden attribute set
and won't be visible in Windows Explorer unless the "Show hidden files" option is
set.
If you try and open a corrupted measurement routine, PC-DMIS asks if you want to
open the copy it made before the last save (<name>.prg~). If you choose Yes, PC-
DMIS renames the corrupt measurement routine to <name>.prg.tmp (by default, these
files have the hidden attribute set to be hidden and won't be visible in Windows Explorer
unless the "Show hidden files" option is set correctly), and it renames <name>.prg~ to
the current measurement routine name. If, for some reason, that backup was also
corrupted, PC-DMIS asks if you want to restore from the backup that was made just
before you loaded the measurement routine during your last session (<name>.prg^). It
then follows the same process of renaming and copying.
As with any backup/restore process, you may lose your latest changes when
restoring.
You can disable/enable this functionality by using the DocumentRecovery entry in the
PC-DMIS Settings Editor.
Mirror
The Mirror command (File | Operations | Mirror) allows you to create a mirror image
copy in the X, Y, or Z axis of a measurement routine. When you select this command,
the Choose Part to Mirror dialog box appears.
The following describes the items available for selection on the dialog box:
• Measurement Routines - Displays all the available measurement routines in the
current directory.
• File name - Defines the measurement routine to mirror.
8
Using Basic File Options
• Files of type - Filters the display of the current directory to only show
Measurement Routine files (.PRG).
• Don't mirror CAD - This check box determines whether the resulting CAD is
mirrored. If you select this check box, the resulting CAD is not mirrored. The
check box is initially cleared when you first launch PC-DMIS. Afterwards, this
check box retains the state of what was applied in the last mirroring.
You can use the Settings Editor to change the DoNotMirrorCAD registry entry's
value in the Option section.
• Part Mirror Axis - Defines the axis in which you want to mirror the measurement
routine:
o Mirror in X - Mirrors the part in the X axis
o Mirror in Y - Mirrors the part in the Y axis
o Mirror in Z - Mirrors the part in the Z axis
• Reporting Mirror Option - Defines how PC-DMIS should mirror CAD images in
reports:
o Don't Mirror - Does not mirror at all.
o Horizontal - Mirrors CAD images horizontally.
o Vertical - Mirrors CAD images vertically.
9
Using Basic File Options
PC-DMIS mirrors the part at the same location as the original part. Using
the Machine Mirror Axis area you can define the orientation of the mirrored part
on the virtual machine. You only need to shift the part on the machine to the place
it should get measured.
For a description of how these options position your part, consider this diagram:
- Original part
If you define a reference part using this area then PC-DMIS does not use the
Machine Mirror Axis area. Instead, the location and orientation of the mirrored
part is loaded from the existing (and already mirrored) reference measurement
routine.
This option is especially useful if you have multiple measurement routines that
belong to the same physical part and need to get mirrored. In this case you would
10
Using Basic File Options
only need to define the location and orientation of the mirrored part in the first
mirrored measurement routine. You could then easily mirror other measurement
routines by selecting the first mirrored measurement routine as the reference part.
11
Using Basic File Options
PC-DMIS also attempts to mirror your probe's AB tip angles. If your probe does
not have the exact mirrored tip angles already defined and calibrated, PC-DMIS may
choose the closest calibrated tip angles. It chooses closely calibrated tip angles if the
calibrated tip angles exist, and are within the wrist angle amount specified in the Wrist
Warning Delta box on the Part/Machine tab of the SetUp Options dialog box. If no
closely calibrated AB tip angles exist then PC-DMIS creates perfectly mirrored yet non-
calibrated AB tip angles. See the "Setup Options: Part / Machine tab" topic in the
"Setting Your Preferences" chapter.
Copy
The Copy command allows you to copy all of the files that are associated with a
measurement routine.
To copy a measurement routine:
1. Select the File | Operations | Copy menu item. The Copy part files from dialog
box appears.
2. Navigate through the directory structure and select a measurement routine.
3. Click the Copy button to display the Copy part files to dialog box.
4. Click on the measurement routine that you want to copy so that its file name and
extension appear in the File name box.
5. Navigate to the folder to which you want to copy the measurement routine.
6. Click the Save button.
These files are copied:
• .prg
• .cad
• Any file with the same base name and an extension in the range .001, .002, …,
.999
• <name of measurement routine>.MiniRoutines.xml, if it exists
Delete
The Delete command allows you to delete all of the files that are associated with a
measurement routine.
To delete a measurement routine:
12
Using Basic File Options
1. Select the File | Operations | Delete menu item. The Delete part files dialog
box appears.
2. Choose the measurement routine to delete.
3. Click the Delete button. PC-DMIS asks if you are sure that you want to send the
files to the Recycle Bin.
4. Click the Yes button.
These files are deleted:
• .prg
• .cad
• Any file with the same base name and an extension in the range .001, .002, …,
.999.
• <name of measurement routine>.MiniRoutines.xml, if it exists
Deleted files are sent to the Recycle Bin.
Rename
The Rename command allows you to rename all of the files that are associated with a
measurement routine.
To rename a measurement routine:
1. Select the File | Operations | Rename menu item. The Rename part files from
dialog box appears.
2. Select the measurement routine to rename.
3. Click the Rename button. The Rename part files to dialog box appears.
4. Type in the new name for the file in the File name box.
5. Click the Save button. The name change is applied immediately.
These files are renamed:
• .prg
• .cad
• Any file with the same base name and an extension in the range .001, .002, …,
.999
• <name of measurement routine>.MiniRoutines.xml, if it exists
13
Using Basic File Options
PC-DMIS automatically installs all the user interface resources for the supported
languages during the main installation process. However, to show non-English help file
content, you need to install that separately.
The language help files can be installed as needed by navigating to the language pack
folder and running the appropriate language executable file.
To install a language help file:
1. Navigate to the language folder (<Product_Installer_Folder>\lang) of the main
PC-DMIS installer download.
2. Run the desired language pack executable to install the language help files.
Connecting to Teamcenter
You can use File | Teamcenter to enable or disable a connection to the Teamcenter
software. Teamcenter is an MMS (Metrology Management System) database package
developed by Siemens.
For the File | Teamcenter menu to appear, you must have a Teamcenter
option added to your licence.
14
Using Basic File Options
cannot connect to Teamcenter, it instead defaults to Off and uses the regular Save As
and Open dialog boxes.
Off - Disables the connection with Teamcenter. This uses the software's regular Save
As and Open dialog box.
For information on working with Teamcenter, see "Using Teamcenter" in the "Direct
CAD Interfaces and Translators" documentation.
For information on this dialog box and the options available, consult the help file that
came with your Windows operating system. For any advanced printer-specific
properties, you may need to consult documentation specific to your printer.
15
Using Basic File Options
Use this dialog box to set up your printer and various display options. The options
available in the Printer options area enable you to select the type of graphical view to
print. These include:
Scale to fit on a single page - This option scales any graphical image to fit on a single
page.
Print visible screen area - This option prints only the currently visible screen area. If
you're zoomed in on a feature, it only prints what's on the screen and not the entire part.
Print complete views - This option prints each view you have defined using the Layout
area of the View Setup dialog box on its own page. For example, if you're showing the
Z+ view and the Y- view of a part in your Graphic Display window, PC-DMIS prints two
separate pages: one with the Z+ view and one with the Y- view.
Print complete views w/current scale - This option acts like the Print complete
views option, except that it prints at the current scale. If you have zoomed in on the
image, PC-DMIS still prints the entire view, but it splits the image among various pages.
To save any changes, click the OK button.
16
Using Basic File Options
The Print button opens up a standard Print Setup dialog box so you can send the print
job to the printer.
The Next Page and Prev Page buttons cycle through a print job that has multiple
pages.
The One Page or Two Pages toggle button determines how many pages are displayed
at one time in the Print Preview window.
The Zoom In and Zoom Out buttons allow you to take a quick closer look at a page in
the Print Preview window. It doesn't affect the display of what's sent to the printer.
17
Using Basic File Options
Print Preview window that shows the contents of the Edit window
18
Using Basic File Options
When you print the Edit window's contents, you should use a True Type font
(such as Courier New). Otherwise, characters or lines may not line up as expected. To
change the fonts used in the Edit window and in your reports, see "To Customize User
Interface Fonts" in the "Navigating the User Interface" chapter.
When printing a text-only report, you should use a True Type font (such as
Courier New). Otherwise, characters or lines may not line up as expected. If you need
to change the font used in a text-only report, modify the Font property on the
TextReportObject used in your report template.
19
Using Basic File Options
You can use this dialog box to tell PC-DMIS where to send the inspection report. The
dialog box contains the following tabs that you can use to send the report to a file or
printer, output it as a DMIS file or a Microsoft Excel file, or send to any combination of
these:
Report - Sends the report output to a file (.rtf, .pdf, or .txt) or printer. For
information about this tab, see "Output to an RTF, PDF, TXT or the Default
Printer". For information about using this tab to output to a file using expressions,
see "Output to a File Using Expressions".
DMIS - Sends the report output to a DMIS output file (.dmo). For information about
this tab, see "Output to a DMIS File".
Excel - Sends the report output to an Excel file (.xls, xlsx, or .csv). For information
about this tab, see "Output to an Excel File".
For information on viewing a saved inspection report, see the "Viewing an Inspection
Report" topic in the "Using Other Windows, Editors, and Tools" chapter.
20
Using Basic File Options
To define printing options for existing marked sets, select the set in the Marked Sets
window and then select File | Printing | Report Window Print Setup.
In the Output Configuration dialog box (File | Printing | Report Window Print
Setup), the Report tab defines whether to:
• Send the report's output to a printer
• Save the report as a separate file (.rtf, .pdf, or .txt)
• Do both of the above
The dialog box also provides options for the generated report.
21
Using Basic File Options
Report Output
Report output - If selected, PC-DMIS sends the output to a file. It can be saved in
either a Rich Text Format (.rtf) or Portable Document Format (.pdf) file. The file name is
initially generated and formatted to have the same name as the measurement routine
plus an appended numerical index before the extension. Although PC-DMIS generates
this initial file name, the name does not need to follow the default format and can be
changed.
You can also type a variable name in the Report output box. As long as there's not a
pathway already in the box, PC-DMIS interprets that variable's value for the filename.
Append - PC-DMIS adds the current data from the inspection report to the
selected file. 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 you generate the report.
RTF Limitations Using Append: Due to a limitation with how the RTF
driver works with the PC-DMIS template approach to reporting, when appending
to an RTF file, PC-DMIS only sends the contents of the TextReporting object,
regardless of any other objects that may exist in your current report template.
Additionally, if you choose to append to an RTF file, it must be to a file that you
have always used with the Append option. You cannot append to an RTF file that
you first used with Overwrite or Auto.
Overwrite - PC-DMIS overwrites the selected file with the current inspection
report data. Note that the complete path must be specified; otherwise, PC-DMIS
will assume the same directory as the measurement routine. Also, if the file does
not exist, it is created when you generate the report.
Prompt - PC-DMIS displays the Save As dialog box through which you can
choose the destination file for the report.
Auto - PC-DMIS generates the report file name automatically using the number in
the Index box. The name of the generated file name will have the same name as
the measurement routine appended by the numerical index and extension. Also,
the generated file will be located in the same directory as the measurement
routine. If a file exists with the same name as the generated file name, the Auto
option increments the index value until a unique file name is found.
22
Using Basic File Options
After the report prints, PC-DMIS internally updates the value in Index to
the next number. It also changes the file name in the Print Options dialog box so
that it shows the newly incremented file name.
Rich Text Format (RTF) - PC-DMIS generates the report using the Microsoft Rich Text
Format (.rtf file) for interchanging documents. Images in RTF reports have a light border
around them. By default, PC-DMIS generates RTF reports using an Amyuni RTF
converter. This essentially orders information inside several text boxes inside the RTF
file. This is needed for accurate positioning of report template elements inside the RTF
report. To properly view the report, you should use Microsoft Word and set the
document's view to Print Layout. If you find editing the report in this format difficult to
work with, you may want to generate an old-style RTF report.
This setting only works if the RTF output is done using the File |
Printing | Report Window Print Setup menu option. If you have inserted a
PRINT/REPORT command (Insert | Report Command | Print Command)
and you want that command to generate your RTF output, set the value to 2.
5. Restart PC-DMIS.
6. Ensure that the Report window is set to print the report in a text-only
format. To do this, right-click on the white-space at the end of the
Report window and select the Use Text Mode Dimension Reporting
check box. For more information, see "Changing the Report Window's
Contents" in the "Reporting Measurement Results" chapter.
23
Using Basic File Options
PcdmisRTFLeftMargin
PcdmisRTFRightMargin
PcdmisRTFTopMargin
PcdmisRTFBottomMargin
PcdmisRTFPaperHeight
PcdmisRTFPaperWidth
RTF files containing graphical elements, such as those based off of the
CADonly.rtp, TextOnly.rtp, and other similar templates, will take an extended
amount of time to create, the files may become quite large, and the graphics may
not look as good as with other file formats. For these reasons, the PDF format is
recommended over the RTF format for graphical reports.
24
Using Basic File Options
Portable Document Format (PDF) - PC-DMIS generates the report using the Adobe
Portable Document Format (.pdf file) or electronic file sharing. Dimensions in PDF
format do not have the default blue background color or display the dimension symbol.
If not already installed on your computer, you need to install the free
Adobe® Acrobat® Reader™ in order to view .pdf files. You can download it from
Adobe's Web site at: http://www.adobe.com/products/acrobat/readstep.html
Textual Document (TXT) - PC-DMIS generates the report in a plain text format. You
can view this type of report with any text editor. During report generation, PC-DMIS
uses the default.rtp template, regardless of the actual template selected in the Report
window. This textual report ignores any objects, such as images. For information on the
default.rtp template, see "Viewing a Legacy Text Report" in the "Reporting
Measurement Results" chapter. If you save your measurement routine to a version that
doesn't support the .txt output, PC-DMIS uses the PDF output instead.
Use Global Print Settings - This check box becomes available if you first select a
marked set from the Marked Sets window and then access this dialog box. The Use
Global Print Settings check box determines whether or not PC-DMIS uses global
output file parameters for the marked set. Selecting this check box overrides the very
specific default printing options used for marked sets, with the measurement routine's
global settings, that gives you greater control over the output. Select this check box to
give you more control over the print-to-file naming schemes used with marked sets.
You can use the Hyper Reports Inline check box with the REPORT/LEGACY
command. For more information, see "Embedding Reports or Report Templates in a
Measurement Routine" in the "Reporting Measurement Results" chapter.
Output Options
Printer - Determines whether to send the report to the default printer.
Print background colors - Determines whether the report prints background
colors.
By default, PC-DMIS marks this check box and prints the background colors. If you
clear this check box, PC-DMIS does not print any background colors. If you want to
clear or display the background color from a report already in the Report window, make
sure you click the Redraw the Report button from the Reporting toolbar.
25
Using Basic File Options
To change the default state of this check box, click the Edit menu, point to
Preferences, and then click Setup. Then on the General tab, in the list of check boxes,
mark or clear the Print Background Colors check box.
26
Using Basic File Options
In certain cases, you may continue to see some background colors in your
report even if you've turned off the display of background colors here. This is due to a
special background color setting that exists inside certain report template objects and is
not controlled by this check box. By default, the TextReportObject and the Report
object that exist in PC-DMIS report templates have a faint light-green background color
in their color scheme. For the TextReportObject, this exists to help show the limits of
the object inside the template. If this background color poses a problem, access the
Color property for these objects inside the report template, and change these objects'
background colors to white. For more information on how to do this, see "Changing the
Report's Text Colors" in the "Reporting Measurement Results" chapter.
Print Black and White - Determines whether text, lines, and the tolerance zone
graphs print in black and white or use the defined colors.
This does not make every report a completely black and white report. Some
elements are not affected by this check box (for example, the Graphic Display window,
images, and elements in some OCXs are not affected).
27
Using Basic File Options
Show Report - Determines whether to open the report that was sent to a .pdf or
an .rtf file. If you select this option, the report opens in whatever application you
have associated with the .rtf or .pdf file types after you generate the report.
Copies - Determines how many copies to send to your printer. This option is only
enabled if you mark the Printer option.
28
Using Basic File Options
In the Output Configuration dialog box (File | Printing | Report Window Print
Setup), on the DMIS tab, if you mark DMIS output check box and execute the
measurement routine, PC-DMIS saves the inspection report's information as a DMIS
output file with the same base file name as your measurement routine, with a .dmo file
extension. PC-DMIS saves the file in the same directory where your measurement
routine resides.
The Overwrite output file, Output theoretical values, and Output features with
dimensions check boxes and Save As button become available. By default, PC-DMIS
automatically generates the output file whenever you execute the measurement routine.
It increments the number on the file name each time.
29
Using Basic File Options
Save As
This button opens a Save As dialog box. This saves the inspection report to a file and
directory of your choice in the DMIS output format (.dmo). PC-DMIS does not save the
30
Using Basic File Options
file once you click Save from the Save As dialog box. Instead, it creates the output file
with the specified name the next time you execute the measurement routine.
The numeric portion of the file name should not exceed more than 10 digits.
Otherwise, you run the risk of overwriting older output files.
Output to a Microsoft Excel file follows the mode of the Report window.
• If you select the View Report Mode on the Report window's toolbar, the report
output is generated from beginning to end.
• If you select the View Last Execute Report Mode on the Report window's
toolbar, the report output is generated by following the execution list.
For more details, see "Reporting Toolbar".
31
Using Basic File Options
32
Using Basic File Options
33
Using Basic File Options
Once - Field labels appear only once after the heading information and
before all the dimensions are listed.
Always - Field labels appear before each dimension.
Detailed - If you mark Always, this check box becomes available.
Select this check box if you want all field labels to appear in the report.
The labels that appear if this check box is selected are:
DIMENSION, DESCRIPTION, FEATURE, AXIS, SEGMENT,
NOMINALS, MEAS, +TOL, -TOL, BONUS, DEV, OUTTOL,
DEVANG, Datum Shift Effect, Unused Zone, Shift X, Shift Y, Shift
Z, Rotation X, Rotation Y, and Rotation Z.
If the check box is not selected, only these labels appear:
DIMENSION, DESCRIPTION, AXIS, NOMINALS, MEAS, +TOL,
-TOL, DEV, and OUTTOL.
Delete Empty - Deletes any empty field from the report.
Data Storage By - Determines how the report is presented: either by row or by column.
Row - Dimensions are laid out horizontally.
Column - Dimensions are laid out vertically.
Data Filter - Determines how the data filters in the output report.
Report FCF dimensions - PC-DMIS passes the Feature Control Frame
commands to the Excel file. See the "Using Feature Control Frames" chapter.
Report dimensions between STATS/ON and STATS/OFF - If you select this
check box, you must include dimension (or Feature Control Frame dimension)
commands between the STATS/ON and STATS/OFF commands in your
measurement routine; otherwise, the data does not export to the Excel file. If you
clear this check box, all dimension commands export into the Excel file. See the
"Tracking Statistical Data" chapter. The following option becomes enabled:
Report TRACEFIELD - PC-DMIS includes data from TRACEFIELD
commands in your Excel report if the TRACEFIELD commands are within the
STATS/ON and STATS/OFF commands. For more information, see the
"Using Trace Fields" chapter.
Report COMMENT - Determines whether PC-DMIS includes comments in your
Excel report. It has these options:
None - PC-DMIS does not send comments to the Excel report.
REPT - PC-DMIS only sends report comments (COMMENT/REPT commands)
to the Excel report.
Display on report - PC-DMIS sends all report comments (COMMENT/REPT
commands), as well as any comment that has its Display on report check
box marked to the Excel report.
34
Using Basic File Options
36
Using Basic File Options
Thereafter, whenever you execute the measurement routine, if John is the user, the
report John.rtf is saved to his directory; if Amy is the user, Amy.rtf is saved to her
directory; if another user types his or her name, it goes to the default
C:\Inspectionreports\ directory.
• For information on comments, see the "Inserting Programmer Comments" topic
in the "Inserting Report Commands" chapter.
• For information on expressions and variables, see the "Using Expressions and
Variables" chapter.
• For information on flow control statements, see the "Branching by Using Flow
Control" chapter.
37
Using Basic File Options
If you close down all open sub-windows in the software (the Report window, the
Edit window, and the Graphic Display window) by clicking on each window's X, PC-
DMIS immediately saves the measurement routine and then closes it. If you use the
View menu to hide the windows, the measurement routine remains open.
38