Rotate

Specifies the amount of rotation to apply to the image.

• Positive values rotate the image clockwise; negative values rotate counterclockwise.
• The valid range is from -360 to 360.
• A value of 0 leaves the image unchanged.

Configuration Guidance

Set the 'Angle' property to the desired rotation. For example, use 90 to rotate an image 90° clockwise, or -90 for counterclockwise. Fractional values such as 1.5 can be used for fine adjustments, which is useful for correcting minor misalignments or for custom orientation requirements.

Impact

Rotating by standard angles (90°, 180°, 270°) is common for page orientation correction. Small angles are often used for deskewing or aligning images for OCR and data extraction. When combined with 'Resize', the entire rotated image is preserved; otherwise, parts may be cropped.

Example:
To rotate a scanned page 180° (upside down), set 'Angle' to 180.

Can be one of the following values:

Controls the quality and speed of the rotation operation by determining how new pixel values are computed.

• Linear: Balances speed and quality, suitable for most document images.
• Cubic: Produces the highest quality, minimizing artifacts and preserving detail, but is slower.
• NearestNeighbor: Fastest, but may introduce jagged edges or blocky artifacts; recommended for binary or line art images.

Configuration Guidance

Choose Cubic for best results with photographs or detailed images. Use Linear for general document processing. Select NearestNeighbor for speed or when working with binary images where quality is less critical.

Tip:
Review output images to ensure text and graphics remain sharp and readable after rotation.

When enabled, the output image is resized as needed so that no part of the rotated image is lost. When disabled, the image retains its original dimensions, and any content rotated outside the original bounds will be cropped.

Use Cases

• Enable 'Resize' to preserve all content, especially for documents with important information near the edges.
• Disable 'Resize' if you want to maintain the original image size, accepting that corners may be cropped after rotation.

Impact

Enabling this property may increase the output image size and file size. Disabling may result in loss of content at the corners, particularly for non-90° rotations.

Example:
For rotating a form with data near the edges, enable 'Resize' to avoid losing information.

Can be one of the following types:

Specifies the fill color for regions revealed when the image is rotated and the canvas is expanded. If not set or left empty, the dominant background color of the image is used automatically.

Configuration Guidance

Set this property if you require a specific background color, such as pure white for forms or a corporate color for branding. For best OCR results, use a color that matches the document background.

Impact

This property is most noticeable when 'Resize' is enabled or when rotating by angles that expose corners or edges. If left unset, Grooper will attempt to detect and use the most common background color in the image.

Example:
To ensure all exposed areas are white, set 'Background Color' to Color.White.

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.