org.openimaj.image.processing.transform

Class RemapProcessor

java.lang.Object

org.openimaj.image.processing.transform.RemapProcessor

All Implemented Interfaces:

ImageProcessor<FImage>, Processor<FImage>, SinglebandImageProcessor<Float,FImage>

public class RemapProcessor
extends Object
implements SinglebandImageProcessor<Float,FImage>

ImageProcessor and associated static utility methods for transforming an image based on the pixel positions given by a distortion map: destination(x,y) = source(mapx(x,y), mapy(x,y)). This allows efficient implementation of highly non-linear mappings.

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

Nested Class Summary

Nested classes/interfaces inherited from interface org.openimaj.image.processor.SinglebandImageProcessor

SinglebandImageProcessor.Processable<T,S extends Image<T,S>,I extends Image<?,I>>

Constructor Summary

Constructors

Constructor and Description
RemapProcessor(FImage xords, FImage yords) Construct with the given distortion map, and use ImageInterpolation.InterpolationType.BILINEAR interpolation.
RemapProcessor(FImage xords, FImage yords, ImageInterpolation.Interpolator interpolator) Construct with the given distortion map and interpolator.

Method Summary

Modifier and Type	Method and Description
void	processImage(FImage image) Process an image.
static FImage	remap(FImage in, FImage xords, FImage yords) Transform an image using the given parameters.
static FImage	remap(FImage in, FImage out, FImage xords, FImage yords) Transform an image using the given parameters, and write the results into out.
static FImage	remap(FImage in, FImage out, FImage xords, FImage yords, ImageInterpolation interpolation) Transform an image using the given parameters, and write te results into out
static FImage	remap(FImage in, FImage xords, FImage yords, ImageInterpolation.Interpolator interpolator) Transform an image using the given parameters
static FImage	remap(FImage in, FImage xords, FImage yords, ImageInterpolation interpolation) Transform an image using the given parameters

Methods inherited from class java.lang.Object

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

Constructor Detail

RemapProcessor

public RemapProcessor(FImage xords,
                      FImage yords)

Construct with the given distortion map, and use ImageInterpolation.InterpolationType.BILINEAR interpolation.

Parameters:

xords - the x-ordinates

yords - the y-ordinates

RemapProcessor

public RemapProcessor(FImage xords,
                      FImage yords,
                      ImageInterpolation.Interpolator interpolator)

Construct with the given distortion map and interpolator.

Parameters:

xords - the x-ordinates

yords - the y-ordinates

interpolator - the interpolator

Method Detail

processImage

public void processImage(FImage image)

Description copied from interface: ImageProcessor

Process an image. Implementing classes must alter the image passed in-place or assign the output to the input using Image.internalAssign(Image).

Specified by:

processImage in interface ImageProcessor<FImage>

Parameters:

image - The image to process in place.

remap

public static FImage remap(FImage in,
                           FImage xords,
                           FImage yords,
                           ImageInterpolation.Interpolator interpolator)

Transform an image using the given parameters

Parameters:

in - the image to transform

xords - the x-ordinates

yords - the y-ordinates

interpolator - the interpolator

Returns:

the transformed image

remap

public static FImage remap(FImage in,
                           FImage xords,
                           FImage yords,
                           ImageInterpolation interpolation)

Transform an image using the given parameters

Parameters:

in - the image to transform

xords - the x-ordinates

yords - the y-ordinates

interpolation - the interpolation

Returns:

the transformed image

remap

public static FImage remap(FImage in,
                           FImage out,
                           FImage xords,
                           FImage yords,
                           ImageInterpolation interpolation)

Transform an image using the given parameters, and write te results into out

Parameters:

in - the image to transform

out - the output image

xords - the x-ordinates

yords - the y-ordinates

interpolation - the interpolation

Returns:

out

remap

public static FImage remap(FImage in,
                           FImage xords,
                           FImage yords)

Transform an image using the given parameters. Assume ImageInterpolation.InterpolationType.BILINEAR interpolation.

Parameters:

in - the image to transform

xords - the x-ordinates

yords - the y-ordinates

Returns:

the transformed image

remap

public static FImage remap(FImage in,
                           FImage out,
                           FImage xords,
                           FImage yords)

Transform an image using the given parameters, and write the results into out. Assume ImageInterpolation.InterpolationType.BILINEAR interpolation.

Parameters:

in - the image to transform

out - the output image

xords - the x-ordinates

yords - the y-ordinates

Returns:

out