/// <summary>
/// Implement this method as an external command for Revit.
/// </summary>
/// <param name="commandData">An object that is passed to the external application
/// which contains data related to the command,
/// such as the application object and active view.</param>
/// <param name="message">A message that can be set by the external application
/// which will be displayed if a failure or cancellation is returned by
/// the external command.</param>
/// <param name="elements">A set of elements to which the external application
/// can add elements that are to be highlighted in case of failure or cancellation.</param>
/// <returns>Return the status of the external command.
/// A result of Succeeded means that the API external method functioned as expected.
/// Cancelled can be used to signify that the user cancelled the external operation
/// at some point. Failure should be returned if the application is unable to proceed with
/// the operation.</returns>
public virtual Result Execute(ExternalCommandData commandData
, ref string message, ElementSet elements)
{
//Get the document from external command data.
UIDocument activeDoc = commandData.Application.ActiveUIDocument;
Autodesk.Revit.DB.Document doc = activeDoc.Document;
if (null == doc)
{
return(Result.Failed);
}
try
{
// The list of elements to create the shear stud pattern on
Reference eRef = activeDoc.Selection.PickObject(ObjectType.Face, "Please pick an element to create the shear stud pattern on");
// Start detailed steel modeling transaction
using (FabricationTransaction trans = new FabricationTransaction(doc, false, "Create shear stud pattern"))
{
// Creating the shear stud pattern involves using AdvanceSteel classes and objects only.
// for more details, please consult http://www.autodesk.com/adv-steel-api-walkthroughs-2019-enu
FilerObject filerObj = Utilities.Functions.GetFilerObject(doc, eRef);
if (null == filerObj)
{
return(Result.Failed);
}
Autodesk.AdvanceSteel.Modelling.Connector shearStud = new Autodesk.AdvanceSteel.Modelling.Connector();
shearStud.WriteToDb();
// Creating a rectangle for the shear stud pattern. A Polyline3d is required for the rectangle. We will use it for the Arranger and the Matrix3d objects.
Polyline3d polyLine = new Polyline3d();
Matrix3d matCS = new Matrix3d();
Arranger arranger = null;
double x = eRef.GlobalPoint.X * Utilities.Functions.FEET_TO_MM;
double y = eRef.GlobalPoint.Y * Utilities.Functions.FEET_TO_MM;
double z = eRef.GlobalPoint.Z * Utilities.Functions.FEET_TO_MM;
double w = 500; // width of the contour;
double h = 500; // height of the contour;
polyLine.Append(new Point3d(x, y, z));
polyLine.Append(new Point3d(x + w, y, z));
polyLine.Append(new Point3d(x + w, y + h, z));
polyLine.Append(new Point3d(x, y + h, z));
Point3d[] vertices = polyLine.Vertices;
if (vertices.Length == 4) //rectangular shear stud pattern
{
Vector3d xAxis1 = vertices[0].Subtract(vertices[1]);
Vector3d xAxis2 = vertices[0].Subtract(vertices[3]);
Vector3d zAxis = new Vector3d(0, 0, 1);
Vector3d vDiag = vertices[0].Subtract(vertices[2]);
Point3d orig = new Point3d(vertices[2]);
orig = orig.Add(vDiag * 0.5);
if (xAxis1.GetLength() > xAxis2.GetLength())
{
arranger = new BoundedRectArranger(xAxis1.GetLength(), xAxis2.GetLength());
matCS.SetCoordSystem(orig, xAxis1.Normalize(), zAxis.CrossProduct(xAxis1).Normalize(), zAxis.Normalize());
}
else
{
arranger = new BoundedRectArranger(xAxis2.GetLength(), xAxis1.GetLength());
matCS.SetCoordSystem(orig, xAxis2.Normalize(), zAxis.CrossProduct(xAxis2).Normalize(), zAxis.Normalize());
}
arranger.Nx = 2;
arranger.Ny = 2;
}
shearStud.Arranger = arranger;
shearStud.SetCS(matCS);
shearStud.Connect(filerObj, matCS);
shearStud.Material = "Mild Steel";
shearStud.Standard = "Nelson S3L-Inch";
shearStud.Diameter = 19.05;
shearStud.Length = 101.6;
trans.Commit();
}
}
catch (Autodesk.Revit.Exceptions.OperationCanceledException)
{
return(Result.Cancelled);
}
return(Result.Succeeded);
}
/// <summary>
/// Implement this method as an external command for Revit.
/// </summary>
/// <param name="commandData">An object that is passed to the external application
/// which contains data related to the command,
/// such as the application object and active view.</param>
/// <param name="message">A message that can be set by the external application
/// which will be displayed if a failure or cancellation is returned by
/// the external command.</param>
/// <param name="elements">A set of elements to which the external application
/// can add elements that are to be highlighted in case of failure or cancellation.</param>
/// <returns>Return the status of the external command.
/// A result of Succeeded means that the API external method functioned as expected.
/// Cancelled can be used to signify that the user cancelled the external operation
/// at some point. Failure should be returned if the application is unable to proceed with
/// the operation.</returns>
public virtual Result Execute(ExternalCommandData commandData
, ref string message, ElementSet elements)
{
// Get the document from external command data.
UIDocument activeDoc = commandData.Application.ActiveUIDocument;
Autodesk.Revit.DB.Document doc = activeDoc.Document;
if (null == doc)
{
return(Result.Failed);
}
try
{
// Start detailed steel modeling transaction
using (FabricationTransaction trans = new FabricationTransaction(doc, false, "Create contour cut"))
{
// for more details, please consult http://www.autodesk.com/adv-steel-api-walkthroughs-2019-enu
// Selecting the elements to create the contour cut on
Reference eRef = activeDoc.Selection.PickObject(ObjectType.Element, "Please pick an element to create the contour cut on");
// getting the selected element
Element elem = null;
if (eRef != null && eRef.ElementId != ElementId.InvalidElementId)
{
elem = doc.GetElement(eRef.ElementId);
}
if (null == elem)
{
return(Result.Failed);
}
// ensuring the element has FabricationData
SteelElementProperties cell = SteelElementProperties.GetSteelElementProperties(elem);
if (null == cell)
{
List <ElementId> elemsIds = new List <ElementId>();
elemsIds.Add(elem.Id);
SteelElementProperties.AddFabricationInformationForRevitElements(doc, elemsIds);
}
FilerObject filerObj = Utilities.Functions.GetFilerObject(doc, eRef);
if (null == filerObj)
{
return(Result.Failed);
}
if (!(filerObj is Plate) && !(filerObj is Beam))
{
return(Result.Failed);
}
// The point where the element was hit when selected.
Point3d p1 = new Point3d(eRef.GlobalPoint.X, eRef.GlobalPoint.Y, eRef.GlobalPoint.Z);
// Contour coordinates, according to the point where the element was hit when selected
double x = Utilities.Functions.FEET_TO_MM * p1.x; // x of upper-left corner of the contour;
double y = Utilities.Functions.FEET_TO_MM * p1.y; // y of upper-left corner of the contour;
double z = Utilities.Functions.FEET_TO_MM * p1.z; // z of upper-left corner of the contour;
// Adding the contour cut, using AdvanceSteel classes.
Polyline3d plContour;
Polyline3d contour = new Polyline3d();
if (filerObj is Plate)
{
double w = 500; // width of the contour;
double h = 500; // height of the contour;
contour.Append(new Point3d(x, y, z));
contour.Append(new Point3d(x + w, y, z));
contour.Append(new Point3d(x + w, y + h, z));
contour.Append(new Point3d(x, y + h, z));
if (contour.VertexCount <= 0)
{
return(Result.Failed);
}
Plate plate = filerObj as Plate;
plate.GetBaseContourPolygon(1, out plContour);
plContour.Project(new Autodesk.AdvanceSteel.Geometry.Plane(contour.Vertices[0], contour.PolyNormal), contour.PolyNormal);
PlateContourNotch plateContour = new PlateContourNotch(plate, 0, contour, contour.Normal, contour.Normal.GetPerpVector());
plate.AddFeature(plateContour);
}
else if (filerObj is Beam)
{
double w = 50; // width of the contour;
double h = 50; // height of the contour;
contour.Append(new Point3d(x, y, z));
contour.Append(new Point3d(x + w, y, z));
contour.Append(new Point3d(x + w, y, z + h));
contour.Append(new Point3d(x, y, z + h));
if (contour.VertexCount <= 0)
{
return(Result.Failed);
}
Beam beam = filerObj as Beam;
Point3d ptClosest = beam.GetClosestPointToSystemline(contour.Vertices[0]);
double d1 = ptClosest.DistanceTo(beam.GetPointAtStart());
double d2 = ptClosest.DistanceTo(beam.GetPointAtEnd());
Beam.eEnd beamEnd = d1 > d2 ? Beam.eEnd.kEnd : Beam.eEnd.kStart;
Vector3d normal = contour.Normal;
Vector3d xVec = normal.GetPerpVector();
BeamMultiContourNotch beamContour = new BeamMultiContourNotch(beam, beamEnd, contour, normal, xVec);
beam.AddFeature(beamContour);
}
trans.Commit();
}
}
catch (Autodesk.Revit.Exceptions.OperationCanceledException)
{
return(Result.Cancelled);
}
return(Result.Succeeded);
}
