11/10/21, 4:31 PM Help | Advance Steel 2021 .

NET and COM API Changes | Autodesk

Advance Steel 2021 .NET and COM API Changes

Learn about modifications and new additions in the API of this release of the software.

.NET API Breaking Changes

WeldPattern

void connect (HashSet<FilerObject> elems, eAssemblyLocation location) ; changed signature to void

connect (FilerObject[] elems, eAssemblyLocation location) ;
void removeConnectedObjects(HashSet<FilerObject> elems); changed signature to void
removeConnectedObjects(FilerObject[] elems);

BoltPattern

void connect (HashSet<FilerObject> elems, eAssemblyLocation location) ; changed signature to void

connect (FilerObject[] elems, eAssemblyLocation location) ;
void removeConnectedObjects(HashSet<FilerObject> elems); changed signature to void
removeConnectedObjects(FilerObject[] elems);

Polyline3d

Polyline3d(Point3d []vertices, double []bulges); changed signature to static

Polyline3d.CreateFromVerticesAndFilletInformation(Point3d[] vertices, double []bulges, Vector3d
normal, bool closed);
Creates an augmented polygon
Precondition: plg.length() == filletRadia.length()
plgNormal is the normal of the plg
Positive radia indicates a fillet at convex vertices
Negative radia indicates a fillet at concav vertices
Zero-Radia indicates non filleted vertices
Postcondition:
An open polygon is created, where filleted corners are split into two new corners. One of these new
corners contains the corner feature information.
For convex fillets plgNormal is used.
For concav fillets -plgNormal is used.
Polyline3d(Point3d []vertices, double []bulges, Vector3d normal, bool closed, double absError);
changed signature to static Polyline3d.CreateFromVerticesAndBulges(Point3d []vertices, double
[]bulges, Vector3d normal, bool closed, double absError);
Creates an augmented polygon
https://help.autodesk.com/view/ADSTPR/2021/ENU/?guid=GUID-309B2ACB-5CD4-4B91-98B7-D00F2026BBD7 1/5
11/10/21, 4:31 PM Help | Advance Steel 2021 .NET and COM API Changes | Autodesk

The bulge is the tangent of 1/4 of the included angle for the arc between the vertex and the next
vertex in the polyline's vertex list.
A negative bulge value indicates that the arc goes clockwise from this vertex to the next.
Passing bulges as null will build a polyline with straight segments only.

UserAutoConstructionObject

public UserAutoConstructionObject(string ruleName, List<Tuple<FilerObject, Point3d>> inputDrivers);

changed signature to public UserAutoConstructionObject(string ruleName, List<Tuple<FilerObject,
Point3d>> inputDrivers, List<Point3d> additionalInputPoints);
New parameter List<Point3d> additionalInputPoints should be provided when creating connections
with additional points (e.g. stiffener connection).
public UserAutoConstructionObject(string ruleName, List<Tuple<FilerObject, Point3d>> inputDrivers,
IFiler pFiler); changed signature to public UserAutoConstructionObject(string ruleName,
List<Tuple<FilerObject, Point3d>> inputDrivers, IFiler pFiler, List<Point3d> additionalInputPoints);
New parameter List<Point3d> additionalInputPoints should be provided when creating connections
with additional points (e.g. stiffener connection).
public UserAutoConstructionObject(string ruleName, List<Tuple<FilerObject, Point3d>> inputDrivers,
IFiler pFiler, ValueType uid); changed signature to public UserAutoConstructionObject(string
ruleName, List<Tuple<FilerObject, Point3d>> inputDrivers, IFiler pFiler, ValueType uid, List<Point3d>
additionalInputPoints);
New parameter List<Point3d> additionalInputPoints should be provided when creating connections
with additional points (e.g. stiffener connection).

.NET API New Classes and Methods

Autodesk.AdvanceSteel.CADAccess.FilerObject

New method: void markChanged(bool bPropagateChanges) //marks an object as changed; when

bPropagateChanges is true, all related objects will be updated; otherwise only current object will be
updated.

Autodesk.AdvanceSteel.Modelling.BeamMultiContourNotch

New method: void getContourPolygon(out Point3d[] ptsContour)

Autodesk.AdvanceSteel.Modelling.HoleDefinition

New get/set property: bool HoleUsedForNumbering

Autodesk.AdvanceSteel.ConstructionTypes.AtomicElement

New get/set property: int RoleUsedForNumbering

New get/set property: int HolesUsedForNumbering

Autodesk.AdvanceSteel.Connection.ConnectionHoleFeature

New get/set property: bool UsedForNumbering

Autodesk.AdvanceSteel.ConstructionTypes.MainAlias

https://help.autodesk.com/view/ADSTPR/2021/ENU/?guid=GUID-309B2ACB-5CD4-4B91-98B7-D00F2026BBD7 2/5
11/10/21, 4:31 PM Help | Advance Steel 2021 .NET and COM API Changes | Autodesk

