Annot Border and Rect shift.

[ibbit]

Hello everyone,

I wanted to quickly ask why PyMuPDF behaves the way it does in the following example.

I added a rectangle as a note using my editor (to define a zone on my floor plan). Now I want to use PyMuPDF to add my "content" and save it. The problem I observe is that after calling annot.update(), the boundaries somehow change.

See following images:
Rectangle (created in the editor)

After I run:

doc_new = pymupdf.open(pth2)
p1 = doc_new[0]
for annot in p1.annots():
    if annot.type[0] in [4]:
        annot.update()

Image 2: (updated rectangle)
When I open the PDF, you can see that the "selection" frame does not match the one in the first image.

Additional:
Image 3:
Shows the behavior when I simply stretch the rectangle to the right in the editor. Then the "border" just jumps back.

It's hard for me to explain this more precisely.

Am I missing something about how to properly use the annot.update() method?

But I also observe:

doc = pymupdf.open(pth1)
p1 = doc[0]
rect = pymupdf.Rect([10, 10, 100, 100])
new_rect = p1.add_rect_annot()
print("rect:", new_rect.rect)

terminal printout:

rect: Rect(9.0, 9.0, 101.0, 101.0)

But my definition is 10,10,100,100

Maybe some can drop a comment to understand this circumstance here and thx for your help!

BTW: I have the same behavior with PDFXchange and Ocular.

greets: ibbit

[JorjMcKie]

When updating an annotation with a tool that is different from the tool that created it, errors or unexpected results are to be expected in general - see here.

Independently from this, there is some inconsistency in PyMuPDF's behavior as you have noticed:
The base library automatically adds a /RD (= "rectangle difference") item to Square and Circle annotations which is used to compute the inner annotation rectangle - i.e. the one resulting when disregarding the line width.
What we should be doing in PyMuPDF is modifying the provided Annot.rect such that your intended rectangle results after taking /RD into account.
Either that or offer specifying the /RD values in the API and leave it to the user's discretion.

In any case, your creator software makes the annotation in a way such that everything is inside the specified rectangle, whereas the PyMuPDF update changes the rectangle such that 50% of the line width area is outside ...

Can you please give me the annotation object details as created by your initial editor? Probably an out like doc.xref_object(annot.xref) would be sufficient.