desmoteo/pyblur3

#Pyblur
##Python image blurring routines.

Just a few fixes to port the unmaintained original https://github.com/lospooky/pyblur to python3.

Pyblur is a collection of simple image blurring routines.

It supports Gaussian, Disk, Box, and Linear Motion Blur Kernels as well as the Point Spread Functions
used in Convolutional Neural Networks for Direct Text Deblurring.

Functions receive a PIL image as input, and return another as output.

Kernel sizes can either be specified as input, or randomized.

Finally, there's a RandomizedBlur function that applies a random type of blurring kernel with a random width/strength.

##Installation
From Pip: pip install pyblur3

Or alternatively git clone this repo and run locally

##Usage
from pyblur import *

###Gaussian Blur
Blurs image using a Gaussian Kernel

blurred = GaussianBlur(img, bandwidth)

Randomized kernel bandwidth (between 0.5 and 3.5)

blurred = GaussianBlur_random(img)

###Defocus (Disk) Blur
Blurs image using a Disk Kernel

blurred = DefocusBlur(img, kernelsize)

Randomized kernel size (between 3 and 9)

blurred = DefocusBlur_random(img)

###Box Blur
Blurs image using a Box Kernel

blurred = BoxBlur(img, kernelsize)

Randomized kernel size (between 3 and 9)

blurred = BoxBlur_random(img)

###Linear Motion Blur
Blurs image using a Line Kernel

blurred = LinearMotionBlur(img, dim, angle, linetype)

####Parameters

• dim Kernel Size: {3,5,7,9}
  
• angle Angle of the line of motion. Will be floored to the closest one available for the given kernel size.
  
• linetype = {left, right, full} Controls whether the blur kernel will be applied in full or only the left/right halves of it.
  

Randomized kernel size, angle, and line type

blurred = LinearMotionBlur_random(img)

PSF Blur

Blurs image using one of the Point Spread Functions (Kernels) used in:

Convolutional Neural Networks for Direct Text Deblurring

blurred = PsfBlur(img, psfid)

####Parameters

• psfid Id of the Point Spread Function to apply [0, 99]
  

Randomized kernel size, angle, and line type

blurred = PsfBlur_random(img)

###Random Blur
Randomly applies one of the supported blur types, with a randomized bandwidth/strenght.

blurred = RandomizedBlur(img)