org.openimaj.image.processing.transform

Class ProjectionProcessor<Q,T extends Image<Q,T>>

java.lang.Object

org.openimaj.image.processing.transform.ProjectionProcessor<Q,T>

Type Parameters:

Q - The image pixel type

T - the image type

All Implemented Interfaces:

AccumulatingImageCombiner<T,T>

Direct Known Subclasses:

FProjectionProcessor, MBFProjectionProcessor

public class ProjectionProcessor<Q,T extends Image<Q,T>>
extends Object
implements AccumulatingImageCombiner<T,T>

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk), Sina Samangooei (ss@ecs.soton.ac.uk) Perform a set of matrix transforms on a set of images and construct a single image containing all the pixels (or a window of the pixels) in the projected space.

Field Summary

Fields

Modifier and Type	Field and Description
protected Jama.Matrix	currentMatrix
protected List<T>	images
protected int	maxc
protected int	maxr
protected int	minc
protected int	minr
protected List<Rectangle>	projectedRectangles
protected List<Shape>	projectedShapes
protected List<Jama.Matrix>	transforms
protected List<Jama.Matrix>	transformsInverted
protected boolean	unset

Constructor Summary

Constructors

Constructor and Description
ProjectionProcessor() Construct a projection processor starting with an identity matrix for any images processed (i.e., don't do anything)

Method Summary

Modifier and Type	Method and Description
void	accumulate(T image) Prepare an image to be transformed using the current matrix.
T	combine() Combine the accumulated images and produce the output.
protected Shape[][]	getCurrentShapes() Get the current shapes as an array for efficient access, first entry for each shape is its rectangle, second entry is the shape
Jama.Matrix	getMatrix()
protected boolean	isInside(int shapeIndex, Shape[][] projectRectangleShapes, Point2d realPoint)
T	performBlendedProjection(int windowMinC, int windowMaxC, int windowMinR, int windowMaxR, Q backgroundColour) Perform blended projection but only request data for pixels within the windowed range provided.
T	performProjection() Using all the images currently processed, perform the projection on each image and draw every pixel with valid data.
T	performProjection(boolean keepOriginalWindow, Q backgroundColour) Perform projection specifying the background colour (i.e.
T	performProjection(int windowMinC, int windowMaxC, int windowMinR, int windowMaxR) Perform projection but only request data for pixels within the windowed range provided.
T	performProjection(int windowMinC, int windowMaxC, int windowMinR, int windowMaxR, Q backgroundColour) Perform projection but only request data for pixels within the windowed range provided.
T	performProjection(int windowMinC, int windowMinR, T output) Perform projection but only request data for pixels within the windowed range provided.
T	performProjection(Q backgroundColour) Perform projection specifying the background colour (i.e.
static <Q,T extends Image<Q,T>> T	project(T image, Jama.Matrix matrix) Utility function, project one image with one matrix.
static <Q,T extends Image<Q,T>> T	project(T image, Jama.Matrix matrix, Q backgroundColour) Utility function, project one image with one matrix.
void	setMatrix(Jama.Matrix matrix) Set the matrix, any images processed from this point forward will be projected using this matrix

Methods inherited from class java.lang.Object

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

Field Detail

minc

protected int minc

minr

protected int minr

maxc

protected int maxc

maxr

protected int maxr

unset

protected boolean unset

transforms

protected List<Jama.Matrix> transforms

transformsInverted

protected List<Jama.Matrix> transformsInverted

images

protected List<T extends Image<Q,T>> images

projectedShapes

protected List<Shape> projectedShapes

projectedRectangles

protected List<Rectangle> projectedRectangles

currentMatrix

protected Jama.Matrix currentMatrix

Constructor Detail

ProjectionProcessor

public ProjectionProcessor()

Construct a projection processor starting with an identity matrix for any images processed (i.e., don't do anything)

Method Detail

setMatrix

public void setMatrix(Jama.Matrix matrix)

Set the matrix, any images processed from this point forward will be projected using this matrix

Parameters:

matrix - a 3x3 matrix representing a 2d transform

accumulate

public void accumulate(T image)

Prepare an image to be transformed using the current matrix. The bounds of the image post transform are calculated so the default performProjection() knows what range of pixels to draw

Specified by:

accumulate in interface AccumulatingImageCombiner<T extends Image<Q,T>,T extends Image<Q,T>>

Parameters:

image - to be transformed

performProjection

public T performProjection()

Using all the images currently processed, perform the projection on each image and draw every pixel with valid data. Pixels within the bounding box but with no data are set to black (more specifically 0, whatever that may mean for this kind of image)

Returns:

the image containing all the pixels drawn

performProjection

public T performProjection(Q backgroundColour)

Perform projection specifying the background colour (i.e. the colour of pixels with no data).

Parameters:

backgroundColour - the background colour

Returns:

projected images

performProjection

public T performProjection(boolean keepOriginalWindow,
                           Q backgroundColour)

Perform projection specifying the background colour (i.e. the colour of pixels with no data) and whether the original window size should be kept. If set to true the window of pixels drawn post projection are within the window of the first image processed.

Parameters:

keepOriginalWindow - whether to keep the original image's window

backgroundColour - the background colour

Returns:

projected images

performProjection

public T performProjection(int windowMinC,
                           int windowMaxC,
                           int windowMinR,
                           int windowMaxR)

Perform projection but only request data for pixels within the windowed range provided. Specify the background colour, i.e. the value of pixels with no data post projection.

Parameters:

windowMinC - left X

windowMaxC - right X

windowMinR - top Y

windowMaxR - bottom Y

Returns:

projected image within the window

performProjection

public T performProjection(int windowMinC,
                           int windowMaxC,
                           int windowMinR,
                           int windowMaxR,
                           Q backgroundColour)

Perform projection but only request data for pixels within the windowed range provided. Specify the background colour, i.e. the value of pixels with no data post projection.

Parameters:

windowMinC - left X

windowMaxC - right X

windowMinR - top Y

windowMaxR - bottom Y

backgroundColour - background colour of pixels with no data

Returns:

projected image within the window

getCurrentShapes

protected Shape[][] getCurrentShapes()

Get the current shapes as an array for efficient access, first entry for each shape is its rectangle, second entry is the shape

Returns:

isInside

protected boolean isInside(int shapeIndex,
                           Shape[][] projectRectangleShapes,
                           Point2d realPoint)

performProjection

public T performProjection(int windowMinC,
                           int windowMinR,
                           T output)

Perform projection but only request data for pixels within the windowed range provided. Specify the background colour, i.e. the value of pixels with no data post projection.

Parameters:

windowMinC - left X

windowMinR - top Y

output - the target image in which to project

Returns:

projected image within the window

performBlendedProjection

public T performBlendedProjection(int windowMinC,
                                  int windowMaxC,
                                  int windowMinR,
                                  int windowMaxR,
                                  Q backgroundColour)

Perform blended projection but only request data for pixels within the windowed range provided. Specify the background colour, i.e. the value of pixels with no data post projection. This blends any existing pixels to newly added pixels

Parameters:

windowMinC - left X

windowMaxC - right X

windowMinR - top Y

windowMaxR - bottom Y

backgroundColour - background colour of pixels with no data

Returns:

projected image within the window

getMatrix

public Jama.Matrix getMatrix()

Returns:

Current matrix

project

public static <Q,T extends Image<Q,T>> T project(T image,
                                                 Jama.Matrix matrix)

Utility function, project one image with one matrix. Every valid pixel in the space the image is projected into is displayed in the final image.

Type Parameters:

Q - the image pixel type

T - image type

Parameters:

image - the image to project

matrix - the matrix to project against

Returns:

projected image

project

public static <Q,T extends Image<Q,T>> T project(T image,
                                                 Jama.Matrix matrix,
                                                 Q backgroundColour)

Utility function, project one image with one matrix. Every valid pixel in the space the image is projected into is displayed in the final image.

Type Parameters:

Q - the image pixel type

T - image type

Parameters:

image - the image to project

matrix - the matrix to project against

backgroundColour - The colour of pixels with no data

Returns:

projected image

combine

public T combine()

Description copied from interface: AccumulatingImageCombiner

Combine the accumulated images and produce the output.

Specified by:

combine in interface AccumulatingImageCombiner<T extends Image<Q,T>,T extends Image<Q,T>>

Returns:

combined image.