Extrusion

Extrusion class

Represents an extrusion, or objects such as beams or linearly extruded elements, that can be represented by profile curves and two miter planes at the extremes.

Inheritence: Rhino.Runtime.CommonObjectRhino.Geometry.GeometryBaseRhino.Geometry.SurfaceExtrusion
Derived Classes:

Namespace: Rhino.Geometry
Extrusion: references

Constructors (7)

CommonObject()

Allows construction from inheriting classes.

CommonObject(SerializationInfo info, StreamingContext context)

Protected constructor for internal use.

Extrusion()

Initializes a new instance of the Extrusion class.

Extrusion(SerializationInfo info, StreamingContext context)

Protected serialization constructor.

GeometryBase(SerializationInfo info, StreamingContext context)

Protected constructor for internal use.

Surface()

Protected constructor for internal use.

Surface(SerializationInfo info, StreamingContext context)

Protected constructor for internal use.

Properties (26)

CapCount

Gets the amount of capping surfaces.

Disposed

Indicates if this object has been disposed or the document it originally belonged to has been disposed.

HasBrepForm

Returns True if the Brep.TryConvertBrep function will be successful for this object

HasUserData

Gets True if this class has any custom information attached to it through UserData.

IsCappedAtBottom

Gets a value indicating whether the surface that fills the bottom profile is existing.

IsCappedAtTop

Gets a value indicating whether the surface that fills the top profile is existing.

IsDeformable

True if object can be accurately modified with "squishy" transformations like projections, shears, and non-uniform scaling.

IsDocumentControlled

If True this object may not be modified. Any properties or functions that attempt to modify this object when it is set to "IsReadOnly" will throw a NotSupportedException.

IsDocumentControlled

If True this object may not be modified. Any properties or functions that attempt to modify this object when it is set to "IsReadOnly" will throw a NotSupportedException.

IsMiteredAtEnd

Gets a value indicating whether a miter plane at the end is defined.

IsMiteredAtStart

Returns a value indicating whether a miter plane at start is defined.

IsSolid

Gets a value indicating whether there is no gap among all surfaces constructing this object.

IsSolid

Gets a values indicating whether a surface is solid.

IsSubDFriendly

Returns True if the surface is a non-rational, uniform, natural or periodic, cubic NURBS surface. Otherwise, False is returned.

IsValid

Tests an object to see if it is valid.

MiterPlaneNormalAtEnd

Gets or sets the normal of the miter plane at the end in profile coordinates. In profile coordinates, 0,0,1 always maps to the extrusion axis

MiterPlaneNormalAtStart

Gets or sets the normal of the miter plane at the start in profile coordinates. In profile coordinates, 0,0,1 always maps to the extrusion axis

ObjectType

Useful for switch statements that need to differentiate between basic object types like points, curves, surfaces, and so on.

PathEnd

Gets the end point of the path.

PathStart

Gets the start point of the path.

PathTangent

Gets the up vector of the path.

PerformCorruptionTesting

Used to test ON_Object* pointers to see if they are a brep or mesh that is corrupt enough to crash Rhino.

ProfileCount

Gets the amount of profile curves.

UserData

List of custom information that is attached to this class.

UserDictionary

Dictionary of custom information attached to this class. The dictionary is actually user data provided as an easy to use shareable set of information.

UserStringCount

Gets the amount of user strings.

Methods (148)

AddInnerProfile(Curve innerProfile)

Adds an inner profile.

ClosestPoint(Point3d testPoint,Double u,Double v)

Input the parameters of the point on the surface that is closest to testPoint.

ClosestSide(Double u,Double v)

Gets the side that is closest, in terms of 3D-distance, to a U and V parameter.

ComponentIndex()

If this piece of geometry is a component in something larger, like a BrepEdge in a Brep, then this function returns the component index.

ConstructConstObject(Object parentObject,Int32 subobjectIndex)

Assigns a parent object and a sub-object index to this.

Create(Curve curve, Plane plane,Double height,Boolean cap)

