com.esri.core.geometry.OperatorCut Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of esri-geometry-api Show documentation

The Esri Geometry API for Java enables developers to write custom applications for analysis of spatial data.

There is a newer version: 2.2.4

/*
 Copyright 1995-2013 Esri

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

 For additional information, contact:
 Environmental Systems Research Institute, Inc.
 Attn: Contracts Dept
 380 New York Street
 Redlands, California, USA 92373

 email: [email protected]
 */

package com.esri.core.geometry;

import com.esri.core.geometry.Operator.Type;

/**
 * Calculates distance between geometries.
 */
public abstract class OperatorCut extends Operator {
	@Override
	public Type getType() {
		return Type.Cut;
	}

	/**
	 * Performs the Cut operation on a geometry. \param bConsiderTouch Indicates
	 * whether we consider a touch event a cut. This only applies to Polylines,
	 * but it's recommended to set this variable to True. \param cuttee The
	 * input geometry to be cut. \param cutter The polyline that will be used to
	 * divide the cuttee into pieces where they cross the cutter. \return
	 * Returns a GeometryCursor of cut geometries. For Polylines, all left cuts
	 * will be grouped together in the first Geometry, Right cuts and coincident
	 * cuts are grouped in the second Geometry, and each undefined cut, along
	 * with any uncut parts, are output as separate Polylines. For Polygons, all
	 * left cuts are grouped in the first Polygon, all right cuts are in the
	 * second Polygon, and each undefined cut, along with any left-over parts
	 * after cutting, are output as a separate Polygon. If there were no cuts
	 * the cursor will return no geometry. If the left or right cut does not
	 * exist, the returned geometry will be empty for this type of cut. An
	 * undefined cut will only be produced if a left cut or right cut was
	 * produced, and there was a part left over after cutting or a cut is
	 * bounded to the left and right of the cutter.
	 */
	public abstract GeometryCursor execute(boolean bConsiderTouch,
			Geometry cuttee, Polyline cutter,
			SpatialReference spatialReference, ProgressTracker progressTracker);

	public static OperatorCut local() {
		return (OperatorCut) OperatorFactoryLocal.getInstance().getOperator(
				Type.Cut);
	}
}