TeklaAPIExtensions.Model 0.0.3

Tekla API Extensions

A collection of extension methods for Tekla Structures Open API to simplify common operations and improve code readability.

Features

• Extension methods for working with geometry:
  • PointExtensions: Transform points, calculate averages, remove duplicates
  • LineSegmentExtensions: Cut line segments by planes and bounding boxes
  • SolidExtensions: Get faces, calculate bounding boxes
  • FaceExtensions: Extract loops and vertices
• Model object extensions:
  • ModelObjectExtensions: Easy access to properties and UDAs
  • ModelObjectEnumeratorExtensions: LINQ-style filtering
• Drawing extensions:
  • DrawingObjectEnumeratorExtensions: LINQ-style filtering
  • PointListExtensions: Convert between point collections

Installation

.NET CLI:

dotnet add package TeklaAPIExtensions.Model
dotnet add package TeklaAPIExtensions.Drawing

Project reference:

<ItemGroup>
  <PackageReference Include="TeklaAPIExtensions.Model" Version="0.0.2" />
  <PackageReference Include="TeklaAPIExtensions.Drawing" Version="0.0.1" />
</ItemGroup>

Usage

using Tekla.Structures.Geometry3d;
using Tekla.Structures.Model;
using Tekla.Structures.Solid;
using TeklaAPIExtensions.Model;
using TeklaAPIExtensions.Drawing;

// Filter model objects by type
var selectedObjects = new Tekla.Structures.Model.UI.ModelObjectSelector().GetSelectedObjects();
var beams = selectedObjects.OfType<Beam>();

// Get property values safely
var modelObject = beams.First();
if (modelObject.TryGetProperty("PROFILE", out string profile))
{
    // Use profile value
}

// Transform points
List<Point> points = [new(0, 0, 0), new(1000, 1000, 1000)];
CoordinateSystem coordinateSystem = new(new Point(100, 100, 100), new Vector(1, 0, 0), new Vector(0, 1, 0));
var transformedPoints = points.Transform(coordinateSystem);

// Get visible faces
Solid solid = beams.First().GetSolid();
Vector viewDirection = new(0, 0, 1);
List<Face> visibleFaces = solid.GetVisibleFaces(viewDirection).ToList();

Requirements

• .NET Standard 2.0
• Tekla Structures 2024 or newer
• Valid Tekla Open API license

Licence

MIT License. See LICENSE file for details.

Note: This is an independent library and is not endorsed by or affiliated with Trimble Solutions Corporation. Tekla Structures and Tekla Open API are trademarks of Trimble Solutions Corporation.