M

RebarContainer.AppendItemFromCurvesAndShape

Description:
Appends an Item to the RebarContainer. Fills its data on base of the input parameters.

public RebarContainerItem AppendItemFromCurvesAndShape(
	RebarShape rebarShape,
	RebarBarType barType,
	RebarHookType startHook,
	RebarHookType endHook,
	XYZ normal,
	IList<Curve> curves,
	RebarTerminationOrientation startHookOrient,
	RebarTerminationOrientation endHookOrient
)

Public Function AppendItemFromCurvesAndShape ( 
	rebarShape As RebarShape,
	barType As RebarBarType,
	startHook As RebarHookType,
	endHook As RebarHookType,
	normal As XYZ,
	curves As IList(Of Curve),
	startHookOrient As RebarTerminationOrientation,
	endHookOrient As RebarTerminationOrientation
) As RebarContainerItem

public:
RebarContainerItem^ AppendItemFromCurvesAndShape(
	RebarShape^ rebarShape, 
	RebarBarType^ barType, 
	RebarHookType^ startHook, 
	RebarHookType^ endHook, 
	XYZ^ normal, 
	IList<Curve^>^ curves, 
	RebarTerminationOrientation startHookOrient, 
	RebarTerminationOrientation endHookOrient
)

member AppendItemFromCurvesAndShape : 
        rebarShape : RebarShape * 
        barType : RebarBarType * 
        startHook : RebarHookType * 
        endHook : RebarHookType * 
        normal : XYZ * 
        curves : IList<Curve> * 
        startHookOrient : RebarTerminationOrientation * 
        endHookOrient : RebarTerminationOrientation -> RebarContainerItem

RebarShape

rebarShape

A RebarShape element that defines the shape of the rebar. A RebarShape element matches curves and hooks. A RebarShape element provides RebarStyle of the rebar.
RebarBarType

barType

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

startHook

A RebarHookType element that defines the hook for the start of the bar. If this parameter is null, it means to create a rebar with no hook.
RebarHookType

endHook

A RebarHookType element that defines the hook for the end of the bar. If this parameter is null, it means to create a rebar with no hook.
XYZ

normal

The normal to the plane that the rebar curves lie on.
IList<Curve>

curves

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 and hooks should not be included in the array of curves.
RebarTerminationOrientation

startHookOrient

Defines the orientation of the hook plane at the start of the rebar with respect to the orientation of the first curve and the plane normal. Only two values are permitted: Value = Right: The hook is on your right as you stand at the end of the bar, with the bar behind you, taking the bar's normal as "up." Value = Left: The hook is on your left as you stand at the end of the bar, with the bar behind you, taking the bar's normal as "up."
RebarTerminationOrientation

endHookOrient

Defines the orientation of the hook plane at the end of the rebar with respect to the orientation of the last curve and the plane normal. Only two values are permitted: Value = Right: The hook is on your right as you stand at the end of the bar, with the bar behind you, taking the bar's normal as "up." Value = Left: The hook is on your left as you stand at the end of the bar, with the bar behind you, taking the bar's normal as "up."

Return Value RebarContainerItem The Rebar Container Item.

ArgumentException

The input curves is empty. -or- The input curves contains at least one curve which is not a bound Line or bound Arc and is not supported for this operation. -or- curves do not form a valid CurveLoop. -or- The input curves contains at least one helical curve and is not supported for this operation. -or- A RebarContainerItem cannot be created from a Rebar Shape that has End Treatments or Cranks or terminations' rotation angles are different than 0.
ArgumentNullException

A non-optional argument was null
ArgumentOutOfRangeException

normal has zero length. -or- A value passed for an enumeration argument is not a member of that enumeration
ArgumentsInconsistentException

curves contains non-fillet arcs with radii that are less than the minimum bend radius for the RebarBarType and RebarShape style.
InvalidOperationException

rebarShape does not match curves.