IMSegmentation4 Interface

Provides access to additional linear referencing operations on polylines.

Members

Name Description
Method CalculateNonSimpleMs Redefines the non-simple Ms to be values obtained from interpolation of surrounding defined Ms, or extrapolation of Ms.
Method CalibrateByDistance Calibrates Ms of existing vertices using new Ms from the input points and the shortest path distances along the polyline between those points. The update method is given as a combination of esriGeometryUpdateMEnum values.
Method CalibrateByDistance3D Calibrates Ms of existing vertices using new Ms from the input points and the shortest 3D path distances along the polyline between those points. The update method is given as a combination of esriGeometryUpdateMEnum values.
Method CalibrateByMs Calibrates Ms of existing vertices using new Ms from the input points and existing Ms along shortest paths between those points. The update method is given as a combination of esriGeometryUpdateMEnum values.
Method CalibrateByMs3D Calibrates Ms of existing vertices using new Ms from the input points and existing Ms along the shortest 3D paths between those points. The update method is given as a combination of esriGeometryUpdateMEnum values.
Method ExtrapolateMs Extrapolates the Ms at one or both ends of the geometry based on the M interval between the fromIndex and the toIndex.
Method ExtrapolateMs3D Extrapolates the Ms at one or both ends of the geometry based on the M interval between the fromIndex and the toIndex.
Method GetDistancesAtM Returns an array of distances along the polyline at which is located the specified M. If the geometry's M's are monotonic along the geometry then the array will only have one element.
Method GetDistancesAtM3D Returns an array of 3D distances along the polyline at which is located the specified M. If the geometry's M's are monotonic along the geometry then the array will only have one element.
Method GetMsAtDistance Returns M values at the distance along the geometry. An array of one or two Ms is returned. Two Ms can be returned if the given distance is exactly at the beginning or ending of a part.
Method GetMsAtDistance3D Returns M values at the 3D distance along the geometry. An array of one or two Ms is returned. Two Ms can be returned if the given distance is exactly at the beginning or ending of a part.
Method GetNormalsAtM Returns a geometry bag of line segments corresponding to the normal at the locations along the geometry where the specified M occurs.
Method GetPointsAtM Returns a multipoint geometry corresponding to the locations along the geometry where the specified M occurs.
Method GetPointsAtM3D Returns a multipoint geometry corresponding to the locations along the geometry where the specified M occurs.
Method GetSubcurveBetweenMs Returns a polyline geometry corresponding to the subcurve(s) between the fromM and the toM.
Method GetSubcurveBetweenMs3D Returns a polyline geometry corresponding to the subcurve(s) between the fromM and the toM.
Method GetSubcurveBetweenMsEx Returns a polyline geometry corresponding to the subcurve(s) between the fromM and the toM values. The 'details' arguments are composed of esriMCurveRelationEnum values.
Method GetSubcurveBetweenMsEx3D Returns a polyline geometry corresponding to the subcurve(s) between the fromM and the toM values. The 'details' arguments are composed of esriMCurveRelationEnum values.
Method InsertMAtDistance Sets the M value at the given distance along the geometry; creates a point at that distance if no point exists there.
Method InsertMAtDistance3D Sets the M value at the given 3D distance along the geometry; creates a point at that distance if no point exists there.
Method InterpolateMsBetween Generates Ms by linear interpolation of segment distances for all vertices in the range [start+1, end-1].
Method InterpolateMsBetween3D Generates Ms by linear interpolation of 3D distances for all vertices in the range [start+1, end-1].
Read-only property MMax The maximum M value.
Read-only property MMin The minimum M value.
Read-only property MMonotonic A value indicating whether Ms are monotonic, and if so, whether they are ascending or descending.
Read-only property MMonotonicity A combination of esriMonotinicityEnum values that describes all trends in M values over the length of the curve.
Method MultiplyMs Multiplies all the M values by a factor.
Method OffsetMs Offsets all the M values by an offset value.
Method OrientByMs Re-orients the curve to make Ms non-decreasing, if possible.
Method QueryFirstLastM Returns the first and last defined M value for the curve.
Method ReverseMsOrder Reverses the order of the Ms along the geometry.
Method SetAndInterpolateMsBetween Sets the Ms at the beginning and the end of the geometry and interpolates the M values between these values.
Method SetAndInterpolateMsBetween3D Sets the Ms at the beginning and the end of the geometry and interpolates the M values between these values based on an interpolation normalized to the 3D length of the shape.
Method SetMsAsDistance Sets the M values to the cumulative length from the origin of the geometry.
Method SetMsAsDistance2 Sets Ms on vertices as scaled and offset distances from the input origin as measured along the polyline. Shortest path distances from the origin are used. Optionally ignores distances between parts of the polyline.
Method SetMsAsDistance3D Sets the M values to the cumulative 3D length from the origin of the geometry.
Method UpdateAllMsByMs Sets Ms on vertices as scaled and offset M distances from the input origin as measured along the polyline based on the existing M's. Shortest path distances from the origin are used. Optionally ignores distances between parts of the polyline.
Method UpdateMsByDistance Updates Ms along the shortest path between the specified endpoints. The interpolation ratio is determined by the input ms and euclidean distance along that path. The update method is given as a combination of esriGeometryUpdateMEnum values.
Method UpdateMsByMs Updates Ms along the shortest path between the specified endpoints. The interpolation ratio is determined by the existing ms along that path and the input ms. The update method is given as a combination of esriGeometryUpdateMEnum values.

