* include/freetype/ftimage.h (FT_Bitmap): Describe empty bitmap.

2024-08-25 18:13:10 +00:00 · 2024-08-25 18:13:10 +00:00 · 4f00846dde
parent f92c96550a
commit 4f00846dde
1 changed files with 4 additions and 0 deletions
--- a/include/freetype/ftimage.h
+++ b/include/freetype/ftimage.h
@ -267,6 +267,10 @@ FT_BEGIN_HEADER
   *   *logical* one.  For example, if @FT_Pixel_Mode is set to
   *   `FT_PIXEL_MODE_LCD`, the logical width is a just a third of the
   *   physical one.
+   *
+   *   An empty bitmap with a NULL `buffer` is valid, with `rows` and/or
+   *   `pitch` also set to 0.  Such bitmaps might be produced while rendering
+   *   empty or degenerate outlines.
   */
  typedef struct  FT_Bitmap_
  {