:mod:`pygame2.font` -- A module used to find system fonts
=========================================================

A module used to find system fonts

.. module:: pygame2.font
   :synopsis: A module used to find system fonts

Module Functions
----------------
.. function:: find_fonts (name, bold=False, italic=False, ftype=None) -> [ (str, bool, bool), ... ]

  Finds all fonts matching a certain family or font filename.

  Tries to find all fonts that match the passed requirements best. The
  *name* argument denotes a specific font or font family name. If multiple
  fonts match that name, the *bold* and *italic* arguments are used to find
  the fonts that match the requirements best. *ftype* is an optional font
  filetype argument to request specific font file types, such as bdf or ttf
  fonts.

  All found fonts are returned as list.



.. function:: find_font (name, bold=False, italic=False, ftype=None) -> str, bool, bool

  Finds a font matching a certain family or font filename.

  Tries to find a font that matches the passed requirements best. The
  *name* argument denotes a specific font or font family name. If multiple
  fonts match that name, the *bold* and *italic* arguments are used to find
  a font that matches the requirements best. *ftype* is an optional font
  filetype argument to request specific font file types, such as bdf or ttf
  fonts.



.. function:: get_families () -> [str, str, ...]

  Gets the list of available font families.




