.. _ImageFilter:

ImageFilter Module
##################

.. note::

  All source images in this document are derived from https://www.pexels.com (CC0 License).

.. |srcimg01| image:: _static/exams/data/srcimg01.jpg
  :width: 20%

.. |srcimg02| image:: _static/exams/data/srcimg02.jpg
  :width: 20%

.. |srcimg03| image:: _static/exams/data/srcimg03.jpg
  :width: 20%

.. |srcimg04| image:: _static/exams/data/srcimg04.jpg
  :width: 20%

.. |srcimg05| image:: _static/exams/data/srcimg05.jpg
  :width: 20%

.. |srcimg06| image:: _static/exams/data/srcimg06.jpg
  :width: 20%

.. |srcimg07| image:: _static/exams/data/srcimg07.jpg
  :width: 20%

Filters
*******
:doc: https://pillow.readthedocs.io/en/latest/reference/ImageFilter.html#filters,
      http://effbot.org/imagingbook/imagefilter.htm#filters

.. list-table::

  * - srcimg05.jpg |srcimg05|

.. |ImageFilter.predefs.res01| image:: _static/exams/result/ImageFilter_predefs_Blur_01.jpg
.. |ImageFilter.predefs.res02| image:: _static/exams/result/ImageFilter_predefs_Contour_01.jpg
.. |ImageFilter.predefs.res03| image:: _static/exams/result/ImageFilter_predefs_Detail_01.jpg
.. |ImageFilter.predefs.res04| image:: _static/exams/result/ImageFilter_predefs_Edge-enhance_01.jpg
.. |ImageFilter.predefs.res05| image:: _static/exams/result/ImageFilter_predefs_Edge-enhance-More_01.jpg
.. |ImageFilter.predefs.res06| image:: _static/exams/result/ImageFilter_predefs_Emboss_01.jpg
.. |ImageFilter.predefs.res07| image:: _static/exams/result/ImageFilter_predefs_Find-Edges_01.jpg
.. |ImageFilter.predefs.res08| image:: _static/exams/result/ImageFilter_predefs_Smooth_01.jpg
.. |ImageFilter.predefs.res09| image:: _static/exams/result/ImageFilter_predefs_Smooth-More_01.jpg
.. |ImageFilter.predefs.res10| image:: _static/exams/result/ImageFilter_predefs_Sharpen_01.jpg

.. literalinclude:: _static/exams/ImageFilter_predefs_01.py

.. list-table::

  * - Blur |ImageFilter.predefs.res01|
    - Contour |ImageFilter.predefs.res02|
    - Detail |ImageFilter.predefs.res03|
    - Edge-enhance |ImageFilter.predefs.res04|
    - Edge-enhance More |ImageFilter.predefs.res05|
  * - Emboss |ImageFilter.predefs.res06|
    - Find Edges |ImageFilter.predefs.res07|
    - Smooth |ImageFilter.predefs.res08|
    - Smooth More |ImageFilter.predefs.res09|
    - Sharpen |ImageFilter.predefs.res10|

class GaussianBlur
==================
:doc: https://pillow.readthedocs.io/en/latest/reference/ImageFilter.html#PIL.ImageFilter.GaussianBlur

.. |ImageFilter.GaussianBlur.res01| image:: _static/exams/result/ImageFilter_GaussianBlur_10.jpg

.. list-table::

  * - srcimg05.jpg |srcimg05|

.. list-table::
  :widths: 30 10

  * - .. literalinclude:: _static/exams/ImageFilter_GaussianBlur_01.py
    - |ImageFilter.GaussianBlur.res01|

class UnsharpMask
=================
:doc: https://pillow.readthedocs.io/en/latest/reference/ImageFilter.html#PIL.ImageFilter.UnsharpMask

.. |ImageFilter.UnsharpMask.res01| image:: _static/exams/result/ImageFilter_UnsharpMask_2_150_3.jpg

