com.esri.arcgis.geometry
Interface IMSegmentation3

All Superinterfaces:

IMCollection, IMSegmentation, IMSegmentation2, Serializable

All Known Subinterfaces:

IMSegmentation4

All Known Implementing Classes:

Polyline

public interface IMSegmentation3
extends IMSegmentation2, Serializable

Provides access to additional linear referencing operations on polylines.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Method Summary

int	getMMonotonicity() A combination of esriMonotinicityEnum values that describes all trends in M values over the length of the curve.
IGeometryCollection	getNormalsAtM(double m, double length) Returns a geometry bag of line segments corresponding to the normal at the locations along the geometry where the specified M occurs.
void	orientByMs() Re-orients the curve to make Ms non-decreasing, if possible.
void	queryFirstLastM(double[] firstM, double[] lastM) Returns the first and last defined M value for the curve.
void	updateAllMsByMs(IPoint origin, double scale, double offset, boolean ignoreGaps) 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.

Methods inherited from interface com.esri.arcgis.geometry.IMSegmentation2

calibrateByDistance, calibrateByMs, getSubcurveBetweenMsEx, setMsAsDistance2, updateMsByDistance, updateMsByMs

Methods inherited from interface com.esri.arcgis.geometry.IMSegmentation

calculateNonSimpleMs, extrapolateMs, getDistancesAtM, getMMonotonic, getMsAtDistance, getPointsAtM, getSubcurveBetweenMs, insertMAtDistance, interpolateMsBetween, reverseMsOrder, setAndInterpolateMsBetween, setMsAsDistance

Methods inherited from interface com.esri.arcgis.geometry.IMCollection

getMMax, getMMin, multiplyMs, offsetMs

Method Detail

updateAllMsByMs

void updateAllMsByMs(IPoint origin,
                     double scale,
                     double offset,
                     boolean ignoreGaps)
                     throws IOException,
                            AutomationException

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.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Parameters:

origin - A reference to a com.esri.arcgis.geometry.IPoint (in)

scale - The scale (in)

offset - The offset (in)

ignoreGaps - The ignoreGaps (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getNormalsAtM

IGeometryCollection getNormalsAtM(double m,
                                  double length)
                                  throws IOException,
                                         AutomationException

Returns a geometry bag of line segments corresponding to the normal at the locations along the geometry where the specified M occurs.

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.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Parameters:

m - The m (in)

length - The length (in)

Returns:

A reference to a com.esri.arcgis.geometry.IGeometryCollection

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMMonotonicity

int getMMonotonicity()
                     throws IOException,
                            AutomationException

A combination of esriMonotinicityEnum values that describes all trends in M values over the length of the curve.

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.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Returns:

The monotonicityDetails

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryFirstLastM

void queryFirstLastM(double[] firstM,
                     double[] lastM)
                     throws IOException,
                            AutomationException

Returns the first and last defined M value for the curve.

Description

QueryFirstLastM returns the first and the last Non-NAN Ms on the polyline. If all the vertex attributes are NANs then NANs are returned.

Remarks

Note : NAN stands for Not A Number.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Parameters:

firstM - The firstM (out: use single element array)

lastM - The lastM (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

orientByMs

void orientByMs()
                throws IOException,
                       AutomationException

Re-orients the curve to make Ms non-decreasing, if possible.

Remarks

Note: If one or many parts of the polyline are non-MMonotonic then the reordering will not happen.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.