Title: Hollow/Outline text module

Author: Pete Shinners (Pete at shinners.org)
Submission date: December 03, 2001

Description: Two functions that create opaque or transparent text with a 1-pixel wide border around it.

Download: hollow.py

pygame version required: Any
SDL version required: Any
Python version required: Any

Comments: TextHollow's fontcolor argument isn't actually the color of the text - this effect makes the text transparent. Instead, it's the color of the outline. Both functions return surfaces with the colorkey set; the supplied example script demonstrates this by blitting both over a varied background.

Messages: 2

#!/usr/bin/env python

two text rendering styles. outlined and hollow. both
use a single pixel border around the text. you might be
able to cheat a bigger border by fooling with it some.
import os, sys, pygame, pygame.font, pygame.image
from pygame.locals import *

def textHollow(font, message, fontcolor):
    notcolor = [c^0xFF for c in fontcolor]
    base = font.render(message, 0, fontcolor, notcolor)
    size = base.get_width() + 2, base.get_height() + 2
    img = pygame.Surface(size, 16)
    img.blit(base, (0, 0))
    img.blit(base, (2, 0))
    img.blit(base, (0, 2))
    img.blit(base, (2, 2))
    base.set_palette_at(1, notcolor)
    img.blit(base, (1, 1))
    return img

def textOutline(font, message, fontcolor, outlinecolor):
    base = font.render(message, 0, fontcolor)
    outline = textHollow(font, message, outlinecolor)
    img = pygame.Surface(outline.get_size(), 16)
    img.blit(base, (1, 1))
    img.blit(outline, (0, 0))
    return img

entry_info1 = 'Hollow, by Pete Shinners'
entry_info2 = 'Outlined, by Pete Shinners'

#this code will display our work, if the script is run...
if __name__ == '__main__':

    #create our fancy text
    white = 255, 255, 255
    grey = 100, 100, 100
    bigfont = pygame.font.Font(None, 60)
    text1 = textHollow(bigfont, entry_info1, white)
    text2 = textOutline(bigfont, entry_info2, grey, white)

    #create a window the correct size
    width = max(text1.get_width(), text2.get_width())
    height = text1.get_height() + text2.get_height()
    win = pygame.display.set_mode((width, height))
    win.fill((20, 20, 80), (0, 0, width, 30))
    win.fill((20, 20, 80), (0, height-30, width, 30))

    win.blit(text1, (0, 0))
    win.blit(text2, (0, text1.get_height()))
    #wait for the finish
    while 1:
        event = pygame.event.wait()
        if event.type is KEYDOWN and event.key == K_s: #save it
            name = os.path.splitext(sys.argv[0])[0] + '.bmp'
            print 'Saving image to:', name
            pygame.image.save(win, name)
        elif event.type in (QUIT,KEYDOWN,MOUSEBUTTONDOWN):

From: Anonymous

Date: August 24, 2003 07:27 GMT

is there anyway to make the text completely transparent, so when the area is highlighted, then the text will appear and could be read? please email me at preciousmac@aol.com


From: Anonymous

Date: February 28, 2005 22:54 GMT

Thanks Pete, this was helpful.


Main - Repository - Submit - News