Pgmagick charcoal() method - Python

Last Updated : 26 May, 2020

The charcoal() function is an inbuilt function in the Pgmagick library which is used to to add a charcoal filter to the image. The function returns the true value on success.

Syntax:
charcoal(factor)
Parameters: This function accepts single parameters as mentioned above and described below:

factor: This parameter stores the value of the charcoal factor which is to be apply on the image.

Return Value: This function returns the Pgmagick object with image added.

Input Image:

Example 1:

Python3

from pgmagick import Image, DrawableCircle, DrawableText
from pgmagick import Geometry, Color

# draw the image of dimension 600 * 600
img = Image('input.png')

# invoke charcoal function with factor 8
img.charcoal(8)

# invoke write function along with filename
img.write('2_a.png')

Output:

Example 2:

Python3

# import library
from pgmagick import Image, DrawableCircle, DrawableText
from pgmagick import Geometry, Color

# Draw image of dimension 600 * 600 having background green
im = Image(Geometry(600, 600), Color("# 32CD32"))

# invoke DrawableCircle() function
circle = DrawableCircle(100, 100, 300, 20)

# invoke draw() function
im.draw(circle)

# set font size to 40px
im.fontPointsize(40)

# invoke DrawableText() function
text = DrawableText(250, 450, "GeeksForGeeks")

# invoke draw() function
im.draw(text)

# invoke charcoal function with factor 5
im.charcoal(5)

# invoke write function along with filename
im.write('1_b.png')