FIL.CreateRectificationMap

public static void CreateRectificationMap
(
	FilNet.ImageFormat inImageFormat,
	FilNet.CreateSpatialMapUnit inCenterPointType,
	FilNet.CreateSpatialMapUnit inOutputSizeType,
	FilNet.InterpolationMethod inInterpolationMethod,
	FilNet.RectificationTransform inTransform,
	FilNet.RectificationMap outRectificationMap
)

Creates a RectificationMap, which is used by RectifyImage filter for image rectification onto a defined world plane. Point locations on rectified images are related to the world plane (defined by inTransform) only by translation and scaling.

The filter may be used to generate a map which only removes a lens distortion in the image – to achieve this behaviour attach a camera model directly to inTransform (i.e. do not provide a homography matrix).

The inTransform may not contain a camera model – in such case the the generated map will assume undistorted image on input.

The output image dimensions, resolution and cropping is specified by:

1. inCenterPoint - the point which will be the center of output image. Can be selected on the input image or it can be defined in world units - see inCenterPointType
2. inOutputWidth,inOutputHeight - the size of output image, can be defined in output pixels or in world units - see inOutputSizeType
3. inWorldScale - the scale for output image, defined in pixels per world unit.

For example, if one is interested in area spanning from (0,0) to (10,6) world coordinate, with resolution 100 pixels / world unit, then inputs would be set as follows:

• inCenterPoint = (5,3)
• inCenterPointType = WorldUnits
• inOutputWidth = 10
• inOutputHeight = 6
• inOutputSizeType = WorldUnits
• inWorldScale = 100

Auxiliary data contained inside the RectificationMap describes the relation of rectified image to the world plane.

List of possible exceptions:

Error type	Description
DomainError	Homography matrix must be a 3x3 matrix