added basic support for Free Text annotations

fpdf/annotations.py

@@ -44,6 +44,7 @@ def __init__(
         file_spec: str = None,
         field_type: str = None,
         value=None,
+        default_appearance: str = None,  # for free text annotations
     ):
         self.type = Name("Annot")
         self.subtype = Name(subtype)
@@ -71,6 +72,7 @@ def __init__(
             else None
         )
         self.f_s = file_spec
+        self.d_a = "(0 1 0 rg /Helv 12 Tf)" if default_appearance else None
 
 
 class PDFAnnotation(AnnotationMixin, PDFObject):
@@ -100,6 +102,7 @@ class AnnotationDict(AnnotationMixin):
         "name",
         "ink_list",
         "f_s",
+        "d_a",
     )
 
     def serialize(self, _security_handler=None, _obj_id=None):

fpdf/fpdf.py

@@ -2235,6 +2235,44 @@ def text_annotation(
         self.pages[self.page].annots.append(annotation)
         return annotation
 
+    @check_page
+    def free_text_annotation(
+        self,
+        x,
+        y,
+        text,
+        w=1,
+        h=1,
+        name=None,
+        flags=DEFAULT_ANNOT_FLAGS,
+        default_appearance=False,
+    ):
+        """
+        Puts a free text annotation on a rectangular area of the page.
+
+        Args:
+            x (float): horizontal position (from the left) to the left side of the link rectangle
+            y (float): vertical position (from the top) to the bottom side of the link rectangle
+            text (str): text to display
+            w (float): optional width of the link rectangle
+            h (float): optional height of the link rectangle
+            name (fpdf.enums.AnnotationName, str): optional icon that shall be used in displaying the annotation
+            flags (Tuple[fpdf.enums.AnnotationFlag], Tuple[str]): optional list of flags defining annotation properties
+        """
+        annotation = AnnotationDict(
+            "FreeText",
+            x * self.k,
+            self.h_pt - y * self.k,
+            w * self.k,
+            h * self.k,
+            contents=text,
+            name=AnnotationName.coerce(name) if name else None,
+            flags=tuple(AnnotationFlag.coerce(flag) for flag in flags),
+            default_appearance=default_appearance,
+        )
+        self.pages[self.page].annots.append(annotation)
+        return annotation
+
     @check_page
     def add_action(self, action, x, y, w, h):
         """