Showing results for 
Search instead for 
Do you mean 

Tecnomatix .NET API New Features (as of 10.1)

by Siemens Pioneer Siemens Pioneer on ‎06-08-2016 08:09 AM - edited

The following items are new in .NET API version 12.1.3:


New TxHuman methods and properties are exposed in the .NET API, allowing users to manipulate the human and query ergonomic properties for custom analysis. Get the calculated posture angle for an angle definition using the GetPostureAngle method. Access Site location, load or force using the new GetSiteLocation , GetSiteLoad and GetSiteForce methods. Query or modify joint angles and location with the new GetJointAngles , SetJointAngles and GetJointLocation methods. See TxHuman for all new functionality.

Multiple Graphic Viewers support

In this version new methods and properties have been added to TxViewersManager for multiple Graphic viewer manipulation. The currently active Graphic viewer is returned by the GraphicViewer property. The GraphicViewers property returns a list of all open Graphic viewers. A new Graphic viewer can be created with the CreateNewGraphicViewer method. Graphic viewer windows can be arranged using the ArrangeGraphicViewers and BringGraphicViewerToFront methods.


New events have been added to TxViewersManager that notify when a new viewer is added or is about to be removed from the application, or if the active viewer was changed - ViewerAdded, ViewerRemoving and ViewerActivated

Component Modeling

A new method for curve creation is now available: CreateCurvesByOffsetOnBody. It creates a curve object by offsetting another curve on a surface or body. The new ItemCreated event has been added to ITxComponent. It is sent when an item has been created as a child of the component. The new CurrentModelingWorkingSpaceChanged event has been added to TxDocument. It is sent after the current modeling working space is changed.


The new ITxPlcRobotSignal interface has been introduced to the .NET API that defines a robot signal behavior. A new TxPlcRobotPoseSensorSignal class has been added that represents a signal which is sent from a robot to PLC when a robot reaches a specific pose. The new AddPosition, RemovePosition and UpdatePosition methods that enable adding, removing and updating conveyor positions are exposed in ITxPlcGenericConveyor interface.

e-Mail Support Reminder

For any .NET API issues, you can contact us at:

The following items are new in version 12.1.2:


The new TxLocationNote note type was introduced. This note shows the location value of an object, and can be created using the new CreateLocationNote method on the ITxNoteCreation interface using the new TxLocationNoteCreationData creation data.


The new GetTranslationLimit method, on the TxWeldLocationOperation class, adds the ability to get the translation limits of the weld location operation along the axis of a reference frame.


The LimitPermittedDistance and PermittedDistance properties were added to TxWeldOptions . The PermittedDistance property was added to TxContinuousOptions .

e-Mail Support Reminder

For any .NET API issues, you can contact us at:

The following items are new in version 12.1.1:


The option to set and get the note's background color was added to TxNote .


The ability to set a selected component as modeling scope was added to ITxComponent . The ability to end modeling and store a modeled object was added to ITxComponent . The ability to create equipment was added to TxPhysicalRoot and TxComponent .

Kinematics API

The new ITxKinematicsModellable interface was introduced, with the ability to:
Create link, using CreateLink . Create joint, using CreateJoint . Couple joints, using CoupleJoints .

Stack Interrogation

The new GetLocationAxisIntersectionPoints method, on the ITxComponent interface, adds the ability to get the intersection points of component and the line defined by the axis of the given location. The new GetPerpendicularLocationAxisIntersectionPoints method, on the ITxComponent interface, adds the ability to get the intersection points of component and the line defined by the perpendicular axis of the given location.

The following items are new in version 12.1:

Visual Studio 2013 support

As of version 12.1, developing an add-in (using the .NET API) can be done with Visual Studio 2013.

64bit support (reminder)

As of version 12, developing an add-in (using the .NET API) no longer requires installing a 32bit version. Developers can install either the 64bit or 32bit Tecnomatix application that is referenced by Visual Studio.
Detailed instructions available here.

e-Mail Support

You can contact this new support email address for any .NET API issues:

The following items are new in version 12.0TR1:

1D Approximation geometry

The GetPointOnCurveByRatio method was added to ITx1DimensionalGeometry .

Dimension Creation

The new TxCurveLengthDimension dimension type was introduced. This dimension measures the length of a curve, and can be created using the new CreateCurveLengthDimension method on the ITxDimensionCreation interface using the new TxSingleObjectDimensionCreationData creation data.

Path Editor Viewer

