public class WriteConvertedIterableRandomAccessibleInterval<A,B,S extends RandomAccessible<A> & IterableInterval<A>> extends AbstractConvertedIterableRandomAccessibleInterval<A,B,S>
sourceInterval
Constructor and Description |
---|
WriteConvertedIterableRandomAccessibleInterval(S source,
SamplerConverter<? super A,B> converter) |
WriteConvertedIterableRandomAccessibleInterval(S source,
Supplier<SamplerConverter<? super A,B>> converterSupplier) |
Modifier and Type | Method and Description |
---|---|
WriteConvertedCursor<A,B> |
cursor()
Returns a
RealCursor that iterates with optimal speed without
calculating the location at each iteration step. |
WriteConvertedCursor<A,B> |
localizingCursor()
Returns a
RealLocalizable Iterator that calculates its
location at each iteration step. |
WriteConvertedRandomAccess<A,B> |
randomAccess()
Create a random access sampler for integer coordinates.
|
WriteConvertedRandomAccess<A,B> |
randomAccess(Interval interval)
Create a random access sampler for integer coordinates.
|
firstElement, iterationOrder, iterator, size
dimension, dimensions, max, max, max, min, min, min
getSource, numDimensions, realMax, realMax, realMax, realMin, realMin, realMin
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
forEach, spliterator
getAt, getAt, getAt
dimension, max, max, max, maxAsLongArray, maxAsPoint, min, min, min, minAsLongArray, minAsPoint, realMax, realMin
maxAsDoubleArray, maxAsRealPoint, minAsDoubleArray, minAsRealPoint, realMax, realMax, realMin, realMin
allPositive, allPositive, dimensions, dimensions, dimensionsAsLongArray, dimensionsAsPoint, verify, verify, verifyAllPositive, verifyAllPositive
numDimensions
public WriteConvertedIterableRandomAccessibleInterval(S source, Supplier<SamplerConverter<? super A,B>> converterSupplier)
public WriteConvertedIterableRandomAccessibleInterval(S source, SamplerConverter<? super A,B> converter)
public WriteConvertedRandomAccess<A,B> randomAccess()
RandomAccessible
The returned random access covers as much of the domain as possible.
Please note:RandomAccessibleInterval
s have a finite domain (their Interval
),
so RandomAccessible.randomAccess()
is only guaranteed to cover this finite domain.
This may lead to unexpected results when using Views
. In
the following code
RandomAccessible<T> extended = Views.extendBorder( img ) RandomAccessibleInterval<T> cropped = Views.interval( extended, img ); RandomAccess<T> a1 = extended.randomAccess(); RandomAccess<T> a2 = cropped.randomAccess();The
access
a1
on the extended image is valid
everywhere. However, somewhat counter-intuitively, the
access
a2
on the extended and cropped image
is only valid on the interval img
to which the extended image was
cropped. The access is only required to cover this interval, because it
is the domain of the cropped image. Views
attempts to provide the
fastest possible access that meets this requirement, and will therefore
strip the extension.
To deal with this, if you know that you need to access pixels outside the
domain of the RandomAccessibleInterval
, and you know that the
RandomAccessibleInterval
is actually defined beyond its interval
boundaries, then use the RandomAccessible.randomAccess(Interval)
variant and
specify which interval you actually want to access. In the above example,
RandomAccess<T> a2 = cropped.randomAccess( Intervals.expand( img, 10 ) );will provide the extended access as expected.
randomAccess
in interface RandomAccessible<B>
randomAccess
in class AbstractConvertedIterableRandomAccessibleInterval<A,B,S extends RandomAccessible<A> & IterableInterval<A>>
public WriteConvertedRandomAccess<A,B> randomAccess(Interval interval)
RandomAccessible
The returned random access is intended to be used in the specified
interval only. Thus, the RandomAccessible may provide optimized versions.
If the interval is completely contained in the domain, the random access
is guaranteed to provide the same values as that obtained by
RandomAccessible.randomAccess()
within the interval.
randomAccess
in interface RandomAccessible<B>
randomAccess
in class AbstractConvertedIterableRandomAccessibleInterval<A,B,S extends RandomAccessible<A> & IterableInterval<A>>
interval
- in which interval you intend to use the random access.public WriteConvertedCursor<A,B> cursor()
IterableRealInterval
Returns a RealCursor
that iterates with optimal speed without
calculating the location at each iteration step. Localization is
performed on demand.
Use this where localization is required rarely/ not for each iteration.
cursor
in interface IterableInterval<B>
cursor
in interface IterableRealInterval<B>
cursor
in class AbstractConvertedIterableRandomAccessibleInterval<A,B,S extends RandomAccessible<A> & IterableInterval<A>>
public WriteConvertedCursor<A,B> localizingCursor()
IterableRealInterval
Returns a RealLocalizable
Iterator
that calculates its
location at each iteration step. That is, localization is performed with
optimal speed.
Use this where localization is required often/ for each iteration.
localizingCursor
in interface IterableInterval<B>
localizingCursor
in interface IterableRealInterval<B>
localizingCursor
in class AbstractConvertedIterableRandomAccessibleInterval<A,B,S extends RandomAccessible<A> & IterableInterval<A>>
Copyright © 2015–2022 ImgLib2. All rights reserved.