Package noaa.coastwatch.util

Class ConstrainedStrideLocationIterator

java.lang.Object

noaa.coastwatch.util.ConstrainedStrideLocationIterator

All Implemented Interfaces:

Iterator<DataLocation>, DataLocationIterator, ResettableIterator

public class ConstrainedStrideLocationIterator
extends Object
implements DataLocationIterator

The ConstrainedStrideLocationIterator class iterates over data locations using a constant step stride vector, but uses a java.awt.Shape object to determine if each location is contained within a shape boundary. See DataLocation.increment(int[],int[]) for details on how the locations are incremented with a stride.

Since:

3.1.7

Author:

Peter Hollemans

Constructor Summary

Constructors

Constructor	Description
ConstrainedStrideLocationIterator(Shape shape, int[] stride)	Creates a new constrained stride location iterator.

Method Summary

Modifier and Type	Method	Description
boolean	hasNext()
static void	main(String[] argv)	Tests this class.
DataLocation	next()
DataLocation	nextLocation(DataLocation loc)	Gets the next data location.
void	remove()
void	reset()	Resets the iterator to the first element.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Iterator

forEachRemaining

Constructor Details

ConstrainedStrideLocationIterator

public ConstrainedStrideLocationIterator(Shape shape,
 int[] stride)

Creates a new constrained stride location iterator.

Parameters:

shape - the shape to use for constraining the iterator data locations.

stride - the data location stride in each dimension.

Method Details

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<DataLocation>

nextLocation

public DataLocation nextLocation(DataLocation loc)

Description copied from interface: DataLocationIterator

Gets the next data location.

Specified by:

nextLocation in interface DataLocationIterator

Parameters:

loc - the location to fill in with coordinates, or null to allocate a new location.

Returns:

the next location. The location is allocated only if the passed location is null, otherwise the same location is returned.

remove

public void remove()

Specified by:

remove in interface Iterator<DataLocation>

reset

public void reset()

Description copied from interface: ResettableIterator

Resets the iterator to the first element.

Specified by:

reset in interface ResettableIterator

next

public DataLocation next()

Specified by:

next in interface Iterator<DataLocation>

main

public static void main(String[] argv)

Tests this class.

Parameters:

argv - the array of command line parameters.