IMSegmentation4.CalibrateByDistance3D Method

Calibrates Ms of existing vertices using new Ms from the input points and the shortest 3D path distances along the polyline between those points. The update method is given as a combination of esriGeometryUpdateMEnum values.

Public Function CalibrateByDistance3D ( _
    ByVal Points As IEnumVertex, _
    ByVal updateHow As Integer, _
    ByVal ignoreGaps As Boolean, _
    ByVal cutoffDistance As Double _
) As IEnumSplitPoint
public IEnumSplitPoint CalibrateByDistance3D (
    IEnumVertex Points,
    int updateHow,
    bool ignoreGaps,
    double cutoffDistance
);

IMSegmentation4.CalibrateByMs3D Method

Calibrates Ms of existing vertices using new Ms from the input points and existing Ms along the shortest 3D paths between those points. The update method is given as a combination of esriGeometryUpdateMEnum values.

Public Function CalibrateByMs3D ( _
    ByVal Points As IEnumVertex, _
    ByVal updateHow As Integer, _
    ByVal cutoffDistance As Double _
) As IEnumSplitPoint
public IEnumSplitPoint CalibrateByMs3D (
    IEnumVertex Points,
    int updateHow,
    double cutoffDistance
);

IMSegmentation4.ExtrapolateMs3D Method

Extrapolates the Ms at one or both ends of the geometry based on the M interval between the fromIndex and the toIndex.

Public Sub ExtrapolateMs3D ( _
    ByVal extrapolationStyle As esriExtrapolationEnum, _
    ByVal fromPart As Integer, _
    ByVal FromPoint As Integer, _
    ByVal toPart As Integer, _
    ByVal ToPoint As Integer _
)
public void ExtrapolateMs3D (
    esriExtrapolationEnum extrapolationStyle,
    int fromPart,
    int FromPoint,
    int toPart,
    int ToPoint
);

IMSegmentation4.GetDistancesAtM3D Method

Returns an array of 3D distances along the polyline at which is located the specified M. If the geometry's M's are monotonic along the geometry then the array will only have one element.

Public Function GetDistancesAtM3D ( _
    ByVal asRatio As Boolean, _
    ByVal M As Double _
) As Object
public object GetDistancesAtM3D (
    bool asRatio,
    double M
);

IMSegmentation4.GetMsAtDistance3D Method

Returns M values at the 3D distance along the geometry. An array of one or two Ms is returned. Two Ms can be returned if the given distance is exactly at the beginning or ending of a part.

