Creo® Parametric TOOLKIT
Release Notes
4.0 F000
Copyright © 2016 PTC Inc. and/or Its Subsidiary Companies. All Rights Reserved.
User and training guides and related documentation from PTC Inc. and its subsidiary companies (collectively
"PTC") are subject to the copyright laws of the United States and other countries and are provided under a
license agreement that restricts copying, disclosure, and use of such documentation. PTC hereby grants to the
licensed software user the right to make copies in printed form of this documentation if provided on software
media, but only for internal/personal use and in accordance with the license agreement under which the
applicable software is licensed. Any copy made shall include the PTC copyright notice and any other
proprietary notice provided by PTC. Training materials may not be copied without the express written consent
of PTC. This documentation may not be disclosed, transferred, modified, or reduced to any form, including
electronic media, or transmitted or made publicly available by any means without the prior written consent of
PTC and no authorization is granted to make copies for such purposes. Information described herein is
furnished for general information only, is subject to change without notice, and should not be construed as a
warranty or commitment by PTC. PTC assumes no responsibility or liability for any errors or inaccuracies
that may appear in this document.
The software described in this document is provided under written license agreement, contains valuable trade
secrets and proprietary information, and is protected by the copyright laws of the United States and other
countries. It may not be copied or distributed in any form or medium, disclosed to third parties, or used in any
manner not provided for in the software licenses agreement except with written prior approval from PTC.
UNAUTHORIZED USE OF SOFTWARE OR ITS DOCUMENTATION CAN RESULT IN CIVIL
DAMAGES AND CRIMINAL PROSECUTION.
PTC regards software piracy as the crime it is, and we view offenders accordingly. We do not tolerate the
piracy of PTC software products, and we pursue (both civilly and criminally) those who do so using all legal
means available, including public and private surveillance resources. As part of these efforts, PTC uses data
monitoring and scouring technologies to obtain and transmit data on users of illegal copies of our software.
This data collection is not performed on users of legally licensed software from PTC and its authorized
distributors. If you are using an illegal copy of our software and do not consent to the collection and
transmission of such data (including to the United States), cease using the illegal version, and contact PTC to
obtain a legally licensed copy.
Important Copyright, Trademark, Patent, and Licensing Information: See the About Box, or copyright
notice, of your PTC software.
UNITED STATES GOVERNMENT RIGHTS
PTC software products and software documentation are “commercial items” as that term is defined at 48 C.F.
R. 2.101. Pursuant to Federal Acquisition Regulation (FAR) 12.212 (a)-(b) (Computer Software) (MAY 2014)
for civilian agencies or the Defense Federal Acquisition Regulation Supplement (DFARS) at 227.7202-1(a)
(Policy) and 227.7202-3 (a) (Rights in commercial computer software or commercial computer software
documentation) (FEB 2014) for the Department of Defense, PTC software products and software
documentation are provided to the U.S. Government under the PTC commercial license agreement. Use,
duplication or disclosure by the U.S. Government is subject solely to the terms and conditions set forth in the
applicable PTC software license agreement.
PTC Inc., 140 Kendrick Street, Needham, MA 02494 USA
Contents
About This Guide ........................................................................................................7
Summary of Technical Changes ...................................................................................9
Critical Technical Changes ..................................................................................10
New Functions ...................................................................................................28
Superseded Functions ........................................................................................52
Miscellaneous Technical Changes .......................................................................63
5
About This Guide
This document provides release-specific information for Creo Parametric
TOOLKIT for Creo Parametric. It describes new functions in Creo Parametric
TOOLKIT and also includes critical functions that require investigation of
existing applications and adjustment of existing code.
Documentation for Creo Parametric TOOLKIT
Creo Parametric TOOLKIT documentation comes in the following forms:
•
API Wizard in HTML format
•
Creo Parametric TOOLKIT User’s Guide in PDF format
•
Reference Documents page at http://www.ptc.com/appserver/cs/doc/refdoc.
jsp
(Choose the product or document type)
The API Wizard and the Creo Parametric TOOLKIT User’s Guide are on the Creo
Parametric DVD-ROM. You can view the API Wizard with your Internet browser.
To view and print the PDF book, you must have Acrobat Reader installed. PTC
welcomes your suggestions and comments on its documentation. Send comments
electronically to:
MCAD-documentation@ptc.com
Technical Support
For resources and services to help you with PTC software products, please visit
the Customer Support Guide in the eSupport Portal at:
http://support.ptc.com/appserver/support/csguide/csguide.jsp
7
You must have a Service Contract Number (SCN) before you can receive assisted
technical support. If you do not have a service contract number please contact
PTC Customer Care by clicking the Contact tab on the Customer Support Guide
page.
8
Creo® Parametric TOOLKIT Release Notes
1
Summary of Technical Changes
Critical Technical Changes .........................................................................................10
New Functions ..........................................................................................................28
Superseded Functions...............................................................................................52
Miscellaneous Technical Changes ..............................................................................63
This chapter describes the critical and miscellaneous technical changes in Creo
Parametric 4.0 and Creo Parametric TOOLKIT. It also lists the new and
superseded functions for this release.
9
Critical Technical Changes
This section describes the changes in Creo Parametric 4.0 and Creo Parametric
TOOLKIT that might require alteration of existing Creo Parametric TOOLKIT,
Creo Elements/Pro TOOLKIT, and Pro/TOOLKIT applications.
Non-Applet Based Version of the APIWizard
The non-applet based APIWizard supports Internet Explorer 9.0 or higher,
Firefox, and Chromium browsers.
To open the non-applet based version of the Creo Parametric TOOLKIT
APIWizard, point your browser to:
<creo_toolkit_loadpoint>\protkdoc\index.html
index.html contains links to the Creo Parametric TOOLKIT APIWizard and
User’s Guide. Creo Parametric TOOLKIT APIWizard has a search field which
allows you to search for APIs with its full name or by using the wild character *.
See the Creo Parametric TOOLKIT User’s Guide for more information.
Applet Based Version of the APIWizard
From Creo Parametric 4.0 F000, the Applet Based APIWizard is no longer
supported. Use the non-applet based APIWizard instead.
Applying the default_leader_arrow_style Option
while Creating Annotations
While creating annotations with leaders, Creo Parametric TOOLKIT applications
used to ignore the setting no_arrow, defined in the Detail configuration option
default_leader_arrow_style.
From Creo Parametric 2.0 M090 onward, Creo Parametric TOOLKIT applications
use the setting defined by the option default_leader_arrow_style
during the creation of annotations with leaders. This is applicable for annotations,
such as notes or symbol instances.
Behavior of ProMdlnameRename() for Generic
Models
When you call the function ProMdlnameRename() on an instance of generic
model, the status of the generic model changes to marked for save. If you call save
action, the generic model is saved, even if no changes were made to the model.
10
Creo® Parametric TOOLKIT Release Notes
Change in Behavior of Frozen State in Assemblies
From Creo Parametric 3.0 onward, the Creo Parametric TOOLKIT applications
ignore the behavior of the configuration option freeze_failed_assy_comp
and the freeze commands on the Creo Parametric user interface are not available.
The applications set the frozen status on components only during the regeneration
of the model.
Use the new configuration option allow_freeze_failed_assy_comp to
restore the behavior of the configuration option freeze_failed_assy_
comp. When you set this option, the freeze commands on the Creo Parametric
user interface are available, which allow you to set the component status as
frozen.
Change in Behavior of Cabling Functions
From Creo Parametric 2.0 M080 onward, when you execute the following
functions the active part switches to the harness part and then back to the original
part:
•
•
•
ProCableCreate()
ProBundleCreate()
ProCablesFromLogicalCreate()
The function ProCableRoutingStart() switches the current model to a
harness part. Call the function ProCableRoutingEnd() to switch the harness
part back to its original part.
Change in Behavior of ProDtlnoteDataGet()
The function ProDtlnoteDataGet() returned the hard line breaks data,
which must not be used by the applications. From Creo Parametric 2.0 M040
onward, the behavior of the function has been fixed, and it does not return this
data.
Change in Behavior of ProDtlnoteModify()
When the function ProDtlnoteModify() was called on the On Item note
type which was created with the attachment type PRO_DTLATTACHTYPE_
UNIMPLEMENTED, the note type could change to Free note type. From Creo
Parametric 2.0 M190 this has been fixed. The note type does not change when the
function PrDtlnoteModify() is called.
Summary of Technical Changes
11
Change in Behavior of ProDwgtableRowSizeGet(),
ProDrawingTablesUpdate(),
ProDtlnoteLineEnvelopeGet(), and
ProNoteLineEnvelopeGet()
The following Creo Parametric TOOLKIT functions provide more accurate
results:
• ProDwgtableRowSizeGet()
• ProDrawingTablesUpdate()
• ProDtlnoteLineEnvelopeGet()
• ProNoteLineEnvelopeGet()
Previously, these functions returned results based on inappropriate character size
and these results were inconsistent under different conditions.
Change in Behavior of ProFitClearanceCompute()
The function ProFitClearanceCompute() used to incorrectly return PRO_
B_TRUE for the argument is_interference_found, when there was no
interference and the clerance value was postive and non-zero. From Creo
Parametric 2.0 M120 onward, this behavior has been fixed. The function correctly
returns PRO_B_FALSE, for a positive and non-zero clearance value, indicating no
interference.
Change in Behavior of ProGtolRightTextSet() and
ProGtolTopTextSet()
The height of text for geometric tolerances was set to the default height by the
functions ProGtolRightTextSet() and ProGtolTopTextSet(). From
Creo Parametric 2.0 M060 onward, these functions set the height of text for the
specified geometrical tolerance according to the model units.
Change in the Behavior of ProGtolRightTextSet()
The function ProGtolRightTextSet() did not set the orientation of the text
correctly due to which a call to the function
ProGtolRightTextEnvelopeGet() used to return an error. This behavior
has been fixed in Creo Parametric 2.0 M080. All function calls to
ProGtolRightTextSet() followed by
ProGtolRightTextEnvelopeGet() are now successful.
12
Creo® Parametric TOOLKIT Release Notes
Change in Behavior of ProReferenceOwnerGet()
The function ProReferenceOwnerGet() used to return NULL for local copy
reference in a model. Local copy reference is a local copy of the external reference
that is backed up in the model. From Creo Parametric 2.0 M070 onward, the
function returns the local model for the specified local copy reference.
Change in Behavior of ProServerObjectIsModified()
From Creo Parametric 2.0 M040 onward, the behavior of the function
ProServerObjectIsModified() has been updated to fix for the value
returned by the argument checkout_status. The argument now returns the
value PRO_B_FALSE to indicate one of the following statuses for the specified
object:
•
•
the object was only saved, but never uploaded
the object was only uploaded, but never checked in
Change in Behavior of ProSolidExternParentsGet()
The function ProSolidExternParentsGet() did not collect external
dependencies for patterns. From Creo Parametric 2.0 M110 onward, the behavior
of the function ProSolidExternParentsGet() has been fixed. The
function now collects external and local parents of the specified solid for pattern
type of reference.
Change in Behavior of User Defined Features
From Creo Parametric 3.0 onward, for features created using external references,
Creo Parametric creates a geometry backup to support feature regeneration and
redefinition when the external references are out of context or out of session. This
allows missing references in the feature to be visited, and additional information
about these references is returned when functions such as
ProFeatureAnnotationelemsVisit() are called. If you do not want the
functions to return this additional information about references, you can disable
the functionality by setting the configuration option backup_reference_
information to no.
Summary of Technical Changes
13
Change in Directory Structure for Creo Installation
From Creo 3.0 onward, the directory structure for Creo installation has changed
from:
•
•
<creo_loadpoint>\Parametric to <creo_loadpoint>\
<datecode>\Parametric.
<creo_loadpoint>\Common Files\<datecode> to <creo_
loadpoint>\<datecode>\Common Files
Change in String Values for Material Condition
From Creo Parametric 3.0 onward, the function
ProParameterScaledvalueGet() returns the strings Maximum
Material, Least Material, Regardless of size (with symbol)
and Regardless of size (no symbol) instead of MMC, LMC, RFC, and
Default-RFS respectively.
Color of the Hatch Pattern
The structure ProXsecXhatchPattern specifies the color of the hatch pattern
as a ProColor object.
Compiling and Linking on Windows
From Creo Parametric 4.0 F000, Creo Parametric TOOLKIT will support both
Visual Studio 2012 and Visual Studio 2015. In a future release, Creo Parametric
will fully support Visual Studio 2015. When Creo Parametric fully supports Visual
Studio 2015, Creo Parametric TOOLKIT will be available only with Visual Studio
2015. The compiler flags and libraries which support Visual Studio 2012 will not
be available.
All Creo Parametric TOOLKIT applications on 32-bit and 64-bit Windows
platforms built using the Microsoft Visual Studio 2012 compiler must set the
configuration property Platform Toolset as Visual Studio 2012 - Windows XP
(v110_xp).
To use the makefile based solution, you must add the flag -D_USING_V110_
SDK71_ to the compile line of each object. These changes have been incorporated
in the sample makefiles.
14
Creo® Parametric TOOLKIT Release Notes
Customized Ribbon User Interface
Customized Ribbon User Interface components built in Creo Parametric 1.0 F000
or M010 may not work correctly in certain situations. PTC recommends that you
send these customized ribbon files to PTC for review and clean-up before using
them in Creo Parametric 1.0 M020 and higher releases. Alternatively, rebuild
these ribbon customizations again using Creo Parametric 1.0 M020 and higher
releases.
Ensure that all new ribbon customizations are created in Creo Parametric 1.0
M020 or higher releases only.
Dialogs Not Supported While Invoking Creo
Parametric TOOLKIT Application
When you invoke the Creo Parametric TOOLKIT application, ensure that no
dialogs are open in Creo Parametric session. If Creo Parametric dialog is open, the
results may be unpredictable.
Digital Rights Management Retired
From Creo Parametric 3.0 onward, Digital Rights Management (DRM) is no
longer supported. Creo Parametric TOOLKIT applications that check the DRM
permissions will have to be updated.
Disable Notification Messages in Trail Files
When notifications are set in Creo Parametric TOOLKIT applications, every time
an event is triggered, notification messages are added to the trail files.
From Creo Parametric 2.0 M210 onward, a new environment variable PROTK_
LOG_DISABLE allows you to disable this behavior. When set to true, the
notifications messages are not added to the trail files.
Drawing Functions to Display Annotations and
Create BOM Balloons
The following functions will show the annotations or create BOM balloons only if
the drawing is displayed in the current session:
•
•
•
•
•
ProAnnotationByViewShow()
ProAnnotationByFeatureShow()
ProAnnotationByComponentShow()
ProDrawingDimensionsCleanup()
ProDimensionAutoOrdinateCreate()
Summary of Technical Changes
15
•
•
•
•
•
ProBomballoonCreate()
ProBomballoonAllCreate()
ProBomballoonByComponentCreate()
ProBomballoonByRecordCreate()
ProBomballoonClean()
From Creo Parametric 2.0 M060 onward, you can specify the view in which the
annotations must be displayed for the functions
ProAnnotationByFeatureShow() and
ProAnnotationByComponentShow().
Environment Variables to Initiate Applications
From Creo Parametric 3.0 onward, the following environment variables allow you
to load your applications with calls from user_initialize() even if the
Creo Platform Agent has not loaded:
•
•
PROTK_DELAYINIT_NO_DELAY—Initiates the application directly, without
waiting for Creo Platform Agent to load.
PROTK_DELAYINIT_ALWAYS_INIT—Waits for PTC Creo Platform Agent
to load. However, it initiates the application even if the Creo Platform Agent
fails to load or times out.
Fill Patterns
A new value PRO_GRP_PATTERN_HEADER has been added to the enumerated
data type ProGrppatternStatus defined in the header file
ProFeature.h. This value specifies that the feature is the header of a group
pattern.
A new value PRO_PATTERN_HEADER has been added to the enumerated data
type ProPatternStatus defined in the header file ProFeature.h. This
value specifies that the feature is the header of a pattern.
Geometric Tolerances
From Creo Parametric 4.0 F000 onward, the object Gtoldata has been
deprecated. All the ProGtolData* functions have also been deprecated. Use
the new ProGtolAttach object and new ProGtol* functions instead. The
new functions are defined in the header files ProGtol.h and
ProGtolAttach.h.
Geometric tolerance functions deprecated in Creo Parametric 4.0 F000 must not
be used with the new geometric tolerance functions available from Creo
Parametric 4.0 F000 in a Creo Parametric TOOLKIT application. If the functions
are used together in an application, the results may be unpredictable.
16
Creo® Parametric TOOLKIT Release Notes
When the new ProGtol*Get() functions, except
ProGtolTopModelGet(), ProGtolValidate()
ProGtolReferencesGet(), and ProGtolReferenceDelete(), are
called on geometric tolerances created in releases prior to Creo Parametric 4.0
F000, these legacy geometric tolerances are converted to the new Creo Parametric
4.0 geometric tolerances. In this case, the revision number of the model is also
incremented.
Inventor Model Units Retained during Import as
Assembly
The Inventor model units were not retained when an Inventor model was imported
as an assembly in Creo Parametric. From Creo Parametric 2.0 M110 onward, this
behavior has been fixed. The Inventor model units are now retained during the
import of the Inventor model as an assembly.
Layout Model Type
From Creo Parametric 3.0 onward, the enumerated type ProMdlType contains
an additional value PRO_MDL_CE_SOLID that represents models of type Layout.
Creo Parametric TOOLKIT functions will only be able to read models of type
Layout, but will not be able to pass Layout models as input to other functions. To
work with Layout models, you must rebuild your existing Creo Parametric
TOOLKIT applications.
License INTF_for_JT Required to Import and Export
JT Files
From Creo Parametric 2.0 M200 onward, the following functions require the
license INTF_for_JT to import and export a JT file to Creo Parametric. If the
license is not available the functions return the error PRO_TK_NO_LICENSE.
•
•
•
•
•
•
•
ProIntf3DFileWrite()
ProIntfimportModelCreate()
ProIntfimportModelWithOptionsCreate()
ProIntfimportModelWithProfileCreate()
ProImportfeatCreate()
ProImportfeatWithProfileCreate()
ProDatumcurveFromfileCreate()
From Creo Parametric 3.0 M080 onward, the function
ProIntfimportModelWithOptionsMdlnameCreate() requires the
license INTF_for_JT to import a JT file to Creo Parametric.
Summary of Technical Changes
17
Manufacturing Subtype PRO_MFGTYPE_MACH_
PART
From Creo Parametric 3.0 onward, the manufacturing subtype PRO_MFGTYPE_
MACH_PART for part machining is no longer supported.
Material Type and Material Surface Finish Types for
Fatigue Analysis
From Creo Parametric 3.0 onward, two new material types PRO_MATERIAL_
FATIGUE_MAT_TYPE_FERROUS and PRO_MATERIAL_FATIGUE_MAT_
TYPE_OTHER have been added for fatigue analysis. The material types PRO_
MATERIAL_FATIGUE_MAT_TYPE_UNALLOYED_STEELS and PRO_
MATERIAL_FATIGUE_MAT_TYPE_LOW_ALLOY_STEELS are obsolete. You
must rebuild your existing Creo Parametric TOOLKIT applications to work with
the new material types.
Migrating Creo Parametric TOOLKIT Applications to
PTC Object TOOLKIT C++
From Creo Parametric 3.0 M010 onward, a new perl script mark_
otkmethod.pl facilitates migration of Creo Parametric TOOLKIT applications
to Creo Object TOOLKIT C++.
Migrating Tools
From Creo Parametric 3.0 onward, the migration tool ptk_revtool has been
retired, and will not be supported in future releases.
A new perl script mark_deprecated.pl allows you to update applications
from older versions to current release of Creo Parametric TOOLKIT.
Model Type for a Manufacturing Assembly
For a manufacturing assembly, specify the type of model ProMdlType as either
PRO_MDL_ASSEMBLY or PRO_MDL_MFG. To work with an assembly handle,
specify the model type as PRO_MDL_ASSEMBLY and to work with a
manufacturing handle, specify the model type as PRO_MDL_MFG.
If the assembly type is not known, initialize the model type as PRO_MDL_
ASSEMBLY. Check the assembly subtype using the function
ProMdlSubtypeGet(). If the function returns the subtype as
PROMDLSTYPE_MFG_NCASM, then the assembly is a manufacturing assembly.
You can then initialize the model type as PRO_MDL_MFG to work with
manufacturing data.
18
Creo® Parametric TOOLKIT Release Notes
Modifications to Sketched Datum Point
The sketched datum point is obsolete. The element tree for sketch datum point
defined in the header file ProDtmPnt.h is no longer supported. To create new
sketched datum points, you must use the element tree for sketched datum curves
defined in the header file ProDtmCrv.h.
Multithreading in Creo Parametric TOOLKIT
Applications
From Creo Parametric 3.0 onward, the function
ProEngineerMultithreadModeEnable() has been deprecated.
Multithreading is now always supported in Creo Parametric TOOLKIT
applications. There is no need, to call the multithreading function, when the
application creates additional threads for processing.
New Field to Specify Ribbon File in Registry File
From Creo Parametric 3.0 onward, a new field rbn_path has been added in the
registry file creotk.dat. It allows you to specify the name and path of the
ribbon file, which must be loaded when you open Creo Parametric.
No Support for Boundary Box Type of Simplified
Representation
From Creo Parametric 3.0 onward, the boundary box type of representation
specified by the value PRO_SIMPREP_BOUNDBOX_REP in the header file
ProSimprep.h is no longer supported.
No Support for Deleting Items While Visiting Them
While using the visit functionality, PTC recommends that you must not delete the
items, which the function will visit. If you delete the items that will be visited, the
results may be unpredictable.
No Support for Pro/Develop Functions
From Creo Parametric 3.0 onward, the Pro/Develop header files and related
support files will not be shipped with Creo Parametric. The Pro/Develop functions
are not supported. All supported functions are prototyped in headers files under
<creo_toolkit_loadpoint>/includes. PTC recommends that you
update applications that use Pro/Develop functions to use equivalent Creo
Parametric TOOLKIT functions or Creo Object TOOLKIT C++ methods.
Summary of Technical Changes
19
No Support for PRO_LWG_SIMPREP_LEVEL_
SELECTED
The value PRO_LWG_SIMPREP_LEVEL_SELECTED in enumerated data type
ProLightweightGraphicsSimprepLevel is not supported, and is
reserved for future use.
Performance Improvement in Solid Interference and
Clearance
The performance of functions detecting solid interference or clearance has been
improved.
ProAsmcomppathDispQuiltVisit()
In Creo Parametric 2.0, there was a change in the behavior of the function
ProAsmcomppathDispQuiltVisit(). After change in behavior, the
function visited all the quilts, including displayed and un-displayed quilts in the
solid. This behavior has been fixed in Creo Parametric 2.0 M030. It now visits
only displayed quilts.
ProCableLogicalEndsGet()
The function ProCableLogicalEndsGet() did not work correctly for
conductors. This issue has now been fixed. From Creo 3.0 M020 onward, you can
also use the function ProCableLogicalEndsGet() to retrieve the logical
ends of a conductor.
ProDimensionValueSet()
From Creo Parametric 3.0 onward, the function ProDimensionValueSet()
checks if the value being set is valid for the specified dimension or feature type. If
the value is not valid for the specified dimension or feature, the function returns
the error PRO_TK_GENERAL_ERROR. For example, you cannot set negative
value for the diameter of a hole. However, you can set either positive or negative
value for an offset in a datum plane.
ProDtlattachArrowtypeGet()
The function ProDtlattachArrowtypeGet() used to return PRO_TK_
BAD_INPUTS error instead of returning the type of arrowhead for a leader
attached to a free point. From Creo Parametric 3.0 onward, this behavior has been
fixed and the function now returns the correct type of arrowhead for the leader
attached to a free point.
20
Creo® Parametric TOOLKIT Release Notes
ProNoteElbowlengthGet()
In previous releases for certain scenarios, the function
ProNoteElbowlengthGet() used to return incorrect length and sign for 3D
notes and as a result would change the position of the 3D note. From Creo
Parametric 2.0 M070 onward, this behavior has been fixed and the function
returns the correct values for 3D notes.
ProSetdatumtagAttachmentSet()
From Creo Parametric 2.0 M090 onward, you can place the datum tag on its
datum axis at the default position, or on its datum plane. To specify the datum axis
or datum plane as the attachment option, pass the input argument attachment
as NULL for the function ProSetdatumtagAttachmentSet().
ProNoteTextStyleGet() and ProNoteTextStyleSet()
The functions ProNoteTextStyleGet()and ProNoteTextStyleSet()
were deprecated in Creo Parametric 1.0.
From Creo Parametric 3.0 M020 onward, the functions
ProNoteTextStyleGet()and ProNoteTextStyleSet() are now
supported.
Creo Parametric TOOLKIT Support for Creo
Applications
Creo Parametric TOOLKIT applications in synchronous and asynchronous modes
are supported only with the Creo Parametric application. They are not supported
with the other Creo applications, such as, Creo Direct, Creo Layout, Creo
Simulate, and so on. In future these Creo applications will be supported by Creo
Object TOOLKIT. In Creo 3.0, Creo Object TOOLKIT supports Creo Parametric
and Creo Direct.
The functions ProEngineerConnect() and ProEngineerStart()
return an error when the Creo Parametric TOOLKIT application attempts to
connect to a Creo application other than Creo Parametric. Refer to the section
Creo Parametric TOOLKIT Support for Creo Applications in Creo Parametric
TOOLKIT 3.0 User’s Guide.
Summary of Technical Changes
21
Retrieving Solids in a Creo Parametric session
Linked to Windchill
You must retrieve solid models in a Creo Parametric session, which is linked to
Windchill, only after you create a new workspace. If you retrieve the models
before creating the workspace, the models would be erased from the Creo
Parametric session.
Spread Angle Set Using ProLightSourcesSet()
The function ProLightSourcesSet() used to set the spread angle as double
of the specified angle for spot lights. The function treated the specified angle as
half angle. This issue has been fixed in Creo Parametric 2.0 M030.
The function now treats the specified angle as the full spread angle of the spot
light and sets it correctly to the specified value. The spread angle of the spot light
is the total angle encompassed by the light.
Structural Temperature Load on Point References
From Creo Parametric 2.0 M120 onward, you cannot create structural temperature
loads on point references using Creo Parametric TOOLKIT applications. This
functionality has been deprecated in Creo Parametric TOOLKIT as it is no longer
supported in Creo Parametric user interface.
If your applications use structural temperature loads on point references, you must
specify other references, such as, curves or surfaces, and rebuild your
applications. The existing structural temperature loads on point references in Creo
Parametric TOOLKIT applications and models are suppressed.
Support for Creo Unite
Creo Unite enables you to open non-Creo parts and assemblies in Creo
applications without creating separate Creo models.
You can open the part and assembly models of the following non-Creo file
formats in Creo applications:
•
•
•
•
•
•
22
CATIA V5 (.CATPart, .CATProduct)
CATIA V5 CGR
CATIA V4 (.Model)
SolidWorks (.sldasm, .sldprt)
NX (.prt)
Creo Elements/Direct (.sdpc, .sdac, .sdcc, and .sdrc)
Creo® Parametric TOOLKIT Release Notes
From Creo Parametric 4.0 F000 onward, the following Creo Elements/Direct
files can be opened in Creo Parametric and other Creo applications such as
Creo Simulate and Creo Direct without creating separate Creo models:
○ Part content file (.sdpc)
○ Assembly content file (.sdac)
To support Creo Elements/Direct in Creo Unite, two new values PRO_CC_
ASSEMBLY and PRO_CC_PART have been added to the enumerated data type
ProMdlfileType.
The non-Creo parts and assemblies are opened as components of Creo assemblies.
These parts and assemblies can be assembled in Creo applications to create multiCAD assemblies of mixed content.
Most of the Creo Parametric TOOLKIT functions support multi-CAD assemblies.
The functions which do not support assemblies of mixed content return the error
type PRO_TK_UNSUPPORTED, when a non-Creo part or assembly is passed as
the input model.
When using the function ProFeatureWithoptionsCreate() while
working with a multi-CAD model, the following scenarios are possible depending
on the value of the configuration option confirm_on_edit_foreign_
models. The default value of the configuration option confirm_on_edit_
foreign_models is yes.
•
•
•
If the configuration option confirm_on_edit_foreign_models is set
to no, the non-Creo model is modified without any notification.
If the configuration option confirm_on_edit_foreign_models is set
to yes, or the option is not defined in the configuration file, then in batch mode
the application returns the error PRO_TK_GENERAL_ERROR.
In some situations you may need to provide input in the interactive mode with
Creo. Refer to the Creo Parametric Data Exchange online help, for more
information.
Support for Multi-Byte Characters in Model Names
and File Paths
From Creo Parametric 4.0 F000 onward, the Creo Parametric TOOLKIT functions
support some multi-byte characters in file names and file paths of the models. The
local file paths can contain a maximum of 260 characters.
In releases prior to Creo Parametric 4.0 F000, the Creo Parametric TOOLKIT
applications could have been written based on single-byte character support for
model names. For multi-byte characters, these applications may incorrectly
convert wchar_t based name string into char buffers of insufficient length.
Therefore, such applications may have to be rewritten or rebuilt to work with
multi-byte characters.
Summary of Technical Changes
23
The following multi-byte characters are supported:
•
•
All characters from Unicode code point 0800 onward.
The following characters from Unicode code points 0000 to 0070F are
supported. All the other characters between Unicode code points 0000 to
0070F are not supported.
○
○
○
○
○
A to Z
a to z
0 to 9
_ Underscore
– Hyphen
New Libraries
From Creo Parametric 4.0 F000 onward, the following libraries are no longer
supported and will not be shipped. Equivalent new libraries are available. When
you migrate an application to Creo Parametric 4.0, relink it to the new libraries,
and rebuild the application. The new libraries avoid linking of the application to
Unicode libraries.
Old Library Name
New Library Name
protk_dll.lib
protk_dll_NU.lib
protoolkit.lib
protoolkit_NU.lib
protk_dllmd.lib
protk_dllmd_NU.lib
protkmd.lib
protkmd_NU.lib
The following new import libraries and dlls have been added:
•
•
•
•
24
ucore.lib
udata.lib
ucore46.dll
udata46.dll
Creo® Parametric TOOLKIT Release Notes
Updates to Enumerated Data Type
ProFitComputeSetup
From Creo Parametric 2.0 M030 onward, the following values have been added to
the enumerated data type ProFitComputeSetup:
•
•
PRO_FIT_PART_DETAILED—Computes interference between the pairs of
parts in an assembly, irrespective of whether the volume can be calculated
between the pairs.
PRO_FIT_SUB_ASSEMBLY_DETAILED—Computes interference between
the pairs of subassemblies in an assembly, irrespective of whether the volume
can be calculated between the pairs.
Updates to Enumerated Data Type
ProDtmaxisConstrType
From Creo Parametric 2.0 onward, the following value has been added to the
enumerated data type ProDtmaxisConstrType:
•
PRO_DTMAXIS_CONSTR_TYPE_PARALLEL—Positions the datum axis
parallel to the selected reference.
Updates to Error Codes for ProFaminstanceAdd()
and ProFaminstanceCreate()
From Creo Parametric 2.0 M010 onward, the function
ProFaminstanceCreate() returns the error type PRO_TK_E_NOT_FOUND
instead of PRO_TK_NO_ERROR if you try to create new instance having the same
name as the generic model.
The function ProFaminstanceAdd() returns the error type PRO_TK_ABORT
if you add an instance having the same name as the generic model to the family
table. From Creo Parametric 2.0 M010, this error type is documented in the header
file ProFaminstance.h.
Updates to Error Types
Following is the list of the error types added to functions:
•
•
ProFilesList()—The error type PRO_TK_INVALID_DIR has been
added. It indicates that the directory specified for the input argument
directory_path is not a valid directory.
ProIntf3DFileWrite()—The error type PRO_TK_NO_CHANGE has
been added. It specifies that the model was not exported because the up-todate image for the specified Creo Parametric source model already exists in
the heterogeneous design in context (HDIC) format.
Summary of Technical Changes
25
•
•
•
•
•
•
•
•
•
•
•
•
•
•
26
ProIntfimportModelCreate()—The error type PRO_TK_CANT_
OPEN has been added. It specifies that the imported file could not be opened.
ProIntfimportModelWithOptionsCreate() and
ProIntfimportModelWithProfileCreate()—The error type PRO_
TK_INVALID_TYPE has been added. It specifies that the combination of the
input arguments is invalid.
ProXsecGeometryArrayFree()—The error type PRO_TK_BAD_
INPUTS has been added. It specifies that the value for the input array p_
geom_arr is NULL.
ProXsecGeometryFree()—The error type PRO_TK_BAD_INPUTS has
been added. It specifies that the value for the input array xsec_geom is
NULL.
ProCombstateAnnotationsAdd()—The error type PRO_TK_NO_
CHANGE has been added. It specifies that the status of some annotations in the
specified combined state item has not changed.
ProFeatureInit()—The error type PRO_TK_NOT_EXIST has been
added. It specifies that the feature with the specified identifier does not exist.
ProLayerItemInit()—The error type PRO_TK_NOT_EXIST has been
added. It specifies that the item with the specified identifier and type does not
exist in the layer.
ProModelitemInit()—The error type PRO_TK_NOT_EXIST has been
added. It specifies that the item with the specified identifier and type does not
exist in the model.
ProSimprepSelect()—The error type PRO_TK_USER_ABORT has
been added. It specifies that the user has quit the simplified representation
selection process.
ProDimensionSymbolSet()—The error type PRO_TK_NO_CHANGE
has been added. It specifies that the function will return the error PRO_TK_
NO_CHANGE if the specified symbol already exists for another dimension in
the model.
ProMechmaterialorientdataRotationGet()—The error type
PRO_TK_INVALID_TYPE has been added. It specifies that the material
orientation data type is not PRO_MECH_MATLORI_MODEL.
ProMechmaterialorientdataRotationSet()—The error type
PRO_TK_CANT_WRITE has been added. It specifies that the subtype cannot
be changed.
ProDrawingViewSimplifiedGet()—The error type PRO_TK_
INVALID_TYPE has been added. It specifies that the top model for the view
is not a solid.
ProEdgeVertexdataGet()—The error type PRO_TK_INVALID_TYPE
has been added. It specifies that the selected edge is not visible in current
geometry.
Creo® Parametric TOOLKIT Release Notes
•
•
•
•
•
•
•
•
•
•
•
•
ProFamtableInit()—The error type PRO_TK_UNSUPPORTED has
been added. It specifies that the family table cannot be created in the specified
model.
ProGtoldataValueSet() and ProGtoldataPerUnitSet()—The
error type PRO_TK_NOT_VALID has been added. It indicates that the
specified tolerance values are not valid for creating the geometric tolerance.
ProSurfaceAreaEval()—The error type PRO_TK_OUT_OF_RANGE
has been added. It specifies that the computed surface area is too small, almost
close to zero.
ProMfgCreate()—The error type PRO_TK_UNSUPPORTED has been
added. It specifies that the manufacturing object with subtype PRO_
MFGTYPE_MACH_PART was not created.
ProAnimframeObjRemove()—The error type PRO_TK_E_NOT_FOUND
has been added. It specifies that the animation object is not present in the
specified animation frame.
ProSurfaceParamEval()—The error type PRO_TK_E_NOT_FOUND
has been added. It indicates that the specified point cannot be found projected
on the specified surface.
ProServerWorkspaceDelete()—The error type PRO_TK_E_IN_USE
has been added. It indicates that the workspace is active.
ProMdlnameRetrieve() and ProMdlFiletypeLoad()—The error
type PRO_TK_BAD_CONTEXT indicates that the function is attempting to
retrieve a multi-CAD model from a location other than active Windchill
server, when an active connection to a Windchill server exists. The multi-CAD
assembly must be retrieved only from the active Windchill server.
ProDrawingPosToLocgrid()— The error types PRO_TK_NOT_EXIST
and PRO_TK_OUT_OF_RANGE have been added. The error type PRO_TK_
NOT_EXIST specifies that the location grid has not been defined for the
drawing sheet. The error type PRO_TK_OUT_OF_RANGE specifies that the
position of the point, that is the screen coordinates pos, is outside the location
grid.
ProElementReferencesGet()—The error type PRO_TK_EMPTY has
been added. It indicates that no reference value has been set for the specified
element.
ProQuiltVolumeEval()—The error type PRO_TK_INCOMPLETE has
been added. It indicates that the maximum number of iterations allowed to
evaluate the volume has been reached.
ProNotePlacementSet()—The error type PRO_TK_BAD_CONTEXT
Summary of Technical Changes
27
•
has been added. It indicates that the note cannot be placed at the specified
location because the note has an annotation plane, which is flat to screen and
is not compatible with the specified placement point.
ProNoteAttachFreeGet()—The error type PRO_TK_E_NOT_FOUND
has been added. It indicates that the specified note is attached to a geometry,
that is, the note is not freely located.
Visibility of Cross Section
From Creo Parametric 4.0 F000 onward, when a cross section is created, it is not
displayed by default in the model. You must call the function
ProXsecMakeVisible() to display the cross section.
While porting Creo Parametric TOOLKIT applications, which have used the
function ProXsecPlanarWithoptionsCreate() and have been created in
releases prior to Creo Parametric 4.0 F000, depending on whether you want the
cross section to be displayed, call the function ProXsecMakeVisible() in
your applications. ProXsecMakeVisible() displays the cross section in the
model.
Windchill Operations in Creo Parametric Running in
Asynchronous Mode
For Windchill operations, such as, registering a Windchill server, managing
workspaces, and so on you can run Creo Parametric in non-interactive mode, that
is, batch mode application or asynchronous application. When Creo Parametric
applications are running in asynchronous non-graphical mode, they require login
credentials before execution. If you want to override the requirement of specifying
login credentials for Creo Parametric applications, set the environment variable
PROWT_AUTH_MODE to PROWT_AUTH_UNATTENDED.
wmain() Function
Creo Parametric TOOLKIT application must contain its own wmain() function
if the application needs to receive command-line arguments as wchar_t, for
example if the input contains non-usascii characters.
New Functions
This section describes new functions for Creo Parametric TOOLKIT for Creo
Parametric 4.0.
28
Creo® Parametric TOOLKIT Release Notes
Annotations
New Function
ProAnnotationByViewShow()
ProAnnotationByFeatureShow()
ProAnnotationByComponentShow()
ProAnnotationfeatElementCopy()
ProCombstateAnnotationErase()
ProDrawingAnnotationErase()
ProAnnotationLegacyConvert()
Description
Displays the annotation in the specified
view, for the specified type of feature
and component.
Copies and adds the annotation element
to the specified annotation feature.
Removes an annotation from the
display for the specified combined
state.
Removes an annotation from the
display for the specified drawing.
Converts following annotations to the
latest Creo Parametric version:
• Annotations created in releases
prior to Creo Parametric 4.0 F000
•
ProMdlDatumTargetCreate()
Annotations created using the
deprecated functions
ProGtolCreate() or
ProSetdatumtagCreate()
Creates a new datum target annotation.
Assembly
New Function
ProAsmcompMdlMdlnameGet()
ProAsmcompMdlnameCreateCopy()
ProAsmSkeletonMdlnameCreate()
ProAsmcompMdldataGet()
Summary of Technical Changes
New Function
Retrieves the model name and type for
the specified component.
Creates a new component in the
assembly by copying a component from
an existing model.
Creates a new skeleton model and adds
it to the specified assembly.
Retrieves the name, file type, and type
of the model under the specified
assembly component.
29
New Function
ProMdlVariantfeatAsmcomppathGet()
ProAsmcompAllConstrRemove()
New Function
Retrieves a special pointer from an
inheritance feature or flexible
component, where the pointer
represents the component path.
Removes all types of constraints
including interface constraints for the
specified assembly component.
BOM Balloon
New Function
ProDwgtableCellRegionGet()
Description
Creates the BOM balloons.
ProBomballoonCreate()
ProBomballoonAllCreate()
ProBomballoonByComponentCreate()
ProBomballoonByRecordCreate()
ProBomballoonClean()
Cleans the display and location of the
BOM balloons.
Cabling
New Function
ProCablingNeutralwirelistImport()
ProAssemblyHarnessesTopCollect()
ProCableLocationsOnSegEndGet()
ProCableTapeFeatSpoolGet()
ProCablingIsHarness()
30
Description
Imports the PTC neutral wire list file
(.nwf) format file in the current
session.
Returns an array of handles to the
harnesses present in the specified top
level assembly.
Gets the start and end location of each
segment for the specified cable.
Gets the spool for the specified tape
feature.
Identifies if the specified model is a
harness part.
Creo® Parametric TOOLKIT Release Notes
New Function
Description
ProConnectorWithAllParamsDesignate Designates a component in the
()
assembly as a cabling connector using
all the logical parameters.
ProCablesFromLogicalAllCreate()
Creates cables and conductors from
logical references. If the spool feature
is not defined for a cable, then this
function also creates spools for the such
cables.
Cavity Layout
New Function
ProCavitylayoutLeaderMdlnameSet()
ProCavitylayoutModelMdlnamesGet()
ProCavitylayoutModelMdlnamesSet()
Description
Sets the leader model for the cavity
layout.
Gets the names of instances in a pattern
which will be replaced with another
pattern.
Sets the specified instances in a pattern
to be replaced with another pattern.
Combined State
New Function
ProCombstateAnnotationsStateGet()
ProCombstateSupplGeomStateGet()
ProCombstateIsPublished()
ProCombstateIsDefault()
Description
Checks if the visibility of annotations is
controlled by combined state or layers.
Checks if the visibility of
supplementary geometry is controlled
by combined state or layers.
Checks if the specified combined state
has been published to Creo View.
Checks if the specified combined state
is set as the default combined state.
Configuration Option
New Function
ProConfigoptionGet()
Summary of Technical Changes
Description
Retrieves the current value for the
specified configuration file option.
31
Copied References
New Function
Description
ProFeatureCopiedRefStateDetailsGet() Retrieves the status of copied
references for a specified feature using
the enumerated data type
ProCopiedRefStateDetails.
Creating Tools
New Function
ProToolFileRead()
ProToolFileWrite()
Description
Creates a new tool or redefines an
existing tool.
Writes all information about the tool
into a file.
Creo Simulate
New Function
ProMechcurveAncestorsGet()
ProMechcontactinterfacedataFrictionSet()
ProMechcontactinterfacedataFrictionGet()
Description
Retrieves the ancestor curves, that is,
the actual Creo Parametric geometry
curves that were used to construct the
Creo Simulate curve.
Sets the type of the friction at the
contact interface, between the pairs of
nodes.
Obtains the type of friction present at
the contact interface.
Cross Section
New Function
ProXsecPlanarWithoptionsCreate()
ProXsecFlipGet()
ProXsecExcludeCompGet()
ProAsmpathProarrayFree()
32
Description
Creates a cross section feature through
a datum plane.
Retrieves the direction in which the
cross section was clipped.
Retrieves the status and path of the
assembly components included and
excluded for the specified cross section.
Frees the memory allocated to
assembly component path.
Creo® Parametric TOOLKIT Release Notes
New Function
ProXsecCompXhatchStyleGet()
ProXsecCompXhatchStyleSet()
ProXsecOffsetCreate()
ProXsecMakeVisible()
ProXsecIsVisible()
Description
Retrieves and sets the hatch pattern for
the specified cross section component.
Creates an offset cross section from a
polyline.
Displays the specified cross section in
the model.
Checks if the specified cross section is
displayed in the model.
Data Exchange
New Function
ProOutputFileMdlnameWrite()
Description
Creates a file of the specified type from
data in Creo Parametric.
Pro2dImportMdlnameCreate()
Imports two-dimensional geometry
files and creates a new two-dimensional
model.
ProIntfSliceFileWithOptionsMdlnaExports the model to the specified
meExport()
tesellated format.
ProATBMdlnameVerify()
Checks if the specified ATB model is
out-of-date with the source CAD
model.
ProSolidShrinkwrapMdlnameCreate() Exports the specified solid model as a
shrinkwrap model.
ProProductviewFormattedMdlnameEx- Exports a drawing to the specified userport()
defined Creo View format.
ProIntfimportModelWithOptionsMdl- Imports objects of other formats using a
nameCreate()
profile and creates a new model or set
of models with the specified name and
representation.
Summary of Technical Changes
33
Data Exchange: Import Validation Score
New Function
ProIntfimportValidationscoreCalculate
()
ProIntfimportValidationscoreGet()
ProIntfimportValidationpreferencesLoad()
Description
Calculates the validation score for the
specified model.
Retrieves the validation score for the
specified model.
Loads the preferences file
config.val for data validation.
Data Sharing Features
New Function
ProFeatureDSFDependencystateGet()
ProFeatureDSFDependencystateSet()
Description
Retrieves and sets the dependency
status for the data sharing feature.
Dimensions
New Function
ProDimensionSimpleBreakCreate()
ProDimensionJogCreate()
ProDimensionIsSignDriven()
ProDimensionParentGet()
ProDimensionWitnesslineErase()
ProDimensionWitnesslineShow()
ProDimensionElbowSet()
ProDimensionChamferTextGet()
ProDimensionChamferTextSet()
ProDimensionChamferLeaderGet()
ProDimensionChamferLeaderSet()
ProDimensionConfigGet()
34
Description
Creates a simple break on an existing
dimension witness line.
Creates a jog on an existing dimension
witness line.
Checks if a dimensions uses negative
sign in its value to flip the direction.
Retrieves the parent dimension for the
specified dependent dimension.
Erases the specified witness line from a
dimension.
Shows the erased witness line of the
specified dimension.
Sets the length of the elbow for the
specified dimension.
Gets and sets the dimension scheme for
the specified 45-degree chamfer
dimension.
Gets and sets the display style of the
leader for the specified 45-degree
chamfer dimension.
Gets and sets the display style of the
Creo® Parametric TOOLKIT Release Notes
New Function
ProDimensionConfigSet()
ProDimensionCanRegenerate()
ProDimensionDisplayFormatGet()
ProDimensionDisplayFormatSet()
ProDimensionOriginSideGet()
ProDimensionOriginSideSet()
ProDimensionArrowtypeSet()
ProDimensionDualOptionsGet()
ProDimensionDualOptionsSet()
ProDimensionAdditionalRefsAdd()
ProDimensionAdditionalRefsGet()
ProDimensionAdditionalRefDelete()
ProDrawingDimensionCreate()
Description
specified 45-degree chamfer dimension.
Checks if a driven dimension can be
regenerated.
Gets and sets the format in which the
specified dimension is displayed.
Gets and sets a witness line as origin of
measurement for the specified
dimension.
Sets the arrow type for the specified
arrow in a dimension.
Gets and sets the display options for a
dual dimension.
Adds, retrieves, and deletes semantic
references in the specified dimension.
Creates a dimension in the specified
drawing.
Dimension Text
New Function
ProDimensionTextWstringsGet()
ProDimensionTextWstringsSet()
Description
Gets and sets the text for the specified
dimension.
Dimension Text Style
New Function
ProDrawingDimensionTextstyleGet()
Description
Returns the text style assigned to the
specified dimension or reference
dimension.
Displaying the Color Selection Dialog Box
New Function
ProUIColorSelectionShow()
Summary of Technical Changes
Description
Displays the dialog box used to select
values for the red, green, blue (RGB).
35
Drawing
New Function
ProDrawingFormatSizeGet()
ProDrawingFormatSizeSet()
ProDrawingDimensionsCleanup()
ProDrawingErasedviewSheetGet()
ProDrawingToleranceStandardGet()
ProDrawingToleranceStandardSet()
ProDwgtableByOriginRetrieve()
ProDtlsyminstdataIsInvisible()
Description
Gets and sets the size of the drawing
format in the specified drawing.
Cleans the display and location of the
dimensions in the specified drawing.
Gets the number of the sheet which
contained the view that was erased.
Gets and sets the tolerance standard for
the specified drawing.
Retrieves and places a drawing table in
the drawing at the specified point. The
origin of the table is positioned at the
specified point.
Checks if the specified symbol instance
is invisible.
ECAD Area
New Function
ProElementEcadAreaProColorGet()
ProElementEcadAreaProColorSet()
Description
Gets and sets the color of the specified
ECAD area in the element PRO_E_
ECAD_AREA_COLOR.
External Reference Dependency
New Function
ProExtRefInfoExport()
ProExtRefIsDependency()
ProExtRefDependencyIsBreakable()
ProExtRefBreakDependency()
36
Description
Prints a dependency report.
Indicates if the specified reference is an
external dependency.
Indicates if some of the dependencies
can be broken.
Breaks the external references from the
specified array.
Creo® Parametric TOOLKIT Release Notes
File Handling
New Function
ProFileMdlnameOpen(),
ProFileMdlfiletypeOpen()
ProFileMdlnameSave(),
ProFileMdlfiletypeSave()
ProFileMdlnameParse()
New Function
Opens the dialog box to browse
directories and open files.
Opens the dialog box to save files.
Retrieves the directory path, file name,
extension, and version from the
specified single wide character string.
Features
New Function
ProFeatureIsInFooter()
Description
Checks if the specified feature is
currently located in the model tree
footer.
ProFeatureToFooterMove()
Moves the specified feature into the
regeneration footer.
ProFeatureFromFooterMove()
Moves the specified feature out of the
regeneration footer.
ProMdlFeatBackupOwnerNamesGet() Gets the names of the models, along the
model path, from the top model to the
owner model for the specified feature.
ProMdlFeatBackupRefMdlNamesGet() Gets the names of the models, along the
model path, from the top model to the
external reference model for the
specified feature.
Geometric Tolerances
New Function
ProGtolLeftTextGet()
ProGtolLeftTextSet()
ProGtolBottomTextGet()
ProGtolBottomTextSet()
ProMdlGtolCreate()
ProGtolNameGet()
ProGtolTypeGet()
Summary of Technical Changes
Description
Retrieves and assigns additional text to
the left and bottom of the specified
geometric tolerance control frame.
Creates a new geometric tolerance.
Gets the name of the geometric
tolerance.
Gets and sets the type of geometric
37
New Function
ProGtolTypeSet()
ProGtolTopModelGet()
ProGtolReferencesGet()
ProGtolAttachGet()
ProGtolAttachSet()
ProGtolAttachTypeGet()
ProGtolDatumReferencesGet()
ProGtolDatumReferencesSet()
ProGtolCompositeGet()
ProGtolCompositeSet()
ProGtolValueStringGet()
ProGtolValueStringSet()
ProGtolSymbolStringGet()
ProGtolCompositeShareRefGet()
ProGtolCompositeShareRefSet()
ProGtolAllAroundGet()
ProGtolAllAroundSet()
ProGtolAllOverGet()
ProGtolAllOverSet()
38
Description
tolerance.
Retrieves the model that owns the
specified geometric tolerance.
Retrieves the geometric entities
referenced by the specified geometric
tolerance.
Retrieves and sets the attachment
options for the specified geometric
tolerance.
Retrieves the type of attachment for a
geometric tolerance.
Retrieves and sets the primary,
secondary, and tertiary datum
references for a geometric tolerance.
Retrieves and sets the value and datum
references for the specified composite
geometric tolerance.
Retrieves and sets the value for the
specified geometric tolerance.
Retrieves the string value in the
specified font for the geometric
tolerance symbol.
Checks if the datum references are
shared between all the rows defined in
the composite geometric tolerance.
Specifies if datum references in a
composite geometric tolerance must be
shared between all the defined rows.
Checks if the All Around symbol has
been set for the specified geometric
tolerance.
Sets the All Around symbol for the
specified geometric tolerance.
Checks if the All Over symbol has been
set for the specified geometric
tolerance.
Sets the All Over symbol for the
specified geometric tolerance.
Creo® Parametric TOOLKIT Release Notes
New Function
ProGtolAddlTextBoxedGet()
ProGtolAddlTextBoxedSet()
ProGtolReferencesAdd()
ProGtolReferenceDelete()
ProGtolAttachOffsetItemGet()
ProGtolAttachOffsetItemSet()
ProGtolAttachAlloc()
ProGtolAttachFree()
ProGtolAttachFreeGet()
ProGtolAttachFreeSet()
ProGtolAttachLeadersGet()
ProGtolAttachLeadersSet()
ProGtolAttachOnDatumGet()
ProGtolAttachOnDatumSet()
ProGtolAttachOnAnnotationGet()
ProGtolAttachOnAnnotationSet()
ProGtolAttachMakeDimGet()
ProGtolAttachMakeDimSet()
ProGtolBoundaryDisplayGet()
ProGtolBoundaryDisplaySet()
ProGtolUnilateralGet()
ProGtolUnilateralSet()
ProGtolElbowlengthSet()
Summary of Technical Changes
Description
Checks if a box has been created
around the specified additional text in a
geometric tolerance.
Creates a box around the specified
additional text in a geometric tolerance.
Sets the datum references for the
specified geometric tolerance.
Deletes the specified datum references
in the geometric tolerance.
Retrieves and sets the offset reference
for the specified geometric tolerance
structure.
Allocates a ProGtolAttach
structure.
Frees the ProGtolAttach structure.
Retrieves and sets the annotation plane
and location of text for a free type of
geometric tolerance.
Retrieves and sets the attachment
options for leader type of geometric
tolerance.
Retrieves and sets the datum symbol for
a geometric tolerance.
Retrieves and sets the annotation
associated with the geometric tolerance.
Retrieves and sets the options for a
geometric tolerance created with Make
Dim type of reference.
Checks and sets the boundary modifier
for the specified geometric tolerance.
Checks and sets the profile boundary as
unilateral for the specified geometric
tolerance.
Sets the elbow for the specified
geometric tolerance.
39
New Function
ProGtolIndicatorsGet()
ProGtolIndicatorsSet()
ProGtolValidate()
Description
Retrieves and sets indicators for the
specified geometric tolerance.
Checks if the specified geometric
tolerance is syntactically correct.
Layers
New Function
ProLayerRuleExecute()
ProLayerRuleCopy()
ProLayerRuleMatch()
ProLayerDisplaystatusNoUpdateSet()
ProLayerDisplaystatusUpdate()
Description
Executes the layer rules on the
specified model.
Copies the layer rules from a reference
model to the current model.
Compares the layer rules between the
current and reference models.
Sets the display status of a layer,
without updating the model tree.
Updates the model tree for changes in
the display statuses of all the layers in
the specified model.
Layer State
New Function
ProLayerstateActivestateUpdate()
Description
Updates the layer state which is active
in the model.
LearningConnector
New Function
ProLearningconnectorNotify()
40
Description
Notifies the LearningConnector that an
event has been triggered from a Creo
Parametric TOOLKIT application.
Creo® Parametric TOOLKIT Release Notes
Manufacturing
New Function
Description
ProMfgMdlCreate()
ProToolModelMdlnameGet()
Creates a manufacturing object handle.
Gets the name of the model associated
with the specified tool.
Measuring Geometry
New Function
Description
ProSelectionWithOptionsDistanceEval Evaluates the distance between two
()
selected items.
Messages
New Function
ProMessageWstringbufferAlloc()
Description
Writes a message with any length to an
internal buffer instead of to the Creo
Parametric message area.
Model
New Function
ProMdlDependenciesCleanup()
ProMdlnameInit()
ProMdlnameRename()
ProMdlnameCopy()
ProMdlfileMdlnameCopy()
ProMdlnameBackup()
ProMdlFiletypeLoad()
ProMdlDeclaredDataList()
ProMdlDependenciesDataList()
ProMdlnameRetrieve()
Summary of Technical Changes
Description
Cleans the dependencies for an object
in the Creo Parametric workspace.
Initializes the ProMdl handle.
Renames the specified model.
Saves a copy of the model with the
specified new name.
Saves a copy of the object in memory
to a disk in the specified directory.
Loads the specified object in the current
session.
Retrieves the first-level objects
declared for the specified object.
Retrieves the first-level dependencies
for an object in the Creo Parametric
workspace.
Retrieves the specified model in
41
New Function
ProMdlDisplaynameGet()
ProPathMdlnameCreate()
ProMdlFiletypeGet()
ProFileSubtypeGet()
ProMdlMdlnameGet()
ProMdlOriginGet()
ProMdlExtensionGet()
ProMdlDirectoryPathGet()
ProMdlLocationIsStandard()
Description
memory.
Retrieves the name of the model, which
is displayed in the Creo Parametric user
interface.
Creates a single wide string that
identifies the file, from the inputs such
as, path, file name, extension, and
version.
Retrieves the file type of the specified
model.
Retrieves the file type, model type and
subtype, when the path to a file is
specified as input.
Retrieves the name of the specified
model.
Retrieves the path from where the
specified model has been opened.
Retrieves the file extension for the
specified model.
Retrieves the file path where the
specified model would be saved.
Checks if the specified model was
opened from a standard file location
such as, local disk or a mapped drive on
a remote computer.
Notebook
New Function
ProLayoutRegenerate()
Description
Regenerates the specified notebook (.
lay) file.
Ordinate Dimension
New Function
ProDimensionAutoOrdinateCreate()
42
Description
Creates an ordinate dimension
automatically for the selected surfaces.
Creo® Parametric TOOLKIT Release Notes
Parameters
New Function
ProParameterLockstatusGet()
ProParameterLockstatusSet()
ProParameterValueWithUnitsGet()
ProParameterValueWithUnitsSet()
ProParameterCreateWithUnitsPreAction()
ProParameterModifyWithUnitsPreAction()
Description
Gets and sets the access state of the
specified parameter in the model using
the enumerated data type
ProLockstatus.
Gets and sets the value of a parameter
along with units.
Notification functions that are called
when a parameter is created, modified,
and deleted.
ProParameterModifyWithUnitsPostAction()
ProParameterDeleteWithUnitsPostAction()
ProParameterUnitsAssign()
Assigns the specified unit to a
parameter. It can also convert a
parameter with unit to a unitless
parameter.
Piping
New Function
ProPipelineSpecDrivenCreate()
ProPipelineCreateFromXML()
ProPipelineCreate()
ProPipelineParametersCollect()
ProPipelineParametersSet()
ProPipelineParameterAdd()
ProPipelineParameterDelete()
Summary of Technical Changes
Description
Creates a Specification-Driven pipeline
feature.
Creates a pipeline feature based on the
schematic information defined in the
XML file for the specified pipeline
label.
Creates a Non Specification-Driven
pipeline feature.
Retrieves all the parameters of the
specified pipeline.
Sets the parameters in the specified
pipeline.
Adds and deletes the parameter in the
specified pipeline.
43
Windchill Operators
New Function
ProFileCopyFromWSDocument()
ProFileselectionDocNameGet()
ProDocumentFileContentsRead()
ProServerIsOnline()
Description
Copies a primary or secondary file from
the workspace to a location on disk.
Gets the name of the primary document
for the last selected secondary file.
Reads the contents of the specified file,
which can be located on the local disk
or Windchill.
Checks if the specified server is online
or offline.
References
New Function
ProReferenceOwnerMdlnameGet()
ProReferenceOriginalownerMdlnameGet()
Description
Gets the name of the reference owner
for the referenced geometry item.
Gets the name of the original owner for
the referenced geometry item.
Relations
New Function
ProRelationEvalWithUnits()
ProRelsetUnitsSensitiveSet()
ProRelsetIsUnitsSensitive()
Description
Evaluates a line of a relation set and
outputs the resulting value with its unit.
Sets the condition that units must be
considered while solving the specified
relation.
Checks if units must be considered
while solving the relation.
Setting the Dashboard Title
New Function
Description
ProUIDashboardshowoptionsTitleSet() Sets the title of the dashboard.
44
Creo® Parametric TOOLKIT Release Notes
Set Datum - Datum Feature Symbol
New Function
ProMdlSetdatumtagCreate()
ProMdlSetdatumtagDelete()
ProSetdatumtagLabelGet()
ProSetdatumtagLabelSet()
ProSetdatumtagAdditionalTextGet()
ProSetdatumtagAdditionalTextSet()
ProSetdatumtagElbowGet()
ProSetdatumtagElbowSet()
ProSetdatumtagASMEDisplayGet()
ProSetdatumtagASMEDisplaySet()
ProSetdatumtagReferencesAdd()
ProSetdatumtagReferencesGet()
ProSetdatumtagReferenceDelete()
ProSetdatumtagTextLocationGet()
Description
Creates a new datum feature symbol in
the specified solid or drawing.
Deletes a datum feature symbol.
Gets and sets the label for the specified
datum feature symbol.
Gets and sets additional text for the
specified datum feature symbol.
Gets and sets the display of a leader in
the datum feature symbol to have an
elbow.
Gets and sets the display of the
specified datum feature symbol
according to the ASME standard.
Adds, retrieves, and deletes semantic
references in the specified datum
feature symbol.
Gets the location of the text for the
specified datum feature symbol.
Sheetmetal
New Function
ProSmtBendsrfInfoGet()
Description
Collects all the information related to
the specified bend surface.
Shrinkwrap Features
New Function
Description
ProFeatureIsShrinkwrapRefCopyGeom Checks if the specified feature is a
()
reference copy geometry feature, which
is created by the shrinkwrap feature.
ProFeatureShrinkwrapGetRefCopyGets an array of reference copy
geometry features, which are created by
Geoms()
the shrinkwrap feature.
ProFeatureIsShrinkwrap()
Checks if the specified feature is a
shrinkwrap feature.
Summary of Technical Changes
45
New Function
ProFeatureRefCopyGeomShrinkwrapGet()
ProSolidShrinkwrapMdlnameCreate()
Description
Gets the shrinkwrap feature for the
specified reference copy geometry
feature.
Exports the specified solid model as a
shrinkwrap model.
Simplified Representations
New Function
Description
ProMdlRepresentationFiletypeLoad()
Retrieves the simplified representation
of a model.
ProAssemblySimprepMdlnameRetrieve Retrieves the simplified representation
()
from an assembly.
ProSimprepMdlnameRetrieve()
Retrieves geometry, graphics, symbolic
simplified, boundary box, default
envelope, and light graphics
representations in session.
Sketched Features
New Function
Description
ProFeatureSketchedWithOptionsCreate Creates a feature from the element tree
()
and also copies the sketched sections to
the new feature.
Solids
New Function
ProSolidToleranceStandardGet()
ProSolidToleranceStandardSet()
ProSolidMdlnameInit()
ProSolidMdlnameCreate()
ProSolidDtlsyminstsCollect()
ProSolidDtlsymdefsCollect()
46
Description
Gets and sets the tolerance standard for
the specified solid.
Initializes the ProSolid handle of the
specified type with the specified name.
Creates an empty part or assembly with
the specified name.
Collects symbol instances used in the
specified solid.
Collects symbol definitions used in the
specified solid.
Creo® Parametric TOOLKIT Release Notes
Surfaces
New Function
ProMdlVisibleAppearancepropsGet()
ProMdlVisibleAppearancepropsSet()
ProMdlVisibleTexturepropsGet()
ProMdlVisibleTexturepropsSet()
ProMdlVisibleTextureplacementprops
Get()
ProMdlVisibleTextureplacementprops
Set()
ProSurfacePeriodicityGet()
Description
Gets and sets the surface properties for
the specified part, assembly component,
subassembly, quilt or surface.
Gets and sets the texture properties of
the surface for the specified part,
assembly component, subassembly,
quilt or surface.
Gets and sets the properties related to
the placing of surface texture for the
specified part, assembly component,
subassembly, quilt or surface.
Gets information about the periodicity
of a surface.
Symbol Definition
New Function
ProDtlsyminstDimattachGet()
Description
Retrieves the dimension to which the
specified symbol is attached.
Text Properties
New Function
ProTextStyleColorGetWithDef()
ProTextStyleColorSetWithDef()
ProTextStyleFontGet()
ProTextStyleFontSet()
ProTextStyleValidate()
ProTextStyleVertJustificationGet()
ProTextStyleVertJustificationSet()
Summary of Technical Changes
Description
Retrieves and sets the color for the
specified text object. These functions
also retrieve and set the default color
for text style objects.
Retrieves and set the font for the
specified text.
Checks whether the properties of text
style applied to the specified object
type are valid.
Retrieves and sets the vertical
justification for the specified text style
object.
47
New Function
ProDtlnotetextStyleGet()
ProDtlnotetextStyleSet()
ProDtlnotedataTextStyleGet()
ProDtlnotedataTextStyleSet()
Description
Retrieves and sets the text style for the
specified text.
Retrieves and sets the text style for the
specified note.
User Defined Features (UDF)
New Function
ProUdfmdlMdlnamesAlloc()
Description
Sets a structure, which returns the new
name and the original name, for the
new components created by the UDF
placement.
User Interface: Dialog
New Function
ProUITimerCreate()
ProUIDialogTimerStart()
ProUIDialogTimerStop()
ProUITimerDestroy()
Description
Creates a timer that will execute the
action after specified time interval in
Creo Parametric.
Starts the timer to execute the action
after the specified time interval.
Stops the timer.
Removes the specified timer.
User Interface: Graphics
New Function
ProDispObjectCreate()
ProDispObjectAttach()
ProDispObjectDetach()
ProDispObjectDelete()
ProDispObjectSetTransform()
ProDispObjectSetSurfaceAppearanceProps()
48
Description
Creates a display object which contains
triangle information.
Attaches and detaches a display object
to a Creo Parametric scene.
Deletes the specified display object.
Transforms the display object to the
specified location.
Sets the display properties of the
display object attached to a scene.
Creo® Parametric TOOLKIT Release Notes
User Interface: Tree
New Function
ProUITreeUpdateActionSet()
ProUITreeStateGet()
ProUITreeStateSet()
ProUITreeMixedStateGet()
ProUITreeMixedStateSet()
ProUITreeLastentereditemGet()
Summary of Technical Changes
Description
Sets the update action for the tree.
Gets and sets the checked and
unchecked state of an item in the tree.
Gets and sets the indeterminate state of
an item in the tree.
Gets the name of the item, which was
last pointed to by the pointer.
49
User Interface (UI): Components
New Function
ProUICheckbuttonMinimumsizeGet()
ProUIDrawingareaMinimumsizeGet()
ProUIInputpanelMinimumsizeGet()
Description
Returns the minimum size for the
height and width of a User Interface
(UI) Component.
ProUILabelMinimumsizeGet()
ProUILayoutMinimumsizeGet()
ProUIListMinimumsizeGet()
ProUIOptionmenuMinimumsizeGet()
ProUIProgressbarMinimumsizeGet()
ProUIPushbuttonMinimumsizeGet()
ProUIRadiogroupMinimumsizeGet()
ProUISliderMinimumsizeGet()
ProUISpinboxMinimumsizeGet()
ProUITabMinimumsizeGet()
ProUITableMinimumsizeGet()
ProUITextareaMinimumsizeGet()
ProUIThumbwheelMinimumsizeGet()
ProUITreeMinimumsizeGet()
ProNavigatorpanePHolderHelptextSet() Sets the help text for the navigator pane
component.
ProNavigatorpanePHolderDelete()
Deletes, shows, and hides the specified
pane in the navigation area.
ProNavigatorpanePHolderShow()
ProNavigatorpanePHolderHide()
Version Number of the Creo Parametric
New Function
Description
ProEngineerReleaseNumericversionGet Returns the version number of the Creo
()
Parametric executable to which the
Creo Parametric TOOLKIT application
is connected.
50
Creo® Parametric TOOLKIT Release Notes
Views
New Function
ProViewNameLineGet()
ProViewIdFromNameLineGet()
Description
Gets the name of the view.
Gets the ID of the view.
Welds
New Function
ProMdlIsSolidWeld()
ProWeldGeomTypeGet()
Description
Checks if the specified solid was
created from solid weld.
Gets the type of geometry
representation for the specified weld.
Windows
New Function
ProObjectwindowMdlnameCreate()
Description
Opens a new window containing a
specified solid.
ProAccessorywindowWithTreeMdlna- Opens an accessory window containing
meCreate()
the specified object.
ProBarewindowMdlnameCreate()
Opens a window containing the
specified object. The window does not
have any menus or toolbar.
ProAccessorywindowAboveactivewin- Displays the accessory window always
dowSet()
above the active window.
Zone Feature
New Function
ProFeatureZonesectionGet()
Description
Returns an array of zone reference
planes.
ProFeatureZonesectionWithflipCreate() Creates a zone feature handle with an
option to flip the direction of zone
planes.
ProFeatureZoneXsecgeomGet()
Returns an array of cross section
geometry.
ProFeatureZoneXsecGeomArrayFree() Frees the memory allocated for the
arrays.
ProZoneReferenceArrayFree()
ProZoneReferenceFree()
Summary of Technical Changes
51
Superseded Functions
This section describes the superseded functions for Creo Parametric TOOLKIT
for Creo Parametric 4.0.
Annotations
New Function
Superseded Function
ProAnnotationErase()
ProCombstateAnnotationErase()
ProAnnotationfeatDatumtargetCreate() ProMdlDatumTargetCreate()
Assembly
Superseded Function
ProAsmcompMdlNameGet()
ProAsmcompCreateCopy()
ProAsmSkeletonCreate()
New Function
ProAsmcompMdlMdlnameGet()
ProAsmcompMdlnameCreateCopy()
ProAsmSkeletonMdlnameCreate()
Cavity Layout
Superseded Function
ProCavitylayoutLeaderSet()
ProCavitylayoutModelnamesSet()
ProCavitylayoutModelnamesGet()
New Function
ProCavitylayoutLeaderMdlnameSet()
ProCavitylayoutModelMdlnamesSet()
ProCavitylayoutModelMdlnamesGet()
Configuration Option
Superseded Function
ProConfigoptGet()
New Function
ProConfigoptionGet()
Copied References
Superseded Function
ProFeatureCopiedRefStateGet()
Enumerated data type
ProCopiedRefState
52
New Function
ProFeatureCopiedRefStateDetailsGet()
Enumerated data type
ProCopiedRefStateDetails
Creo® Parametric TOOLKIT Release Notes
Cross Section
Superseded Function
ProXsecPlanarCreate()
New Function
ProXsecPlanarWithoptionsCreate()
Data Exchange
New Function
ProOutputFileMdlnameWrite()
Pro2dImportMdlnameCreate()
ProIntfSliceFileWithOptionsMdlnameExport()
ProATBVerify()
ProATBMdlnameVerify()
ProSolidShrinkwrapCreate()
ProSolidShrinkwrapMdlnameCreate()
ProProductviewFormattedExport()
ProProductviewFormattedMdlnameExport()
ProIntfimportModelCreate()
ProIntfimportModelWithOptionsCreate
()
ProIntfimportModelWithOptionsCreate ProIntfimportModelWithOptionsMdl()
nameCreate()
Superseded Function
ProOutputFileWrite()
Pro2dImportCreate()
ProIntfSliceFileWithOptionsExport()
Data Sharing Features
Superseded Function
ProFeatureCopyGeomDependSet()
New Function
ProFeatureDSFDependencystateSet()
ProFeatureCopyGeomInDependSet()
Detail Note Data
Superseded Function
ProDtlnotedataMirrorSet()
ProDtlnotedataIsMirrored()
ProDtlnotedataColorGet()
ProDtlnotedataColorSet()
ProDtlnotedataAngleGet()
ProDtlnotedataAngleSet()
ProDtlnotetextHeightGet()
ProDtlnotetextHeightSet()
Summary of Technical Changes
New Function
ProTextStyleMirrorSet()
ProTextStyleMirrorGet()
ProTextStyleColorGetWithDef()
ProTextStyleColorSetWithDef()
ProTextStyleAngleGet()
ProTextStyleAngleSet()
ProTextStyleHeightGet()
ProTextStyleHeightSet()
53
Superseded Function
ProDtlnotetextWidthGet()
ProDtlnotetextWidthSet()
ProDtlnotetextSlantGet()
ProDtlnotetextSlantSet()
ProDtlnotetextThicknessGet()
ProDtlnotetextThicknessSet()
ProDtlnotetextFontGet()
ProDtlnotetextFontSet()
ProDtlnotedataJustifGet()
New Function
ProTextStyleWidthGet()
ProTextStyleWidthSet()
ProTextStyleSlantAngleGet()
ProTextStyleSlantAngleSet()
ProTextStyleThicknessGet()
ProTextStyleThicknessSet()
ProTextStyleFontGet()
ProTextStyleFontSet()
ProTextStyleJustificationGet()
ProDtlnotedataJustifSet()
ProTextStyleVertJustificationGet()
ProTextStyleJustificationSet()
ProTextStyleVertJustificationSet()
Dimensions
Superseded Function
ProDimensionElbowlengthSet()
ProDimensionChamferstyleGet()
New Function
ProDimensionElbowSet()
ProDimensionChamferTextGet()
ProDimensionChamferstyleSet()
ProDimensionChamferLdrstyleGet()
ProDimensionChamferTextSet()
ProDimensionChamferLeaderGet()
ProDimensionChamferLdrstyleSet()
ProDimensionConfigurationGet()
ProDimensionChamferLeaderSet()
ProDimensionConfigGet()
ProDimensionConfigurationSet()
ProDrawingDimensionTextstyleGet()
ProDimensionCanRegen()
ProDrawingDimCreate()
ProDimensionConfigSet()
ProAnnotationTextstyleGet()
ProDimensionCanRegenerate()
ProDrawingDimensionCreate()
Family Table Instances
Superseded Function
ProFaminstanceCreate()
54
New Function
ProFaminstanceRetrieve()
Creo® Parametric TOOLKIT Release Notes
File Handling
Superseded Function
ProFileOpen()
ProFileSave()
ProFilenameParse()
ProPathCreate()
New Function
ProFileMdlnameOpen(),
ProFileMdlfiletypeOpen()
ProFileMdlnameSave(),
ProFileMdlfiletypeSave()
ProFileMdlnameParse()
ProPathMdlnameCreate()
Geometric Tolerances
Superseded Function
ProGtolDataGet()
ProGtolEditCancel
New Function
NA
NA
ProGtolEditCommit()
ProGtolEditInit()
ProGtoldataTypeGet()
ProGtoldataTypeSet()
ProGtoldataOwnerGet()
ProGtoldataReferenceGet()
ProGtoldataPlacementGet()
ProGtolTypeGet()
ProGtolTypeSet()
ProGtolTopModelGet()
ProGtolReferencesGet()
ProGtolAttachGet()
ProGtoldataPlaneGet()
ProGtoldataModelGet()
ProGtoldataModelSet()
ProGtoldatumrefFree()
ProGtoldataGtoldatumrefGet()
NA
NA
NA
ProGtolDatumReferencesGet()
ProGtoldatumrefGet()
ProGtoldatumrefTranslationGet()
ProGtoldatumrefAlloc()
ProGtolDatumReferencesSet()
ProGtoldatumrefTranslationSet()
ProGtoldataGtoldatumrefSet()
ProGtoldataCompositeGet()
ProGtoldataCompositeSet()
ProGtoldataValueGet()
ProGtolCompositeGet()
ProGtolCompositeSet()
ProGtolValueStringGet()
ProGtoldataUnitareaStyleGet()
Summary of Technical Changes
55
Superseded Function
New Function
ProGtoldataDispositionValGet()
ProGtoldataValueSet()
ProGtolValueStringSet()
ProGtoldataUnitareaStyleSet()
ProGtoldataDispositionValSet()
ProGtoldataPerUnitGet()
ProGtolCompositeShareRefGet()
ProGtoldataPerUnitSet()
ProGtoldataTangentPlaneGet()
ProGtolCompositeShareRefSet()
ProGtolValueStringGet()
ProGtoldataDiameterGet()
ProGtolSymbolStringGet()
ProGtoldataStatTolGet()
ProGtoldataFreeStateGet()
ProGtoldataMatCondGet()
ProGtoldataTangentPlaneSet()
ProGtolSymbolStringGet()
ProGtoldataDiameterSet()
ProGtolValueStringSet()
ProGtoldataStatTolSet()
ProGtoldataFreeStateSet()
ProGtoldataMatCondSet()
ProGtoldataASMEY1441Get()
NA
ProGtoldataASMEY1441Set()
ProGtoldataProjZoneGet()
NA
ProGtoldataProjZoneSet()
ProGtoldataAlloverGet()
ProGtoldataAlloverSet()
ProGtoldataAllAroundGet()
ProGtoldataAllAroundSet()
ProGtoldatumrefAlloc()
ProGtoldataAlloc()
ProGtolCreate()
ProGtoldataReferenceSet()
ProGtolAllOverGet()
ProGtolAllOverSet()
ProGtolAllAroundGet()
ProGtolAllAroundSet()
ProGtolDatumReferencesSet()
NA
ProMdlGtolCreate()
ProGtolReferencesAdd()
ProGtoldataPlacementSet()
ProGtolReferenceDelete()
ProGtolAttachSet()
ProGtoldataPlaneSet()
ProGtolValueSet()
ProGtoldataNumdigitsGet()
ProGtolValueStringSet()
NA
56
Creo® Parametric TOOLKIT Release Notes
Superseded Function
New Function
ProGtoldataNumdigitsSet()
ProGtoldataFree()
ProGtoldataNumdigitsGet()
NA
NA
ProGtoldataNumdigitsSet()
Manufacturing
Superseded Function
New Function
ProMfgCreate()
ProToolModelGet()
ProMfgMdlCreate()
ProToolModelMdlnameGet()
Model
Superseded Function
ProMdlInit()
ProMdlRename()
ProMdlCopy()
ProMdlBackup()
ProMdlRetrieve()
ProMdlLoad()
ProMdlfileCopy()
ProMdlNameGet()
ProMdlDataGet()
ProMdlDeclaredList()
ProMdlDependenciesList()
ProMdlRepresentationLoad()
New Function
ProMdlnameInit()
ProMdlnameRename()
ProMdlnameCopy()
ProMdlnameBackup()
ProMdlnameRetrieve()
ProMdlFiletypeLoad()
ProMdlfileMdlnameCopy()
ProMdlMdlnameGet()
ProMdlMdlnameGet(),
ProMdlOriginGet(),
ProMdlExtensionGet(),
ProMdlDirectoryPathGet()
ProMdlDeclaredDataList()
ProMdlDependenciesDataList()
ProMdlRepresentationFiletypeLoad()
Parameters
Superseded Function
New Function
ProParameterValueGet()
ProParameterValueSet()
ProParameterValueWithUnitsGet()
ProParameterValueWithUnitsSet()
Summary of Technical Changes
57
Superseded Function
ProParameterCreatePreAction()
ProParameterModifyPreAction()
ProParameterModifyPostAction()
ProParameterDeletePostAction()
New Function
ProParameterCreateWithUnitsPreAction()
ProParameterModifyWithUnitsPreAction()
ProParameterModifyWithUnitsPostAction()
ProParameterDeleteWithUnitsPostAction()
Creo Simulate
Contact Interface
Superseded Function
ProMechcontactinterfacedataInfiniteFrictionGet()
ProMechcontactinterfacedataInfiniteFrictionSet()
New Function
ProMechcontactinterfacedataFrictionGet()
ProMechcontactinterfacedataFrictionSet()
References
Superseded Function
ProReferenceOwnernameGet()
ProReferenceOriginalownernameGet()
New Function
ProReferenceOwnerMdlnameGet()
ProReferenceOriginalownerMdlnameGet()
Relations
Superseded Function
ProRelationEval()
New Function
ProRelationEvalWithUnits()
Set Datum - Datum Feature Symbol
Superseded Function
ProSetdatumtagCreate()
58
New Function
ProMdlSetdatumtagCreate()
Creo® Parametric TOOLKIT Release Notes
Simplified Representation
Superseded Function
ProGraphicsSimprepRetrieve()
ProGeomSimprepRetrieve()
ProSymbSimprepRetrieve()
ProBoundaryBoxSimprepRetrieve()
ProDefaultEnvelopeSimprepRetrieve()
ProLightweightGraphicsSimprepRetrieve()
ProAssemblySimprepRetrieve()
ProPartSimprepRetrieve()
New Function
ProSimprepMdlnameRetrieve()
ProSimprepMdlnameRetrieve()
ProSimprepMdlnameRetrieve()
ProSimprepMdlnameRetrieve()
ProSimprepMdlnameRetrieve()
ProSimprepMdlnameRetrieve()
ProAssemblySimprepMdlnameRetrieve
()
ProSimprepMdlnameRetrieve()
Sketched Features
Superseded Function
ProFeatureSketchedCreate()
New Function
ProFeatureSketchedWithOptionsCreate
()
Solids
Superseded Function
ProSolidInit()
ProSolidCreate()
New Function
ProSolidMdlnameInit()
ProSolidMdlnameCreate()
Text Style
Superseded Function
ProTextStyleColorGet()
ProTextStyleColorSet()
New Function
ProTextStyleColorGetWithDef()
ProTextStyleColorSetWithDef()
User Defined Feature(UDF)
Superseded Function
ProUdfmdlNamesAlloc()
Summary of Technical Changes
New Function
ProUdfmdlMdlnamesAlloc()
59
Views
Superseded Function
ProViewNameGet()
ProViewIdFromNameGet()
New Function
ProViewNameLineGet()
ProViewIdFromNameLineGet()
Windows
Superseded Function
New Function
ProObjectwindowCreate()
ProObjectwindowMdlnameCreate()
ProAccessorywindowWithTreeCreate() ProAccessorywindowWithTreeMdlnameCreate()
ProBarewindowCreate()
ProBarewindowMdlnameCreate()
Material Type and Material Surface Finish Types for
Fatigue Analysis
From Creo Parametric 3.0 onward, the material types PRO_MATERIAL_
FATIGUE_MAT_TYPE_UNALLOYED_STEELS and PRO_MATERIAL_
FATIGUE_MAT_TYPE_LOW_ALLOY_STEELS are obsolete. Use the material
type PRO_MATERIAL_FATIGUE_MAT_TYPE_FERROUS instead. The
following surface finish types for fatigue analysis are also obsolete:
•
•
•
•
•
PRO_MATERIAL_FATIGUE_FINISH_FORGED
PRO_MATERIAL_FATIGUE_FINISH_WATER_CORRODED
PRO_MATERIAL_FATIGUE_FINISH_SEA_WATER_CORRODED
PRO_MATERIAL_FATIGUE_FINISH_NITIRIDED
PRO_MATERIAL_FATIGUE_FINISH_SHOT_PEENED
Support for Legacy and Native Encoding
From Creo Parametric 3.0 onward, the following legacy and native encoding
functions have been deprecated. These functions will be obsoleted in a future
release of Creo Parametric:
•
•
•
•
•
•
60
ProNativestringToString()
ProNativestringToWstring()
ProStringToNativestring()
ProStringToNativewstring()
ProNativewstringToString()
ProNativewstringToWstring()
Creo® Parametric TOOLKIT Release Notes
•
•
•
•
•
•
•
•
ProWstringToNativewstring()
ProWstringToNativestring()
ProLegacystringToString()
ProStringToLegacystring()
ProLegacystringToWstring()
ProWstringToLegacystring()
ProToolkitUnicodeencodingDisable()
ProToolkitUnicodeencodingIsEnabled()
Support for Legacy Pro/TOOLKIT Functions
From Creo Parametric 4.0 F000 onward, the following header files along with
their functions have been obsoleted:
•
•
•
•
ProLayerR19.h
ProAsmcompR20.h
ProParameterRWildfire.h
ProViewRWildfire2.h
In your applications, you must replace APIs from these header files with
recommended equivalent Creo Parametric TOOLKIT functions. After replacing
the APIs, you must rebuild your applications.
The following table lists the obsoleted and equivalent functions:
Obsoleted Function
Assembly
ProAsmcompR20.h
ProAsmcompPackageMoveR20()
Layers
ProLayerR19.h
ProLayerCreateR19()
ProLayerDeleteR19()
ProLayerItemsGetR19()
ProMdlLayerNamesGetR19()
ProLayerDisplaystatusGetR19()
ProLayerItemAddR19()
ProLayerItemRemoveR19()
ProLayerDisplaystatusSetR19()
Parameters
ProParameterRWildfire.h
Summary of Technical Changes
New Function
ProAsmcompPackageMove()
ProLayerCreate()
ProLayerDelete()
ProLayerItemsGet()
Contextual menu available
ProLayerDisplaystatusGet()
ProLayerItemAdd()
ProLayerItemRemove()
ProLayerDisplaystatusSet()
61
Obsoleted Function
ProParameterSelectRWildfire()
Views
ProViewRWildfire2.h
ProViewNamesGetRWildfire2()
New Function
ProParameterSelect()
ProViewNamesGet()
Support for Windchill ProductPoint
From Creo Parametric 3.0 F000 onward, the header file ProWpp.h along with its
functions has been obsoleted as Windchill ProductPoint is no longer supported.
Support for Notification Events and Callback
Functions
From Creo Parametric 3.0 onward, the following events and callback functions
have been deprecated. You must use the new events and callback functions
instead.
Superseded Event
type
New Event type
Superseded Callback New Callback typedef
typedef
Pre-file Management Events
PRO_MDL_SAVE_PRE PRO_MODEL_SAVE_
PRE
PRO_MDL_COPY_PRE PRO_MODEL_COPY_
PRE
PRO_MDL_RENAME_
PRO_MODEL_RENAME_
PRE
PRE
PRO_MDL_RETRIEVE_ PRO_MODEL_
PRE
RETRIEVE_PRE
ProMdlSavePreAc
tion
ProMdlCopyPreAc
tion
ProMdlRenamePreAc
tion
ProMdlRetrievePre
Action
ProModelSavePreAc
tion
ProModelCopyPreAc
tion
ProModelRenamePre
Action
ProModelRetrieveP
reAction
Post-file Management Events
PRO_MDL_SAVE_POST PRO_MODEL_SAVE_
POST
PRO_MDL_COPY_POST PRO_MODEL_COPY_
POST
PRO_MDL_RENAME_
PRO_MODEL_RENAME_
POST
POST
PRO_MDL_ERASE_
PRO_MODEL_ERASE_
POST
POST
PRO_MDL_RETRIEVE_ PRO_MODEL_
POST
RETRIEVE_POST
ProMdlSavePostAc
tion
ProMdlCopyPostAc
tion
ProMdlRenamePos
tAction
ProMdlErasePostAc
tion
ProMdlRetrievePos
tAction
ProModelSavePos
tAction
ProModelCopyPos
tAction
ProModelRenamePos
tAction
ProModelErasePos
tAction
ProModelRetrieve
PostAction
Post All File Management Events
PRO_MDL_SAVE_
PRO_MODEL_SAVE_
POST_ALL
POST_ALL
ProMdlSavePostAl
lAction
ProModelSavePos
tAllAction
PRO_MDL_COPY_
POST_ALL
PRO_MODEL_COPY_
POST_ALL
ProMdlCopyPostAl
lAction
ProModelCopyPos
tAllAction
PRO_MDL_ERASE_
POST_ALL
PRO_MODEL_ERASE_
POST_ALL
ProMdlErasePostAl ProModelErasePos
lAction
tAllAction
PRO_MDL_RETRIEVE_ PRO_MODEL_
62
ProMdlRetrievePos ProModelRetrieve
Creo® Parametric TOOLKIT Release Notes
Superseded Event
type
POST_ALL
New Event type
Superseded Callback New Callback typedef
typedef
RETRIEVE_POST_ALL tAllAction
File Management Failed Events
PRO_MDL_DBMS_
PRO_MODEL_DBMS_
FAILURE
FAILURE
PostAllAction
ProMdlDbmsFailure ProModelDbmsFailu
Action
reAction
Support for Pro/INTRALINK 3.4 Functions
From Creo Parametric 1.0, M050 onward, the following Pro/INTRALINK 3.4
functions have been deprecated. The corresponding functions can be used only
after migrating to Pro/INTRALINK 10.0.
Superseded Function
ProCurrentWorkspaceGet()
New Function
ProServerWorkspaceGet()
ProWorkspaceRegister()
ProObjModelsCheckOut()
ProServerWorkspacesCollect()
ProServerRegister()
ProServerObjectsCheckout()
ProEngineerConnectWS()
ProObjRenamedInWSSessionSync()
ProWorkspaceStatusUpdate()
ProServerMultiobjectsCheckout()
ProEngineerConnect()
No equivalent function
No equivalent function
Support for Pro2dCadamImportCreate()
The obsolete function Pro2dCadamImportCreate() has been removed from
the header file ProUtil.h.
Support for ProMirrorGeometry.h
From Creo Parametric 2.0 M070 onward, the header file
ProMirrorGeometry.h is no longer supported. Use the header file
ProFlexMirror.h instead to mirror geometry.
Miscellaneous Technical Changes
The following changes in Creo Parametric 4.0 can affect the functional behavior
of Creo Parametric TOOLKIT. PTC does not anticipate that these changes cause
critical issues with existing Creo Parametric TOOLKIT, Creo Elements/Pro
TOOLKIT, or Pro/TOOLKIT applications.
Summary of Technical Changes
63
Adding Sketch Constraints as Layer Item
From Creo Parametric 3.0 onward, a new value PRO_LAYER_SKETCH_
CONSTRAINT has been added to the enumerated data type ProLayerType in
the header file ProLayer.h. You can now specify the constraints on a sketch as
a layer item in layouts.
Additional Constraints, Midplane, Bisector 1 and
Bisector 2 Added for Datum Plane Creation
From Creo Parametric 4.0 F000 onward, the following new constraints have been
added to the enumerated data type ProDtmplnConstrType:
•
•
•
PRO_DTMPLN_MIDPLN—Places the new datum plane half way between two
parallel references, or places it to bisect the angle formed by two nonparallel
references.
PRO_DTMPLN_BISECTOR1—Places the new datum plane to bisect the α
angle formed by the two references.
PRO_DTMPLN_BISECTOR2—Places the new datum plane to bisect the
(180° - α) angle formed by the two references.
Additional Display Format for Dimension Tolerance
From Creo Parametric 4.0 F000 onward, an additional display format PRO_DIM_
TOL_BASIC has been added to the enumerated data type
ProDimToleranceType for dimension tolerance. This option enables you to
display the dimensions as basic dimensions. Tolerances are not displayed in basic
dimensions.
Adding Table Column and Row Values as a Fraction
From Creo Parametric 2.0 2.0 M210 onward, a new value PRODWGTABLESIZE_
CHARS_TRUE has been added to the enumerated data type
ProDwgtableSizetype. This option enables you to specify a fractional value
for the width of a column and height of a row. The size is set in characters.
Arc Length Added as Dimension Type
From Creo Parametric 4.0 F000 onward, a new type of dimension
PRODIMTYPE_ARC_LENGTH has been added to the enumerated data type
ProDimensiontype. The value indicates arc length type of dimension.
64
Creo® Parametric TOOLKIT Release Notes
Change in the Duration for ProUIDialogTimerStart()
From Creo Parametric 2.0 M180 onward, in the function
ProUIDialogTimerStart() the minimum time interval for the input
argument duration has been changed from 500 milliseconds to 100
milliseconds.
Capping and Attaching an Extrude and Revolve Thin
Feature
From Creo Parametric 4.0 F000 onward, a new element PRO_E_FEAT_THIN has
been added to the extrude and revolve element trees, which are defined in the
header files ProExtrude.h and ProRevolve.h respectively. The element
enables you to specify how a thin extruded or thin revolved feature must be
capped and attached to the solid geometry of a model.
Chamfer Leader Style
From Creo Parametric 4.0 F000 onward, a new display style PRO_DIM_CHMFR_
LEADER_STYLE_LINEAR has been added to the enumerated data type
ProDimChamferLeaderStyle. You can set linear style of display for leaders
of chamfer dimensions.
Creating Dimensions with Intersection Type of
Reference
From Creo Parametric 3.0 onward, you can create dimensions that have
intersection type of reference. The functions ProDimensionCreate(),
ProDimensionAttachmentsGet(),
ProDimensionAttachmentsSet(), and ProDrawingDimCreate()
support dimensions with intersection type of reference.
Configuration Flag to Include Annotations During
Export of Creo Parametric Models
From Creo Parametric 3.0 onward, a new configuration flag PRO_EXPORT_
INCLUDE_ANNOTATIONS has been added. The flag includes annotations during
the export of Creo Parametric model to the specified format.
Summary of Technical Changes
65
Configuration Option for Displaying Accessory
Window on Top
From Creo Parametric 2.0 M100 onward, a new configuration option
accessory_window_above allows you to control the display of accessory
window on top of the active window.
Display Style for Views
From Creo Parametric 3.0 M010 onward, a new display type PRO_DISPSTYLE_
SHADED_WITH_EDGES has been added to the enumerated data type
ProDisplayStyle. This option allows you to display the model as a shaded
solid along with its edges.
Draft Angle and Taper Angle During Extrude
From Creo Parametric 3.0 onward, you can specify the draft angle in draft feature
and the taper angle in extrude feature in the range of -89.9 to 89.9 degrees.
Elements to Set the Properties of a Datum
Coordinate System Feature
From Creo Parametric 4.0 F000 onward, the following elements have been added
in the element tree for Datum Coordinate System feature defined in the header file
ProDtmCsys.h:
•
•
•
PRO_E_CSYS_NAME_DISPLAY_OPT—Specifies if the name of the datum
coordinate system must be displayed in the graphics window.
PRO_E_CSYS_DISPLAY_ZOOM_DEP_OPT—Specifies if the size of the
coordinate system is dependent on the zoom of the model.
PRO_E_CSYS_AXIS_LENGTH—Specifies the default length for the
coordinate system axes.
Extruding upto the Offset or Translation of a
Reference Element
From Creo Parametric 4.0 F000 onward, the extrude option PRO_EXT_DEPTH_
TO_REF, which extrudes upto a selected point, curve, plane, or surface, enables
you to specify an offset or translation value from the reference element. The
feature will be extruded upto the offset or translation value specified for the
selected reference point, curve, plane, or surface. The offset and translation values
66
Creo® Parametric TOOLKIT Release Notes
can be specified for Side 1 and Side 2. The following new elements have been
added to the extrude element tree, which is defined in the header file
ProExtrude.h:
•
•
•
•
PRO_E_EXT_DEPTH_TO_REF_TRF
PRO_E_EXT_DEPTH_TO_REF_TRF_VAL
PRO_E_EXT_DEPTH_FROM_REF_TRF
PRO_E_EXT_DEPTH_FROM_REF_TRF_VAL
Data Exchange
This section explains the changes in Data Exchange.
Export Option writeWhichFiles Added to the JT
Configuration File
From Creo 4.0 F000 onward, a new export option writeWhichFiles has been
added to the JT configuration file jt.config. The option enables you to specify
if the product structure, parts, or the entire assembly with parts must be exported
to JT format.
Include Annotations in the Export of Creo Parametric
Models as U3D Graphics in a PDF File
From Creo Parametric 3.0 onward, a new export option PRO_PDFOPT_INCL_
ANNOT has been added to the enumerated data type ProPDFOptionType. You
can specify if annotations must be included when a Creo Parametric model is
exported as U3D graphics in a PDF file.
Importing Solid Edge Part and Sheet Metal Part as Features
From Creo Parametric 3.0 M020 onward, you can import Soild Edge part and
sheet metal part as features. To import, use the following values added to
enumerated data type ProIntfType:
•
•
PRO_INTF_SE_PART
PRO_INTF_SE_SHEETMETAL_PART
Support Color Override During the Import of Solid Edge
Models
From Creo Parametric 3.0 M030 onward, Solid Edge models are imported to Creo
Parametric with their color overrides. Components with color overrides at any
level in an assembly structure are supported.
Summary of Technical Changes
67
Support Import of Creo Elements/Direct Drafting Files
From Creo Parametric 3.0 onward, you can import and append the Creo Elements/
Direct drafting files of type .mi, .bi and .bdl using Creo Parametric
TOOLKIT functions Pro2dImportMdlnameCreate() and
Pro2dImportAppend(). You can import basic drawing entities and their
attributes, tolerances, sheets, layers, and so on from the Creo Elements/Direct
drafting files to Creo Parametric drawing file.
A new drawing file type PRO_CCD_DRAWING_FILE has been added in the
enumerated type ProImportExportFile for Creo Elements/Direct drafting
files.
Support Export of Creo Parametric Parts and Assemblies to
SolidWorks
From Creo Parametric 3.0 onward, you can export Creo Parametric part and
assembly models to SolidWorks using the enumerated values:
•
•
PRO_INTF_EXPORT_SW_PART
PRO_INTF_EXPORT_SW_ASSEM
Support Export of Creo Parametric Parts and Assemblies to
Additive Manufacturing File Format
From Creo Parametric 4.0 F000 onward, you can export Creo Parametric part and
assembly models to additive manufacturing file (AMF) format using the function
ProIntfSliceFileWithOptionsMdlnameExport(). The new file type
PRO_AMF_FILE added to the enumerated data type ProImportExportFile
supports export to the AMF format.
Support Import and Export of Cross Section from JT to Creo
Parametric
From Creo Parametric 3.0 onward, you can import and export the planar and zonal
cross-sections of part and assembly models between JT and Creo Parametric files.
Support Import of Clipping Features from Creo Elements/
Direct to Creo Parametric
From Creo Parametric 3.0 onward, you can import the clipping features owned by
Creo Elements/Direct part and assembly models as cross-sections in Creo
Parametric.
68
Creo® Parametric TOOLKIT Release Notes
Support Import of Solid Edge Part, Sheet Metal Part, and
Assembly Models to Creo Parametric
From Creo Parametric 3.0 M010 onward, you can import Solid Edge part and
assembly models to Creo Parametric using the enumerated values:
•
•
PRO_INTF_IMPORT_SEDGE_PART
PRO_INTF_IMPORT_SEDGE_ASSEMBLY
From Creo Parametric 3.0 M020 onward, you can also import a Solid Edge sheet
metal part to Creo Parametric. To import, use the value PRO_INTF_IMPORT_
SEDGE_SHEETMETAL_PART added to the enumerated data type
ProIntfImportType.
Support Product Manufacturing Information (PMI) in Creo
Elements/Direct and JT Files
From Creo Parametric 3.0 onward, you can import 3D notes and basic dimensions
as semantic representation from Creo Elements/Direct and JT models to Creo
Parametric models.
You can also export these annotations as semantic representation from Creo
Parametric to JT models.
Documentation Updated for Element PRO_E_TOOL_
MTN_TURN_CORNER_ARR
The element tree documentation for the element PRO_E_TOOL_MTN_TURN_
CORNER_ARR in the header files ProMfgElemToolMtnProfTurn.h,
ProMfgElemToolMtnGrooveTurn.h, and
ProMfgElemToolMtnAreaTurn.h has been updated in Creo Parametric 2.0
M110. The element is now correctly documented as the child of PRO_E_TOOL_
MTN_TURN_PROF.
Documentation Updated for PRO_LAYER_XSEC
The layer item type PRO_LAYER_XSEC defined in the data type
ProLayerType is not supported in Creo Parametric TOOLKIT. The
documentation for PRO_LAYER_XSEC has been updated in the header file
ProFeature.h to reflect this.
Summary of Technical Changes
69
Documentation Updated for
ProAsmcompConstraintsSet()
The documentation for the function ProAsmcompConstraintsSet() in the
header file ProAsmcomp.h has been updated in Creo Parametric 2.0 M100 to
correctly reflect its behavior.
Documentation Updated for
ProCablingNeutralwirelistImport()
The documentation for the function
ProCablingNeutralwirelistImport() in the header file
ProCabling.h has been updated in Creo Parametric 2.0 M130 to correctly
reflect its behavior. The first input argument has been updated to document the
ProAssembly object.
Documentation Updated for
ProDimensionAnnotationelemCreate()
The documentation for the function
ProDimensionAnnotationelemCreate() in the header file
ProDimension.h has been updated in Creo Parametric 3.0 M050 to include
the error type PRO_TK_NOT_VALID. The error indicates that the driving
dimension annotation element (DDAE) was not created because the orientation
defined for the annotation was not in frozen state.
Documentation Updated for
ProElementCollectionGet() and
ProElementCollectionSet()
The documentation for the functions ProElementCollectionGet() and
ProElementCollectionSet() in the header file ProElement.h has
been updated in Creo Parametric 4.0 F000. The documentation for the functions
has been updated to reflect the correct element type PRO_E_STD_CURVE_
COLLECTION_APPL.
Documentation Updated for ProMdlGtolVisit()
The documentation for the function ProMdlGtolVisit() in the header file
ProMdl.h has been updated in Creo Parametric 3.0 M040 to include all the error
types returned by the function. The error types PRO_TK_BAD_INPUTS, PRO_
TK_GENERAL_ERROR, and PRO_TK_E_NOT_FOUND have been documented.
The error type PRO_TK_BAD_INPUTS specifies that one or more inputs are not
valid. PRO_TK_GENERAL_ERROR specifies that the function visit has been
70
Creo® Parametric TOOLKIT Release Notes
stopped by a value returned by the visit action. PRO_TK_E_NOT_FOUND
indicates that there are no valid geometric tolerances defined in the specified
model.
Documentation Updated for ProModelIsTIM() and
ProModelListTIMFeatures()
The documentation for the functions ProModelIsTIM() and
ProModelListTIMFeatures() in the header file ProATB.h has been
updated in Creo Parametric 3.0 to correctly reflect their behavior.
Documentation Updated for
ProServerObjectIsModified() and
ProServerObjectStatusGet()
The documentation for the output arguments modifiedLocally and
modified for the functions ProServerObjectIsModified() and
ProServerObjectStatusGet() respectively was incorrect in the header
file ProWTUtils.h. The documentation has been updated in Creo Parametric
2.0 M070. The arguments return PRO_B_TRUE when the object is modified and
saved in the local workspace cache.
ECAD Area Feature
From Creo Parametric 3.0 onward, the element PRO_E_ECAD_AREA_COLOR
has been added to the ECAD area element tree which is defined in the header file
ProEcadArea.h. It specifies the color of the ECAD area. The new functions
ProElementEcadAreaProColorGet() and
ProElementEcadAreaProColorSet() are used to get and set the color for
this element.
From Creo Parametric 3.0 M040 onward, a new type of ECAD area PRO_ECAD_
AREA_TYPE_USER_DEFINED has been added to the enumerated data type
ProEcadAreaType. It specifies a user-defined area. The element PRO_E_
ECAD_AREA_USER_DEF_TYPE has been added to the ECAD area element tree
which is defined in the header file ProEcadArea.h. It specifies the name of a
user-defined area.
Edit Chamfer Feature
You can modify an edge chamfer feature using the element tree in the header file
ProModifyChamfer.h.
Summary of Technical Changes
71
Enhancement to Flange or Unattached Wall feature
From Creo Parametric 2.0 onward, the functionality for flange feature, or
unattached wall feature has been enhanced and the default value for the step PRO_
E_SMT_WALL_SHARPS_TO_BENDS has been changed to PRO_B_TRUE. To
retain earlier behavior of the feature, set the default value of this step to PRO_B_
FALSE.
Forward compatibility for legacy Toolkit applications that do not explicitly define
the step PRO_E_SMT_WALL_SHARPS_TO_BENDS will be broken. To work
around this issue set the configuration option smt_add_bends_on_sharp_
edges to no in the Creo Parametric session before running the application.
Enhancement to Hole Feature
From Creo Parametric 4.0 F000 onward, the following elements have been added
to the Hole element tree, which is defined in the header file ProHole.h:
•
•
•
PRO_E_HLE_TOP_CLEARANCE—Specifies if the material at the top of the
hole must be removed to create a clearance
PRO_E_HLE_FT_DIR_REF—Specifies the references that will be used to
orient the direction of hole.
PRO_E_HLE_FT_DIR_OPT—Specifies the direction in which the hole is
oriented, perpendicular or parallel, to the orientation references.
Exporting Quilts in a Model
From Creo Parametric 2.0 M040 onward, a new configuration flag PRO_FACET_
INCLUDE_QUILTS has been added in the header file ProUtil.h. You can use
the function ProOutputInclusionWithOptionsSet() to set the
configuration flag to include quilts in the export of facets of a Creo Parametric
model to the specified format.
Fifth Argument of the function ProSelect()
From Creo Parametric 1.0 M040 onward, the fifth argument (sel_env) of the
function ProSelect() allows the user to pass a set of attributes using the
function ProSelectionEnvAlloc().
Finding a Harness
The description for the function ProAssemblyHarnessesCollect() has
been updated. It now reads as:
The function ProAssemblyHarnessesCollect() returns an array of
handles to any harness that is part of a specified assembly and its sub-assemblies.
72
Creo® Parametric TOOLKIT Release Notes
Flexible Modeling
This section explains the changes in the area of Flexible Modeling.
Attaching Using Information Stored in Intent Objects
From Creo Parametric 4.0 F000 onward, the following elements have been added
to the Attach feature element tree defined in the header file
ProFlexAttach.h:
•
•
PRO_E_OPT_ATTACH_PIO—Specifies if quilt should be attached to model
geometry using the attachment information stored in the intent objects.
PRO_E_OPT_ATTACH_RNDCH—Specifies if the round or chamfer geometry
of the quilt should be attached using the attachment information stored in the
intent objects.
Automatically Splitting Extending Surfaces
From Creo Parametric 4.0 F000 onward, a new element PRO_E_RM_SURF_
AUTO_SPLIT_SRF has been added to the Remove feature, which is defined in
the header file ProRemoveSurf.h. It specifies if the extending surface of the
selected shape surface must be automatically split when geometry is removed.
Flex Move Feature
From Creo Parametric 1.0 M010 onward, the element data types of the following
elements have been updated from PRO_VALUE_TYPE_SELECTION to PRO_
ELEM_TYPE_MULTI_VALUE:
•
•
PRO_E_FLEXMOVE_DIM_REFS
PRO_E_FLEXMOVE_DTM_REF
Moving Component References in Flex Move Feature
From Creo Parametric TOOLKIT 4.0 F000 onward, a new element PRO_E_
FLEXMOVE_MOVED_COMPS has been added to the Move feature, which is
defined in the header file ProFlexMove.h. It collects component references,
that is, parts and subassemblies in an assembly, which are moved by the assembly
level move feature.
Move Using Transformation Matrix
From Creo Parametric TOOLKIT 4.0 F000 onward, a new type of move PRO_
D3_MOVE_TYPE_FREETRF has been defined in the header file ProD3Elem.h.
It uses transformation matrix to move geometry. The final move position is saved
as a transformation matrix.
Summary of Technical Changes
73
Maintaining Topology in Attachment Geometry and Remove
Surface Features
From Creo Parametric TOOLKIT 3.0 onward, you to specify if regeneration of the
model must fail, when the same solution type cannot be reconstructed. The
following elements allow you to maintain topology in:
•
•
Attachment Geometry feature—PRO_E_FLEX_MAINTAIN_TOPO in the
header file ProFlxmdlOpts.h.
Remove surface feature—PRO_E_RM_SURF_MAINTAIN_TOPO in the
header file ProRemoveSurf.h.
Propagating Tangency in Flexible Modeling Features Move,
Offset, and Modify Analytic Surface
From Creo Parametric 3.0 onward, you can propagate tangency in flexible
modeling features Move, Offset, and Modify Analytic Surface feature. To
propagate tangency, the element PRO_E_FLEX_PROPAGATE_TANGENCY
defined in the header file ProFlxmdlOpts.h must be set to PRO_
FLEXMODEL_OPT_YES.
The element PRO_E_FLXSLV_PROP_CONSTRS is used to set the conditions
that controls the changes in geometry during tangency propagation. The element is
defined in the header file ProFlexTanPropOpts.h.
Saving Attachment Information in the PRO_E_FLEX_CR_
RND_GEOM Element
From Creo Parametric 4.0 F000 onward, when the element PRO_E_FLEX_
ATTACH_GEOM is set to PRO_FLEXMODEL_OPT_No, the element PRO_E_
FLEX_CR_RND_GEOM can be set to the following values:
•
•
PRO_FLEXMODEL_OPT_YES—Stores the attachment information of the
rounds in intent objects.
PRO_FLEXMODEL_OPT_NO—Does not store the attachment information of
the rounds.
Substituting One-Sided Edges
From Creo Parametric TOOLKIT 4.0 F000 onward, two new elements have been
added to the Substitute feature, which is defined in the header file
ProFlexSubstitute.h. Use these elements to replace the selected one-sided
edges of a surface or quilt with substituting surfaces.
74
Creo® Parametric TOOLKIT Release Notes
Updates to the Attachment Geometry Feature
The following elements have been added in the header file ProFlxmdlOpts.h:
•
•
•
PRO_E_FLEX_TRF_SEL_ATT_GEOM—Specifies if the chamfers and
rounds that attach the moved geometry to the model must also be transformed.
PRO_E_FLEX_DFLT_CONDITIONS—Specifies if the vertices of the
dragged geometry must be fixed when the dragged surfaces are transformed.
The vertices are selected by the system.
PRO_E_FLEX_PULL_OPTION—Specifies that the bounding chain edges
selected in the element PRO_E_FLEX_BOUND_EDGES_CMP must be used
for the reattachment of moved geometry. This element is relevant only in
Move feature.
Geometric Tolerances
The following updates have been added in the header file ProGtol.h:
•
•
•
Two new material conditions PROGTOLMATCOND_LMC_R and
PROGTOLMATCOND_MMC_R have been added to the enumerated data type
ProGtolMaterialCond in the header file ProGtol.h. You can now
specify the least material condition and the maximum material condition with
reciprocity.
You can specify the horizontal justification for the text style object using the
enumerated data type ProTextHrzJustification defined in the header
file ProGtol.h.
Two new text types PRO_GTOLTEXT_ON_BOTTOM and PRO_GTOLTEXT_
ON_LEFT have been added to the enumerated data type
ProGtolTextType. The values PRO_GTOLTEXT_ON_BOTTOM and
PRO_GTOLTEXT_ON_LEFTallow you to access the bottom and left instances
respectively of the additional text applied on the geometric tolerance.
Item Types PRO_PSEG_START and PRO_PSEG_
END—Start and End of Pipe Segments
From Creo Parametric 2.0 M160 onward, two new item types, start of pipe
segment PRO_PSEG_START and end of pipe segment PRO_PSEG_END, have
been added to the enumerated data type ProType. In the function
ProSelect(), for the input argument option, specify the value as pipeseg_
end to select the start and end of a pipe segment.
You can create pipe connects from a XML file using the item types PRO_PSEG_
START and PRO_PSEG_END.
Summary of Technical Changes
75
License Information for
ProDimensionIsAccessibleInModel()
From Creo Parametric 2.0 M180 onward, the function
ProDimensionIsAccessibleInModel() is no longer under license
option 222, that is, the TOOLKIT-for-3D_Drawings license. It is available with
the Creo Parametric TOOLKIT license.
Material Merge Option — Intersect
From Creo Parametric 4.0 F000 onward, a new merge option for material PRO_
GEN_MERGE_INT_MATERIAL has been added to the enumerated data type
ProGenMergeMaterialOpt. It retains the intersecting material between the
modified and modifying models.
Maximum Number of Characters in a Line in the
Message File
From Creo Parametric TOOLKIT 4.0 F000 onward, the maximum length of any
line in the message file is 4096 wide characters.
Mechanism Motor Feature
You can access and create the servo and force motor features in models using the
element tree defined in the header file ProMotorFeat.h.
Model Names in Symbolic Representation
All the models opened in symbolic representation by default now have visible
names same as the master representation.
NC
This section explains the changes in the area of Creo NC.
Creating Holeset by Geometry
A new holeset type PRO_HOLESET_DRILL_GEOM has been added to the
enumerated data type ProHolesetType in the header file
ProMfgOptions.h. You can now select the hole geometry to create a hole set.
76
Creo® Parametric TOOLKIT Release Notes
Defining the Axis and Axis Type for Cutline Milling
Sequence
The compound element PRO_E_MFG_AXIS_DEF_COMP has been added in the
element tree for Cutline Milling Sequence in the header file
ProMfgFeatCutlineMilling.h. The element allows you to define the axis
parameters for the Cutline Milling feature. You can specify the type of axis using
the enumerated data type ProAxisDefType defined in the header file
ProMfgOptions.h.
Defining the Number of Spindles
The element PRO_E_MFG_WCELL_NUM_SPINDLES has been added in the
element trees for the workcell lathe and mill turn feature in the header files
ProMfgFeatWcellLathe.h and ProMfgFeatWcellMillTurn.h. The
element PRO_E_MFG_WCELL_NUM_SPINDLES allows you to set the number of
spindles to be used for feature creation using the enumerated data type
WcellNumSpindles defined in the header file ProMfgOptions.h.
Defining the Spindle Type for Creo NC Sequences
The element PRO_E_MFG_SUB_SPINDLE_OPT allows you to specify the type
of spindle for a Creo NC sequence. The spindle types are defined using the
enumerated data type SubSpindleOpt in the header file ProMfgOptions.h.
The spindle element PRO_E_MFG_SUB_SPINDLE_OPT has been added in the
following header files:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
ProMfgFeat2xCurvTraj.h
ProMfgFeatCornerFinishing.h
ProMfgFeatCutlineMilling.h
ProMfgFeatEngraving.h
ProMfgFeatFacing.h
ProMfgFeatFinishing.h
ProMfgFeatHolemaking.h
ProMfgFeatManualCycle.h
ProMfgFeatProfMilling.h
ProMfgFeatReroughing.h
ProMfgFeatRoughing.h
ProMfgFeatRoundChamferMilling.h
ProMfgFeatThreadMilling.h
ProMfgFeatTrajectory.h
Summary of Technical Changes
77
•
•
ProMfgFeatTurning.h
ProMfgFeatTurnThread.h
Defining the Stock Allowance
From Creo Parametric 3.0 onward, the elements PRO_E_TURN_STK_ALLW_
PROF_ARR and PRO_E_TURN_STK_ALLW_ROUGH_ARR have been added in
the header files ProMfgElemToolMtnAreaTurn.h,
ProMfgElemToolMtnGrooveTurn.h and
ProMfgElemToolMtnProfTurn.h. These elements define the profile and
rough stock allowances respectively, for the Creo NC features.
Holemaking Holeset Feature
The elements PRO_E_HOLESET_SEL_UNSEL_GEOMETRY and PRO_E_
HOLESET_SEL_INDIV_GEOMETRY have been added in the element tree for the
Holemaking Holeset feature in the header file ProMfgElemHoleset.h.
The element PRO_E_HOLESET_SEL_UNSEL_GEOMETRY allows you to
specify a selection of holes that must be excluded from machining operation. The
element PRO_E_HOLESET_SEL_INDIV_GEOMETRY allows you to specify
individual holes in a drill group to define a hole set in the holemaking sequence.
Manufacturing Mill or Turn Workcell
The following elements have been added in the element tree for Manufacturing
Mill or Turn Workcell in the header file ProMfgFeatWcellMillTurn.h:
•
•
•
•
PRO_E_MFG_WCELL_ENABLE_TURN_OPT—This element specifies the
enabling or disabling of the turning machine. This element allows you to
enable and disable the turning operation on the created workcell.
PRO_E_WCELL_HEAD_TURN_OPT—This element has been added in the
compound elements PRO_E_MFG_MILLTURN_HEAD_1 and PRO_E_MFG_
MILLTURN_HEAD_2. It allows you to enable or disable the turning option for
the machine turret.
PRO_E_MFG_MILLTURN_HEAD_3 and PRO_E_MFG_MILLTURN_HEAD_
4— compound elements allow you to set the parameters such as milling,
turning, flash tool and rotation for the turret heads 3 and 4 respectively.
PRO_E_MFG_WCELL_HEAD_3 and PRO_E_MFG_WCELL_HEAD_4—
These compound elements allow you to set the tool specification for the turret
heads 3 and 4 respectively.
Multiple Reference Selection for Creo NC Steps
The element PRO_E_MFG_PROCESS_REF allows multiple selections of
references. The element is defined for the following Creo NC steps:
78
Creo® Parametric TOOLKIT Release Notes
Creo NC Step
Roughing
Reroughing
Finishing
Corner Finishing
2–Axis Curve Trajectory
Milling
3–Axis Trajectory Milling
Profile Milling
Manual Cycle
Thread Milling
Area, Groove, and Profile
Turning
Thread Turning
Holemaking
Face Milling
Header File
ProMfgFeatRoughing.h
ProMfgFeatReroughing.h
ProMfgFeatFinishing.h
ProMfgFeatCornerFinish
ing.h
ProMfgFeat2xCurvTraj.h
ProMfgFeatTrajectory.h
ProMfgFeatProfMilling.h
ProMfgFeatManualCycle.h
ProMfgFeatThreadMilling.h
ProMfgFeatTurning.h
ProMfgFeatTurnThread.h
ProMfgFeatHolemaking.h
ProMfgFeatFacing.h
Creo NC Operation Definition Feature
The following elements have been added in the element tree for Creo NC
Operation Definition sequence in the header file ProMfgFeatOperation.h:
•
•
•
PRO_E_MFG_FROM3_PNT and PRO_E_MFG_HOME3_PNT—The elements
allow you to specify datum points that indicate the start point and the end
point for the machining process by turret head 3 tool.
PRO_E_MFG_FROM4_PNT and PRO_E_MFG_HOME4_PNT—The elements
allow you to specify datum points that indicate the start point and the end
point for the machining process by turret head 4 tool.
PRO_E_OPER_SUBSP_CSYS—The element PRO_E_OPER_SUBSP_CSYS
has been added in the element tree for Creo NC operation sequence in the
header file ProMfgFeatOperation.h. This element allows you to specify
a coordinate system which will be used as the sub-spindle coordinate system.
Retract Feature
The element PRO_E_RETR_SURF_TYPE in the header file
ProMfgElemRetract.h now supports a new value PRO_RETR_SURF_
UNDEFINED. This value specifies that the retract surface is not defined. Refer to
the header file ProMfgOptions.h for more information on the enumerated
data type ProRetrSurfType.
Summary of Technical Changes
79
Setting the Size of User Interface (UI) Components
The following functions will fail, if you specify a value smaller than the minimum
size for the input arguments width or height:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
ProUIDrawingareaSizeSet()
ProUIInputpanelSizeSet()
ProUILabelSizeSet()
ProUILayoutSizeSet()
ProUIListSizeSet()
ProUIOptionmenuSizeSet()
ProUIProgressbarSizeSet()
ProUIPushbuttonSizeSet()
ProUIRadiogroupSizeSet()
ProUISliderSizeSet()
ProUISpinboxSizeSet()
ProUITabSizeSet()
ProUITableSizeSet()
ProUITextareaSizeSet()
ProUIThumbwheelSizeSet()
ProUITreeSizeSet()
Skirt Fill Feature
You can access the Skirt Fill feature in models using the element tree in defined
the header file ProMoldSkirtFill.h.
Skirt Surface Extension Feature
You can access the Skirt Surface Extension feature in models using the element
tree in defined the header file ProMoldSkirtExt.h.
Specifying the Type of Feed
From Creo Parametric 3.0 M040 onward, the new element PRO_E_TOOL_MTN_
FEED_TYPE enables you to specify the type of feed for the tool motion. The
element has been added to the tool motion element trees in the following header
files:
•
•
•
80
ProMfgElemToolMtnAlongAxisAppr.h
ProMfgElemToolMtnAlongAxisExit.h
ProMfgElemToolMtnConnect.h
Creo® Parametric TOOLKIT Release Notes
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
ProMfgElemToolMtnFollowCrv.h
ProMfgElemToolMtnGoDelta.h
ProMfgElemToolMtnGoHome.h
ProMfgElemToolMtnGoRetr.h
ProMfgElemToolMtnGotoAxis.h
ProMfgElemToolMtnGotoPnt.h
ProMfgElemToolMtnGotoSrf.h
ProMfgElemToolMtnHelAppr.h
ProMfgElemToolMtnHelExit.h
ProMfgElemToolMtnLeadIn.h
ProMfgElemToolMtnLeadOut.h
ProMfgElemToolMtnNormAppr.h
ProMfgElemToolMtnNormExit.h
ProMfgElemToolMtnPlunge.h
ProMfgElemToolMtnRampAppr.h
ProMfgElemToolMtnRampExit.h
ProMfgElemToolMtnTanAppr.h
ProMfgElemToolMtnTanExit.h
Specifying the Type of Hole Diameters
From Creo Parametric 3.0 M030 onward, the following new elements enable you
to specify the type of hole diameter for machining, using the new enumerated data
type ProHolesetDiamType:
•
•
PRO_E_MFG_HSET_DIAM_TYPE_OPT—Added in the Thread Milling
Holeset and Holemaking Holeset element trees in the header files
ProMfgElemThreadHoleset.h and ProMfgElemHoleset.h
respectively.
PRO_E_DRILL_GRP_DIAM_TYPE_OPT—Added in the Drill Group feature
element tree in the header file ProMfgFeatDrillGroup.h.
Subroutine Patterning Options
From Creo Parametric 4.0 F000 onward, the following elements have been added
to the pattern element tree in ProPattern.h:
•
•
PRO_E_PAT_MFG_SUB_OUTPUT—Specifies if subroutine pattern must be
created.
PRO_E_PAT_MFG_SUB_OUT_MODE—Specifies the output mode for the
subroutine.
Summary of Technical Changes
81
•
•
PRO_E_PAT_MFG_SUB_OUT_MULTAX—Specifies if the Multax mode must
be selected.
PRO_E_PAT_MFG_SUB_OUT_COPYCL—Specifies if the subroutine pattern
definitions in CL output must be temporarily suppressed.
Tool Motion for Curve and Surface Trajectory Sequence
The elements PRO_E_MFG_AXIS_DEF_COMP and PRO_E_MFG_TRAJ_
CORNER_COND have been added in the element trees for tool motion in the
header files ProMfgElemToolMtnCrvTraj.h and
ProMfgElemToolMtnSrfTraj.h. The compound element PRO_E_MFG_
AXIS_DEF_COMP allows you to specify the parameters that define the axis for
the feature. The compound element PRO_E_MFG_TRAJ_CORNER_COND allows
you to specify the corner conditions for the feature. You can specify the type of
corner using the enumerated data type ProTmTrajCornerType defined in the
header file ProMfgOptions.h.
Tool Motion for Curve Trajectory Sequence
The following elements have been added in the element tree for tool motion for
the Curve Trajectory sequence in the header file
ProMfgElemToolMtnCrvTraj.h:
•
•
•
PRO_E_MFG_AXIS_DEF_NORM_SRF—The element allows you to select
multiple references for the milling sequence.
PRO_E_MFG_AXDEF_NORM_SURF_DIR—The element specifies the
direction of the normal surface.
PRO_E_MFG_AXIS_DEF_LOC_ALIGN_Z—This element allows you to
align the tool axis with the Z-axis of the step coordinate system.
Tool Motion for Profile Mill Cut
The values of the following elements defined in the header file
ProMfgElemToolMtnProfileMillCut.h have been updated:
•
•
82
PRO_E_MFG_START_HEIGHT—While creating the tool motion profile mill
cut feature, specify the element PRO_E_MFG_START_HEIGHT only if the
element PRO_E_TOOL_MTN_PROFILE_TYPE is set to PRO_E_MILL_
CUT_FROM_TO.
PRO_E_MFG_HEIGHT—While creating the tool motion profile mill cut
feature, specify the element PRO_E_MFG_HEIGHT only if the element PRO_
E_TOOL_MTN_PROFILE_TYPE is set toPRO_E_MILL_CUT_FROM_TO,
or PRO_E_MILL_CUT_UPTO, or PRO_E_MILL_CUT_ONE_SLICE.
Creo® Parametric TOOLKIT Release Notes
Tool Motion for Volume Mill Cut
You can create and redefine the Volume Mill Cut feature in the models using the
element tree defined in the header file ProMfgElemToolMtnVolMillCut.h.
Tool Reference - Turret Heads 3 and 4
The following elements have been added in the element tree for Tool Reference in
the header file ProMfgElemToolRef.h:
•
•
•
The turret head values PRO_MACH_HEAD1 and PRO_MACH_HEAD2 for the
element PRO_E_MFG_TOOL_REF_HEAD_NUM are no longer supported. Use
the new values PRO_MFG_TOOL_HEAD_1 and PRO_MFG_TOOL_HEAD_2
instead.
The element PRO_E_MFG_TOOL_REF_HEAD_NUM in the header file
ProMfgElemToolRef.h now supports two new values PRO_MFG_TOOL_
HEAD_3 and PRO_MFG_TOOL_HEAD_4. These values specify that the
machine tool is placed in head 3 or head 4. You can specify these values for
Mill/Turn workcells.
The turret head value PRO_MACH_HEAD1 and PRO_MACH_HEAD2 for the
element PRO_E_MFG_TOOL_REF_HEAD_NUM defined in the header file
ProMfgElemToolRef.h are no longer supported. Use the values PRO_
MFG_TOOL_HEAD_3 and PRO_MFG_TOOL_HEAD_4 instead.
Type of Search Query for Holes
From Creo Parametric 3.0 M040 onward, the following new elements enable you
to specify the type of search query that must be used while collecting holes for
machining. To specify the type of query, the elements use the new enumerated
data type ProHsetParamRuleOpt.
•
•
PRO_E_MFG_HSET_PARAM_RULE_OPT—Added in the Thread Milling
Holeset and Holemaking Holeset element trees in the header files
ProMfgElemThreadHoleset.h and ProMfgElemHoleset.h
respectively.
PRO_E_DRILL_GRP_PARAM_RULE_OPT—Added in the Drill Group
feature element tree in the header file ProMfgFeatDrillGroup.h.
Updates to the header file ProMfgFeat2xCurvTraj.h
The elements PRO_E_MFG_LOOP_SURF_REF and PRO_E_FF_TRAJ_FLIP_
OPT have been added in the header file ProMfgFeat2xCurvTraj.h. The
element PRO_E_MFG_LOOP_SURF_REF allows you to select the surfaces for
which the loops of edges must be collected for machining. The element PRO_E_
FF_TRAJ_FLIP_OPT flips the machining direction of the tool.
Summary of Technical Changes
83
Volume Milling Feature
You can create and redefine the Volume Milling feature in the models using the
element tree defined in the header file ProMfgFeatVolMilling.h.
Notifications Called Before Saving and After
Renaming Models
From Creo Parametric 4.0 F000 onward, the following notification events and
callback functions have been added:
Event type
Callback typedef
Description
PRO_MODEL_SAVE_
ProModelSavePreAl Callback function is
PRE_ALL
lAction
called before saving every
model.
PRO_MODEL_RENAME_ ProModelRenamePos Callback function is
POST_ALL
tAllAction
called after renaming
every model.
New Unit Type for Rotational Displacement
From Creo Parametric 3.0 M070 onward, a new unit type PRO_UNITTYPE_
ROTATIONAL_LENGTH_SPECTDENS has been added to the enumerated data
type ProUnitType for measuring rotational displacement in Rad^2/Q.
Pipe Connect Feature
You can access and create the pipe connect feature using the element tree in the
header file ProPipConnect.h.
No Support for Error Type PRO_TK_NO_LICENSE
The documentation for the functions ProATBVerify(),
ProATBMdlnameVerify(), and ProATBUpdate() incorrectly mentioned
that these functions supported the error type PRO_TK_NO_LICENSE. To correct
this, in Creo Parametric 3.0 M010, the error type PRO_TK_NO_LICENSE has
been removed from the documentation of these functions.
Creo Simulate Environment
This section explains the changes in the Creo Simulate environment.
84
Creo® Parametric TOOLKIT Release Notes
Entering the Creo Simulate Environment with Failed
Features
From Creo Parametric 3.0 onward, you can open a model created in Creo
Parametric with features that failed to regenerate in Creo Simulate environment.
You can also create simulation objects on geometry from failed features on a
model in Creo Simulate environment.
Support for Total Load at Point (TLAP) in FEM Mode
From Creo Parametric 3.0 onward, the Total Load at Point (TLAP) loads are
supported in FEM mode in the Creo Simulate environment. Refer to the Creo
Simulate Help for more information on TLAP loads.
Normal and Parallel Orientations for Dimensions
From Creo Parametric 3.0 onward, dimensions can be placed normal or parallel to
the specified reference, using the enumerated values:
•
•
PRO_DIM_ORNT_NORMAL
PRO_DIM_ORNT_PARALLEL
Pattern Feature
The elements PRO_E_PAT_GEOM_REFS and PRO_E_FLEX_OPTS_CMPND
have been added in the element tree for the Pattern feature in ProPattern.h.
The element PRO_E_PAT_GEOM_REFS allows you to read the references
selected for the pattern leader. The element PRO_E_FLEX_OPTS_CMPND allows
you to read the attachment options selected for a pattern.
Read-Only Features
From Creo Parametric 3.0 onward, the features that are made read-only using the
function ProFeatureReadonlySet() appear under a separate container
node Read Only Features at the top of the model tree. The container node is
dismissed when the read-only status is removed from all the read-only features
using the function ProFeatureReadonlyUnset().
Section Type for Angular Dimension
From Creo Parametric 4.0 F000 onward, a new dimension type PRO_TK_DIM_
ANG_POLAR has been added to the enumerated data type ProSecdimType.
The dimension measures the angle between the x-axis and a vector, which is
defined by two points.
Summary of Technical Changes
85
Sheetmetal
This section explains the changes in the area of Sheetmetal.
Attachment types for Wall Feature
Two new attachment types PRO_SMT_WALL_HEIGHT_OFFSET_FROM_ORIG
and PRO_SMT_WALL_HEIGHT_OFFSET_FROM_BEND have been added to the
enumerated data type ProSmdHeightType defined in the header file
ProSmtFlangeWall.h. The attachment type PRO_SMT_WALL_HEIGHT_
OFFSET_FROM_ORIG specifies that the wall feature attaches to the selected
attachment edge at the specified offset distance. The attachment type PRO_SMT_
WALL_HEIGHT_OFFSET_FROM_BEND specifies that the wall feature appends
to the selected attachment edge at the specified offset distance.
Bend Relief Elements for Edge Bend Feature
From Creo Parametric 4.0 F000 onward, the element PRO_E_SMT_BEND_
RELIEF has been added to the element tree of the Edge Bend feature defined in
the header file ProSmtEdgeBend.h. The element defines bend relief options
for the edge.
Closing Corner Reliefs in Flange Wall and Edge Rip
Features
From Creo Parametric 4.0 F000 onward, the element PRO_E_SMT_EDGE_RIP_
CLOSE_CORNER has been added to the following features:
•
•
Flange Wall feature defined in the header file ProSmtFlangeWall.h
Edge Rip feature defined in the header file ProSmtEdgeRip.h
The element specifies if the gap between the bend surfaces of a corner relief or an
edge rip must be closed.
Edit Bend Relief Feature
You can edit and modify bend reliefs in sheet metal models using the element tree
defined in the header file ProSmtEditBendRelief.h.
Edit Corner Relief Feature
You can edit and modify corner reliefs in sheet metal models using the element
tree defined in the header file ProSmtEditCornerRelief.h.
Edit Corner Seam Feature
You can edit and remove corner seams in sheet metal models using the element
tree defined in the header file ProSmtEditCornerSeam.h.
86
Creo® Parametric TOOLKIT Release Notes
Flattening of Form Walls
The element PRO_E_SMT_FLATTEN_FORM_WALLS has been added in the
element tree for the Unbend feature in the header file ProRegularUnbend.h.
The element allows you to specify an option to flatten the walls of the unbend
form geometry in the model.
General Merge Feature and Dependency Type Not Related
From Creo Parametric 4.0 F000 onward, the elements General Merge Feature
PRO_E_GMRG_FEAT_TYPE and dependency type PRO_E_DSF_DEPENDENCY
are not related. You can independently set the two values. However, the existing
applications from releases prior to Creo Parametric 4.0 F000, where the values of
General Merge feature were dependant on the element PRO_E_DSF_
DEPENDENCY, will continue to work.
When the element PRO_E_GMRG_FEAT_TYPE is set to PRO_GEN_MERGE_
TYPE_MERGE , the element PRO_E_DSF_DEPENDENCY can be set to PRO_
DSF_UPDATE_AUTOMATICALLY only.
Join Feature
The element PRO_E_SMT_WALL_JOIN_EXTEND has been added in the element
tree for the Join feature defined in the header file ProSmtJoinWalls.h. The
element PRO_E_SMT_WALL_JOIN_EXTEND allows you to specify the type of
extension to be used for creating the feature using the enumerated data type
ProSmtJoinWallsExtType.
Project Cuts in Unbend and Flatten Form Features
From Creo Parametric 4.0 F000 onward, the element PRO_E_SMT_FLATTEN_
PROJ_CUTS has been added in the element trees for Unbend feature in the header
file ProRegularUnbend.h and Flatten Form feature in the header file
ProSmtFlattenForm.h. The element specifies if cuts must be projected to
the flattened form.
Punch and Die Form Features
The elements PRO_E_STD_SURF_COLLECTION_APPL and PRO_E_FORM_
DIE_POCKET_GEOM_CMP have been added in the element tree for the Punch
and Die Form Features in the header file ProSmtForm.h. The element PRO_E_
STD_SURF_COLLECTION_APPL enables you to collect the surfaces to be
excluded from the Punch or Die model during the feature creation. While creating
the feature, specify the element PRO_E_FORM_DIE_POCKET_GEOM_CMP only
if the enumerated data type ProGenMergeSmtType is set to the value PRO_
GEN_MERGE_SMT_TYPE_FORM_DIE.
Summary of Technical Changes
87
Two new types of sheet metal features PRO_GEN_MERGE_SMT_TYPE_FORM_
PUNCH and PRO_GEN_MERGE_SMT_TYPE_FORM_DIE have been added to the
enumerated data type ProGenMergeSmtTypes. The sheet metal types PRO_
GEN_MERGE_SMT_TYPE_FORM_PUNCH and PRO_GEN_MERGE_SMT_
TYPE_FORM_DIE enable you to create the Punch and Die Form features
respectively.
Punch Axis Point
The element PRO_E_SMT_PUNCH_AXIS_PNT has been added in the element
tree for the Extrude feature defined in the header file ProExtrude.h. The
element allows you to specify if the punch axis point must be created for sheet
metal cuts and punches.
Recognizing Sheet Metal Design Objects
From Creo Parametric 4.0 F000 onward, the Sheetmetal Design items are created
as design objects. You can tag surfaces as sheet metal design objects or not sheet
metal design objects in a model using the element tree defined in the header file
ProSmtRecognition.h.
Twist Wall Feature
You can access and create the twist wall feature in models using the element tree
defined in the header file ProSmtTwist.h.
Using Original Length As Development Length
From Creo Parametric 4.0 F000 onward, a new value for developed length PRO_
DVL_SRC_USE_ORIGINAL has been added to the enumerated data type
ProDvlLenSrcType. It enables you to use the original length of the bend
feature as the development length.
Support for B-Splines
From Creo Parametric 4.0 F000 onward, b-spline has been added as a new type of
entity PRO_2D_B_SPLINE in the enumerated data type Pro2dEntType. A
new structure Pro2dBSplinedefwhich defines b-splines has also been added
in the header file Pro2dEntdef.h.
The section APIs ProSectionEntityAdd() and
ProSectionEntityGet() now support b-splines.
88
Creo® Parametric TOOLKIT Release Notes
Storing External Data in Chapters
From Creo Parametric 3.0 onward, a new type of data PRO_CHAPTER_TYPE has
been added. You can save external data of any size using the chapter data type.
Tolerance Value for Bend Angle Dimension in the
Flat Wall Feature
You must specify the tolerance value as 0.5 and not 0.01 for the bend angle
dimension of the sheet metal flat wall feature.
Updates in Enumerated Data Type ProColor
From Creo Parametric M080 onward, two new values PRO_COLOR_SS_UPD_
CONTROL_GROUP and PRO_COLOR_SS_CONTAINS_MATHCAD_
WORKSHEET have been added to the enumerated data type ProColor in the
header file ProToolkit.h.
The search query uses the color:
•
•
PRO_COLOR_SS_UPD_CONTROL_GROUP—To highlight the search result.
The search result depends on the search query used in the TOOLKIT
application
PRO_COLOR_SS_CONTAINS_MATHCAD_WORKSHEET—To highlight the
models that contain PTC Mathcad worksheet.
Updates to the Function
ProCablingNeutralwirelistImport()
The prototype of the function ProCablingNeutralwirelistImport()
has been updated to accept the first argument as ProAssembly instead of
ProHarness.
Updates to the Function ProIntfDataDatumGet()
From Creo Parametric 1.0 M020 onward, use the function
ProDatumdataMemoryFree() instead of ProDatumdataFree() to
release the memory after using the function ProIntfDataDatumGet().
Summary of Technical Changes
89