ENH: Add Highlight text markup annotation

[MartinThoma]

See #107

[MartinThoma]

I've got the quadpoints by using pymupdf and inspecting the resulting document:

import fitz

doc = fitz.open("crazyones.pdf")
page = doc[0]

text_instances = page.search_for("crazy")

for inst in text_instances:
    highlight = page.add_highlight_annot(inst)
    highlight.set_colors({"stroke":(0, 0, 1), "fill":(0.75, 0.8, 0.95)})
    highlight.update()

doc.save("annotation.pdf")

@pubpub-zz How difficult would a PageObject.search_for(text) method be to implement that returns something containing the QuadPoints? Some people would be curious: https://stackoverflow.com/q/47497309/562769 :-)

[codecov]

Codecov Report

Patch coverage: 100.00% and no project coverage change.

Comparison is base (4fc0040) 92.38% compared to head (b7bb307) 92.38%.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1740   +/-   ##
=======================================
  Coverage   92.38%   92.38%           
=======================================
  Files          34       34           
  Lines        6553     6557    +4     
  Branches     1300     1301    +1     
=======================================
+ Hits         6054     6058    +4     
  Misses        326      326           
  Partials      173      173           

Impacted Files	Coverage Δ
pypdf/generic/_annotations.py	93.91% <100.00%> (+0.21%)	⬆️

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[pubpub-zz]

@pubpub-zz How difficult would a PageObject.search_for(text) method be to implement that returns something containing the QuadPoints? Some people would be curious: https://stackoverflow.com/q/47497309/562769 :-)

It will be part of the extension of extract_text... I raise it in the stack

[pubpub-zz]

the inprogress PR #1723 about set_color should also allow to change the color : definitively set_color() should be the good name