New get/set property: int FabricationStatusUsedForNumbering

New get/set property: int SupplierUsedForNumbering

New get/set property: int PONumberUsedForNumbering

New get/set property: int RequisitionNumberUsedForNumbering

New get/set property: int HeatNumberUsedForNumbering

Autodesk.AdvanceSteel.ConstructionTypes.IJoint

New set property: bool DefaultAttributeStateAccessible

Autodesk.AdvanceSteel.Modelling.eObjectsAttribute

New attribute value: kHole_UsedForNumbering

New attribute value: kScrew_HoleUsedForNumberingForEachConnObject

New attribute value: kScrew_HolesUsedForNumbering

New attribute value: kBeam_HolesUsedForNumbering

New attribute value: kPlate_HolesUsedForNumbering

Autodesk.AdvanceSteel.Modelling.Beam

New get property: bool HasUnwindedState

New method: UnwindedBeam GetUnwindedBeam()

New class Autodesk.AdvanceSteel.Modelling.UnwindedBeam with the following properties and methods:

// beam - the beam to unwind

// bodyContext - the body context used when obtaining the body to unwind (before
unwinding);

default value: kExactDetailing

// dUnwindFactor - the unwinding start parameter for closed profiles, indicating the
place along

the profile curve where the unwinding is to start;

// should be between 0 and 1; default value: 0

// bForStencil - specifies whether to apply a special processing to closed profiles

for stencil

unwinding; default value: false

UnwindedBeam(Beam^ beam);

UnwindedBeam(Beam^ beam, Modeler::BodyContext::eBodyContext bodyContext);

UnwindedBeam(Beam^ beam, Modeler::BodyContext::eBodyContext bodyContext, double

dUnwindFactor);

UnwindedBeam(Beam^ beam, Modeler::BodyContext::eBodyContext bodyContext, double

dUnwindFactor,

bool bForStencil);

~UnwindedBeam();

!UnwindedBeam();

// returns a name composed from the profile name and the dimensions of the unwinded
beam

String^ GetName();

https://help.autodesk.com/view/ADSTPR/2021/ENU/?guid=GUID-309B2ACB-5CD4-4B91-98B7-D00F2026BBD7 3/5
11/10/21, 4:31 PM Help | Advance Steel 2021 .NET and COM API Changes | Autodesk
// the length of the unwinded beam, calculated as the distance between the farthest

apart vertices of the unwinded body along the beam direction

property double Length

double get();

// the width of the unwinded beam

property double Width

double get();

// the thickness of the unwinded beam

property double Thickness

double get();

// the perimeter of the unwinded beam, calculated according to the "CalcMethod"

default

double GetCircumference();

// the area of the unwinded beam, calculated according to the "CalcMethod" default

double GetArea();

// the weight of the unwinded beam

double GetWeight();

// returns whether a valid unwinding could be calculated

property bool ValidUnwinding

bool get();

// returns the unwinded body

Modeler::ModelerBody^ GetUnwindedModeler();

// returns the transformation matrix that should be applied to a WCS point on the
beam to move it

in its corresponding position on the unwinded body

Geometry::Matrix3d^ GetUnwindingTransformationForPoint(Geometry::Point3d^ ptInWCS);

// returns the position on the median profile from where the unwinding starts, in
WCS

Geometry::Point3d^ GetUnwindingStart();

// returns the direction at the start of the unwinding, in WCS

Geometry::Vector3d^ GetUnwindingDirection();

property ASObjectsAPI::UnwindedBeam* Native

ASObjectsAPI::UnwindedBeam* get();

COM API New Classes and Methods

eAttributeCodes

New attribute value: kHolePatternUsedForNumbering

New attribute value: kBoltPatternHoleUsedForNumberingForEachConnObject

IEqualPartObject

New get/set property: HolesUsedForNumbering

https://help.autodesk.com/view/ADSTPR/2021/ENU/?guid=GUID-309B2ACB-5CD4-4B91-98B7-D00F2026BBD7 4/5
11/10/21, 4:31 PM Help | Advance Steel 2021 .NET and COM API Changes | Autodesk

IBoltHoleDefinition

New get/set property: VARIANT_BOOL HoleUsedForNumbering

IHole

New get/set property: VARIANT_BOOL UsedForNumbering

IJoint

New set property: VARIANT_BOOL DefaultAttributeStateAccessible

Parent topic: Developers

Except where otherwise noted, this work is licensed under a Creative Commons Attribution-
NonCommercial-ShareAlike 3.0 Unported License. Please see the Autodesk Creative Commons FAQ
for more information.
© 2021 Autodesk Inc. All rights reserved

https://help.autodesk.com/view/ADSTPR/2021/ENU/?guid=GUID-309B2ACB-5CD4-4B91-98B7-D00F2026BBD7 5/5