Initial commit

Author: pascalre

.gitignore

@@ -0,0 +1,2 @@
+.idea/
+.DS_STORE

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Pascal Reitermann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,13 @@
+# python-fu-cartoonify
+GIMP plug-in to turn a photo into a cartoon.
+
+## Preview
+![Preview](images/preview.jpg)
+
+# Installation
+1. Copy `python-fu-cartoonify.py` into the plug-in folder listed under `Edit > Preferences > Folders > Plug-ins`.
+1. On unix ensure the file can be executed as program.
+1. Restart GIMP, the plug-in is listed under `Filters > Artistic > Cartoonify...`
+
+# License
+python-fu-cartoonify is licensed under the [MIT License](https://raw.githubusercontent.com/pascalre/python-fu-cartoonify/master/LICENSE).

images/preview.jpg

@@ -0,0 +1,64 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from gimpfu import *
+
+
+def apply_cartoon_filter(img, drawable):
+    # see https://developer.gimp.org/api/2.0/libgimp/index.html
+    # step 1: duplicate layer two times
+    # layer2
+    layer2 = pdb.gimp_layer_copy(drawable, False)
+    pdb.gimp_image_add_layer(img, layer2, 0)
+    pdb.gimp_item_set_name(layer2, "temp_merge_layer")
+
+    # layer3
+    layer3 = pdb.gimp_layer_copy(drawable, False)
+    pdb.gimp_image_add_layer(img, layer3, 0)
+    pdb.gimp_item_set_name(layer3, "temp_sobel_operator")
+    # set layer3 mode to GIMP_GRAIN_EXTRACT_MODE (20)
+    pdb.gimp_layer_set_mode(layer3, 20)
+
+    # step 2: execute sobel operator
+    # alternative pdb.plug_in_sobel(img, layer3, True, True, True)
+    pdb.plug_in_edge(img, layer3, 1, 0, 0)
+
+    # step 3: adjust curves
+    # see https://developer.gimp.org/api/2.0/libgimp/libgimp-gimpcolor.html#gimp-curves-spline
+    pdb.gimp_curves_spline(layer3, 0, 6,
+                           [0, 0,
+                            130, 255,
+                            255, 255])
+
+    # step 4: adjust levels
+    # see https://developer.gimp.org/api/2.0/libgimp/libgimp-gimpcolor.html#gimp-levels
+    pdb.gimp_levels(layer3, 0, 0, 130, 1.0, 0, 255)
+
+    # step 5: merge layers down
+    pdb.gimp_image_merge_down(img, layer3, 0)
+    # set layer2 mode to GIMP_OVERLAY_MODE (23)
+    # see https://developer.gimp.org/api/2.0/libgimp/libgimp-gimpenums.html#GimpLayerModeEffects
+    pdb.gimp_layer_set_mode(img.layers[0], 23)
+    pdb.gimp_image_merge_down(img, img.layers[0], 0)
+
+
+register(
+    "python-fu-cartoonify",                       # Plugin name
+    "Apply cartoon filter",                       # Short description
+    "Apply cartoon filter",                       # Long description
+    "Pascal Reitermann",                          # Plugin author
+    "Pascal Reitermann",                          # Copyright or license
+    "2022",                                       # Year of publishing
+    "Cartoonify...",                              # Name of the plug-in
+    "*",                                          # Supported images
+    [
+        (PF_IMAGE, "img", "Input image", None),
+        (PF_DRAWABLE, "drawable", "Input drawable", None),
+    ],                                            # Input parameter
+    [],                                           # Output result
+    apply_cartoon_filter,                         # Name of the function
+    menu="<Image>/Filters/Artistic"
+    )
+
+
+main()