boofcv.alg.distort

Class LensDistortionOps

java.lang.Object

boofcv.alg.distort.LensDistortionOps

public class LensDistortionOps
extends java.lang.Object

Operations related to manipulating lens distortion in images

Constructor Summary

Constructors

Constructor and Description
LensDistortionOps()

Method Summary

Modifier and Type	Method and Description
static georegression.struct.shapes.RectangleLength2D_F32	boundBoxInside(int srcWidth, int srcHeight, boofcv.struct.distort.PixelTransform2_F32 transform) Finds the maximum area axis-aligned rectangle contained inside the transformed image which does not include any pixels outside the sources border.
static georegression.struct.shapes.RectangleLength2D_F64	boundBoxInside(int srcWidth, int srcHeight, boofcv.struct.distort.PixelTransform2_F64 transform) Finds the maximum area axis-aligned rectangle contained inside the transformed image which does not include any pixels outside the sources border.
static <T extends boofcv.struct.image.ImageBase<T>,O extends CameraPinhole,D extends CameraPinhole> boofcv.alg.distort.ImageDistort<T,T>	changeCameraModel(AdjustmentType type, boofcv.core.image.border.BorderType borderType, O original, D desired, D modified, boofcv.struct.image.ImageType<T> imageType) Creates a distortion for modifying the input image from one camera model into another camera model.
static LensDistortionNarrowFOV	narrow(CameraModel param) Creates the lens distortion for the specified camera parameters.
static void	roundInside(georegression.struct.shapes.RectangleLength2D_F32 bound) Adjust bound to ensure the entire image is contained inside, otherwise there might be single pixel wide black regions
static void	roundInside(georegression.struct.shapes.RectangleLength2D_F64 bound) Adjust bound to ensure the entire image is contained inside, otherwise there might be single pixel wide black regions
static <O extends CameraPinhole,D extends CameraPinhole> boofcv.struct.distort.Point2Transform2_F32	transformChangeModel_F32(AdjustmentType type, O paramOriginal, D paramDesired, boolean desiredToOriginal, D paramMod) Creates a Point2Transform2_F32 for converting pixels from original camera model into a new synthetic model.
static LensDistortionWideFOV	wide(CameraModel param) Creates the lens distortion for the specified camera parameters.

Methods inherited from class java.lang.Object

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

Constructor Detail

LensDistortionOps

public LensDistortionOps()

Method Detail

changeCameraModel

public static <T extends boofcv.struct.image.ImageBase<T>,O extends CameraPinhole,D extends CameraPinhole> boofcv.alg.distort.ImageDistort<T,T> changeCameraModel(AdjustmentType type,
                                                                                                                                                                  boofcv.core.image.border.BorderType borderType,
                                                                                                                                                                  O original,
                                                                                                                                                                  D desired,
                                                                                                                                                                  D modified,
                                                                                                                                                                  boofcv.struct.image.ImageType<T> imageType)

Creates a distortion for modifying the input image from one camera model into another camera model. If requested the camera model can be further modified to ensure certain visibility requirements are meet and the adjusted camera model will be returned.

Parameters:

type - How it should modify the image model to ensure visibility of pixels.

borderType - How the image border is handled

original - The original camera model

desired - The desired camera model

modified - (Optional) The desired camera model after being rescaled. Can be null.

imageType - Type of image.

Returns:

Image distortion from original camera model to the modified one.

transformChangeModel_F32

public static <O extends CameraPinhole,D extends CameraPinhole> boofcv.struct.distort.Point2Transform2_F32 transformChangeModel_F32(AdjustmentType type,
                                                                                                                                    O paramOriginal,
                                                                                                                                    D paramDesired,
                                                                                                                                    boolean desiredToOriginal,
                                                                                                                                    D paramMod)

Creates a Point2Transform2_F32 for converting pixels from original camera model into a new synthetic model. The scaling of the image can be adjusted to ensure certain visibility requirements.

Parameters:

type - The type of adjustment it will apply to the transform

paramOriginal - Camera model for the current image

paramDesired - Desired camera model for the distorted image

desiredToOriginal - If true then the transform's input is assumed to be pixels in the desired image and the output will be in original image, if false then the reverse transform is returned.

paramMod - The modified camera model to meet the requested visibility requirements. Null if you don't want it.

Returns:

The requested transform

narrow

public static LensDistortionNarrowFOV narrow(CameraModel param)

Creates the lens distortion for the specified camera parameters.

wide

public static LensDistortionWideFOV wide(CameraModel param)

Creates the lens distortion for the specified camera parameters.

boundBoxInside

public static georegression.struct.shapes.RectangleLength2D_F32 boundBoxInside(int srcWidth,
                                                                               int srcHeight,
                                                                               boofcv.struct.distort.PixelTransform2_F32 transform)

Finds the maximum area axis-aligned rectangle contained inside the transformed image which does not include any pixels outside the sources border. Assumes that the coordinates are not flipped and some other stuff too.

Parameters:

srcWidth - Width of the source image

srcHeight - Height of the source image

transform - Transform being applied to the image

Returns:

Bounding box

boundBoxInside

public static georegression.struct.shapes.RectangleLength2D_F64 boundBoxInside(int srcWidth,
                                                                               int srcHeight,
                                                                               boofcv.struct.distort.PixelTransform2_F64 transform)

Finds the maximum area axis-aligned rectangle contained inside the transformed image which does not include any pixels outside the sources border. Assumes that the coordinates are not flipped and some other stuff too.

Parameters:

srcWidth - Width of the source image

srcHeight - Height of the source image

transform - Transform being applied to the image

Returns:

Bounding box

roundInside

public static void roundInside(georegression.struct.shapes.RectangleLength2D_F32 bound)

Adjust bound to ensure the entire image is contained inside, otherwise there might be single pixel wide black regions

roundInside

public static void roundInside(georegression.struct.shapes.RectangleLength2D_F64 bound)

Adjust bound to ensure the entire image is contained inside, otherwise there might be single pixel wide black regions