blooalien/CoderCat Example.jpg

## README.md

      
    Raw
  

              README.md
            
          
    speechbubble.py

A simple GIMP plugin to easily create cartoon speech bubbles using arbitrary selection shapes.

License


Public Domain - This script is entirely too simple for me to care how it's used.  Just enjoy it...


Installation

(Ensure that you have gimp-python installed if you wish to use Python based GIMP plug-ins.)
For versions of GIMP prior to v2.10, simply copy or link this script into your "$HOME/.gimp-2.x/plug-ins/" folder, mark it as executable, and you should be good to go...  If you are on GIMP v2.10 (or later), this directory has changed from earlier versions.  The new location for plug-ins is now "$HOME/.config/GIMP/2.10/plug-ins/" and this script should be placed there instead.

Usage

You may not want to alter your original image directly while using this plug-in, so be sure to create a separate layer above the image you're working with, and ensure that's the layer you're actually editing in order to protect the main image from unexpected changes.
(Chances are likely that you already knew this, but I mention it here just in case you're new to image editing.)
Create a selection in the size and shape of the intended speech bubble, then look in the "Filters" menu under "Render". If all went well with the installation, there should be a menu entry labeled "Speech Bubble". Choosing that will open a dialog asking for a "Line Stroke Size". This is the number of pixels thick that the outline of the resulting speech bubble will be.  The rendered speech bubble should use the foreground color for the outline, and the background color to render the background of the speech bubble.

The attached file CoderCatExample.jpg shows the result of creating an irregular "thought bubble" type shape with some antialiasing and feathering applied to the selection to soften the edges.  This plugin was then run with black foreground and white background, and we get a nice soft-edged cloudy thought bubble.  Sharper edged selection shapes should result in a nice dark solid outline around the resulting bubble instead of this fuzzy look.
That's about it.  Can't think of anything else right now.  Enjoy...

  
## CoderCat Example.jpg

      
    Raw
  

              CoderCat Example.jpg
            
          
## speechbubble.py
#!/usr/bin/env python

#	Title: Simple Speech Bubble
#	Author: Bloo Alien <https://github.com/blooalien>
#	License: Public Domain <http://creativecommons.org/publicdomain/zero/1.0/>

from gimpfu import *

def speechbubble(image, drawable, radius):
	gimp.context_push()
	image.undo_group_start()

	pdb.gimp_edit_fill(drawable, FOREGROUND_FILL)
	pdb.gimp_selection_shrink(image, radius)
	pdb.gimp_edit_fill(drawable, BACKGROUND_FILL)

	image.undo_group_end()
	gimp.context_pop()

register(
	"speech_bubble",
	"Cartoon Speech Bubble",
	"Add a cartoon speech bubble using the current selection.",
	"Bloo Alien",
	"Public Domain",
	"2019",
	"<Image>/Filters/Render/Speech Bubble...",
	"*",
	[
		(PF_SPINNER, 'radius', 'Line Stroke Size', 2, (1,6,1))
	],
	[],
	speechbubble,
	)

main()
	#!/usr/bin/env python

	# Title: Simple Speech Bubble
	# Author: Bloo Alien <https://github.com/blooalien>
	# License: Public Domain <http://creativecommons.org/publicdomain/zero/1.0/>

	from gimpfu import *

	def speechbubble(image, drawable, radius):
	gimp.context_push()
	image.undo_group_start()

	pdb.gimp_edit_fill(drawable, FOREGROUND_FILL)
	pdb.gimp_selection_shrink(image, radius)
	pdb.gimp_edit_fill(drawable, BACKGROUND_FILL)

	image.undo_group_end()
	gimp.context_pop()

	register(
	"speech_bubble",
	"Cartoon Speech Bubble",
	"Add a cartoon speech bubble using the current selection.",
	"Bloo Alien",
	"Public Domain",
	"2019",
	"<Image>/Filters/Render/Speech Bubble...",
	"*",
	[
	(PF_SPINNER, 'radius', 'Line Stroke Size', 2, (1,6,1))
	],
	[],
	speechbubble,
	)

	main()