You are here: Start » FIL.NET » FIL.CreateCylinderMap
Creates a spatial map for transformations from a cylinder surface to a flat rectangle.
Namespace: | FilNet |
---|---|
Assembly: | FIL.NET.dll |
Syntax
C++
C#
public static void CreateCylinderMap ( FilNet.ImageFormat inImageFormat, FilNet.Rectangle2D inCylinderRectangle, float inCylinderRadiusCorrection, int inMargin, FilNet.InterpolationMethod inInterpolationMethod, FilNet.SpatialMap outSpatialMap, FilNet.Region outOutputRegion )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
![]() | inImageFormat | FilNet.ImageFormat | Information about dimensions, depth and pixel type of the image. | ||
![]() | inCylinderRectangle | FilNet.Rectangle2D | Bounding rectangle of the cylinder. | ||
![]() | inCylinderRadiusCorrection | float | <0.0f, INF> | 0.0f | How many pixels the cylinder radius is larger than the visible circle radius. Default value: 0.0f. |
![]() | inMargin | int | <0, INF> | 0 | Width of the cylinder extreme points zone excluded from spatial map. Default value: 0. |
![]() | inInterpolationMethod | FilNet.InterpolationMethod | Bilinear | Interpolation method used in extraction of image pixel values. Default value: Bilinear. | |
![]() | outSpatialMap | FilNet.SpatialMap | Output spatial map. | ||
![]() | outOutputRegion | FilNet.Region | Pixels set by the spatial map application. |
Description
The filter creates a spatial map that allows to transform a cylinder surface to a flat rectangle. The inCylinderRectangle should be the minimal rectangle that contains the given cylinder. Because of the presence of a camera, the cylinder radius is not equal to but greater than the width of the input rectangle. To compensate the difference, inCylinderRadiusCorrection has to be properly set experimentally. Another important parameter is the inOpticalAxis input that represents the coordinates of the camera optical axis, i.e. it shows which pixel is directly under the camera. It is set to the input image center by default.


Examples
![]() |
![]() |
Results of applying RemapImage with a spatial map created with the CreateCylinderMap filter.
Hardware Acceleration
This operation supports automatic parallelization for multicore and multiprocessor systems.
Hardware acceleration settings may be manipulated with Settings class.
Errors
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Empty domain in CreateCylinderMap. |
Function Overrides
- CreateCylinderMap(ImageFormat, Rectangle2D, Single, Int32, InterpolationMethod, SpatialMap)
- CreateCylinderMap(ImageFormat, Rectangle2D, Single, Nullable<Point2D>, Nullable<Int32>, Nullable<Int32>, Int32, InterpolationMethod, SpatialMap)
- CreateCylinderMap(ImageFormat, Rectangle2D, Single, Nullable<Point2D>, Nullable<Int32>, Nullable<Int32>, Int32, InterpolationMethod, SpatialMap, Region)