Create an extrusion from a 3d curve, a plane and a height.

Create(Curve planarCurve,Double height,Boolean cap)

Creates an extrusion of a 3d curve (which must be planar) and a height.

CreateBoxExtrusion(Box box,Boolean cap)

Gets an extrusion from a box.

CreateCylinderExtrusion(Cylinder cylinder,Boolean capBottom,Boolean capTop)

Gets an extrusion form of a cylinder.

CreateExtrusion(Curve profile, Vector3d direction)

Constructs a surface by extruding a curve along a vector.

CreateExtrusionToPoint(Curve profile, Point3d apexPoint)

Constructs a surface by extruding a curve to a point.

CreatePeriodicSurface(Surface surface,Int32 direction,Boolean bSmooth)

Constructs a periodic surface from a base surface and a direction.

CreatePeriodicSurface(Surface surface,Int32 direction)

Constructs a periodic surface from a base surface and a direction.

CreatePipeExtrusion(Cylinder cylinder,Double otherRadius,Boolean capTop,Boolean capBottom)

Gets an extrusion form of a pipe.

CreateRollingBallFillet(Surface surfaceA, Point2d uvA, Surface surfaceB, Point2d uvB,Double radius,Double tolerance)

Constructs a rolling ball fillet between two surfaces.

CreateRollingBallFillet(Surface surfaceA, Surface surfaceB,Double radius,Double tolerance)

Constructs a rolling ball fillet between two surfaces.

CreateRollingBallFillet(Surface surfaceA,Boolean flipA, Surface surfaceB,Boolean flipB,Double radius,Double tolerance)

Constructs a rolling ball fillet between two surfaces.

CreateSoftEditSurface(Surface surface, Point2d uv, Vector3d delta,Double uLength,Double vLength,Double tolerance,Boolean fixEnds)

Creates a soft edited surface from an existing surface using a smooth field of influence.

CreateTweenSurfacesWithSampling(Surface surface0, Surface surface1,Int32 numSurfaces,Int32 numSamples,Double tolerance)

Create tween surfaces that gradually transition between two bounding surfaces using point sampling.

CurvatureAt(Double u,Double v)

Computes the curvature at the given UV coordinate.

DataCRC(UInt32 currentRemainder)

Returns a CRC calculated from the information that defines the object. This CRC can be used as a quick way to see if two objects are not identical.

Degree(Int32 direction)

Returns the maximum algebraic degree of any span (or a good estimate if curve spans are not algebraic).

DeleteAllUserStrings()

DeleteUserString(String key)

Dispose()

Actively reclaims unmanaged resources that this instance uses.

Dispose(Boolean disposing)

For derived class implementers.
This method is called with argument True when class user calls Dispose(), while with argument False when the Garbage Collector invokes the finalizer, or Finalize() method.
You must reclaim all used unmanaged resources in both cases, and can use this chance to call Dispose on disposable fields if the argument is true.
Also, you must call the base virtual method within your overriding method.

Dispose(Boolean disposing)

Overridden in order to destroy local display cache information

Domain(Int32 direction)

Gets the domain in a direction.

Duplicate()

Constructs a deep (full) copy of this object.

DuplicateShallow()

Constructs a light copy of this object. By "light", it is meant that the same underlying data is used until something is done to attempt to change it. For example, you could have a shallow copy of a very heavy mesh object and the same underlying data will be used when doing things like inspecting the number of faces on the mesh. If you modify the location of one of the mesh vertices, the shallow copy will create a full duplicate of the underlying mesh data and the shallow copy will become a deep copy.

EnsurePrivateCopy()

If you want to keep a copy of this class around by holding onto it in a variable after a command completes, call EnsurePrivateCopy to make sure that this class is not tied to the document. You can call this function as many times as you want.

Evaluate(Double u,Double v,Int32 numberDerivatives, out Point3d point, out Vector3d[] derivatives)

Evaluates a surface mathematically.

Extend(IsoStatus edge,Double extensionLength,Boolean smooth)