The new ITxPathEditorViewer interface was introduced to represent the Path Editor viewer, and allow insert and query operations.
The new ITxPathEditorViewModel interface which was also introduced, serves as the root interface for objects found in Path Editor. These can be either ITxPathEditorViewableRoboticProgram that encapsulates a Robotic program object, or ITxPathEditorViewableOperations that represents a list of operations.
To get an instance of Path Editor use TxApplication.ViewersManager.PathEditorViewer .

Conceptual Conveyor Control Point

The new IsStopper and ConditionExpression properties were added to TxPlcGenericConceptualConveyorControlPoint .

Location Calculation

The new TxLocationCalculation was introduced for calculating frames given various combinations of points/vectors.

The following items are new in version 12:


The BackgroundColor property was added to TxNote .

Generic Conveyor Path Curve

The ControlPoints property was added to TxPlcGenericConveyorPathCurve .

Generic Conceptual Conveyor Control Point

The new TxPlcGenericConceptualConveyorControlPoint class was introduced to represent control points. To set or get control points list on a specific conveyor use the new TxPlcGenericConveyorPathCurve.ControlPoints property.

Viewer tree commands support

The new ITxTreeViewerControl interface was introduced.
Implement this interface in a custom viewer to support global application tree commands (Expand/Collapse) in the custom viewer.

64bit support

As of version 12, developing an add-in (using the .NET API) no longer requires installing a 32bit version. Developers can install either the 64bit or 32bit Tecnomatix application that is referenced by Visual Studio.
Detailed instructions available here.

The following items are new in version 11.1TR3:


The FullPath property was added to TxLibraryStorage .

Frame controls

The VisualizePickedFrameInGraphicViewer property was added to TxFrameComboBoxCtrl , TxFrameEditBoxCtrl .


The new MovementTypeChanged event was added. Along with the new TxPlacementCollisionControlMovementTypeChangedEventHanlder delegate and the TxPlacementCollisionControlMovementTypeChangedEventArgs event arguments.


The new LoadLineSimulationStudy methods were added.

PLC generic conveyor

The new ITxPlcGenericConveyor interface was added to represent PLC generic conveyor.

The following items are new in version 11.1TR2:


The Object property is now a dependency property, a new ComboBoxItemsSource dependency property was added.

Set object transparency

The Transparency property was added to ITxDisplayableObject .

PLC Sensors

ITxPlcDeviceDistanceSensor interface was introduced to represent a PLC device distance sensor object. ITxPlcRobotPoseSensor interface was introduced to represent a PLC robot pose sensor object.


The RegistryPath property was added.


The new Projected event was added.


The new SetCellCheckboxValue and GetCellCheckboxValue methods were added, for handling the check box cell in the object grid.

The following items are new in version 11.1TR1:

ITxRobot interface

The SetConveyorTriggerSignal and SetConveyorPositionSignal methods were added.

Motion Options

The IgnoreLogicInOlpCommands property was added.


The AllowListObjectsOnly property was added.


The SetCurrentFrame method was added.


Multiple insertion/deletion information was added to the grid events arguments classes, which allows indication of batch delete or insert, and updating data can be done after finishing the operation. In TxObjGridCtrl_ObjectInsertedEventArgs – ObjectNumberInCurrentInsertion and TotalObjectsInCurrentInsertion were added. In TxObjGridCtrl_RowDeletedEventArgs – RowNumberInCurrentDeletion and TotalRowsInCurrentDeletion were added.

The following items are new in version 11.1:

Creation of Human operations

As of this version, users can create human operations for the objects represented by the following interfaces:
To create new operations use the new ITxHumanOperationCreation interface, and the ITxOperationCreation interface (to create Human compound operations).
Use the new matching creation data object and methods, for example, in order to create a human compound operation, use the following method:
ITxOperationCreation.CreateHumanCompoundOperation(TxHumanCompoundOperationCreationData creationData) .

Human Event

As of this version, users can create human events, represented by the ITxHumanEvent , interface, using the new method:
ITxSimulationHumanEventParentOperation.CreateHumanEvent and passing the new TxHumanEventCreationData creation data class.


A new WPF UI control, that resembles a combo box, enables end users to choose objects either by selecting them from a combo box, or by picking them in the Graphics Viewer or typing object names in the text field.
This control is similar to the existing TxObjComboBoxCtrl WinForms control, but it is built on top of WPF technology, for seamless use in WPF windows.


The DecimalPlaces property was added.


The UseDecimalPlacesFromOption property was added.


The ShowModal method was added.


