Package net.imglib2.stream

Interface RealLocalizableSpliterator<T>

Type Parameters:

T - pixel type

All Superinterfaces:

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

All Known Subinterfaces:

LocalizableSpliterator<T>

All Known Implementing Classes:

ArrayLocalizingSpliterator, ArraySpliterator, CellSpliterator, CursorSpliterator, PlanarSpliterator, RealCursorSpliterator

public interface RealLocalizableSpliterator<T>
extends java.util.Spliterator<T>, RealLocalizable, Sampler<T>

A Spliterator<T> which is Localizable similar to a Cursor.

The location of the Spliterator reflects the location of the element passed to the Consumer in Spliterator.tryAdvance(java.util.function.Consumer<? super T>) or Spliterator.forEachRemaining(java.util.function.Consumer<? super T>) (at the time the element is passed, and until the next element is passed).

Similar to RealCursor, RealLocalizableSpliterator usually comes in two flavors:

• IterableRealInterval.spliterator() computes location only on demand, and
• IterableRealInterval.localizingSpliterator() preemptively tracks location on every step.

(Which one is more efficient depends on how often location is actually needed.)

To make the RealLocalizable property available in a Stream, use the Streams utility class to create Stream<RealLocalizableSampler<T>> (which internally wraps RealLocalizableSpliterator).

Corresponding to the RealLocalizableSpliterator flavors,

• Streams.localizable(IterableRealInterval) computes element location only on demand, and
• Streams.localizing(IterableRealInterval) tracks location on every step.

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Spliterator

java.util.Spliterator.OfDouble, java.util.Spliterator.OfInt, java.util.Spliterator.OfLong, java.util.Spliterator.OfPrimitive<T extends java.lang.Object,T_CONS extends java.lang.Object,T_SPLITR extends java.util.Spliterator.OfPrimitive<T,T_CONS,T_SPLITR>>

Field Summary

Fields inherited from interface java.util.Spliterator

CONCURRENT, DISTINCT, IMMUTABLE, NONNULL, ORDERED, SIZED, SORTED, SUBSIZED

Method Summary

Modifier and Type	Method	Description
RealLocalizableSpliterator<T>	copy()
RealLocalizableSpliterator<T>	trySplit()

Methods inherited from interface net.imglib2.EuclideanSpace

numDimensions

Methods inherited from interface net.imglib2.RealLocalizable

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

Methods inherited from interface net.imglib2.Sampler

get, getType

Methods inherited from interface java.util.Spliterator

characteristics, estimateSize, forEachRemaining, getComparator, getExactSizeIfKnown, hasCharacteristics, tryAdvance

Method Detail

trySplit

RealLocalizableSpliterator<T> trySplit()

Specified by:

trySplit in interface java.util.Spliterator<T>

copy

RealLocalizableSpliterator<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)