Extends an untrimmed surface along one edge.

Extend(Int32 direction, Interval interval)

Analytically extends the surface to include the interval.

Fit(Int32 uDegree,Int32 vDegree,Double fitTolerance)

Fits a new surface through an existing surface.

FitCurveToSurface(Curve trimCurve3d, Vector3d trimProjectionDir,Double tolerance, IEnumerable<double> Knots,Boolean divideIntoSections, ref Curve trimCurveOnSurface, ref Curve splitCurve)

FrameAt(Double u,Double v, out Plane frame)

Computes the orient plane on a surface given a U and V parameter.
This is the simple evaluation call with no error handling.

FromBase64String(Int32 archive3dm,Int32 opennurbs,String base64Data)

Create a CommonObject instance from a Base64 encoded string. This is typically the values used when passing common objects around as JSON data

FromJSON(Dictionary<string, string> jsonDictionary)

Create a CommonObject instance from a JSON dictionary

FromJSON(String json)

Create a CommonObject instance from a JSON string

GeometryEquals(GeometryBase first, GeometryBase second)

Determines if two geometries equal one another, in pure geometrical shape. This version only compares the geometry itself and does not include any user data comparisons. This is a comparison by value: for two identical items it will be true, no matter where in memory they may be stored.

GeometryReferenceEquals(GeometryBase one, GeometryBase other)

Determines if two objects are respectively shallow copies, new managed instantiations of the same geometry, or similar internal references to the exact same geometry, both in managed and in unmanaged code.

GetBoundingBox(Plane plane, out Box worldBox)

Aligned Bounding box solver. Gets the plane aligned bounding box.

GetBoundingBox(Plane plane)

Aligned Bounding box solver. Gets the plane aligned bounding box.

GetBoundingBox(Boolean accurate)

Bounding box solver. Gets the world axis aligned bounding box for the geometry.

GetBoundingBox(Transform xform)

Aligned Bounding box solver. Gets the world axis aligned bounding box for the transformed geometry.

GetBrepFormComponentIndex(ComponentIndex extrusionComponentIndex)

Convert a component index that identifies a part of this extrusion to a component index that identifies a part of the Brep created by Extrusion.ToBrep(false).

GetMesh(MeshType meshType)

Obtains a reference to a specified type of mesh for this extrusion.

GetNextDiscontinuity(Int32 direction, Continuity continuityType,Double t0,Double t1,Double t)

Searches for a derivative, tangent, or curvature discontinuity.

GetNextDiscontinuity(Int32 direction, Continuity continuityType,Double t0,Double t1,Double cosAngleTolerance,Double curvatureTolerance,Double t)

Searches for a derivative, tangent, or curvature discontinuity.

GetNurbsFormParameterFromSurfaceParameter(Double surfaceS,Double surfaceT,Double nurbsS,Double nurbsT)

Translates a parameter from the current surface to the parameter space of the surface returned by ToNurbsSurface() .

GetObjectData(SerializationInfo info,StreamingContext context)

Populates a System.Runtime.Serialization.SerializationInfo with the data needed to serialize the target object.

GetPathPlane(Double s)

Gets the 3D plane perpendicular to the path at a normalized path parameter.

GetProfilePlane(Double s)

Gets the 3D plane containing the profile curve at a normalized path parameter.

GetProfileTransformation(Double s)

Gets the transformation that maps the XY profile curve to its 3d location.

GetSpanVector(Int32 direction)

Gets array of span "knots".

GetSurfaceParameterFromNurbsFormParameter(Double nurbsS,Double nurbsT,Double surfaceS,Double surfaceT)

Translates a parameter from a value on the surface returned by ToNurbsSurface() to the current surface.

GetSurfaceSize(Double width,Double height)

Gets an estimate of the size of the rectangle that would be created if the 3d surface where flattened into a rectangle.

GetUserString(String key)

Gets user string from this geometry.

GetUserStrings()

Gets a copy of all (user key string, user value string) pairs attached to this geometry.

GetWireframe()

