/// <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); }