Skip to main content

A python module to convert text quotes into graphical images

Project description

Quote2Image

A python module to convert text quotes into graphical images

Installation

To install Quote2Image, you can use pip:

pip install Quote2Image

Usage

The Convert function takes the following arguments:

  • quote : The quote to convert.

  • author : The author of the quote.

  • fg : The foreground color of the text.

  • bg : The background color of the image.

  • font_type : The font to use for the text.

  • font_size : This font size is used for the quote and watermark.

  • font_size_author : This font size is used for the author (Optional, Default value is set to font_size).

  • width : The width of the image.

  • height : The height of the image.

  • watermark_text : The text for the watermark (Leave it blank for no watermarks).

  • watermark_font_size : The font size for the watermark text (Optional, Default save is set to font_size).

Generating an image using RGB background and foreground

The package comes with a builtin GenerateColors function that generates a fg and bg color with the correct amount of luminosity and returns them in tuples.

from Quote2Image import Convert, GenerateColors



# Generate Fg and Bg Color

fg, bg = GenerateColors()



img=Convert(

	quote="Pooing keeps you healthy",

	author="Pee",

	fg=fg,

	bg=bg,

	font_size=32,

	font_type="arial.ttf",

	width=1080,

	height=450)



# Save The Image as a Png file

img.save("hello.png")

Generating an image using a custom background image.

We can do that using the ImgObject that gives us alot of flexibility on how we want our background Image to be.

The ImgObject class takes the following arguments:

  • image : The link to the background image (required).

  • brightness : The brightness of the image (optional, default is 100).

  • blur : The blur of the image (optional, default is 0).

You can then use the ImgObject instance as the bg argument in the convert function:

from Quote2Image import Convert, ImgObject



bg=ImgObject(image="IMAGE FILE LOCATION", brightness=80, blur=80)



img=Convert(

	quote="Pooing keeps you healthy",

	author="Pee",

	fg=(21, 21, 21),

	bg=bg,

	font_size=32,

	font_type="arial.ttf",

	width=1080,

	height=450)



# Save The Image as a Png file

img.save("hello.png")

Adding a watermark:

  • watermark_text : The text for the watermark.

  • watermark_font_size : The font size for the watermark text.

from Quote2Image import Convert, GenerateColors



# Generate Fg and Bg Color

fg, bg = GenerateColors()



img=Convert(

	quote="Pooing keeps you healthy",

	author="Pee",

	fg=fg,

	bg=bg,

	font_size=32,

	font_type="arial.ttf",

	font_size_author=25,

	width=1080,

	height=450,

    	watermark_text="@My.Watermark",

    	watermark_font_size=15

)



# Save The Image as a Png file

img.save("hello.png")

Permissions

  • You are allowed to use, modify, and distribute the module.

  • You are allowed to distribute modified versions of the module, as long as you follow the terms of the license.

Obligations

  • You must include a copy of the GPL-3.0 license with the module.

  • You must provide a copy of the source code of the module, either along with the modified version of the module or through a written offer to provide the source code.

  • You must provide a prominent notice stating that you have modified the module, and the date of the modification.

  • If you distribute the module, you must do so under the terms of the GPL-3.0 license.

That's It!

Thank You! Hope this was useful to you <3

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Quote2Image-0.0.5.tar.gz (16.4 kB view hashes)

Uploaded Source

Built Distribution

Quote2Image-0.0.5-py3-none-any.whl (16.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page