Constructs all the Wireframe curves for this Extrusion.

HasNurbsForm()

Is there a NURBS surface representation of this surface.

InterpolatedCurveOnSurface(IEnumerable<Point3d> points,Double tolerance)

Constructs an interpolated curve on a surface, using 3D points.

InterpolatedCurveOnSurfaceUV(IEnumerable<Point2d> points,Double tolerance,Boolean closed,Int32 closedSurfaceHandling)

Returns a curve that interpolates points on a surface. The interpolant lies on the surface.

InterpolatedCurveOnSurfaceUV(IEnumerable<Point2d> points,Double tolerance)

Returns a curve that interpolates points on a surface. The interpolant lies on the surface.

IsAtSeam(Double u,Double v)

Tests if a surface parameter value is at a seam.

IsAtSingularity(Double u,Double v,Boolean exact)

Tests if a surface parameter value is at a singularity.

IsClosed(Int32 direction)

Gets a value indicating if the surface is closed in a direction.

IsCone()

Determines if the surface is a portion of a cone within RhinoMath.ZeroTolerance.

IsCone(Double tolerance)

Determines if the surface is a portion of a cone within a given tolerance.

IsContinuous(Continuity continuityType,Double u,Double v)

Tests continuity at a surface parameter value.

IsCylinder()

Determines if the surface is a portion of a cylinder within RhinoMath.ZeroTolerance.

IsCylinder(Double tolerance)

Determines if the surface is a portion of a cylinder within a given tolerance.

IsIsoparametric(BoundingBox bbox)

Determines if a 2d bounding box is isoparametric in the parameter space of this surface.

IsIsoparametric(Curve curve, Interval curveDomain)

Determines if a 2D curve is isoparametric in the parameter space of this surface.

IsIsoparametric(Curve curve)

Determines if a 2d curve is isoparametric in the parameter space of this surface.

IsoCurve(Int32 direction,Double constantParameter)

Gets isoparametric curve.

IsPeriodic(Int32 direction)

Gets a value indicating if the surface is periodic in a direction (default is false).

IsPlanar()

Tests a surface to see if it is planar to zero tolerance.

IsPlanar(Double tolerance)

Tests a surface to see if it is planar to a given tolerance.

IsSingular(Int32 side)

True if surface side is collapsed to a point.

IsSphere()

Determines if the surface is a portion of a sphere within RhinoMath.ZeroTolerance.

IsSphere(Double tolerance)

Determines if the surface is a portion of a sphere within a given tolerance.

IsTorus()

Determines if the surface is a portion of a torus within RhinoMath.ZeroTolerance.

IsTorus(Double tolerance)

Determines if the surface is a portion of a torus within a given tolerance.

IsValidWithLog(String log)

Determines if an object is valid. Also provides a report on errors if this object happens not to be valid.

LocalClosestPoint(Point3d testPoint,Double seedU,Double seedV,Double u,Double v)

Find parameters of the point on a surface that is locally closest to the testPoint. The search for a local close point starts at seed parameters.

MakeDeformable()

If possible, converts the object into a form that can be accurately modified with "squishy" transformations like projections, shears, an non-uniform scaling.

MemoryEstimate()

Computes an estimate of the number of bytes that this object is using in memory.

NonConstOperation()

For derived classes implementers.
Defines the necessary implementation to free the instance from being constant.

NonConstOperation()

Destroy cache handle

NormalAt(Double u,Double v)

Computes the surface normal at a point.
This is the simple evaluation call - it does not support error handling.

Offset(Double distance,Double tolerance)

Constructs a new surface which is offset from the current surface.

OnSwitchToNonConst()

Is called when a non-constant operation first occurs.

OnSwitchToNonConst()

Is called when a non-constant operation occurs.

PathLineCurve()

Gets the line-like curve that is the conceptual axis of the extrusion.

PointAt(Double u,Double v)

Evaluates a point at a given parameter.

Profile3d(ComponentIndex ci)

Gets one of the profiles.