.. list-table::

  * - srcimg07.jpg |srcimg07|

.. list-table::
  :widths: 30 10

  * - .. literalinclude:: _static/exams/ImageFilter_UnsharpMask_01.py
    - |ImageFilter.UnsharpMask.res01|

class Kernel
============
:doc: https://pillow.readthedocs.io/en/latest/reference/ImageFilter.html#PIL.ImageFilter.Kernel,
      http://effbot.org/imagingbook/imagefilter.htm#tag-ImageFilter.Kernel

.. list-table::

  * - srcimg05.jpg |srcimg05|

.. |ImageFilter.Kernel.res01| image:: _static/exams/result/ImageFilter_Kernel_01.jpg
.. |ImageFilter.Kernel.res02| image:: _static/exams/result/ImageFilter_Kernel_02.jpg

.. list-table::
  :widths: 10 10 10 10

  * - .. literalinclude:: _static/exams/ImageFilter_Kernel_01.py
    - |ImageFilter.Kernel.res01|
    - .. literalinclude:: _static/exams/ImageFilter_Kernel_02.py
    - |ImageFilter.Kernel.res02|

class RankFilter, MedianFilter, MinFilter, MaxFilter
====================================================
:doc: https://pillow.readthedocs.io/en/latest/reference/ImageFilter.html#PIL.ImageFilter.RankFilter,
      https://pillow.readthedocs.io/en/latest/reference/ImageFilter.html#PIL.ImageFilter.MedianFilter,
      https://pillow.readthedocs.io/en/latest/reference/ImageFilter.html#PIL.ImageFilter.MinFilter,
      https://pillow.readthedocs.io/en/latest/reference/ImageFilter.html#PIL.ImageFilter.MaxFilter
      http://effbot.org/imagingbook/imagefilter.htm#tag-ImageFilter.RankFilter,
      http://effbot.org/imagingbook/imagefilter.htm#tag-ImageFilter.MedianFilter,
      http://effbot.org/imagingbook/imagefilter.htm#tag-ImageFilter.MinFilter,
      http://effbot.org/imagingbook/imagefilter.htm#tag-ImageFilter.MaxFilter

.. note::

  MedianFilter, MinFilter, and MaxFilter are subclasses of RankFilter.

.. |ImageFilter.RankFilter.res01| image:: _static/exams/result/ImageFilter_RankFilter_9_2.jpg
.. |ImageFilter.RankFilter.res02| image:: _static/exams/result/ImageFilter_MedianFilter_9.jpg
.. |ImageFilter.RankFilter.res03| image:: _static/exams/result/ImageFilter_MinFilter_9.jpg
.. |ImageFilter.RankFilter.res04| image:: _static/exams/result/ImageFilter_MaxFilter_9.jpg

.. list-table::

  * - srcimg06.jpg |srcimg06|

.. literalinclude:: _static/exams/ImageFilter_RankFilter_01.py

.. list-table::
  :widths: 10 10 10 10

  * - RankFilter(size=9, rank=2) |ImageFilter.RankFilter.res01|
    - MinFilter(size=9) |ImageFilter.RankFilter.res03|
    - MedianFilter(size=9) |ImageFilter.RankFilter.res02|
    - MaxFilter(size=9) |ImageFilter.RankFilter.res04|


class ModeFilter
================
:doc: https://pillow.readthedocs.io/en/latest/reference/ImageFilter.html#PIL.ImageFilter.ModeFilter,
      http://effbot.org/imagingbook/imagefilter.htm#tag-ImageFilter.ModeFilter

.. |ImageFilter.ModeFilter.res01| image:: _static/exams/result/ImageFilter_ModeFilter_9.jpg

.. list-table::

  * - srcimg06.jpg |srcimg06|

.. list-table::
  :widths: 30 10

  * - .. literalinclude:: _static/exams/ImageFilter_ModeFilter_01.py
    - |ImageFilter.ModeFilter.res01|