Parametric Technology Corporation
® Pro/ENGINEER Wildfire J-Link Release Notes
January 2003 Copyright © 2002 Parametric Technology Corporation. All Rights Reserved.
User and training documentation from Parametric Technology Corporation (PTC) is subject to the copyright laws of the United States and other countries and is provided under a license agreement that restricts copying, disclosure, and use of such documentation. PTC hereby grants to the licensed 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. 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. Registered Trademarks of Parametric Technology Corporation or a Subsidiary Advanced Surface Design, CADDS, Computervision, Computervision Services, Electronic Product Definition, EPD, EPD.Connect, Expert Machinist, Flexible Engineering, HARNESSDESIGN, Info*Engine, InPart, Optegra, Parametric Technology, Parametric Technology Corporation, PHOTORENDER, Pro/DESKTOP, Pro/E, Pro/ENGINEER, Pro/HELP, Pro/INTRALINK, Pro/MECHANICA, Pro/TOOLKIT, PTC, PT/Products, Shaping Innovation, and Windchill. Trademarks of Parametric Technology Corporation or a Subsidiary 3DPAINT, Associative Topology Bus, Behavioral Modeling, CDRS, CounterPart, Create Collaborate Control, CV, CVact, CVaec, CVdesign, CV-DORS, CVMAC, CVNC, CVToolmaker, DataDoctor, DesignSuite, DIMENSION III, DIVISION, DVS, DVSAFEWORK, EDE, e/ENGINEER, Electrical Design Entry, EMX, eNC Explorer, Expert MoldBase, Expert Toolmaker, GRANITE, ISSM, KDiP, Knowledge Discipline in Practice, Knowledge System Driver, ModelCHECK, MoldShop, NC Builder, PartSpeak, Pro/ANIMATE, Pro/ASSEMBLY, Pro/CABLING, Pro/CASTING, Pro/CDT, Pro/CMM, Pro/COLLABORATE, Pro/COMPOSITE, Pro/CONCEPT, Pro/CONVERT, Pro/DATA for PDGS, Pro/DESIGNER, Pro/DETAIL, Pro/DIAGRAM, Pro/DIEFACE, Pro/DRAW, Pro/ECAD, Pro/ENGINE, Pro/FEATURE, Pro/FEM-POST, Pro/FICIENCY, Pro/FLY-THROUGH, Pro/HARNESS, Pro/INTERFACE, Pro/LANGUAGE, Pro/LEGACY, Pro/LIBRARYACCESS, Pro/MESH, Pro/Model.View, Pro/MOLDESIGN, Pro/NC-ADVANCED, Pro/NC-CHECK, Pro/NC-MILL, Pro/NCPOST, Pro/NC-SHEETMETAL, Pro/NC-TURN, Pro/NC-WEDM, Pro/NC-Wire EDM, Pro/NETWORK ANIMATOR, Pro/NOTEBOOK, Pro/PDM, Pro/PHOTORENDER, Pro/PIPING, Pro/PLASTIC ADVISOR, Pro/PLOT, Pro/POWER DESIGN, Pro/PROCESS, Pro/REPORT, Pro/REVIEW, Pro/SCAN-TOOLS, Pro/SHEETMETAL, Pro/SURFACE, Pro/VERIFY, Pro/Web.Link, Pro/Web.Publish, Pro/WELDING, Product Development Means Business, Product First, Products First, ProductView, PTC Precision, Shrinkwrap, The Product Development Company, The Way to Product First, Wildfire, Windchill DynamicDesignLink, Windchill PartsLink, Windchill PDMLink, Windchill ProjectLink, and Windchill SupplyLink. Third-Party Trademarks Adobe is a registered trademark of Adobe Systems. Advanced ClusterProven, ClusterProven, and the ClusterProven design are trademarks or registered trademarks of International Business Machines Corporation in the United States and other countries and are used under license. IBM Corporation does not warrant and is not responsible for the operation of this software product. AIX is a registered trademark of IBM Corporation. Allegro, Cadence, and Concept are registered trademarks of Cadence Design Systems, Inc. AutoCAD is a registered trademark of Autodesk, Inc. Baan is a registered trademark of Baan Company. CADAM and CATIA are registered trademarks of Dassault Systems. COACH is a trademark of CADTRAIN, Inc. DOORS is a registered trademark of Telelogic AB. FLEXlm is a registered trademark of GLOBEtrotter Software, Inc. Geomagic is a registered trademark of Raindrop Geomagic, Inc.
EVERSYNC, GROOVE, GROOVEFEST, GROOVE.NET, GROOVE NETWORKS, iGROOVE, PEERWARE, and the interlocking circles logo are trademarks of Groove Networks, Inc. Helix is a trademark of Microcadam, Inc. HOOPS is a trademark of Tech Soft America, Inc. HP-UX is a registered trademark and Tru64 is a trademark of the Hewlett-Packard Company. I-DEAS, Metaphase, Parasolid, SHERPA, Solid Edge, and Unigraphics are trademarks or registered trademarks of Electronic Data Systems Corporation (EDS). InstallShield is a registered trademark and service mark of InstallShield Software Corporation in the United States and/or other countries. Intel is a registered trademark of Intel Corporation. IRIX is a registered trademark of Silicon Graphics, Inc. MatrixOne is a trademark of MatrixOne, Inc. Mentor Graphics and Board Station are registered trademarks and 3D Design, AMPLE, and Design Manager are trademarks of Mentor Graphics Corporation. Netscape and the Netscape N and Ship's Wheel logos are registered trademarks of Netscape Communications Corporation in the U.S. and other countries. Oracle is a registered trademark of Oracle Corporation. OrbixWeb is a registered trademark of IONA Technologies PLC. PDGS is a registered trademark of Ford Motor Company. RAND is a trademark of RAND Worldwide. Rational Rose is a registered trademark of Rational Software Corporation. RetrievalWare is a registered trademark of Convera Corporation. RosettaNet is a trademark and Partner Interface Process and PIP are registered trademarks of “RosettaNet,” a non-profit organization. SAP and R/3 are registered trademarks of SAP AG Germany. SolidWorks is a registered trademark of SolidWorks Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the United States and in other countries. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. STHENO is a trademark of CAD Schroer GmbH. Sun, Sun Microsystems, the Sun logo, Solaris, UltraSPARC, Java and all Java based marks, and “The Network is the Computer” are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and in other countries. VisTools is a trademark of Visual Kinematics, Inc. (VKI). VisualCafé is a trademark of WebGain, Inc. WebEx is a trademark of WebEx Communications, Inc. Microsoft, Windows, Windows NT, Visual Basic, and the Visual Basic logo are registered trademarks of Microsoft Corporation in the United States and/or other countries.
Licensed Third-Party Technology Information Certain PTC software products contain licensed third-party technology: Rational Rose 2000E is copyrighted software of Rational Software Corporation. RetrievalWare is copyrighted software of Convera Corporation. VisualCafé is copyrighted software of WebGain, Inc. VisTools library is copyrighted software of Visual Kinematics, Inc. (VKI) containing confidential trade secret information belonging to VKI. HOOPS graphics system is a proprietary software product of, and is copyrighted by, Tech Soft America, Inc. G-POST is copyrighted software and a registered trademark of Intercim. VERICUT is copyrighted software and a registered trademark of CGTech. Pro/PLASTIC ADVISOR is powered by Moldflow technology. Moldflow is a registered trademark of Moldflow Corporation. The JPEG image output in the Pro/Web.Publish module is based in part on the work of the independent JPEG Group. DFORMD.DLL is copyrighted software from Compaq Computer Corporation and may not be distributed. METIS, developed by George Karypis and Vipin Kumar at the University of Minnesota, can be researched at http://www.cs.umn.edu/~karypis/metis. METIS is © 1997 Regents of the University of Minnesota. LightWork Libraries are copyrighted by LightWork Design 1990–2001. Visual Basic for Applications and Internet Explorer is copyrighted software of Microsoft Corporation. Adobe Acrobat Reader is copyrighted software of Adobe Systems. Parasolid © Electronic Data Systems (EDS). Windchill Info*Engine Server contains IBM XML Parser for Java Edition and the IBM Lotus XSL Edition. Pop-up calendar components Copyright © 1998 Netscape Communications Corporation. All Rights Reserved. TECHNOMATIX is copyrighted software and contains proprietary information of Technomatix Technologies Ltd. Apache Server, Tomcat, Xalan, and Xerces are technologies developed by, and are copyrighted software of, the Apache Software Foundation (http://www.apache.org/) – their use is subject to the terms and limitations at: http://www.apache.org/LICENSE.txt. UnZip (© 1990-2001 Info-ZIP, All Rights Reserved) is provided “AS IS” and WITHOUT WARRANTY OF ANY KIND. For the complete Info-ZIP license see ftp://ftp.info-zip.org/pub/infozip/license.html. Gecko and Mozilla components are subject to the Mozilla Public License Version 1.1 at http://www.mozilla.org/MPL/. Software distributed under the MPL is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the MPL for the specific language governing rights and limitations. Technology "Powered by Groove" is provided by Groove Networks, Inc. Technology "Powered by WebEx" is provided by WebEx Communications, Inc. Acrobat Reader is Copyright © 1998 Adobe Systems Inc. Oracle 8i run-time, Copyright © 2000 Oracle Corporation. The Java™ Telnet Applet (StatusPeer.java, TelnetIO.java, TelnetWrapper.java, TimedOutException.java), Copyright © 1996, 97 Mattias L. Jugel, Marcus Meißner, is redistributed under the GNU General Public License. This license is from the original copyright holder
and the Applet is provided WITHOUT WARRANTY OF ANY KIND. You may obtain a copy of the source code for the Applet at http://www.mud.de/se/jta (for a charge of no more than the cost of physically performing the source distribution), by sending an e-mail to [email protected] or [email protected]—you are allowed to choose either distribution method. The source code is likewise provided under the GNU General Public License. GTK+The GIMP Toolkit are licensed under the GNU LPGL. You may obtain a copy of the source code at http://www.gtk.org/, which is likewise provided under the GNU LPGL.
UNITED STATES GOVERNMENT RESTRICTED RIGHTS LEGEND 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), is 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. 110102 Parametric Technology Corporation, 140 Kendrick Street, Needham, MA 02494 USA
Contents
About This Guide ...... vii Documentation for PTC Products...... viii Documentation Conventions ...... viii Critical Technical Changes ...... 1-1 Patterns ...... 1-2 Selection...... 1-2 System Colors ...... 1-2 Version String...... 1-2 pfcModel.Model.GetInfo ...... 1-2 PRO_JAVA_COMMAND...... 1-3 New Methods ...... 2-1 Assembly...... 2-2 Data Exchange...... 2-3 Dimensions...... 2-3 Drawings...... 2-4 Web Browser...... 2-12 Family Table...... 2-13 Features ...... 2-13 Interoperability...... 2-13 J-Link Tasks...... 2-13 Pro/TOOLKIT DLL Tasks ...... 2-14 Models ...... 2-15 Model Items...... 2-16 Session...... 2-16 Simplified Representations...... 2-17 Solids...... 2-17 Superseded Methods ...... 2-18 Miscellaneous Technical Changes ...... 3-1 Choosing the JRE Version ...... 3-2 Canceling Pro/ENGINEER Events...... 3-2 Text Directory Support ...... 3-2 JAR Files ...... 3-2
v Data Exchange ...... 3-3 Model Retrieval Errors ...... 3-3
vi Pro/ENGINEER Wildfire J-Link Release Notes
About This Guide
This document provides release-specific information for the J-Link Wildfire Release. It describes new methods in J-Link Wildfire and also includes critical changes that may require investigation of existing applications and adjustment of existing code.
Topic Page Documentation for PTC Products ...... viii Documentation Conventions ...... viii
vii Documentation for PTC Products PTC provides documentation in the following forms:
• Context-sensitive Help
• PDF books
• Information located on the PTC Web site at http://www.ptc.com/.
When your PTC software has been installed, you can right-click on any menu or dialog box to get Help. You can also choose a command from the Help menu.
All books are available in HTML and PDF formats on the documentation CD- ROM. You can view HTML books with your Internet browser. To view and print PDF books, you must have the Acrobat Reader installed.
PTC welcomes your suggestions and comments on its documentation. You can send feedback in the following ways:
• Send comments electronically to [email protected].
Documentation Conventions PTC documentation uses the following conventions:
Convention Item Example
Bold Menus paths, dialog box Click File > Save. options, buttons, and other Assignee check box. elements from the user License File dialog box. interface.
Courier User input, system Processing completed. messages, file names
Courier with less-than Variables for which the user output=
viii Pro/ENGINEER Wildfire J-Link Release Notes 1 Critical Technical Changes
This chapter describes the changes in Pro/ENGINEER Wildfire and J-Link that might require alteration of existing J-Link applications.
Topic Page Patterns ...... 1-2 Selection ...... 1-2 System Colors...... 1-2 Version String ...... 1-2 pfcModel.Model.GetInfo ...... 1-2 PRO_JAVA_COMMAND...... 1-3
1-1 Patterns Patterns are treated as features in Pro/ENGINEER Wildfire. A new feature type, FEATTYPE_PATTERN, is used for the pattern header feature. The result of the pattern header feature for users of previous versions of J-Link is that models that contain patterns get one extra feature of type FEATTYPE_PATTERN_HEAD in the regeneration list. This changes the feature numbers of all subsequent features, including those in the group.
Selection The method pfcSession.BaseSession.Select enables you to make one or more selections based on the input filters and options. In Pro/ENGINEER Wildfire, the selection user interface has migrated to a new mechanism and the Get Select menu is no longer displayed. You must provide detailed instructions through the message window or dialog box that the application expects the user to make a selection.
External applications should:
• Prompt the user to make a selection as well as specify what to select.
• Be alert to issues caused by the change in pfcSession.BaseSession.Select.
System Colors Pro/ENGINEER Wildfire features a new system of standard colors. Applications using any of the standard colors defined in the enumerated type pfcBase.StdColor will experience changes in application-created graphics, text, or other colors. Applications using customized RGB values for colors will be affected because of reduced contrast between the custom application color and entities in the window.
Version String The version name of this Pro/ENGINEER release is Wildfire. This string is passed to the method pfcGlobal.pfcGlobal.GetProEVersion. Applications using numerical routines to attempt to determine version compatibility will not be successful. pfcModel.Model.GetInfo Pro/ENGINEER Wildfire can retrieve models from URLs and pseudo-URLs from sources such as HTTP, Pro/INTRALINK, Windchill, and Groove. The method pfcModel.Model.GetInfo() returns a pfcModel.ModelDescriptor with the host and path set to portions of that URL, for example: • descr.GetHost () "groove" • descr.GetPath () "//Conference1/" or
1-2 Pro/ENGINEER Wildfire J-Link Release Notes • descr.GetHost() "http" • descr.GetPath() "//webserver.mycompany.com/LOCATION/" Code using the return of pfcModel.Model.GetInfo for file-system related operations may require adjustment.
PRO_JAVA_COMMAND The syntax for the environment variable PRO_JAVA_COMMAND has changed.
In the Wildfire release, set the environment variable to the name of the Java command to be used to run a synchronous application.
setenv PRO_JAVA_COMMAND "java_g"
Do not include the class com.ptc.pfc.Implementation.Starter as was required in previous releases.
Pro/ENGINEER Wildfire features a configuration option jlink_java2 to set up J-Link to use Java 1.2 and later, instead of setting the PRO_JAVA_COMMAND variable.
Critical Technical Changes 1-3
2 New Methods
This chapter describes the J-Link methods that are new for the Wildfire release.
Topic Page Assembly...... 2-2 Data Exchange ...... 2-3 Dimensions...... 2-3 Drawings ...... 2-4 Web Browser ...... 2-12 Family Table ...... 2-13 Features...... 2-13 Interoperability ...... 2-13 Models...... 2-15 Model Items...... 2-16 Session ...... 2-16 Simplified Representations ...... 2-17 Solids...... 2-17 Superseded Methods...... 2-18
2-1 Assembly
New Method Description
Component Attributes
pfcComponentFeat.ComponentFeat.GetIsBulkitem
pfcComponentFeat.ComponentFeat.GetIsSubstitute
pfcComponentFeat.ComponentFeat.GetComponentType
pfcComponentFeat.ComponentFeat.SetComponentType
pfcComponentFeat.ComponentFeat.GetIsPlaced Provides access to assembly component information and pfcComponentFeat.ComponentFeat.SetIsPlaced attributes.
pfcComponentFeat.ComponentFeat.GetIsPackaged
pfcComponentFeat.ComponentFeat.GetIsUnderconstrained
pfcComponentFeat.ComponentFeat.GetIsFrozen
pfcComponentFeat.ComponentFeat.GetPosition
pfcComponentFeat.ComponentFeat.SetPosition
Creating Components
pfcAssembly.Assembly.AssembleComponent
pfcAssembly.Assembly.AssembleByCopy Allows you to create new components and to access their pfcAssembly.Assembly.AssembleComponent position and constraints.
pfcComponentFeat.ComponentFeat.GetConstraints
pfcComponentFeat.ComponentFeat.SetConstraints
Skeleton Models
pfcAssembly.Assembly.AssembleSkeleton
pfcAssembly.Assembly.AssembleSkeletonByCopy Provides access to skeleton models in assemblies. pfcAssembly.Assembly.GetSkeleton
pfcAssembly.Assembly.DeleteSkeleton
pfcSolid.Solid.GetIsSkeleton
2-2 Pro/ENGINEER Wildfire J-Link Release Notes New Method Description
Exploded States
pfcAssembly.Assembly.GetActiveExplodedState
pfcAssembly.Assembly.GetDefaultExplodedState Provides access to assembly exploded states. pfcAssembly.ExplodedState.Activate
pfcAssembly.ExplodedState.Delete
Data Exchange
New Method Description
Import 3D Geometry Files
pfcSession.BaseSession.ImportNewModel Imports files of other formats and creates a new model or set of models with the specified name. The created models can be assemblies, parts, or drawings.
Shrinkwrap Export
pfcSolid.Solid.ExportShrinkwrap Exports the specified solid model as a Shrinkwrap model. This is similar to using the Pro/ENGINEER Save As dialog box and selecting the type as Shrinkwrap.
Dimensions
New Method Description
Values
pfcDimension.BaseDimension.GetDimValue Provides access to the dimension value as a double pfcDimension.BaseDimension.SetDimValue instead of a pfcModelItem.ParamValue object.
New Methods 2-3 Drawings
New Method Description
Creating from Templates
pfcSession.BaseSession.CreateDrawingFromTemplate Creates a drawing from the drawing template and returns the created drawing.
Detail Entities
pfcDetail.pfcDetail.DetailEntityInstructions_Create
pfcDetail.DetailEntityInstructions.GetGeometry
pfcDetail.DetailEntityInstructions.SetGeometry
pfcDetail.DetailEntityInstructions.GetIsConstruction
pfcDetail.DetailEntityInstructions.SetIsConstruction
pfcDetail.DetailEntityInstructions.GetIsHidden
pfcDetail.DetailEntityInstructions.SetIsHidden
pfcDetail.DetailEntityInstructions.GetColor
pfcDetail.DetailEntityInstructions.SetColor
pfcDetail.DetailEntityInstructions.GetFontName
pfcDetail.DetailEntityInstructions.SetFontName Provides access to drawing detail entities. pfcDetail.DetailEntityInstructions.GetWidth
pfcDetail.DetailEntityInstructions.SetWidth
pfcDetail.DetailEntityInstructions.GetView
pfcDetail.DetailEntityInstructions.SetView
pfcDetail.DetailEntityItem.GetInstructions
pfcDetail.DetailEntityItem.GetSymbolDef
pfcDetail.DetailEntityItem.Draw
pfcDetail.DetailEntityItem.Erase
pfcDetail.DetailEntityItem.Remove
2-4 Pro/ENGINEER Wildfire J-Link Release Notes New Method Description
pfcDetail.DetailEntityItem.Modify Provides access to drawing detail entities.
Detail Groups
pfcDetail.pfcDetail.DetailGroupInstructions_Create
pfcDetail.DetailGroupInstructions.GetName
pfcDetail.DetailGroupInstructions.SetName
pfcDetail.DetailGroupInstructions.GetElements
pfcDetail.DetailGroupInstructions.SetElements Provides access to drawing detail groups. pfcDetail.DetailGroupInstructions.GetIsDisplayed
pfcDetail.DetailGroupInstructions.SetIsDisplayed
pfcDetail.DetailGroupItem.GetInstructions
pfcDetail.DetailGroupItem.Draw
pfcDetail.DetailGroupItem.Erase
pfcDetail.DetailGroupItem.Modify
Detail Items
pfcModelItem.ModelItemOwner.ListItems Provides access to detail items in J-Link. Detail items include pfcDetail.DetailItemOwner.ListDetailItems entities, notes, groups, symbol definitions, and symbol pfcModelItem.ModelItemOwner.GetItemById instances.
pfcDetail.DetailItemOwner.CreateDetailItem
pfcDetail.DetailItemOwner.CreateDetailItem
Detail Notes
pfcDetail.pfcDetail.DetailNoteInstructions_Create
pfcDetail.DetailNoteInstructions.GetTextLines
pfcDetail.DetailNoteInstructions.SetTextLines Provides access to detail notes.
pfcDetail.DetailNoteInstructions.GetIsDisplayed
pfcDetail.DetailNoteInstructions.SetIsDisplayed
New Methods 2-5 New Method Description
pfcDetail.DetailNoteInstructions.GetIsReadOnly
pfcDetail.DetailNoteInstructions.SetIsReadOnly
pfcDetail.DetailNoteInstructions.GetIsMirrored
pfcDetail.DetailNoteInstructions.SetIsMirrored
pfcDetail.DetailNoteInstructions.GetHorizontal
pfcDetail.DetailNoteInstructions.SetHorizontal
pfcDetail.DetailNoteInstructions.GetVertical
pfcDetail.DetailNoteInstructions.SetVertical
pfcDetail.DetailNoteInstructions.GetColor
pfcDetail.DetailNoteInstructions.SetColor
pfcDetail.DetailNoteInstructions.GetLeader Provides access to detail notes.
pfcDetail.DetailNoteInstructions.SetLeader
pfcDetail.DetailNoteInstructions.GetTextAngle
pfcDetail.DetailNoteInstructions.SetTextAngle
pfcDetail.DetailNoteItem.GetInstructions
pfcDetail.DetailNoteItem.GetSymbolDef
pfcDetail.DetailNoteItem.GetLineEnvelope
pfcDetail.DetailNoteItem.GetModelReference
pfcDetail.DetailNoteItem.Draw
pfcDetail.DetailNoteItem.Show
pfcDetail.DetailNoteItem.Erase
pfcDetail.DetailNoteItem.Remove
pfcDetail.DetailNoteItem.Modify
2-6 Pro/ENGINEER Wildfire J-Link Release Notes New Method Description
Detail Symbol Definitions
pfcDetail.pfcDetail.DetailSymbolDefInstructions_Create
pfcDetail.DetailSymbolDefInstructions.GetSymbolHeight
pfcDetail.DetailSymbolDefInstructions.SetSymbolHeight
pfcDetail.DetailSymbolDefInstructions.GetHasElbow
pfcDetail.DetailSymbolDefInstructions.SetHasElbow
pfcDetail.DetailSymbolDefInstructions. GetIsTextAngleFixed Provides access to detail symbol pfcDetail.DetailSymbolDefInstructions. definitions. SetIsTextAngleFixed
pfcDetail.DetailSymbolDefInstructions.GetHeight
pfcDetail.DetailSymbolDefInstructions.SetHeight
pfcDetail.DetailSymbolDefInstructions.GetAttachments
pfcDetail.DetailSymbolDefInstructions.SetAttachments
pfcDetail.DetailSymbolDefInstructions.GetFullPath
pfcDetail.DetailSymbolDefInstructions.SetFullPath
pfcDetail.DetailSymbolDefInstructions.GetReference
pfcDetail.DetailSymbolDefInstructions.SetReference
pfcDetail.DetailSymbolDefItem.ListDetailItems
pfcDetail.DetailSymbolDefItem.GetInstructions
pfcDetail.DetailSymbolDefItem.CreateDetailItem
pfcDetail.DetailSymbolDefItem.Modify
pfcDetail.DetailItemOwner.RetrieveSymbolDefinition
New Methods 2-7 New Method Description
Detail Symbol Instances
pfcDetail.pfcDetail.DetailSymbolInstInstructions_Create
pfcDetail.DetailSymbolInstInstructions.GetIsDisplayed
pfcDetail.DetailSymbolInstInstructions.SetIsDisplayed
pfcDetail.DetailSymbolInstInstructions.GetColor
pfcDetail.DetailSymbolInstInstructions.SetColor
pfcDetail.DetailSymbolInstInstructions.GetSymbolDef
pfcDetail.DetailSymbolInstInstructions.SetSymbolDef
pfcDetail.DetailSymbolInstInstructions. GetAttachOnDefType
pfcDetail.DetailSymbolInstInstructions. SetAttachOnDefType
pfcDetail.DetailSymbolInstInstructions.GetDefAttachment
pfcDetail.DetailSymbolInstInstructions.SetDefAttachment Provides access to detail symbol pfcDetail.DetailSymbolInstInstructions.GetInstAttachment instances. pfcDetail.DetailSymbolInstInstructions.SetInstAttachment
pfcDetail.DetailSymbolInstInstructions.GetAngle
pfcDetail.DetailSymbolInstInstructions.SetAngle
pfcDetail.DetailSymbolInstInstructions.GetHeight
pfcDetail.DetailSymbolInstInstructions.SetHeight
pfcDetail.DetailSymbolInstInstructions.GetTextValues
pfcDetail.DetailSymbolInstInstructions.SetTextValues
pfcDetail.DetailSymbolInstInstructions. GetCurrentTransform
pfcDetail.DetailSymbolInstItem. GetInstructions
pfcDetail.DetailSymbolInstItem.Draw
2-8 Pro/ENGINEER Wildfire J-Link Release Notes New Method Description
pfcDetail.DetailSymbolInstItem.Erase
pfcDetail.DetailSymbolInstItem.Show Provides access to detail symbol instances. pfcDetail.DetailSymbolInstItem.Remove
pfcDetail.DetailSymbolInstItem.Modify
Dimensions
pfcModelItem.ModelItemOwner.ListItems
pfcModelItem.ModelItemOwner.GetItemById
pfcSelect.Selection.GetSelItem
pfcDimension2D.DrawingDimCreateInstructions_Create
pfcModel2D.Model2D.CreateDrawingDimension
pfcDimension2D.Dimension2D.GetIsAssociative
pfcDimension2D.Dimension2D.GetIsReference
pfcDimension2D.Dimension2D.GetAttachmentPoints
pfcDimension2D.Dimension2D.GetDimensionSenses
pfcDimension2D.Dimension2D.GetOrientationHint Provides access to dimensions owned by and displayed in pfcDimension2D.Dimension2D.GetBaselineDimension drawings.
pfcDimension2D.Dimension2D.GetLocation
pfcDimension2D.Dimension2D.GetView
pfcDimension2D.Dimension2D.ConvertToLinear
pfcDimension2D.Dimension2D.ConvertToOrdinate
pfcDimension2D.Dimension2D.ConvertToBaseline
pfcDimension2D.Dimension2D.SetLocation
pfcDimension2D.Dimension2D.SwitchView
pfcModel2D.Model2D.SetViewDisplaying
New Methods 2-9 New Method Description
Sheets
pfcSheet.SheetOwner.GetSheetData
pfcSheet.SheetOwner.GetSheetTransform
pfcSheet.SheetOwner.GetSheetScale
pfcSheet.SheetOwner.GetSheetFormat
pfcSheet.SheetOwner.GetSheetBackgroundView
pfcSheet.SheetOwner.GetNumberOfSheets Provides access to drawing sheets. pfcSheet.SheetOwner.GetCurrentSheetNumber
pfcSheet.SheetOwner.AddSheet
pfcSheet.SheetOwner.DeleteSheet
pfcSheet.SheetOwner.ReorderSheet
pfcSheet.SheetOwner.RegenerateSheet
pfcSheet.SheetOwner.SetSheetScale
pfcSheet.SheetOwner.SetSheetFormat
pfcSheet.SheetOwner.SetCurrentSheetNumber
Tables
pfcSelect.Selection.GetSelItem
pfcSelect.Selection.GetSelTableCell
pfcSelect.Selection.GetSelTableSegment
pfcTable.TableOwner.CreateTable
pfcTable.TableOwner.RetrieveTable Provides access to drawing tables. pfcTable.TableOwner.ListTables
pfcTable.TableOwner.GetTable
pfcTable.Table.GetRowCount
pfcTable.Table.GetColumnCount
2-10 Pro/ENGINEER Wildfire J-Link Release Notes New Method Description
pfcTable.Table.CheckIfIsFromFormat
pfcTable.Table.GetRowSize
pfcTable.Table.GetColumnSize
pfcTable.Table.GetText
pfcTable.Table.GetCellNote
pfcTable.Table.Erase
pfcTable.Table.Display Provides access to drawing tables. pfcTable.Table.RotateClockwise
pfcTable.Table.CheckIfIsFromFormat
pfcTable.Table.InsertRow
pfcTable.Table.InsertColumn
pfcTable.Table.MergeRegion
pfcTable.Table.SubdivideRegion
pfcTable.Table.DeleteRow
pfcTable.Table.DeleteColumn
pfcTable.Table.SetText
pfcTable.TableOwner.DeleteTable
Views
pfcModel2D.Model2D.CreateView
pfcSelect.Selection.GetSelView2D
pfcModel2D.Model2D.List2DViews Provides access to drawing views. pfcModel2D.Model2D.GetViewByName
pfcModel2D.Model2D.GetViewDisplaying
pfcModel2D.Model2D.GetBackgroundView
pfcSheet.SheetOwner.GetSheetBackgroundView
New Methods 2-11 New Method Description
pfcView2D.View2D.GetSheetNumber
pfcView2D.View2D.GetIsBackground
pfcView2D.View2D.CheckIsDimensionDisplayed
pfcView2D.View2D.GetModel
pfcView2D.View2D.GetScale
pfcView2D.View2D.GetIsScaleUserdefined
pfcView2D.View2D.GetOutline
pfcView2D.View2D.GetLayerDisplayStatus Provides access to drawing views. pfcView2D.View2D.GetIsViewdisplayLayerDependent
pfcView2D.View2D.GetDisplay
pfcView2D.View2D.GetTransform
pfcView2D.View2D.GetName
pfcView2D.View2D.SetScale
pfcView2D.View2D.Translate
pfcView2D.View2D.Delete
pfcView2D.View2D.Regenerate
pfcView2D.View2D.SetLayerDisplayStatus
pfcView2D.View2D.SetDisplay
Web Browser
New Method Description
pfcWindow.Window.GetBrowserSize() Enables you to find and change the size of the Pro/ENGINEER browser. pfcWindow.Window.SetBrowserSize()
pfcWindow.Window.GetURL() Enables you to find and change the URL displayed in the Pro/ENGINEER browser. pfcWindow.Window.SetURL()
2-12 Pro/ENGINEER Wildfire J-Link Release Notes Family Table
New Method Description
pfcFamily.FamilyMember.CreateColumn Creates a new column given a properly defined symbol and column type. The results of this call are passed to pfcFamily.FamilyMember.AddColumn to add the column to the model's family table.
pfcFamily.FamilyMember.GetColumn Returns a pfcFamily.FamilyTableColumn object with the designated symbol.
pfcFamily.FamilyTableColumn.GetType Returns an enumerated value indicating the type of parameter governed by the column in the family table.
pfcFamily.FamilyMember.SetCell Assigns a value to a column in a particular family table instance.
Features
New Method Description
pfcFeature.Feature.GetFeatTypeName Returns a string representation of the feature type.
pfcFeature.Feature.GetFeatSubType Returns a string representation of the feature subtype, for example, Extrude for a protrusion feature.
Interoperability
J-Link Tasks Pro/ENGINEER Wildfire allows J-Link programmers to call methods in other J-Link–based task libraries. This capability allows programmers to reuse code for J-Link applications from a different application to:
• Launch tasks (custom Java classes) from other customization applications
• Use synchronous J-Link Java classes from an asynchronous J-Link application.
New Methods 2-13 New Method Description
pfcSession.BaseSession.StartJLinkApplication Registers and starts a J-Link application.
pfcJLink.JLinkApplication.ExecuteTask Calls a properly designated task method in the J-Link library. You can pass arbitrary combinations of input arguments to the library method
pfcJLink.JLinkApplication.Stop Shuts down a J-Link application previously loaded by pfcSession.BaseSession.StartJLink Application.
Pro/TOOLKIT DLL Tasks Pro/ENGINEER Wildfire allows Pro/TOOLKIT programmers to create reusable Pro/TOOLKIT DLL-based task libraries. This capability assists programmers to use Pro/TOOLKIT applications in the following situations
• Launch DLL tasks (custom functions) from other customization applications like J-Link.
• Extend J-Link and Pro/Web.Link applications into areas not covered by the native Java classes.
• Place computation-intensive code in a Pro/TOOLKIT DLL for best performance.
• Connect asynchronous applications to existing user DLLs to avoid duplicating code.
New Method Description
pfcSession.BaseSession.LoadProToolkitDll Registers and starts a Pro/TOOLKIT DLL.
pfcProToolkit.Dll.ExecuteFunction Calls a properly designated function in the Pro/TOOLKIT DLL library. You can pass arbitrary combinations of input arguments to the library function.
pfcProToolkit.Dll.Unload Shuts down a Pro/TOOLKIT DLL previously loaded by pfcSession.BaseSession.LoadProToolkitDll.
2-14 Pro/ENGINEER Wildfire J-Link Release Notes Models
New Method Description
Erase with Dependencies
pfcModel.Model.EraseAll Erases the indicated model and all of its children simultaneously. If the model is used in another model in session, the method will fail. If a child is used in another model in session, it will not be erased with its parent.
Access by Filename
pfcModel.Model.GetFileName Allows J-Link operations on models using the model’s file pfcSession.BaseSession.GetModelFromFileName name, for example prt0001.prt. pfcModel.ModelDescriptor.GetFileName
pfcModel.pfcModel.ModelDescriptor_CreateFromFileName
New Methods 2-15 Model Items
New Method Description
Locating
pfcModelItem.ModelItemOwner.GetItemByName Returns a pointer to an item or feature, given the name and the type of the item.
The valid item types are:
• Edge
• Surface
• Feature
• Coordinate System
• Axis
• Point
• Quilt
• Curve
• Layer
• Note
pfcSolid.Solid.GetFeatureByName Returns a pointer to an item or feature, given the name and the type of the item.
Session
New Method Description
List Files
pfcSession.BaseSession.ListFiles Returns a list of file names, including the full path and file name, at a designated pfcSession.BaseSession.ListSubdirectories location.
System Environment Variables
pfcSession.BaseSession.GetEnvironmentVariable Returns the value of a system variable as set in the Pro/ENGINEER environment This value may not be similar to the value set in the shell that started an asynchronous J-Link application.
2-16 Pro/ENGINEER Wildfire J-Link Release Notes Simplified Representations
New Method Description
pfcSimpRep.SimpRep.GetSimpRepType Returns the type of simplified representation, that is, master, user defined, or other special types.
Solids
New Method Description
3D Notes
pfcNote.Note.GetLines
pfcNote.Note.SetLines
pfcNote.Note.GetURL
pfcNote.Note.SetURL Provides access to 3D model notes.
pfcNote.Note.Display
pfcNote.Note.Delete
pfcNote.Note.GetOwner
Cross Sections
pfcSolid.Solid.ListCrossSections
pfcSolid.Solid.GetCrossSection
pfcXSection.XSection.GetName
pfcXSection.XSection.SetName Provides access to cross-sections.
pfcXSection.XSection.GetXSecType
pfcXSection.XSection.Delete
pfcXSection.XSection.Display
pfcXSection.XSection.Regenerate
New Methods 2-17 Superseded Methods The method pfcSession.BaseSession.GetConfigOptionValues supersedes the Method pfcSession.BaseSession.GetConfigOption. It provides a sequence containing all of the values set for multiple valued configuration options. The method pfcSession.BaseSession.GetConfigOption is still supported but more limited in its capacity.
2-18 Pro/ENGINEER Wildfire J-Link Release Notes 3 Miscellaneous Technical Changes
This chapter describes miscellaneous technical changes for this release of J-Link.
Topic Page Choosing the JRE Version...... 3-2 Canceling Pro/ENGINEER Events...... 3-2 Text Directory Support...... 3-2 JAR Files ...... 3-2 Data Exchange ...... 3-3 Model Retrieval Errors...... 3-3
3-1 Choosing the JRE Version For Pro/ENGINEER Release 2001, a system variable controlled the use of JRE 1.1 or JRE 1.2 from synchronous J-Link applications. In Pro/ENGINEER Wildfire, the configuration option jlink_java2 allows you to change between using Java 1.1 and Java.
To run J-Link with Java 1.1, set the configuration option jlink_java2 to off. Pro/ENGINEER uses the system command jre to invoke the Java application. This is the default configuration option.
To run J-Link with Java 1.2 and higher, set the configuration option to on. Pro/ENGINEER uses the system command java to invoke the Java application.
Canceling Pro/ENGINEER Events In Pro/ENGINEER Wildfire, J-Link allows you to cancel certain notification events. The static method pfcExceptions.XCancelProEAction.Throw must be called from the body of an action listener to cancel the impending Pro/ENGINEER operation. This method will throw a J-Link exception signaling to Pro/ENGINEER to cancel the listener event.
Note: The application should not catch the J-Link exception, or if caught, the application should throw the exception again, so that Pro/ENGINEER is forced to handle it.
The following events can be cancelled using this technique:
• pfcSession.SessionActionListener.OnBeforeModelErase
• pfcSession.SessionActionListener.OnBeforeModelDelete
• pfcSession.SessionActionListener.OnBeforeModelRename
• pfcSession.SessionActionListener.OnBeforeModelSave
• pfcSession.SessionActionListener.OnBeforeModelPurge
• pfcSession.SessionActionListener.OnBeforeModelCopy
• pfcModel.ModelActionListener.OnBeforeParameterCreate
• pfcModel.ModelActionListener.OnBeforeParameterDelete
Text Directory Support Synchronous J-Link applications support the text_dir field in the registry file that points Pro/ENGINEER to the directory containing the menu and message text files. The entry must include the path to a directory called text, but not the text directory itself.
JAR Files J-Link for Pro/ENGINEER Wildfire includes the following consolidated JAR files:
3-2 Pro/ENGINEER Wildfire J-Link Release Notes • The JAR file
• The JAR file
Data Exchange The method pfcModel.Model.Export supports several new formats. Export instructions objects inheriting from the interface pfcModel.Export3DInstructions export a Pro/ENGINEER model to the specified 3D geometry format. The instructions options available are similar to the options available in the Pro/ENGINEER Save As dialog box.
Model Retrieval Errors The method pfcSolid.Solid.GetHasRetrievalErrors returns a flag if errors occur during model retrieval. During the course of retrieval of a complex assembly, Pro/ENGINEER sometimes encounters errors in retrieving particular components and assembling these components appropriately in the assembly.
In the user interface, the errors are displayed in a dialog box. In J-Link, the retrieval Methods automatically suppress or freeze problem components and return the handle of the assembly model. The retrieval error information must be obtained immediately after a call to the pfcSession.BaseSession.RetrieveModel or equivalent retrieval method.
Miscellaneous Technical Changes 3-3