boofcv.alg.transform.ii

Class IntegralImageOps

java.lang.Object

boofcv.alg.transform.ii.IntegralImageOps

public class IntegralImageOps
extends Object

Common operations for dealing with integral images.

Author:

Peter Abeles

Constructor Summary

Constructors

Constructor and Description
IntegralImageOps()

Method Summary

Methods

Modifier and Type	Method and Description
static float	block_unsafe(ImageFloat32 integral, int x0, int y0, int x1, int y1) Computes the value of a block inside an integral image without bounds checking.
static double	block_unsafe(ImageFloat64 integral, int x0, int y0, int x1, int y1) Computes the value of a block inside an integral image without bounds checking.
static int	block_unsafe(ImageSInt32 integral, int x0, int y0, int x1, int y1) Computes the value of a block inside an integral image without bounds checking.
static long	block_unsafe(ImageSInt64 integral, int x0, int y0, int x1, int y1) Computes the value of a block inside an integral image without bounds checking.
static float	block_zero(ImageFloat32 integral, int x0, int y0, int x1, int y1) Computes the value of a block inside an integral image and treats pixels outside of the image as zero.
static double	block_zero(ImageFloat64 integral, int x0, int y0, int x1, int y1) Computes the value of a block inside an integral image and treats pixels outside of the image as zero.
static int	block_zero(ImageSInt32 integral, int x0, int y0, int x1, int y1) Computes the value of a block inside an integral image and treats pixels outside of the image as zero.
static long	block_zero(ImageSInt64 integral, int x0, int y0, int x1, int y1) Computes the value of a block inside an integral image and treats pixels outside of the image as zero.
static ImageFloat32	convolve(ImageFloat32 integral, IntegralKernel kernel, ImageFloat32 output) General code for convolving a box filter across an image using the integral image.
static ImageFloat64	convolve(ImageFloat64 integral, IntegralKernel kernel, ImageFloat64 output) General code for convolving a box filter across an image using the integral image.
static ImageSInt32	convolve(ImageSInt32 integral, IntegralKernel kernel, ImageSInt32 output) General code for convolving a box filter across an image using the integral image.
static ImageSInt64	convolve(ImageSInt64 integral, IntegralKernel kernel, ImageSInt64 output) General code for convolving a box filter across an image using the integral image.
static ImageFloat32	convolveBorder(ImageFloat32 integral, IntegralKernel kernel, ImageFloat32 output, int borderX, int borderY) Convolves the kernel only across the image's border.
static ImageFloat64	convolveBorder(ImageFloat64 integral, IntegralKernel kernel, ImageFloat64 output, int borderX, int borderY) Convolves the kernel only across the image's border.
static ImageSInt32	convolveBorder(ImageSInt32 integral, IntegralKernel kernel, ImageSInt32 output, int borderX, int borderY) Convolves the kernel only across the image's border.
static ImageSInt64	convolveBorder(ImageSInt64 integral, IntegralKernel kernel, ImageSInt64 output, int borderX, int borderY) Convolves the kernel only across the image's border.
static float	convolveSparse(ImageFloat32 integral, IntegralKernel kernel, int x, int y) Convolves a kernel around a single point in the integral image.
static double	convolveSparse(ImageFloat64 integral, IntegralKernel kernel, int x, int y) Convolves a kernel around a single point in the integral image.
static int	convolveSparse(ImageSInt32 integral, IntegralKernel kernel, int x, int y) Convolves a kernel around a single point in the integral image.
static long	convolveSparse(ImageSInt64 integral, IntegralKernel kernel, int x, int y) Convolves a kernel around a single point in the integral image.
static boolean	isInBounds(int x, int y, IntegralKernel kernel, int width, int height) Checks to see if the kernel is applied at this specific spot if all the pixels would be inside the image bounds or not
static void	print(IntegralKernel kernel) Prints out the kernel.
static ImageFloat32	transform(ImageFloat32 input, ImageFloat32 transformed) Converts a regular image into an integral image.
static ImageFloat64	transform(ImageFloat64 input, ImageFloat64 transformed) Converts a regular image into an integral image.
static ImageSInt32	transform(ImageSInt32 input, ImageSInt32 transformed) Converts a regular image into an integral image.
static ImageSInt64	transform(ImageSInt64 input, ImageSInt64 transformed) Converts a regular image into an integral image.
static ImageSInt32	transform(ImageUInt8 input, ImageSInt32 transformed) Converts a regular image into an integral image.