Profile3d(Int32 profileIndex,Double s)

Gets a transversal isocurve of the extruded profile.

ProfileIndex(Double profileParameter)

Gets the index of the profile curve at a domain related to a parameter.

Pullback(Curve curve3d,Double tolerance, Interval curve3dSubdomain)

Pulls a 3d curve back to the surface's parameter space.

Pullback(Curve curve3d,Double tolerance)

Pulls a 3d curve back to the surface's parameter space.

Pushup(Curve curve2d,Double tolerance, Interval curve2dSubdomain)

Computes a 3d curve that is the composite of a 2d curve and the surface map.

Pushup(Curve curve2d,Double tolerance)

Computes a 3d curve that is the composite of a 2d curve and the surface map.

Rebuild(Int32 uDegree,Int32 vDegree,Int32 uPointCount,Int32 vPointCount)

Rebuilds an existing surface to a given degree and point count.

RebuildOneDirection(Int32 direction,Int32 pointCount, LoftType loftType,Double refitTolerance)

Rebuilds an existing surface with a new surface to a given point count in either the u or v directions independently.

RefitSimplySplitSurface(Curve trimCurve3d, Vector3d trimProjectionDir,Double tolerance, RefitTrimKnotMode knotAdditionMode,Int32 numInsertKnots, IEnumerable<double> Knots, RefitTrimSectionMode sectionMode,Int32 numNonTrimSpans,Boolean meetCurve,Boolean oneSided, Point3d PtActive,Boolean outputSurface,Boolean outputCurve,Int32 numSections, List<Surface> lowerSurface, List<Surface> upperSurface, List<Curve> edgeCurve,Double FitMeasurement, ref Curve trimCurveOnSurface, ref Curve splitCurve)

This routine accepts a 3-d trim curve (trimCrv3d). The trim curve is assumed to run from one surface edge to the opposite edge; this is referred to as a "simple" trim curve, roughly parallel to one of the srf directions (either u or v). We refer to that parameter as the "trim parameter". The routine splits the surface via the trim curve, and then refits either side ("upper" = "above the trim", and "lower" = "below the trim") as a set of untrimmed Nurbs surfaces. The idea is to retain, as much as possible, the Nurbs structure of srf, especially in the trim parameter.

RefitSplit(Curve curve, Vector3d trimProjectionDir,Double tolerance, IEnumerable<double> Knots,Boolean bMeetCurve,Boolean divideIntoSections, List<Surface> srfLower, List<Surface> srfUpper, List<Curve> edgeCurve, ref Curve trimCurveOnSurface, ref Curve splitCurve)

Splits the surface into two and refits the split edge

Reverse(Int32 direction,Boolean inPlace)

Same as Reverse, but if inPlace is set to True this Surface is modified instead of a new copy being created.

Reverse(Int32 direction)

Reverses parameterization Domain changes from [a,b] to [-b,-a]

Rotate(Double angleRadians, Vector3d rotationAxis, Point3d rotationCenter)

Rotates the object about the specified axis. A positive rotation angle results in a counter-clockwise rotation about the axis (right hand rule).

Scale(Double scaleFactor)

Scales the object by the specified factor. The scale is centered at the origin.

SetDomain(Int32 direction, Interval domain)

Sets the domain in a direction.

SetMesh(Mesh mesh, MeshType meshType)

Sets a specified type of mesh for this extrusion.

SetOuterProfile(Curve outerProfile,Boolean cap)

Sets the outer profile of the extrusion.

SetPathAndUp(Point3d a, Point3d b, Vector3d up)

Allows to set the two points at the extremes and the up vector.

SetUserString(String key,String value)

Attach a user string (key,value combination) to this geometry.

ShortPath(Point2d start, Point2d end,Double tolerance)

Constructs a geodesic between 2 points, used by ShortPath command in Rhino.

Smooth(Double smoothFactor,Boolean bXSmooth,Boolean bYSmooth,Boolean bZSmooth,Boolean bFixBoundaries, SmoothingCoordinateSystem coordinateSystem, Plane plane)

