load_font()#

Loads a .vlw formatted font into a Py5Font object.

Examples#

example picture for load_font()

def setup():
    # the font must be located in the sketch's
    # "data" directory to load successfully
    font = py5.load_font("DejaVu_Sans-32.vlw")
    py5.text_font(font, 32)
    py5.text("word", 10, 50)

Description#

Loads a .vlw formatted font into a Py5Font object. Create a .vlw font with the create_font_file() function. This tool creates a texture for each alphanumeric character and then adds them as a .vlw file to the current Sketch’s data folder. Because the letters are defined as textures (and not vector data) the size at which the fonts are created must be considered in relation to the size at which they are drawn. For example, load a 32pt font if the Sketch displays the font at 32 pixels or smaller. Conversely, if a 12pt font is loaded and displayed at 48pts, the letters will be distorted because the program will be stretching a small graphic to a large size.

Like load_image() and other functions that load data, the load_font() function should not be used inside draw(), because it will slow down the Sketch considerably, as the font will be re-loaded from the disk (or network) on each frame. It’s recommended to load files inside setup().

To load correctly, fonts must be located in the “data” folder of the current Sketch. Alternatively, the file maybe be loaded from anywhere on the local computer using an absolute path (something that starts with / on Unix and Linux, or a drive letter on Windows), or the filename parameter can be a URL for a file found on a network.

If the file is not available or an error occurs, None will be returned and an error message will be printed to the console. The error message does not halt the program, however the None value may cause an error if your code does not check whether the value returned is None.

Use create_font() (instead of load_font()) to enable vector data to be used with the default renderer setting. This can be helpful when many font sizes are needed, or when using any renderer based on the default renderer, such as the PDF renderer.

Underlying Processing method: loadFont

Signatures#

load_font(
    filename: str,  # name of the font to load
    /,
) -> Py5Font

Updated on March 06, 2023 02:49:26am UTC