The GetActiveRemoteTcpAbsolutePosition method was added.

Planning representation of Weld Point

A new planning type, TxPlanningWeldPoint has been introduced in version 11.1. It denotes the planning representation of the Weld Point and contains the ProcessType property which indicates the process type of the MFG both on eMServer and Teamcenter platforms.

The following items are new in version 11.0TR2:

PLC Module

The PLC Module object has been introduced in version 11TR02.
The ITxPlcModule interface was introduced to represent a PLC module,
where each PLC module object contains entry objects that can be queried by the ITxPlcModule.PlcEntries property.

Each entry is represented by one of the following interfaces: ITxPlcModuleSimpleCall , ITxPlcModuleExpression , ITxPlcModuleStatement .
ITxPlcModuleExpression consists of two properties:
Expression which represents the PLC expression object.
ResultSignal which represents the target signal for the expression evaluation during line simulation.

Plc Modules on a PLC program can be retrieved using the new TxPlcProgram.PlcModules property and can be created using the new TxPlcModuleCreationData class and the TxPlcProgram.CreateModule method.

End Item object

As of this version, the End Item representation of an object has been added and several new interfaces were introduced:
ITxEndItemProvider , ITxEndItemBase , ITxEndItemRoot
An object that can have End Item representation can implement the ITxEndItemProvider interface and expose the new ITxEndItemProvider.EndItemRepresentation property of ITxEndItemBase type.

ITxEndItemBase contains the EngineeringRepresentation property which gets the object for current end item representation, and the EndItemRoot property of ITxEndItemRoot type, which point to the end item root object.

The ITxEndItemRoot interface contains two methods for hiding/exposing descendant's End Item objects:
ITxEndItemRoot.ExposeDescendants , ITxEndItemRoot.HideDescendants
The ITxEndItemRoot interface also contains the ITxEndItemRoot.IsDescendantsExposed property to get the descendant's exposed state.


TxMessageBar is a new WPF UI control, that can be placed inside WPF controls ( TxWindow for example), and used to show unobtrusive messages to the user. The control consists of an icon, notification and Close button.
The content of the message bar can be set by TxMessageBar.Content property. TxMessageBar.MessageType determines the icon of the message bar. A custom icon can also be configured by setting TxMessageBar.MessageType to MessageType.Custom , and setting the custom icon in the TxMessageBar.CustomImage property.

The following items are new in version 11.0TR1:

Selection of faces by Object controls

As of version 11.0 TR1, users can select faces using the Tecnomatix.Engineering.Ui~Tecnomatix.Engineering.Ui..html TxObjEditBoxCtrl object edit control and the corresponding TxObjEditBoxControl WPF control.
To use these controls, set the TxObjEditCtrl.ValidatorType or TxObjEditCtrlControl.ValidatorType property to TxValidatorType.Faces or TxValidatorType.AnyLocatableObjectAndFace
TxValidatorType.Faces enables selecting faces only, and only when picking objects in the Graphic Viewer.
Using TxValidatorType.AnyLocatableObjectAndFace enables selecting any object, including faces. In order to select faces when picking in the Graphic Viewer, change the Pick Level in the application to “Face Pick Level”.

ISO Parametric Curves API

As of this version, the following new API methods enable users to create and manipulate ISO parametric curves:
Using as parameters the new TxCurveIsoParametricCreationData data class.
The new ITxExactGeometryFace interface for face objects has been introduced. It includes the U, V parameters related method, ITxExactGeometryFace.GetParametricRange which returns a TxUVParametersRectangle structure that defines the U, V parametric range of a face.
Also ITxExactGeometryFace.GetPoint and ITxExactGeometryFace.GetNormal get TxUVParametersPoint struct of U and V parameters as input, and return a vector. Other methods were also added. In addition, several methods were added to the ITx1Dimensional interface for manipulating curve objects:

Note Improvements

The new Zoomable and DisplayLeaderLine properties were added to TxNote and TxNoteCreationData

Planning representation of Continuous Manufacturing Feature

A new planning type, TxPlanningContinuousMfgFeature has been introduced in version 11.0 TR1. It denotes the planning representation of the Continuous Manufacturing Feature and contains the ProcessType property which indicates the process type of the MFG both on eMServer and Teamcenter platforms.

Dialog activated events

The new DialogActivated and DialogDeactivated events were added to TxForm and TxWindow , to provide notification when focus was gained or lost by a different semi modal dialog.

The following items are new in version 11:


As of version 11, Tecnomatix products support Windows Presentation Foundation (WPF). To create WPF windows in Tecnomatix products, inherit from the new TxWindow class, instead of using the WPF System.Windows.Window class

Frame Edit Box Control

TxFrameEditBoxCtrl can filter selected objects using the SetValidator method and ValidatorType property


Enable inclusion of customer information from Process Simulate in the downloaded file as part of the robot template mechanism (not only hard coded keywords), using the new TxOlpDownloadTemplateServices class.

A new method, TxOlpDownloadTemplateServices was added to the ITxOlpRobotControllerParametersHandler interface. The application calls this controller method when a location or operation is moved, in order to update the location or the operation system frames with the new assignment.


In the eMS tab, the Save attributes to PSZ option now has three modes: No attributes, All and Tools and Mfg. This option can be queried by the new TxEmsOptions.SaveAttributesToPSZMode property.

Compound Menu Button Command

The new TxCompoundMenuButtonCommand class can be used to display a compound button menu.


The RobotExpert platform is supported by the Tecnomatix .NET API with some limitations concerning creation of particular objects.

Section Volume

The new GetIntersection method was added to TxSectionVolume .

Seam Manufacturing Feature

The new GetPointOnCurveByDistance method was added to TxSeamMfgFeature .

Teamcenter Private Mfg Feature

The new IsPrivate property was added to TxMfgFeature , to indicate private Mfgs on the Teamcenter platform. Also, the IsPrivateObjectType method was added to TxTcGlobalServicesProvider .

Curve on Border Creation

The new CurvePerEdge . property was added to both TxCurveSolidBorderCreationData and TxCurveSurfaceBorderCreationData . Curve on border can be created for each edge, or as a single curve per closed contour (default).

Manipulator Element

The new Font property was added to TxManipulatorTextElementData class.

Bounding Box Calculator

The new CalculateVisibleMinimalPlaneBoundingBoxVertices method was added to TxBoundingBoxCalculator .

To and From Robot Signals

In TxRobot class, new methods were added for managing To/From robot signals.

Robotic Location Operation

Additional events were added to the robotic location operation in ITxRoboticLocationOperation : ExternalAxisValuesSet , ExternalAxisValuesCleared , and MovedToParentWithDifferentAssignedRobot .

Robotic Ordered Compound Operation

Two new properties were added to the ITxRoboticOrderedCompoundOperation.RobotSet event class in TxRoboticOrderedCompoundOperation_RobotSetEventHandler : OldRobot and NewRobot .

Robotic Controller

new method MirrorSystemFrames was added to ITxRoboticControllerServices interface.

PLC Conveyor

New PLC conceptual conveyor objects have been introduced in Tecnomatix 11: TxPlcDeviceConveyor , TxPlcConveyor . They are represented by the ITxPlcConveyor interface. The PLC conveyor object can be queried from a robot object by the TxRobot.GetPlcConveyorByNumber method.

PLC Signal

As of Tecnomatix 11, the SIMBA connection has been added to the possible PLC simulation connections. As a result, OpcConnection related functionality is now obsolete, replaced by ExternalConnection related functionality, which includes the ExternalConnection property and the ExternalConnectionChanged event as well as the matching properties in TxPlcSignalCreationData .

PLC Resource on Teamcenter Platform

From Tecnomatix 11, a new resource type, TxTcPlcResource has been introduced for the Teamcenter platform, which enables the resource to serve as a signals container, and to load and store signals.

Geometric Creation

New geometric objects were added: Slot and Rectangle. Use the CreateRectangle and CreateSlot methods in ITxGeometryCreation to create them, by using the TxRectangleCreationData and TxSlotCreationData creation data classes.

Creation of Mfg Features

As of Tecnomatix 11, new data interfaces are available to create Teamcenter seam Mfg features and weld points. Use TxMfgCreationDataFactory to get creation data interfaces instead of constructing new creation objects. This new factory has methods for creating non-Teamcenter Mfgs as well as for Teamcenter private and exposed Mfgs . The new creation data interfaces can be used in the TxWeldLocationOperationCreationData.WeldPointCreationData and ITxMfgFeatureCreation methods.

Point Projection on 2/3D Entities Objects

From Tecnomatix 11, a new resource type, TxTcPlcResource has been introduced for the Teamcenter platform, which enables the resource to serve as a signals container, and to load and store signals.

PLC Resource on Teamcenter Platform