Smooths a surface by averaging the positions of control points in a specified region.

Smooth(Double smoothFactor,Boolean bXSmooth,Boolean bYSmooth,Boolean bZSmooth,Boolean bFixBoundaries, SmoothingCoordinateSystem coordinateSystem)

Smooths a surface by averaging the positions of control points in a specified region.

SpanCount(Int32 direction)

Gets number of smooth nonempty spans in the parameter direction.

Split(Int32 direction,Double parameter)

Splits (divides) the surface into two parts at the specified parameter

ToBrep()

Converts the surface into a Brep.

ToBrep(Boolean splitKinkyFaces)

Constructs a brep form of the extrusion. The outer profile is always the first face of the brep. If there are inner profiles, additional brep faces are created for each profile. If the outer profile is closed, then end caps are added as the last two faces of the brep.

ToJSON(SerializationOptions options)

Create a JSON string representation of this object

ToNurbsSurface()

Gets a NURBS surface representation of this surface. Default tolerance of 0.0 is used.

ToNurbsSurface(Double tolerance,Int32 accuracy)

Gets a NURBS surface representation of this surface.

Transform(Transform xform)

Transforms the geometry. If the input Transform has a SimilarityType of OrientationReversing, you may want to consider flipping the transformed geometry after calling this function when it makes sense. For example, you may want to call Flip() on a Brep after transforming it.

Translate(Double x,Double y,Double z)

Translates the object along the specified vector.

Translate(Vector3d translationVector)

Translates the object along the specified vector.

Transpose()

Transposes surface parameterization (swap U and V)

Transpose(Boolean inPlace)

Transposes surface parameterization (swap U and V)

Trim(Interval u, Interval v)

Constructs a sub-surface that covers the specified UV trimming domain.

TryGetCone(out Cone cone,Double tolerance)

Tests a surface to see if it is a portion of a cone and returns the cone.

TryGetCone(out Cone cone)

Tests a surface to see if it is a portion of a cone within RhinoMath.ZeroTolerance and return the cone.

TryGetCylinder(out Cylinder cylinder,Double tolerance)

Tests a surface to see if it is a portion of a cylinder and return the infinite cylinder.

TryGetCylinder(out Cylinder cylinder)

Tests a surface to see if it is a portion of a cylinder within RhinoMath.ZeroTolerance and return the cylinder.

TryGetFiniteCylinder(out Cylinder cylinder,Double tolerance)

Tests a surface with the assumption that it might be a right circular cylinder and returns this geometry.

TryGetPlane(out Plane plane,Double tolerance)

Tests a surface for planarity and return the plane.

TryGetPlane(out Plane plane)

Tests a surface for planarity and return the plane.

TryGetSphere(out Sphere sphere,Double tolerance)

Test a surface to see if it is a portion of a sphere and return the sphere.

TryGetSphere(out Sphere sphere)

Test a surface to see if it is a portion of a sphere and return the sphere.

TryGetTorus(out Torus torus,Double tolerance)

Tests a surface to see if it is a portion of a torus and returns the torus.

TryGetTorus(out Torus torus)

Tests a surface to see if it is a portion of a torus within RhinoMath.ZeroTolerance and returns the torus.

VariableOffset(Double uMinvMin,Double uMinvMax,Double uMaxvMin,Double uMaxvMax, IEnumerable<Point2d> interiorParameters, IEnumerable<double> interiorDistances,Double tolerance)

Copies a surface so that all locations at the corners, and from specified interior locations, of the copied surface are specified distances from the original surface.

VariableOffset(Double uMinvMin,Double uMinvMax,Double uMaxvMin,Double uMaxvMax,Double tolerance)

Copies a surface so that all locations at the corners of the copied surface are specified distances from the original surface.

WallEdge(ComponentIndex ci)

Gets one of the longitudinal curves along the beam or extrusion.

WallSurface(ComponentIndex ci)

Gets one of the longitudinal surfaces of the extrusion.

Nothing found