From 4f00846dde0a9d97e28b654665259ec3dc12d0d7 Mon Sep 17 00:00:00 2001
From: Alexei Podtelezhnikov <apodtele@gmail.com>
Date: Sun, 25 Aug 2024 18:13:10 +0000
Subject: [PATCH] * include/freetype/ftimage.h (FT_Bitmap): Describe empty
 bitmap.

---
 include/freetype/ftimage.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/include/freetype/ftimage.h b/include/freetype/ftimage.h
index 2b4b4ac60..33070fb12 100644
--- 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_
   {