Tekla Structures 2017

Open API Release Notes

March 2017

2017 Trimble Solutions Corporation

Contents

1 Tekla Structures 2017 Open API Release Notes......................... 3

2 Disclaimer.......................................................................................8

2
 1 Tekla Structures 2017 Open API
Release Notes

This document explains new features, fixes and improvements in Tekla Open
API 2017. For more examples and information, see
TeklaOpenAPI_Reference.chm included in the Tekla Open API StartUp
Package.

Tekla.Structures.CustomPropertyPlugin 2017.0.0.0 Assembly

Earlier, custom properties were loaded from all folders and subfolders
in ..common\extensions. This caused performance issues and loading
failures when custom properties were used. Now the custom properties
are loaded only from the extension folder ..common\extensions
\custom\properties\.
This speeds up the loading process and solves loading problems caused by
other software components in other extension folders. The new
functionality for loading custom properties can be switched off in
startup .ini files by defining the following advanced option:
set XS_ENABLE_FAST_CUSTOM_PROPERTY_LOADING=FALSE
When you do this, the loading of custom properties works as in previous
versions.

Tekla.Structures.Catalog 2017.0.0.0 Assembly

Added new command line TSEP builder options to modify extension
product version, and to append product version to the .tsep file name. See
TSEP documentation in Tekla Open API startup package for full details.
TT126994
ShapeItem class has been added to Tekla Open API for inserting new
shapes to shape catalog. Shapes can be used for creating new B-rep parts
to model.

Tekla Structures 2017 Open API Release Notes 3

 Tekla.Structures.Model 2017.0.0.0 Assembly
