Documentation

Overview

preproc contains various image processing methods which are useful for preprocessing page images for OCR. It contains both library functions to incorporate into your own projects and standalone tools which can be used directly.

Index

• func BinToZeroInv(bin *image.Gray, orig *image.RGBA) (*image.RGBA, error)
• func IntegralSauvola(img image.Image, ksize float64, windowsize int) *image.Gray
• func PreCalcedSauvola(intImg integral.Image, intSqImg integral.SqImage, img image.Image, ...) *image.Gray
• func PreProcMulti(inPath string, ksizes []float64, binType string, binWsize int, wipe bool, ...) ([]string, error)
• func ProportionSlice(i SummableImage, x int, width int) float64
• func Sauvola(img image.Image, ksize float64, windowsize int) *image.Gray
• func VWipe(img *image.Gray, wsize int, thresh float64, min int) *image.Gray
• func Wipe(img *image.Gray, wsize int, thresh float64, min int) *image.Gray
• func WipeFile(inPath string, outPath string, hwsize int, hthresh float64, hmin int, ...) error
• type SummableImage

func BinToZeroInv

func BinToZeroInv(bin *image.Gray, orig *image.RGBA) (*image.RGBA, error)

BinToZeroInv converts a binary thresholded image to a zero inverse binary thresholded image

func IntegralSauvola

func IntegralSauvola(img image.Image, ksize float64, windowsize int) *image.Gray

Implements Sauvola's algorithm using Integral Images, see paper "Efficient Implementation of Local Adaptive Thresholding Techniques Using Integral Images" and https://stackoverflow.com/questions/13110733/computing-image-integral

func PreCalcedSauvola

func PreCalcedSauvola(intImg integral.Image, intSqImg integral.SqImage, img image.Image, ksize float64, windowsize int) *image.Gray

PreCalcedSauvola Implements Sauvola's algorithm using precalculated Integral Images

func PreProcMulti

func PreProcMulti(inPath string, ksizes []float64, binType string, binWsize int, wipe bool, wipeWsize int, wipeMinWidthPerc int, vWipeWsize int, wipeMinHeightPerc int) ([]string, error)

PreProcMulti binarizes and preprocesses an image with multiple binarisation levels. inPath: Path of input image. ksizes: Slice of k values to pass to Sauvola algorithm binType: Type of binarization threshold. binary or zeroinv are currently implemented. binWsize: Window size for sauvola binarization algorithm. Set automatically based on resolution if 0. wipe: Whether to wipe (clear sides) the image wipeWsize: Window size for wiping algorithm wipeMinWidthPerc: Minimum percentage of the image width for the content width calculation to be considered valid vWipeWsize: Window size for vertical wiping algorithm wipeMinHeightPerc: Minimum percentage of the image height for the content height calculation to be considered valid

func ProportionSlice

func ProportionSlice(i SummableImage, x int, width int) float64

ProportionSlice returns the proportion of black pixels in a vertical slice of an image starting at x, width pixels wide.

func Sauvola

func Sauvola(img image.Image, ksize float64, windowsize int) *image.Gray

Implements Sauvola's algorithm for text binarization, see paper "Adaptive document image binarization" (2000)

func VWipe

func VWipe(img *image.Gray, wsize int, thresh float64, min int) *image.Gray

VWipe fills the sections of image which fall outside the vertical content area with white, providing the content area is above min %

func Wipe

func Wipe(img *image.Gray, wsize int, thresh float64, min int) *image.Gray

Wipe fills the sections of image which fall outside the content area with white, providing the content area is above min %

func WipeFile

func WipeFile(inPath string, outPath string, hwsize int, hthresh float64, hmin int, vwsize int, vthresh float64, vmin int) error

WipeFile wipes an image file, filling the sections of the image which fall outside the content area with white, providing the content area is above min %. inPath: path of the input image. outPath: path to save the output image. hwsize: window size (width) for horizontal wipe algorithm. hthresh: threshold for horizontal wipe algorithm. hmin: minimum % of content area width to consider valid. vwsize: window size (height) for vertical wipe algorithm. vthresh: threshold for vertical wipe algorithm. vmin: minimum % of content area height to consider valid.

type SummableImage

type SummableImage interface {
	image.Image
	Sum(r image.Rectangle) uint64
}

Package Files

• doc.go
• preprocmulti.go
• sauvola.go
• test_helpers.go
• util.go
• wipesides.go