Public Function GetMsAtDistance3D ( _
    ByVal distance As Double, _
    ByVal asRatio As Boolean _
) As Object
public object GetMsAtDistance3D (
    double distance,
    bool asRatio
);

IMSegmentation4.GetPointsAtM3D Method

Returns a multipoint geometry corresponding to the locations along the geometry where the specified M occurs.

Public Function GetPointsAtM3D ( _
    ByVal M As Double, _
    ByVal Offset As IVector3D _
) As IGeometryCollection
public IGeometryCollection GetPointsAtM3D (
    double M,
    IVector3D Offset
);

IMSegmentation4.GetSubcurveBetweenMs3D Method

Returns a polyline geometry corresponding to the subcurve(s) between the fromM and the toM.

Public Function GetSubcurveBetweenMs3D ( _
    ByVal fromM As Double, _
    ByVal toM As Double _
) As IGeometryCollection
public IGeometryCollection GetSubcurveBetweenMs3D (
    double fromM,
    double toM
);

IMSegmentation4.GetSubcurveBetweenMsEx3D Method

Returns a polyline geometry corresponding to the subcurve(s) between the fromM and the toM values. The 'details' arguments are composed of esriMCurveRelationEnum values.

Public Function GetSubcurveBetweenMsEx3D ( _
    ByVal fromM As Double, _
    ByVal toM As Double, _
    ByRef fromMDetails As Integer, _
    ByRef toMDetails As Integer _
) As IGeometryCollection
public IGeometryCollection GetSubcurveBetweenMsEx3D (
    double fromM,
    double toM,
    ref int fromMDetails,
    ref int toMDetails
);

IMSegmentation4.InsertMAtDistance3D Method

Sets the M value at the given 3D distance along the geometry; creates a point at that distance if no point exists there.

Public Sub InsertMAtDistance3D ( _
    ByVal M As Double, _
    ByVal distance As Double, _
    ByVal asRatio As Boolean, _
    ByVal createPart As Boolean, _
    ByRef SplitHappened As Boolean, _
    ByRef newPartIndex As Integer, _
    ByRef newSegmentIndex As Integer _
)
public void InsertMAtDistance3D (
    double M,
    double distance,
    bool asRatio,
    bool createPart,
    ref bool SplitHappened,
    ref int newPartIndex,
    ref int newSegmentIndex
);

IMSegmentation4.InterpolateMsBetween3D Method

Generates Ms by linear interpolation of 3D distances for all vertices in the range [start+1, end-1].

Public Sub InterpolateMsBetween3D ( _
    ByVal fromPart As Integer, _
    ByVal FromPoint As Integer, _
    ByVal toPart As Integer, _
    ByVal ToPoint As Integer _
)
public void InterpolateMsBetween3D (
    int fromPart,
    int FromPoint,
    int toPart,
    int ToPoint
);

IMSegmentation4.SetAndInterpolateMsBetween3D Method

Sets the Ms at the beginning and the end of the geometry and interpolates the M values between these values based on an interpolation normalized to the 3D length of the shape.

Public Sub SetAndInterpolateMsBetween3D ( _
    ByVal fromM As Double, _
    ByVal toM As Double _
)
public void SetAndInterpolateMsBetween3D (
    double fromM,
    double toM
);

IMSegmentation4.SetMsAsDistance3D Method

Sets the M values to the cumulative 3D length from the origin of the geometry.

Public Sub SetMsAsDistance3D ( _
    ByVal asRatio As Boolean _
)
public void SetMsAsDistance3D (
    bool asRatio
);

Inherited Interfaces

Interfaces Description
IMSegmentation3 Provides access to additional linear referencing operations on polylines.
IMSegmentation2 Provides access to additional linear referencing operations on polylines.
IMSegmentation Provides access to members for defining an M-based linear coordinate system on a polyline or polygon.
IMCollection Provides access to members that control operations on M-aware multipoints, polylines, polygons and multipatches.

Classes that implement IMSegmentation4

Classes Description
Polyline An ordered collection of paths; optionally has measure, height and ID attributes.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.