Package net.imglib2

Interface RealCursor<T>

All Superinterfaces:

EuclideanSpace, java.util.Iterator<T>, Iterator, RealLocalizable, Sampler<T>, Typed<T>

All Known Subinterfaces:

Cursor<T>

All Known Implementing Classes:

AbstractArrayCursor, AbstractArrayLocalizingCursor, AbstractConvertedCursor, AbstractConvertedRealCursor, AbstractCursor, AbstractCursorInt, AbstractLocalizingCursor, AbstractLocalizingCursorInt, AbstractLongListImg.LongListCursor, AbstractLongListImg.LongListLocalizingCursor, ArrayCursor, ArrayLocalizingCursor, ArrayLocalizingSubIntervalCursor, ArraySubIntervalCursor, BiConvertedCursor, BiConvertedRealCursor, CellCursor, CellLocalizingCursor, ConvertedCursor, ConvertedRealCursor, KDTree.KDTreeCursor, ListCursor, ListLocalizingCursor, NtreeCursor, PlanarCursor, PlanarCursor1D, PlanarCursor2D, PlanarLocalizingCursor, PlanarLocalizingCursor1D, PlanarLocalizingCursor2D, PlanarPlaneSubsetCursor, PlanarPlaneSubsetLocalizingCursor, PointSampleList.PointSampleListCursor, RandomAccessibleIntervalCursor, RealPointSampleList.RealPointSampleListCursor, SlicingCursor, WriteConvertedCursor, WriteConvertedRealCursor

public interface RealCursor<T>
extends RealLocalizable, Sampler<T>, Iterator, java.util.Iterator<T>

A RealCursor iterates over a set of RealLocalizable elements, for example intensity values sampled at a finite set of arbitrary real positions.

RealCursor is a combination of several interfaces to achieve this. The Iterator interface is used to iterate the set. Use Iterator.fwd() to advance the cursor and Iterator.hasNext() to check whether there are more elements. Note, that the Cursor starts before the first element, i.e., you have to call fwd() once to move to the first element.

The RealLocalizable interface provides access to the position of the current element. The Sampler.get() method of the Sampler interface provides access to the value of the current element.

For convenience, Cursor also extends the Iterator interface so that you are able to use Cursors in for-each loops. Calling the Iterator.next() method is equivalent to calling fwd() and get(). That is, after next() the Cursor is on the element returned by next(). get() can be used to obtain that element (again), and getPosition() to obtain its position. The Iterator.remove() method is not supported by imglib Cursors, in general.

It is not guaranteed that a RealCursor will perform bounds checking. Asking the position or value of a RealCursor that was not advanced to its first element, or was moved beyond its last element, has undefined results.

Method Summary

Modifier and Type	Method	Description
RealCursor<T>	copy()
default RealCursor<T>	copyCursor()	Deprecated. Use copy() instead
default T	next()	Default implementation, calls Iterator.fwd() then Sampler.get().

Methods inherited from interface net.imglib2.EuclideanSpace

numDimensions

Methods inherited from interface java.util.Iterator

forEachRemaining, hasNext, remove

Methods inherited from interface net.imglib2.Iterator

fwd, hasNext, jumpFwd, reset

Methods inherited from interface net.imglib2.RealLocalizable

getDoublePosition, getFloatPosition, localize, localize, localize, positionAsDoubleArray, positionAsRealPoint

Methods inherited from interface net.imglib2.Sampler

get, getType

Method Detail

copyCursor

@Deprecated
default RealCursor<T> copyCursor()

Deprecated.

Use copy() instead

copy

RealCursor<T> copy()

Specified by:

copy in interface Sampler<T>

Returns:

- A new Sampler in the same state accessing the same values. It does NOT copy T, just the state of the Sampler. Otherwise use T.copy() if available. Sampler.copy().get() == Sampler.get(), i.e. both hold the same value, not necessarily the same instance (this is the case for an ArrayCursor for example)

next

default T next()

Default implementation, calls Iterator.fwd() then Sampler.get().

Note, that hasNext() is not checked before fwd(). If such a check is desired it should be implemented in fwd() (throwing NoSuchElementException).

Specified by:

next in interface java.util.Iterator<T>