Creo Parametric Toolkit 2.0 Release Notes: December 2015
Creo Parametric Toolkit 2.0 Release Notes: December 2015
TOOLKIT 2.0
Release Notes
December 2015
Copyright © 2015 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.
Important Copyright, Trademark, Patent, and Licensing Information: See the About Box, or copyright
notice, of your PTC software.
This document and the software described herein are Commercial Computer Documentation and Software,
pursuant to FAR 12.212(a)-(b) (OCT’95) or DFARS 227.7202-1(a) and 227.7202-3(a) (JUN’95), and are
provided to the US Government under a limited commercial license only. For procurements predating the
above clauses, use, duplication, or disclosure by the Government is subject to the restrictions set forth in
subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software Clause at DFARS 252.227-
7013 (OCT’88) or Commercial Computer Software-Restricted Rights at FAR 52.227-19(c)(1)-(2) (JUN’87),
as applicable. 01012015
5
About This Guide
7
1
Summary of Technical Changes
Critical Technical Changes .........................................................................................10
New Functions ..........................................................................................................20
Superseded Functions...............................................................................................32
Miscellaneous Technical Changes ..............................................................................34
This chapter describes the critical and miscellaneous technical changes in Creo
Parametric 2.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 2.0 and Creo Parametric
TOOLKIT that might require alteration of existing Creo Parametric TOOLKIT,
Creo Elements/Pro TOOLKIT, and Pro/TOOLKIT applications.
From the Creo Parametric TOOLKIT User’s Guide, click the API name to get
more information about the API.
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.
ProAsmcomppathDispQuiltVisit()
In Creo Parametric 2.0, there was a change in 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 2.0 M030. It now visits only displayed
quilts.
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 in the function ProSetdatumtagAttachmentSet().
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 2.0.
Annotations
New Function Description
ProAnnotationByViewShow() Displays the annotation in the specified
ProAnnotationByFeatureShow() view, for the specified type of feature
and component.
ProAnnotationByComponentShow()
ProAnnotationfeatElementCopy() Copies and adds the annotation element
to the specified annotation feature.
ProCombstateAnnotationErase() Erases the annotation from the
specified combined state.
BOM Balloon
New Function Description
ProDwgtableCellRegionGet() Creates the BOM balloons.
ProBomballoonCreate()
ProBomballoonAllCreate()
ProBomballoonByComponentCreate()
ProBomballoonByRecordCreate()
ProBomballoonClean() Cleans the display and location of the
BOM balloons.
Cabling
New Function Description
ProAssemblyHarnessesTopCollect() Gets an array of handles to the
harnesses present in the specified top
level assembly.
ProCablingNeutralwirelistImport() Imports the PTC neutral wire list file
(.nwf) in the current session.
ProCableLocationsOnSegEndGet() Gets the start and end location of each
segment for the specified cable.
ProCableTapeFeatSpoolGet() Gets the spool for the specified tape
feature.
ProCablesFromLogicalAllCreate() Creates cables and conductors from
Creating Tools
New Function Description
ProToolFileRead() Creates a new tool or redefines an
existing tool.
ProToolFileWrite() Writes all information about the tool
into a file.
Cross Section
New Function Description
ProXsecCanCreateAsFeature() Checks if new cross section features
can be created.
ProXsecOldToNewConvert() Converts the cross sections created in
Pro/ENGINEER, Creo Elements/Pro,
and in releases prior to Creo Parametric
2.0 to the new cross section features.
ProXsecIsFeature() Checks if the cross section is a feature.
ProXsecFeatureGet() Returns a pointer to the cross section
feature.
ProXsecCompXhatchStyleGet() Retrieves and sets the hatch pattern for
ProXsecCompXhatchStyleSet() the specified cross section component.
ProXsecExcludeCompGet() Retrieves the status and path of the
assembly components included and
excluded for the specified cross section.
ProAsmpathProarrayFree() Frees the memory allocated to
assembly component path.
Dimensions
New Function Description
ProDimensionSimpleBreakCreate() Creates a simple break on an existing
dimension witness line.
ProDimensionJogCreate() Creates a jog on an existing dimension
witness line.
ProDimensionIsSignDriven() Checks if a dimensions uses negative
sign in its value to flip the direction.
ProDimensionWitnesslineErase() Erases the specified witness line from a
dimension.
ProDimensionWitnesslineShow() Shows the erased witness line of the
specified dimension.
Dimension Text
New Function Description
ProDimensionTextWstringsGet() Gets and sets the text for the specified
ProDimensionTextWstringsSet() dimension.
Drawing
New Function Description
ProDrawingFormatSizeGet() Gets and sets the size of the drawing
ProDrawingFormatSizeSet() format in the specified drawing.
ProDrawingDimensionsCleanup() Cleans the display and location of the
dimensions in the specified drawing.
ProDrawingErasedviewSheetGet() Gets the number of the sheet which
contained the view that was erased.
ProDrawingToleranceStandardGet() Gets and sets the tolerance standard for
ProDrawingToleranceStandardSet() the specified drawing.
ProDwgtableByOriginRetrieve() Retrieves and places a drawing table in
the drawing at the specified point. The
origin of the table is positioned at the
specified point.
ProDtlsyminstdataIsInvisible() Checks if the specified symbol instance
is invisible.
Layers
New Function Description
ProLayerRuleExecute() Executes the layer rules on the
specified model.
ProLayerRuleCopy() Copies the layer rules from a reference
model to the current model.
ProLayerRuleMatch() Compares the layer rules between the
current and reference models.
Layer State
New Function Description
ProLayerstateActivestateUpdate() Updates the layer state which is active
in the model.
Measuring Geometry
New Function Description
ProSelectionWithOptionsDistanceEval Evaluates the distance between two
() selected items.
Model
New Function Description
ProMdlDependenciesCleanup() Cleans the dependencies for an object
in the Creo Parametric workspace.
ProFileSubtypeGet() Retrieves the model type and subtype,
when the path to a file is specified as
input.
Notebook
New Function Description
ProLayoutRegenerate() Regenerates the specified notebook
(.lay) file.
Ordinate Dimension
New Function Description
ProDimensionAutoOrdinateCreate() Creates an ordinate dimension
automatically for the selected surfaces.
Pattern Leader
New Function Description
ProFeaturePatternleaderGet() Returns the pattern leader feature for
the specified pattern member feature.
Piping
New Function Description
ProPipelineSpecDrivenCreate() Creates a Specification-Driven pipeline
feature.
ProPipelineCreateFromXML() Creates a pipeline feature based on the
schematic information defined in the
XML file for the specified pipeline
label.
ProPipelineCreate() Creates a Non Specification-Driven
pipeline feature.
ProPipelineParametersCollect() Retrieves all the parameters of the
specified pipeline.
Relations
New Function Description
ProRelationEvalWithUnits() Evaluates a line of a relation set and
outputs the resulting value with its unit.
ProRelsetUnitsSensitiveSet() Relations must be solved taking units
into account.
ProRelsetIsUnitsSensitive() Checks if the specified relation is unit-
sensitive.
Shrinkwrap Features
New Function Description
ProFeatureIsShrinkwrapRefCopyGeom Checks if the specified feature is a
() reference copy geometry feature, which
is created by the shrinkwrap feature.
ProFeatureShrinkwrapGetRefCopy- Gets an array of reference copy
Geoms() geometry features, which are created by
the shrinkwrap feature.
Solids
New Function Description
ProSolidToleranceStandardGet() Gets and sets the tolerance standard for
ProSolidToleranceStandardSet() the specified solid.
Surfaces
New Function Description
ProMdlVisibleAppearancepropsGet() Gets and sets the surface properties for
ProMdlVisibleAppearancepropsSet() the specified part, assembly component,
subassembly, quilt or surface.
ProMdlVisibleTexturepropsGet() Gets and sets the texture properties of
ProMdlVisibleTexturepropsSet() the surface for the specified part,
assembly component, subassembly,
quilt or surface.
ProMdlVisibleTextureplacementprops- Gets and sets the properties related to
Get() the placing of surface texture for the
ProMdlVisibleTextureplacementprops- specified part, assembly component,
Set() subassembly, quilt or surface.
Symbol Definition
New Function Description
ProDtlsyminstDimattachGet() Retrieves the dimension to which the
specified symbol is attached.
ProElementHoleScrewSizeGet()
ProElementHoleScrewSizeSet()
Views
New Function Description
ProViewIdFromNameGet() Gets the ID of the view.
Superseded Functions
This section describes the superseded functions for Creo Parametric TOOLKIT
for Creo Parametric 2.0.
Annotations
Superseded Function New Function
ProDimensionDisplayUpdate() ProAnnotationDisplay()
and
ProAnnotationUndisplay()
ProAnnotationErase() ProCombstateAnnotationErase()
Dimensions
Superseded Function New Function
ProDimensionTextGet() ProDimensionTextWstringsGet()
ProDimensionTextSet() ProDimensionTextWstringsSet()
ProDrawingDimensionTextstyleGet() ProAnnotationTextstyleGet()
Parameters
Superseded Function New Function
ProParameterValueGet() ProParameterValueWithUnitsGet()
ProParameterValueSet() ProParameterValueWithUnitsSet()
ProParameterCreatePreAction() ProParameterCreateWithUnits
PreAction()
ProParameterModifyPreAction() ProParameterModifyWithUnits
Relations
Superseded Function New Function
ProRelationEval() ProRelationEvalWithUnits()
NC
New functions have been added for NC.
NC Steps
You can access the NC steps using the element trees in the following table:
NC Step Header File
Cut Line Milling ProMfgFeatCutlineMilling.h
Engraving ProMfgFeatEngraving.h
Drill Group ProMfgFeatDrillGroup.h