Methods inherited from class java.lang.Object

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

Constructor Detail

IntegralImageOps

public IntegralImageOps()

Method Detail

transform

public static ImageFloat32 transform(ImageFloat32 input,
                     ImageFloat32 transformed)

Converts a regular image into an integral image.

Parameters:

input - Regular image. Not modified.

transformed - Integral image. If null a new image will be created. Modified.

Returns:

Integral image.

transform

public static ImageFloat64 transform(ImageFloat64 input,
                     ImageFloat64 transformed)

Converts a regular image into an integral image.

Parameters:

input - Regular image. Not modified.

transformed - Integral image. If null a new image will be created. Modified.

Returns:

Integral image.

transform

public static ImageSInt32 transform(ImageUInt8 input,
                    ImageSInt32 transformed)

Converts a regular image into an integral image.

Parameters:

input - Regular image. Not modified.

transformed - Integral image. If null a new image will be created. Modified.

Returns:

Integral image.

transform

public static ImageSInt32 transform(ImageSInt32 input,
                    ImageSInt32 transformed)

Converts a regular image into an integral image.

Parameters:

input - Regular image. Not modified.

transformed - Integral image. If null a new image will be created. Modified.

Returns:

Integral image.

transform

public static ImageSInt64 transform(ImageSInt64 input,
                    ImageSInt64 transformed)

Converts a regular image into an integral image.

Parameters:

input - Regular image. Not modified.

transformed - Integral image. If null a new image will be created. Modified.

Returns:

Integral image.

convolve

public static ImageFloat32 convolve(ImageFloat32 integral,
                    IntegralKernel kernel,
                    ImageFloat32 output)

General code for convolving a box filter across an image using the integral image.

Parameters:

integral - Integral image.

kernel - Convolution kernel.

output - The convolved image. If null a new image will be declared and returned. Modified.

Returns:

Convolved image.

convolve

public static ImageFloat64 convolve(ImageFloat64 integral,
                    IntegralKernel kernel,
                    ImageFloat64 output)

General code for convolving a box filter across an image using the integral image.

Parameters:

integral - Integral image.

kernel - Convolution kernel.

output - The convolved image. If null a new image will be declared and returned. Modified.

Returns:

Convolved image.

convolve

public static ImageSInt32 convolve(ImageSInt32 integral,
                   IntegralKernel kernel,
                   ImageSInt32 output)

General code for convolving a box filter across an image using the integral image.

Parameters:

integral - Integral image.

kernel - Convolution kernel.

output - The convolved image. If null a new image will be declared and returned. Modified.

Returns:

Convolved image.

convolve

public static ImageSInt64 convolve(ImageSInt64 integral,
                   IntegralKernel kernel,
                   ImageSInt64 output)

General code for convolving a box filter across an image using the integral image.

Parameters:

integral - Integral image.

kernel - Convolution kernel.

output - The convolved image. If null a new image will be declared and returned. Modified.

Returns:

Convolved image.

convolveBorder

public static ImageFloat32 convolveBorder(ImageFloat32 integral,
                          IntegralKernel kernel,
                          ImageFloat32 output,
                          int borderX,
                          int borderY)

Convolves the kernel only across the image's border.

Parameters:

integral - Integral image. Not modified.

kernel - Convolution kernel.

output - The convolved image. If null a new image will be created. Modified.

borderX - Size of the image border along the horizontal axis.

borderY - size of the image border along the vertical axis.

