Rebar.CreateFromCurves(Document, RebarStyle, RebarBarType, Element, XYZ, IList<Curve>, BarTerminationsData, Boolean, Boolean) Method

Namespace: Autodesk.Revit.DB.Structure
Assembly: RevitAPI (in RevitAPI.dll) Version: 26.1.0.0 (26.1.0.34)

Syntax

C#

public static Rebar CreateFromCurves(
	Document doc,
	RebarStyle style,
	RebarBarType barType,
	Element host,
	XYZ norm,
	IList<Curve> curves,
	BarTerminationsData barTerminationsData,
	bool useExistingShapeIfPossible,
	bool createNewShape
)

Parameters

doc  Document

A document.

style  RebarStyle

The usage of the bar, "standard" or "stirrup/tie".

barType  RebarBarType

A RebarBarType element that defines bar diameter, bend radius and material of the rebar.

host  Element

The element to which the rebar belongs. The element must support rebar hosting; [!:Autodesk::Revit::DB::Structure::RebarHostData].

norm  XYZ

The normal to the plane that the rebar curves lie on.

curves  IList<Curve>

An array of curves that define the shape of the rebar curves. They must belong to the plane defined by the normal and origin. Bends, hooks and cranks should not be included in the array of curves.

barTerminationsData  BarTerminationsData

Data about the Rebar's terminations.

useExistingShapeIfPossible  Boolean

Attempts to assign a RebarShape from those existing in the document. If no shape matches, this function returns nullptr if createNewShape is false or it will create a new shape if createNewShape is true. When both parameters are "true", the behavior is the same as sketching rebar in the UI. At least one of these parameters must be "true".

createNewShape  Boolean

Creates a shape in the document to match the curves, terminations and specified style and assigns it to the new rebar instance. Shape creation will not succeed unless one or more other shapes already exist in the document, and these shapes have enough shape parameters to define a shape for these curves.

Return Value

Rebar
The newly created Rebar instance, or nullptr if the operation fails.

Exceptions

Example

C#

Rebar CreateRebar(Autodesk.Revit.DB.Document document, FamilyInstance column, RebarBarType barType, BarTerminationsData barTerminationsData)
  {
      // Define the rebar geometry information - Line rebar
      LocationPoint location = column.Location as LocationPoint;
      XYZ origin = location.Point;
      XYZ normal = new XYZ(1, 0, 0);
      // create rebar 9' long
      XYZ rebarLineEnd = new XYZ(origin.X, origin.Y, origin.Z + 9);
      Line rebarLine = Line.CreateBound(origin, rebarLineEnd);

      // Create the line rebar
      IList<Curve> curves = new List<Curve>();
      curves.Add(rebarLine);

      Rebar rebar = Rebar.CreateFromCurves(document, Autodesk.Revit.DB.Structure.RebarStyle.Standard, barType,
                          column, origin, curves, barTerminationsData, true, true);

      if (null != rebar)
      {
          // set specific layout for new rebar as fixed number, with 10 bars, distribution path length of 1.5'
          // with bars of the bar set on the same side of the rebar plane as indicated by normal
          // and both first and last bar in the set are shown
          rebar.GetShapeDrivenAccessor().SetLayoutAsFixedNumber(10, 1.5, true, true, true);
      }

      return rebar;
  }

VB

Private Function CreateRebar(document As Autodesk.Revit.DB.Document, column As FamilyInstance, barType As RebarBarType, barTerminationsData As BarTerminationsData) As Rebar
    ' Define the rebar geometry information - Line rebar
    Dim location As LocationPoint = TryCast(column.Location, LocationPoint)
    Dim origin As XYZ = location.Point
    Dim normal As New XYZ(1, 0, 0)
    ' create rebar 9' long
    Dim rebarLineEnd As New XYZ(origin.X, origin.Y, origin.Z + 9)
    Dim rebarLine As Line = Line.CreateBound(origin, rebarLineEnd)

    ' Create the line rebar
    Dim curves As IList(Of Curve) = New List(Of Curve)()
    curves.Add(rebarLine)

    Dim rebar__1 As Rebar = Rebar.CreateFromCurves(document, Autodesk.Revit.DB.[Structure].RebarStyle.Standard, barType, column,
    origin, curves, barTerminationsData, True, True)

    If rebar__1 IsNot Nothing Then
        ' set specific layout for new rebar as fixed number, with 10 bars, distribution path length of 1.5'
        ' with bars of the bar set on the same side of the rebar plane as indicated by normal
        ' and both first and last bar in the set are shown
        rebar__1.GetShapeDrivenAccessor().SetLayoutAsFixedNumber(10, 1.5, True, True, True)
    End If

    Return rebar__1
End Function

See Also

Reference