From Tecnomatix version 11, new methods for getting point projection have been introduced in ITx2Or3DimensionalGeometry.GetApproximationPointProjection , ITx2Dimensional.GetPointProjection and ITx3Dimensional.GetPointProjection .

The following items are new as of version 10.1:


As of version 10.1, Tecnomatix products support the creation of dimensions between face and edge objects. There is a new type of model object, TxAngularDimension , which represents a persistent angular dimension between two planar faces and/or linear edges. There is also a new TxLinearDimension type: TxLinearDimensionDirection.ParallelDistance . In addition, a new interface was added, ITxDimension , which utilizes filtering of dimension objects.


Two new Teamcenter operation types have been introduced in Tecnomatix v10.1, TxTcDiscreteOperation and TxTcContinuousOperation . These are Teamcenter operations that are saved in the Teamcenter server and have TxWeldOperation and TxContinuousRoboticOperation capabilities. The TxTcContinuousOperation model object represents a Teamcenter continuous operation. It can be created by defining TxTcContinuousOperationCreationData and calling the CreateTcContinuousOperation method. The TxTcDiscreteOperation model object represents a Teamcenter discrete operation. It can be created by defining TxTcDiscreteOperationCreationData and calling the CreateTcDiscreteOperation method. There are also two new interfaces: ITxWeldOperation and ITxContinuousOperation that are implemented from each pair of operations ( TxWeldOperation and TxTcDiscreteOperation ; TxContinuousRoboticOperation and TxTcContinuousOperation ) and provide their full functionality. Beginning this version, we recommend using the interfaces instead of classes, unless there are special requirements.

Seam Manufacturing Feature

The new ProjectWithEqualDistanceSpacing projection method was added to ITxSeamMfgFeature . It projects the continuous Mfg feature using equal distance spacing between the locations. In addition, new properties have been added to TxSeamMfgFeatureProjectionData , KeepPositionOnCurve , StartOffset , EndOffset , TraverseDistance .

Proximity Sensor

A new model object has been introduced in v10.1, TxPlcProximitySensor , which represents PLC proximity sensor (3DSensor) objects.

Geometric Line

The Tecnomatix .NET API has added additional methods for geometric line objects in TxLineData, for example, IsParallelTo and GetAngle .

Geometric Plane

The Tecnomatix .NET API has added additional methods for geometric plane objects in TxPlaneData, for example, IsParallelTo , GetAngle , GetIntersectionLine and GetIntersectionPoint .


The new GetAngle method was added for vector objects in TxVector .

Bounding Box

The Tecnomatix .NET API has added the CalculateVisibleMinimalPlaneBoundingBoxVertices method for calculating the vertices of an oriented bounding box, projected on a plane in TxBoundingBoxCalculator .

Graphic Viewer

The new GetCameraOrientation and SetCameraOrientation methods were added to TxGraphicViewer that get or set the camera orientation of the viewer.


A new viewer interface has been introduced in this version, ITxDockingViewerControl , which declares a viewer as a docking viewer. Viewers that implement this interface can be updated when a viewer window slides out or collapses.

OLP Controller

The new GetCustomizationPath method was added to TxOlpControllerUtilities to enable the use of program templates outside the controller installation.

OLP Command

The new GetCustomizedXmlReference method was added for OLP commands in TxRoboticCompositeCommand , used for persistency in the XML customization.

Robotic Controller

The Tecnomatix .NET API has added additional methods for robotic controllers in ITxRoboticControllerServices , for example, CheckInverse , CalculateInverseSolutions , GetActiveGun , GetActiveGripper and JumpExternals . Now static applications call the controller for any kinematics information. In addition, new methods were added in ITxJumpToLocationData , for example, UseTaughtLocations , UseWorkToolAndSystemFrames , UseExternalAxes and GenerateMessage .

Robotic Program

Tecnomatix products now support a silent download of robotic programs with explicit program filenames. The new Download method was added in ITxRoboticDownloader .

File Attachment

The new DatasetType and DatasetRole properties were added to TxTcFileAttachmentData that represent the dataset type and role. Now by using the DataSetType = "Text", any controller program file can be stored independently of its file extension.

PLC Logic Behavior

The Tecnomatix .NET API has added additional properties for logic behavior entry and exit in ITxPlcLogicBehaviorEntry and ITxPlcLogicBehaviorExit , for example, ConnectInternalExit and DisconnectInternalExit , ConnectInternalEntry and DisconnectInternalEntry . In addition there is a new model object, TxPlcLogicBehaviorJumpJointAction , which represents a logic behavior action that jumps a joint to a specified value.