Interface IMSegmentation3
Provides access to additional linear referencing operations on polylines.
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
[Guid("58AD0D5D-393D-44AA-9797-6E50D06ED524")]
public interface IMSegmentation3 : IMSegmentation2, IMSegmentation, IMCollection
Properties
MMax
double MMax { get; }
Property Value
MMin
double MMin { get; }
Property Value
MMonotonic
esriMMonotonicEnum MMonotonic { get; }
Property Value
MMonotonicity
A combination of esriMonotinicityEnum values that describes all trends in M values over the length of the curve.
int MMonotonicity { get; }
Property Value
Remarks
The MMonotonicity value in the above case is 15 because that polyline has intervals that EsriValueIncreases (1), EsriValueLevel (2), EsriValueDecreases(4) and EsriValuesEmpty(8).
Note : That method returns a combination of esriMonotinicityEnum values.
Methods
CalculateNonSimpleMs()
void CalculateNonSimpleMs()
CalibrateByDistance(IEnumVertex, int, bool, double)
IEnumSplitPoint CalibrateByDistance(IEnumVertex Points, int updateHow, bool ignoreGaps, double cutoffDistance)
Parameters
PointsIEnumVertexupdateHowintignoreGapsboolcutoffDistancedouble
Returns
CalibrateByMs(IEnumVertex, int, double)
IEnumSplitPoint CalibrateByMs(IEnumVertex Points, int updateHow, double cutoffDistance)
Parameters
PointsIEnumVertexupdateHowintcutoffDistancedouble
Returns
ExtrapolateMs(esriExtrapolationEnum, int, int, int, int)
void ExtrapolateMs(esriExtrapolationEnum extrapolationStyle, int fromPart, int FromPoint, int toPart, int ToPoint)
Parameters
extrapolationStyleesriExtrapolationEnumfromPartintFromPointinttoPartintToPointint
GetDistancesAtM(bool, double)
object GetDistancesAtM(bool asRatio, double M)
Parameters
Returns
GetMsAtDistance(double, bool)
object GetMsAtDistance(double distance, bool asRatio)
Parameters
Returns
GetNormalsAtM(double, double)
Returns a geometry bag of line segments corresponding to the normal at the locations along the geometry where the specified M occurs.
IGeometryCollection GetNormalsAtM(double M, double Length)
Parameters
Returns
Remarks
Note : The Length parameter represents the length of the normal lines returned. A negative value returns the normal lines on the left of the polyline.

In the above example the specified M was 10 and the Length was 50. The normal line was then created on the right side of the polyline at the location of M = 10.
GetPointsAtM(double, double)
IGeometryCollection GetPointsAtM(double M, double lateralOffset)
Parameters
Returns
GetSubcurveBetweenMs(double, double)
IGeometryCollection GetSubcurveBetweenMs(double fromM, double toM)
Parameters
Returns
GetSubcurveBetweenMsEx(double, double, ref int, ref int)
IGeometryCollection GetSubcurveBetweenMsEx(double fromM, double toM, ref int fromMDetails, ref int toMDetails)
Parameters
Returns
InsertMAtDistance(double, double, bool, bool, out bool, out int, out int)
void InsertMAtDistance(double M, double distance, bool asRatio, bool createPart, out bool SplitHappened, out int newPartIndex, out int newSegmentIndex)
Parameters
MdoubledistancedoubleasRatioboolcreatePartboolSplitHappenedboolnewPartIndexintnewSegmentIndexint
InterpolateMsBetween(int, int, int, int)
void InterpolateMsBetween(int fromPart, int FromPoint, int toPart, int ToPoint)
Parameters
MultiplyMs(double)
void MultiplyMs(double factor)
Parameters
factordouble
OffsetMs(double)
void OffsetMs(double Offset)
Parameters
Offsetdouble
OrientByMs()
Re-orients the curve to make Ms non-decreasing, if possible.
void OrientByMs()
Remarks
Note: If one or many parts of the polyline are non-MMonotonic then the reordering will not happen.
QueryFirstLastM(out double, out double)
Returns the first and last defined M value for the curve.
void QueryFirstLastM(out double firstM, out double lastM)
Parameters
Remarks
Note : NAN stands for Not A Number.
ReverseMsOrder()
void ReverseMsOrder()
SetAndInterpolateMsBetween(double, double)
void SetAndInterpolateMsBetween(double fromM, double toM)
Parameters
SetMsAsDistance(bool)
void SetMsAsDistance(bool asRatio)
Parameters
asRatiobool
SetMsAsDistance2(IPoint, double, double, bool)
void SetMsAsDistance2(IPoint Origin, double Scale, double Offset, bool ignoreGaps)
Parameters
UpdateAllMsByMs(IPoint, double, double, bool)
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.
void UpdateAllMsByMs(IPoint Origin, double Scale, double Offset, bool ignoreGaps)
Parameters
UpdateMsByDistance(int, int, int, int, double, double, int, bool)
void UpdateMsByDistance(int fromPart, int FromPoint, int toPart, int ToPoint, double fromM, double toM, int updateHow, bool ignoreGaps)
Parameters
fromPartintFromPointinttoPartintToPointintfromMdoubletoMdoubleupdateHowintignoreGapsbool
UpdateMsByMs(int, int, int, int, double, double, int)
void UpdateMsByMs(int fromPart, int FromPoint, int toPart, int ToPoint, double fromM, double toM, int updateHow)