{"id":25073,"date":"2020-03-05T12:15:00","date_gmt":"2020-03-05T10:15:00","guid":{"rendered":"https:\/\/www.webcodegeeks.com\/?p=25073"},"modified":"2020-06-23T14:54:23","modified_gmt":"2020-06-23T11:54:23","slug":"image-titler-1-5-2-supports-logo-insertion","status":"publish","type":"post","link":"https:\/\/www.webcodegeeks.com\/python\/image-titler-1-5-2-supports-logo-insertion\/","title":{"rendered":"Image Titler 1.5.2 Supports Logo Insertion"},"content":{"rendered":"\n

During the first weekend of the semester, I got inspired to do some Python development. Out of the inspiration came the latest feature of the Image Titler took: logo insertion. In this article, we\u2019ll take a look at what that means and how it was implemented.<\/p>\n\n\n\n

What Is Logo Insertion?<\/h2>\n\n\n\n

As far as names are concerned, logo insertion isn\u2019t a formal term. It\u2019s just what I\u2019ve been calling the latest feature of the Image Titler script. Now, in addition to being able to add titles and borders to image, you can also insert your logo:<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Notice how there\u2019s now an image of my logo in the lower left corner. How cool is that?<\/p>\n\n\n\n

Personally, I haven\u2019t tried other logos, but I imagine you\u2019ll get similar performance as long as it\u2019s square. Otherwise, it\u2019ll shrink one way or the other.<\/p>\n\n\n\n

In any case, you can add a logo of your own with the following code:<\/p>\n\n\n\n

\n
\n\n\n\n
\n
1<\/div>\n
2<\/div>\n<\/td>\n
\n
\n
pip install image-titler # in <\/code>case<\/code> you haven't already<\/code><\/div>\n
image_titler -l <\/code>\"path\/to\/logo\"<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n\n\n\n

That will open up a prompt for you to select an image. Then, the tool will attempt to parse the file name (i.e. assumes -<\/code> separators) and place it as a title on the image. Finally, the logo will be positioned in the lower left corner, and the image will be saved wherever you wrote this command.<\/p>\n\n\n\n

How Does Logo Insertion Work?<\/h2>\n\n\n\n

Under the hood, we take advantage of the PIL library in Python. Essentially, we load two images: the background and the foreground. Then, we paste one onto the other:<\/p>\n\n\n\n

\n
\n\n\n\n
\n
01<\/div>\n
02<\/div>\n
03<\/div>\n
04<\/div>\n
05<\/div>\n
06<\/div>\n
07<\/div>\n
08<\/div>\n
09<\/div>\n
10<\/div>\n
11<\/div>\n
12<\/div>\n
13<\/div>\n<\/td>\n
\n
\n
def draw_logo(img: Image, logo_path: str):<\/code><\/div>\n
    <\/code>\"\"<\/code>\"<\/code><\/div>\n
    <\/code>Adds a logo to the image <\/code>if<\/code> a path is provided.<\/code><\/div>\n
 <\/div>\n
    <\/code>:param img: an image to be modified<\/code><\/div>\n
    <\/code>:param logo_path: the path to a logo<\/code><\/div>\n
    <\/code>:<\/code>return<\/code>: nothing<\/code><\/div>\n
    <\/code>\"\"<\/code>\"<\/code><\/div>\n
    <\/code>if<\/code> logo_path:<\/code><\/div>\n
        <\/code>logo = Image.open(logo_path, <\/code>\"r\"<\/code>)<\/code><\/div>\n
        <\/code>logo.thumbnail(LOGO_SIZE)<\/code><\/div>\n
        <\/code>width, height = img.size<\/code><\/div>\n
        <\/code>img.paste(logo, (LOGO_PADDING, height - LOGO_SIZE[<\/code>1<\/code>] - LOGO_PADDING), logo)<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n\n\n\n

As you can see, I wrote a draw_logo()<\/code> function which takes a background image and a path to a logo. Then, if the logo path is present, we load the logo, convert it to a thumbnail of a particular size, and paste it onto the background image.<\/p>\n\n\n\n

Here, the real magic is in the last line. In other words, we can the paste()<\/code> function which takes a few inputs: the image file, its location, and a mask. In this case, we use the logo, and we calculate where to paste it using the height of the logo and the height of the background. Since we don\u2019t want it perfectly in the corner, we add some padding.<\/p>\n\n\n\n

If you\u2019re interested in seeing the entire script, you can check it out here<\/a>. Keep in mind that it\u2019s a little rough around the edges, but it gets the job done. Feel free to fork it and modify it to your needs.<\/p>\n\n\n\n

Any Other Changes?<\/h2>\n\n\n\n

While I was putting this feature together, I realized that there was this strange artifact showing up in my output images. Let me show you what I mean:<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Since I put the Image Titler tool together, I\u2019d been generating images that look exactly like this one. If you don\u2019t look to hard, there\u2019s nothing to see. It\u2019s just a regular featured image.<\/p>\n\n\n\n

However, if you zoom in on the text, you\u2019ll notice some strange artifacts. For instance, the red isn\u2019t exactly solid\u2014there are some darker shades mixed in. Overall, the image looks rather poor.<\/p>\n\n\n\n

For awhile, I chalked this up to WordPress. After all, the previews that Image Titler generates are always extremely clean and clear. Unfortunately, that\u2019s not the same quality you get when you save the image. Apparently, the save function does some compression which can actually be toggled off:<\/p>\n\n\n\n

\n
\n\n\n\n
\n
1<\/div>\n<\/td>\n
\n
\n
edited_image.save(storage_path, subsampling=<\/code>0<\/code>, quality=<\/code>100<\/code>)<\/code><\/div>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n\n\n\n

Here, I set the quality to max and subsampling to zero. Now, images in v1.5.1<\/a> look exactly how I expect them to:<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Of course, WordPress still does some minor distortion. If you want to compare the two raw images, try right clicking and selecting \u201copen image in new tab.\u201d<\/p>\n\n\n\n

Outside of this change, I also updated the dimensions of the image in v1.5.2<\/a>, so they conform more to my thumbnails:<\/p>\n\n\n\n

\"\"<\/figure><\/div>\n\n\n\n

Now, you\u2019ll be able to see both the title and the logo on the archive pages of the website. How cool is that?!<\/p>\n\n\n\n

Future Changes<\/h2>\n\n\n\n

At this point, I\u2019m fairly satisfied with where the Image Titler tool is at. That said, there are a few outstanding issues I\u2019d like to deal with at some point. In addition, I\u2019m open to suggestions. Is there anything you\u2019d like to see?<\/p>\n\n\n\n

Otherwise, thanks for stopping by! If you\u2019re interested in getting updates like this in your inbox, hop on my mailing list<\/a>. I publish twice a week, and I always send both posts out in a Friday newsletter. In addition, you can support this project and others like it by becoming a patron<\/a> or sponsor me directly on GitHub<\/a>.<\/p>\n\n\n\n

Here are a few related posts for your perusal:<\/p>\n\n\n\n