New textbox insertion based on Story class

[JorjMcKie]

We are in the process of developing a new page method page.insert_htmlbox() which behaves very similar to page.insert_textbox() and friends.
It internally uses the genius PyMuPDF Story class (actually MuPDF), but frees the developer from all the technical details.
With this method you will have the following features:

• Invoke it via page.insert_htmlbox(rect, text, <more parameter>) like you would invoke page.insert_textbox().
• The "text" parameter may be plain text or text with HTML tags like <b> or <i>, including inline styling (e.g. for text colors, or using some font-family and more).
• Other parameters like rotation, overlay etc. are also supported.
• The text may be any mixture of any language, including characters from Latin, Cyrillic, Greek, CJK, Hindi, Tamil, Bengali, Thai, etc.
  • The underlying Story will automatically pull in the required fonts from Google's NOTO fonts
  • Text shaping (using the HarfBuzz library) will automatically be invoked - thus solving this old problem.
• There is an option to either return a positive or negative float indicating success as in page.insert_textbox(), or request to decrease the font size until there is a fit.

While we cannot make it for the release due in week starting 2023-11-27, we do hope to publish it in the release thereafter.
Stay tuned.

[JorjMcKie]

Example:

Created via:

page.insert_htmlbox(clip, html, rotate=90)

and the following html text:
thai.zip