convolveBorder

public static ImageFloat64 convolveBorder(ImageFloat64 integral,
                          IntegralKernel kernel,
                          ImageFloat64 output,
                          int borderX,
                          int borderY)

Convolves the kernel only across the image's border.

Parameters:

integral - Integral image. Not modified.

kernel - Convolution kernel.

output - The convolved image. If null a new image will be created. Modified.

borderX - Size of the image border along the horizontal axis.

borderY - size of the image border along the vertical axis.

convolveBorder

public static ImageSInt32 convolveBorder(ImageSInt32 integral,
                         IntegralKernel kernel,
                         ImageSInt32 output,
                         int borderX,
                         int borderY)

Convolves the kernel only across the image's border.

Parameters:

integral - Integral image. Not modified.

kernel - Convolution kernel.

output - The convolved image. If null a new image will be created. Modified.

borderX - Size of the image border along the horizontal axis.

borderY - size of the image border along the vertical axis.

convolveBorder

public static ImageSInt64 convolveBorder(ImageSInt64 integral,
                         IntegralKernel kernel,
                         ImageSInt64 output,
                         int borderX,
                         int borderY)

Convolves the kernel only across the image's border.

Parameters:

integral - Integral image. Not modified.

kernel - Convolution kernel.

output - The convolved image. If null a new image will be created. Modified.

borderX - Size of the image border along the horizontal axis.

borderY - size of the image border along the vertical axis.

convolveSparse

public static float convolveSparse(ImageFloat32 integral,
                   IntegralKernel kernel,
                   int x,
                   int y)

Convolves a kernel around a single point in the integral image.

Parameters:

integral - Input integral image. Not modified.

kernel - Convolution kernel.

x - Pixel the convolution is performed at.

y - Pixel the convolution is performed at.

Returns:

Value of the convolution

convolveSparse

public static double convolveSparse(ImageFloat64 integral,
                    IntegralKernel kernel,
                    int x,
                    int y)

Convolves a kernel around a single point in the integral image.

Parameters:

integral - Input integral image. Not modified.

kernel - Convolution kernel.

x - Pixel the convolution is performed at.

y - Pixel the convolution is performed at.

Returns:

Value of the convolution

convolveSparse

public static int convolveSparse(ImageSInt32 integral,
                 IntegralKernel kernel,
                 int x,
                 int y)

Convolves a kernel around a single point in the integral image.

Parameters:

integral - Input integral image. Not modified.

kernel - Convolution kernel.

x - Pixel the convolution is performed at.

y - Pixel the convolution is performed at.

Returns:

Value of the convolution

convolveSparse

public static long convolveSparse(ImageSInt64 integral,
                  IntegralKernel kernel,
                  int x,
                  int y)

Convolves a kernel around a single point in the integral image.

Parameters:

integral - Input integral image. Not modified.

kernel - Convolution kernel.

x - Pixel the convolution is performed at.

y - Pixel the convolution is performed at.

Returns:

Value of the convolution

block_unsafe

public static double block_unsafe(ImageFloat64 integral,
                  int x0,
                  int y0,
                  int x1,
                  int y1)

Computes the value of a block inside an integral image without bounds checking. The block is defined as follows: x0 < x <= x1 and y0 < y <= y1.

Parameters:

integral - Integral image.

x0 - Lower bound of the block. Exclusive.

y0 - Lower bound of the block. Exclusive.

x1 - Upper bound of the block. Inclusive.

y1 - Upper bound of the block. Inclusive.

Returns:

Value inside the block.

block_unsafe

public static float block_unsafe(ImageFloat32 integral,
                 int x0,
                 int y0,
                 int x1,
                 int y1)

Computes the value of a block inside an integral image without bounds checking. The block is defined as follows: x0 < x <= x1 and y0 < y <= y1.

Parameters:

integral - Integral image.

x0 - Lower bound of the block. Exclusive.

y0 - Lower bound of the block. Exclusive.

