Note to Windows users that FreeType will keep the font file open

This commit is contained in:
Andrew Murray 2022-08-06 22:48:10 +10:00
parent 3b0f046c5a
commit 42a5a743c1

View File

@ -906,9 +906,10 @@ def truetype(font=None, size=10, index=0, encoding="", layout_engine=None):
This function loads a font object from the given file or file-like This function loads a font object from the given file or file-like
object, and creates a font object for a font of the given size. object, and creates a font object for a font of the given size.
Pillow uses FreeType to open font files. If you are opening many fonts Pillow uses FreeType to open font files. On Windows, be aware that FreeType
simultaneously on Windows, be aware that Windows limits the number of files will keep the file open as long as the FreeTypeFont object exists. Windows
that can be open in C at once to 512. If you approach that limit, an limits the number of files that can be open in C at once to 512, so if many
fonts are opened simultaneously and that limit is approached, an
``OSError`` may be thrown, reporting that FreeType "cannot open resource". ``OSError`` may be thrown, reporting that FreeType "cannot open resource".
This function requires the _imagingft service. This function requires the _imagingft service.