ModelObjectChanged and ModelObjectNumbered events now return the
correct type for objects, such as PolyBeam instead of Beam.
TT126695
Rebar groups with only one bar were not coming through the Tekla Open
API correctly. This has now been fixed.
TT129076
New method has been added to TeklaStructuresInfo class:
public static string GetCopyRightText ()
TT129647
FacetedBrep class has been added to Tekla.Structures.Geometry3d:
public FacetedBrep (Vector[] vertices, int[][] outerWires,
IDictionary`2 innerWires, IList`1 edges)
TT101894
New properties have been added to all model objects:
Property: bool IsUpToDate { public get; }
Property: Nullable`1 ModificationTime { public get; }
The following classes have been added to BentPlate objects:
BentPlate class has been added for modifying bent plate objects
BentPlateGeometrySolver class has been added for modifying bent
plate geometry
ConnectiveGeometry class has been added for finding out connecting
geometry points between connecting plates for bent plate
CylidricalSurface class has been added for forming cylinder for bent
plate
GeometrySection and GeometrySectionEnumerator classes has been
added for inquiring bent plate geometry
PolygonNode class has been added for creating new nodes to BentPlate
Close() method has been added to the ModelHandler class.
New Polymesh class has been added for creating new ShapeItem objects.
The following classes have been added for modifying new RebarSet
objects:
RebarEndDetailModifier class has been added for modeling rebar end
details
RebarGuideLine class has been added for creating new guide lines
RebarLegFace class has been added for modifying rebar set geometry

Tekla Structures 2017 Open API Release Notes 4

 RebarProperties class has been added for modifying properties of rebar
set
RebarSetAddition class has been added for overriding default behaviour
of rebar set
RebarSpacing and RebarSpacingZone classes have been added for
defining spacing for rebars in RebarSet
RebarSplice and RebarSplitter classes has been added for splitting
rebars in RebarSet
New methods have been added to the ModelHistory class in the
Tekla.Structures.Model.History namespace:
public static ModificationInfo GetModifications ()
public static ModificationInfo TakeModifications ()
public static void UpdateModificationStampToLatest ()
New class ModifiedObjectInfo has been added to the
Tekla.Structures.Model.History namespace to give more information about
what has changed in the object.
New properties for visibility and representation have been added to the
View class in the Tekla.Structures.Model.UI namespace:
string CurrentRepresentation { public get; public set; }
Property: ViewVisibilitySettings VisibilitySettings
New methods for modifying bent plates and pour units have been added
to the Operations class in the Tekla.Structures.Model.Operations
namespace.
public static bool CalculatePourUnits ()
public static bool RemoveFromPourUnit ()
public static BentPlate CreateBentPlateByFaces ()
public static BentPlate CreateBentPlateByFaces ()
public static BentPlate CreateBentPlateByFaces ()
public static BentPlate CreateBentPlateByFaces ()
public static BentPlate CreateBentPlateByParts ()
public static BentPlate CreateBentPlateByParts ()
public static bool ExplodeBentPlate ()
For single user and multi-user models,
ModelHistory.GetModifications( ) and
ModelHistory.TakeModifications() did not return the objects which
were created in the same session and deleted before saving. Now this is
fixed. The objects which are created between the previous model save/

Tekla Structures 2017 Open API Release Notes 5

 open and taking a ModificationStamp, and deleted before the next save,
are reported as deleted since that ModificationStamp.
TT126877

Tekla.Structures.Datatypes 2017.0.0.0 Assembly

Tolerance check has been added to value comparison for Double and
Distance types.
TT129051

Tekla.Structures.Drawings 2017.0.0.0 Assembly

Tekla Open API drawings now support RebarSet generated drawing rebar
groups (ReinforcementSetGroup).
TT121436
TextFile object now inherits from EmbeddedObjectBase.
TT122345
New properties have been added to all drawing classes:
bool IsReadyForIssue { public get; }
string IsReadyForIssueBy { public get; }
string SectionViewStartLabel { public get; }
DimensionValueFormats.SuperscriptEnding value has been added to
DimensionSetBaseAttributes class.
TT124091
DWGScalingOptions class has been renamed to
EmbeddedObjectScalingOptions and is used in the Scaling property of the
EmbeddedObjectAttributes class.
New Image class has been added to the namespace for modifying images
in drawings.
TT122108

Tekla.Structures.Analysis 2017.0.0.0
New method has been added to AnalysisPart class:
public bool MovePosition (AnalysisPosition position,
Vector move)
TT120958

Tekla.Structures.CustomPropertyPlugin 2017.0.0.0 Assembly

Earlier, custom properties were loaded from all folders and subfolders
in ..common\extensions. This caused performance issues and loading
failures when custom properties were used. Now the custom properties

Tekla Structures 2017 Open API Release Notes 6

 are loaded only from the extension folder ..common\extensions
\custom\properties\.
This speeds up the loading process and solves loading problems caused by
other software components in other extension folders. The new
functionality for loading custom properties can be switched off in
startup .ini files by defining the following advanced option:
set XS_ENABLE_FAST_CUSTOM_PROPERTY_LOADING=FALSE
When you do this, the loading of custom properties works as in previous
versions.

Tekla Structures 2017 Open API Release Notes 7

2 Disclaimer

2017 Trimble Solutions Corporation and its licensors. All rights reserved.
This Software Manual has been developed for use with the referenced
Software. Use of the Software, and use of this Software Manual are governed
by a License Agreement. Among other provisions, the License Agreement sets
certain warranties for the Software and this Manual, disclaims other
warranties, limits recoverable damages, defines permitted uses of the
Software, and determines whether you are an authorized user of the Software.
All information set forth in this manual is provided with the warranty set forth
in the License Agreement. Please refer to the License Agreement for important
obligations and applicable limitations and restrictions on your rights. Trimble
does not guarantee that the text is free of technical inaccuracies or
typographical errors. Trimble reserves the right to make changes and
additions to this manual due to changes in the software or otherwise.
In addition, this Software Manual is protected by copyright law and by
international treaties. Unauthorized reproduction, display, modification, or
distribution of this Manual, or any portion of it, may result in severe civil and
criminal penalties, and will be prosecuted to the full extent permitted by law.
Tekla, Tekla Structures, Tekla BIMsight, BIMsight, Tekla Civil, Tedds, Solve,
Fastrak and Orion are either registered trademarks or trademarks of Trimble
Solutions Corporation in the European Union, the United States, and/or other
countries. More about Trimble Solutions trademarks: http://www.tekla.com/
tekla-trademarks. Trimble is a registered trademark or trademark of Trimble
Inc. in the European Union, in the United States and/or other countries. More
about Trimble trademarks: http://www.trimble.com/trademarks.aspx. Other
product and company names mentioned in this Manual are or may be
trademarks of their respective owners. By referring to a third-party product or
brand, Trimble does not intend to suggest an affiliation with or endorsement
by such third party and disclaims any such affiliation or endorsement, except
where otherwise expressly stated.
Portions of this software:
D-Cubed 2D DCM 2010 Siemens Industry Software Limited. All rights
reserved.

Disclaimer 8
EPM toolkit 1995-2006 Jotne EPM Technology a.s., Oslo, Norway. All rights
reserved.
Open Cascade Express Mesh 2015 OPEN CASCADE S.A.S. All rights reserved.
PolyBoolean C++ Library 2001-2012 Complex A5 Co. Ltd. All rights reserved.
FLY SDK - CAD SDK 2012 VisualIntegrity. All rights reserved.
Teigha 2002-2016 Open Design Alliance. All rights reserved.
CADhatch.com 2017. All rights reserved.
FlexNet Publisher 2014 Flexera Software LLC. All rights reserved.
This product contains proprietary and confidential technology, information
and creative works owned by Flexera Software LLC and its licensors, if any. Any
use, copying, publication, distribution, display, modification, or transmission of
such technology in whole or in part in any form or by any means without the
prior express written permission of Flexera Software LLC is strictly prohibited.
Except where expressly provided by Flexera Software LLC in writing,
possession of this technology shall not be construed to confer any license or
rights under any Flexera Software LLC intellectual property rights, whether by
estoppel, implication, or otherwise.
To see the third party open source software licenses, go to Tekla Structures,
click File menu --> Help --> About Tekla Structures and then click the 3rd
party licenses option.
The elements of the software described in this Manual are protected by
several patents and possibly pending patent applications in the United States
and/or other countries. For more information go to page http://
www.tekla.com/tekla-patents.

Disclaimer 9
Disclaimer 10