Generating an image of multi character emoji using Pillow in python

Question

I'm using Pillow to generate PNGs of emoji, using Google's Noto Emoji font (which can be downloaded from that page). It works well for basic emojis but multi character emojis are output as, well, multiple characters. I can't work out if it's possible to output them as single emoji.

This code:

from PIL import Image, ImageDraw, ImageFont

emoji = "🙂"
image = Image.new("RGB", (600, 100), "#eeeeee")
draw = ImageDraw.Draw(image)
font = ImageFont.truetype("NotoEmoji-Bold.ttf", size=80)
draw.text((0, 0), emoji, font=font, fill="#000000")
image.save("emoji.png")

Outputs:

Which is great.

But if I use a multi-character emoji, like a family:

emoji = "👩‍👩‍👧‍👦"

then I get:

Which is super cute, but I want the single-character family emoji:

Answer 1

I had to install the raqm library to get the multi-character emoji rendering correctly.

On Ubuntu that meant doing apt-get install libraqm-dev.

I thought I'd also have to specify it as the layout_engine for the font, i.e.:

font = ImageFont.truetype("NotoEmoji-Bold.ttf", size=80, layout_engine=ImageFont.LAYOUT_RAQM)

But it worked even without doing that, once raqm was installed. But I left it specified anyway, to be explicit.

UPDATE: From Pillow v10 the layout_engine value needs to change:

font = ImageFont.truetype("NotoEmoji-Bold.ttf", size=80, layout_engine=ImageFont.Layout.RAQM)