M

FamilyItemFactory.NewBlend

Description:
Add a new Blend instance into the Autodesk Revit family document.

Remarks:
This method creates a blend in a family document. Revit will determine an appropriate default mapping for the vertices of the two profiles. A profile loop cannot contain just one closed curve - in such a case, the curve must be split into at least two segments, so that Revit can find vertices to use for mapping the blend. Caution: several aspects of the Blend are not (easily) predictable from the input arguments. For example, the Blend's TopOffset may be less than its BottomOffset in some cases, depending on the orientations of the profile loops and the orientation of the sketch plane (if a sketch plane is provided). Also, such orientations can affect whether the first or second profile lies in the sketch plane (if a sketch plane is provided).

public Blend NewBlend(
	bool isSolid,
	CurveArray profile1,
	CurveArray profile2,
	SketchPlane sketchPlane
)

Public Function NewBlend ( 
	isSolid As Boolean,
	profile1 As CurveArray,
	profile2 As CurveArray,
	sketchPlane As SketchPlane
) As Blend

public:
Blend^ NewBlend(
	bool isSolid, 
	CurveArray^ profile1, 
	CurveArray^ profile2, 
	SketchPlane^ sketchPlane
)

member NewBlend : 
        isSolid : bool * 
        profile1 : CurveArray * 
        profile2 : CurveArray * 
        sketchPlane : SketchPlane -> Blend

Boolean

isSolid

Indicates if the Blend is Solid or Void.
CurveArray

profile1

The first blend section. It should represent a single, planar curve loop.
CurveArray

profile2

The second blend section. It should represent a single, planar curve loop lying in a plane parallel to that of the first blend section.
SketchPlane

sketchPlane

The sketch plane for the first profile. Use this to associate the "base" of the blend to geometry from another element. Optional, it can be null if you want Revit to derive a new sketch plane from the geometry of the base profile.

Return Value Blend If creation was successful the new blend is returned, otherwise an exception with failure information will be thrown.

ArgumentException

Thrown when the argument is invalid.
InvalidOperationException

Thrown when creation is attempted in Conceptual Mass, 2D, or other family where blends cannot be created.
InvalidOperationException

Thrown when the creation failed.