x1 - Upper bound of the block. Inclusive.

y1 - Upper bound of the block. Inclusive.

Returns:

Value inside the block.

block_unsafe

public static int block_unsafe(ImageSInt32 integral,
               int x0,
               int y0,
               int x1,
               int y1)

Computes the value of a block inside an integral image without bounds checking. The block is defined as follows: x0 < x <= x1 and y0 < y <= y1.

Parameters:

integral - Integral image.

x0 - Lower bound of the block. Exclusive.

y0 - Lower bound of the block. Exclusive.

x1 - Upper bound of the block. Inclusive.

y1 - Upper bound of the block. Inclusive.

Returns:

Value inside the block.

block_unsafe

public static long block_unsafe(ImageSInt64 integral,
                int x0,
                int y0,
                int x1,
                int y1)

Computes the value of a block inside an integral image without bounds checking. The block is defined as follows: x0 < x <= x1 and y0 < y <= y1.

Parameters:

integral - Integral image.

x0 - Lower bound of the block. Exclusive.

y0 - Lower bound of the block. Exclusive.

x1 - Upper bound of the block. Inclusive.

y1 - Upper bound of the block. Inclusive.

Returns:

Value inside the block.

block_zero

public static float block_zero(ImageFloat32 integral,
               int x0,
               int y0,
               int x1,
               int y1)

Computes the value of a block inside an integral image and treats pixels outside of the image as zero. The block is defined as follows: x0 < x <= x1 and y0 < y <= y1.

Parameters:

integral - Integral image.

x0 - Lower bound of the block. Exclusive.

y0 - Lower bound of the block. Exclusive.

x1 - Upper bound of the block. Inclusive.

y1 - Upper bound of the block. Inclusive.

Returns:

Value inside the block.

block_zero

public static double block_zero(ImageFloat64 integral,
                int x0,
                int y0,
                int x1,
                int y1)

Computes the value of a block inside an integral image and treats pixels outside of the image as zero. The block is defined as follows: x0 < x <= x1 and y0 < y <= y1.

Parameters:

integral - Integral image.

x0 - Lower bound of the block. Exclusive.

y0 - Lower bound of the block. Exclusive.

x1 - Upper bound of the block. Inclusive.

y1 - Upper bound of the block. Inclusive.

Returns:

Value inside the block.

block_zero

public static int block_zero(ImageSInt32 integral,
             int x0,
             int y0,
             int x1,
             int y1)

Computes the value of a block inside an integral image and treats pixels outside of the image as zero. The block is defined as follows: x0 < x <= x1 and y0 < y <= y1.

Parameters:

integral - Integral image.

x0 - Lower bound of the block. Exclusive.

y0 - Lower bound of the block. Exclusive.

x1 - Upper bound of the block. Inclusive.

y1 - Upper bound of the block. Inclusive.

Returns:

Value inside the block.

block_zero

public static long block_zero(ImageSInt64 integral,
              int x0,
              int y0,
              int x1,
              int y1)

Computes the value of a block inside an integral image and treats pixels outside of the image as zero. The block is defined as follows: x0 < x <= x1 and y0 < y <= y1.

Parameters:

integral - Integral image.

x0 - Lower bound of the block. Exclusive.

y0 - Lower bound of the block. Exclusive.

x1 - Upper bound of the block. Inclusive.

y1 - Upper bound of the block. Inclusive.

Returns:

Value inside the block.

print

public static void print(IntegralKernel kernel)

Prints out the kernel.

Parameters:

kernel - THe kernel which is to be printed.

isInBounds

public static boolean isInBounds(int x,
                 int y,
                 IntegralKernel kernel,
                 int width,
                 int height)

Checks to see if the kernel is applied at this specific spot if all the pixels would be inside the image bounds or not

Parameters:

x - location where the kernel is applied. x-axis

y - location where the kernel is applied. y-axis

kernel - The kernel

width - Image's width

height - Image's height

Returns:

true if in bounds and false if out of bounds