Undistort

Controls the strength of the lens distortion correction by setting the effective focal length divisor for the camera model. Lower values increase the correction strength, causing more aggressive straightening of curved lines, while higher values reduce the effect. The typical value is 2 for most document images. If set too low, the image may become over-corrected and introduce new distortions; if set too high, distortion may remain uncorrected.

Example

• To apply standard correction, use the default value: 2.
• For images with severe distortion, try lowering to 1.5.
• For images with minimal distortion, increase to 3 or higher.

Sets the primary correction for radial distortion, which causes straight lines to bow outward (barrel distortion) or inward (pincushion distortion). Positive values correct barrel distortion; negative values correct pincushion distortion. Start with small values (such as 0.01 or -0.01) and adjust incrementally while visually inspecting the result.

Example

• To correct mild barrel distortion, set K1 to 0.01.
• To correct mild pincushion distortion, set K1 to -0.01.

Fine-tunes the correction for more complex or severe radial distortion. K2 is usually much smaller than K1 and is often left at zero unless additional correction is needed. Adjust only if straight lines are still curved after setting K1.

Example

• For most images, leave K2 at 0.
• If additional correction is needed, try small values such as 0.001 or -0.001.

Corrects tangential distortion caused by lens tilt or decentering, which can make the top or bottom of the image appear stretched or compressed. Positive values enlarge the top; negative values enlarge the bottom. Adjust only if you observe vertical warping or tilt in the image.

Example

• To correct a top-heavy image, try a small positive value (e.g., 0.001).
• To correct a bottom-heavy image, try a small negative value (e.g., -0.001).

Corrects tangential distortion along the horizontal axis, which can make the left or right side of the image appear stretched or compressed. Positive values enlarge the left side; negative values enlarge the right. Adjust only if you observe horizontal tilt or warping.

Example

• To correct a left-heavy image, try a small positive value (e.g., 0.001).
• To correct a right-heavy image, try a small negative value (e.g., -0.001).

The 'Command Type Name' property shows the user-friendly name of the IP Command as it appears in the Grooper UI. This helps users identify which command is being configured or executed, especially when working with IP Profiles containing multiple commands.

This property is read-only and is automatically set based on the command's type.

The 'Supported Pixel Formats' property lists the image pixel formats that the IP Command can process. If an image does not match one of these formats, the command will be skipped for that image.

• By default, all pixel formats are supported unless a derived command restricts this list.
• Example formats include Pixel8bppGrayscale, Pixel24bppBgr, and Pixel1bppIndexed.

Use this property to verify compatibility when building IP Profiles or troubleshooting why a command did not execute.