Extract Page (IP Command) - Revision history

Dgreenwood: /* What is Extract Page? */

2025-08-13T19:32:08Z

What is Extract Page?

← Older revision		Revision as of 14:32, 13 August 2025
Line 10:		Line 10:

	This process is essential for preparing images for downstream tasks such as OCR, data extraction, or archival, ensuring that the page content is properly aligned and free from background noise or distortion.		This process is essential for preparing images for downstream tasks such as OCR, data extraction, or archival, ensuring that the page content is properly aligned and free from background noise or distortion.
	{\|style="text-align:center"		{\|style="text-align:center; margin: auto"
	\|		\|
	<big>Before: Skewed page on black carrier background</big>		<big>Before: Skewed page on black carrier background</big>

Dgreenwood at 16:19, 13 August 2025

2025-08-13T16:19:25Z

← Older revision		Revision as of 11:19, 13 August 2025
Line 60:		Line 60:
	* '''Light page on light background''': The page is on a background similar in color to the page itself, but the outline is still visible. The algorithm detects subtle edge features.		* '''Light page on light background''': The page is on a background similar in color to the page itself, but the outline is still visible. The algorithm detects subtle edge features.

	== Diagnostics and tuning ==		=== Diagnostics and tuning ===

	When run in diagnostic mode, Extract Page generates output images showing the binarized input, detected edges, and the quadrilateral region used for extraction. These diagnostics are essential for tuning the command for your specific document types.		When run in diagnostic mode, Extract Page generates output images showing the binarized input, detected edges, and the quadrilateral region used for extraction. These diagnostics are essential for tuning the command for your specific document types.
Line 68:		Line 68:
	* Use the "Zoning" diagnostic image to visualize the border region and detected edges.		* Use the "Zoning" diagnostic image to visualize the border region and detected edges.

	== Supported pixel formats ==		=== Supported pixel formats ===

	Extract Page supports all common pixel formats, including <code>Pixel8bppGrayscale</code>, <code>Pixel24bppBgr</code>, and <code>Pixel1bppIndexed</code>. Images are automatically converted as needed for edge detection and warping.		Extract Page supports all common pixel formats, including <code>Pixel8bppGrayscale</code>, <code>Pixel24bppBgr</code>, and <code>Pixel1bppIndexed</code>. Images are automatically converted as needed for edge detection and warping.

Dgreenwood: /* What is Extract Page? */

2025-08-08T20:14:05Z

What is Extract Page?

← Older revision		Revision as of 15:14, 8 August 2025
Line 10:		Line 10:

	This process is essential for preparing images for downstream tasks such as OCR, data extraction, or archival, ensuring that the page content is properly aligned and free from background noise or distortion.		This process is essential for preparing images for downstream tasks such as OCR, data extraction, or archival, ensuring that the page content is properly aligned and free from background noise or distortion.
			{\|style="text-align:center"
	<big>Before: Skewed ~~Page~~ on ~~Background~~</big>		\|
			<big>Before: Skewed page on black carrier background</big>
			<br>
	[[File:ExtractPage-BasicGraphic-01.png]]		[[File:ExtractPage-BasicGraphic-01.png]]
			\|
			<big>After: Extracted and de-warped page</big>
	<big>After: Extracted and De-warped ~~Page~~</big>		<br>

	[[File:ExtractPage-BasicGraphic-02.png]]		[[File:ExtractPage-BasicGraphic-02.png]]
			\|}

	== When and why to use Extract Page ==		== When and why to use Extract Page ==

Dgreenwood at 20:12, 8 August 2025

2025-08-08T20:12:13Z

← Older revision		Revision as of 15:12, 8 August 2025
Line 1:		Line 1:
	{{~~Migrated~~}}		{{AutoVersion}}
	{{~~2.80~~:~~{{PAGENAME}}~~}}
			<blockquote>{{#lst:Glossary\|Extract Page}}</blockquote>

			The '''Extract Page''' IP Command in Grooper is a powerful image processing tool designed to automatically locate, extract, and de-warp a document page from a larger carrier image. This command is especially useful for images where a document page is scanned or photographed on a background, such as a flatbed scanner or a camera-captured surface, and the page is not perfectly aligned or may be subject to perspective distortion.

			== What is Extract Page? ==

			The Extract Page command is an [[IP Command]] that detects the four edges of a document page within a larger image, even if the page is skewed, rotated, or warped. It then applies a de-warping (warp) operation to produce a new, rectangular image of the page, correcting for any perspective or alignment issues.

			This process is essential for preparing images for downstream tasks such as OCR, data extraction, or archival, ensuring that the page content is properly aligned and free from background noise or distortion.

			<big>Before: Skewed Page on Background</big>

			[[File:ExtractPage-BasicGraphic-01.png]]


			<big>After: Extracted and De-warped Page</big>

			[[File:ExtractPage-BasicGraphic-02.png]]

			== When and why to use Extract Page ==

			Use the Extract Page command when you have images where the document page is not perfectly cropped or aligned, such as:

			* Scans of pages placed on a flatbed scanner with visible background.
			* Camera-captured images of documents on a desk or other surface.
			* Documents with visible page outlines but not perfectly rectangular in the image.

			Extract Page is ideal for automating the cleanup of such images, removing unwanted backgrounds, and correcting for skew, shear, or perspective distortion. This results in higher quality images for recognition and extraction processes.

			== How Extract Page works ==

			The Extract Page command follows these general steps:

			# The input image is binarized using the configured "Binarization" settings to enhance edge contrast.
			# Edge detection is performed in the border regions of the image to locate the top, right, bottom, and left page edges.
			# Each edge is detected independently, allowing for accurate extraction even if the page is skewed, rotated, or subject to perspective distortion.
			# The four detected edges define a quadrilateral, which is then de-warped using a warp operation to produce a new, rectangular image of the page.

			== Configuration and usage ==

			Extract Page is typically used as part of an [[IP Profile]], which is a sequence of image processing steps. Each step is represented by an [[IP Step]], which specifies an [[IP Command]] to execute—such as Extract Page.

			To use Extract Page:

			# Add an [[IP Step]] to your [[IP Profile]] and set its "Command" property to Extract Page.
			# Configure the following key properties to tune the extraction process:
			## '''"Binarization"''': Controls how the image is converted to black and white before edge detection. Proper binarization is essential for reliable page extraction.
			## '''"Border Size"''': Defines the thickness of the region along each edge of the image where the algorithm searches for page edges. You can specify unit-aware values (e.g., <code>0.25in</code>, <code>10px</code>, <code>6mm</code>).
			## '''"Angle Precision"''': Sets the angular increment (in degrees) for edge angle detection. Lower values increase precision but may slow processing.
			## '''"Threshold"''': Defines the minimum strength required for a detected line to be considered a valid page edge, as a percentage of the image width or height.
			## '''"Interpolation Mode"''': Determines the algorithm used to resample pixels during the warp operation. "Cubic" is recommended for most documents.
			## '''"Apply Edge Smoothing"''': Enables or disables additional smoothing of the page edges during the warp operation.

			=== Example scenarios ===

			* '''Light page on dark background''': The page is placed on a black or significantly darker background. The algorithm detects the strong contrast at the page edges.
			* '''Light page on light background''': The page is on a background similar in color to the page itself, but the outline is still visible. The algorithm detects subtle edge features.

			== Diagnostics and tuning ==

			When run in diagnostic mode, Extract Page generates output images showing the binarized input, detected edges, and the quadrilateral region used for extraction. These diagnostics are essential for tuning the command for your specific document types.

			* Use the "Binarized" diagnostic image to review the effect of your binarization settings.
			* Use the "Edges" diagnostic image to see which lines are detected.
			* Use the "Zoning" diagnostic image to visualize the border region and detected edges.

			== Supported pixel formats ==

			Extract Page supports all common pixel formats, including <code>Pixel8bppGrayscale</code>, <code>Pixel24bppBgr</code>, and <code>Pixel1bppIndexed</code>. Images are automatically converted as needed for edge detection and warping.

			== Best practices ==

			* Start with the default settings and review diagnostic images to verify edge detection.
			* Adjust "Binarization" and "Border Size" to ensure page edges are clearly visible.
			* Fine-tune "Angle Precision" and "Threshold" for your specific document and image conditions.
			* Use "Cubic" interpolation for best quality unless performance is a concern.
			* Enable "Apply Edge Smoothing" if the output image shows jagged or rough edges.

			== Integration in IP Profiles ==

			Extract Page can be combined with other [[IP Command]]s in an [[IP Profile]] to create a complete image processing workflow. Each command is applied in sequence, with the output of one command serving as the input to the next.

			== Summary ==

			The Extract Page IP Command is a robust solution for extracting and de-warping document pages from carrier images in Grooper. By accurately detecting page edges and correcting for perspective, it ensures that your images are clean, properly aligned, and ready for further processing.

			For more information on configuring and using Extract Page, see the documentation for [[IP Command]], [[IP Step]], and [[IP Profile]].

Randallkinard: Randallkinard moved page Extract Page to Extract Page (IP Command): new naming convention

2024-04-17T15:28:19Z

Randallkinard moved page Extract Page to Extract Page (IP Command): new naming convention

← Older revision	Revision as of 10:28, 17 April 2024
(No difference)

Dgreenwood: Removed redirect to 2.80:Extract Page

2023-12-28T22:21:17Z

Removed redirect to 2.80:Extract Page

← Older revision		Revision as of 17:21, 28 December 2023
Line 1:		Line 1:
	~~#REDIRECT [[~~2.80:~~Extract Page]]~~		{{Migrated}}
			{{2.80:{{PAGENAME}}}}

Dgreenwood: Dgreenwood moved page Extract Page to 2.80:Extract Page

2023-12-28T22:21:03Z

Dgreenwood moved page Extract Page to 2.80:Extract Page

New page

#REDIRECT [[2.80:Extract Page]]