write an zh+en string on a 90 degree page, the orientation is error

[sa168]

When the page.rotation is 90 degrees (displayed as landscape orientation), the header/footer text positioning becomes problematic, whereas it works fine when page.rotation is 0 degrees (also landscape orientation by default). The issue manifests as text vertically aligned along the right edge of the page from top to bottom - essentially normal horizontal text rotated 90 degrees clockwise around the right edge as the origin. However, TextWriter's append() and write_text() methods lack a rotate parameter, making it unclear how to correct this orientation.

If using insert_text() with mixed Chinese/English text, English letters and numbers occupy double-width spacing (visually unappealing) and the pre-calculated text width becomes inaccurate, causing truncation. insert_htmlbox() appears to embed fonts regardless of font-family specifications, bloating file sizes from 700KB to over 30MB compared to insert_text().

The goal is to either:

1. Use insert_text() with fontname="cjk" while maintaining consistent Chinese/English character spacing, OR

2. Implement TextWriter with proper text positioning that handles page rotation correctly.

`

import pymupdf as fitz

def add_attached_text(self, page, text, font, isHeader):  
    if not text:
        return
    
    rect = page.rect
    rotation = page.rotation
    margin = 20
    font_size = 9
    font_color = (1, 0, 0)  # red       
    
    try:
         
        text_width = 0
        for c in text.strip():
            try:
                code = ord(c)
                advance = font.glyph_advance(code)    
            except:
                advance = font.glyph_advance(0xfffd)  
            text_width += advance * font_size         
                    
        # alignment: right
        x = max(rect.x0 + 5, rect.width - text_width - margin)
        
        if isHeader:
            y = margin
        else:
            y = rect.height - margin - font_size 

        p = fitz.Point(x, y)    
        print(f"add text corrdinates: {p}，transto：{p * page.derotation_matrix}")         
        if page.rotation == 90:
            p = p * page.derotation_matrix    
              
                  
        tw = fitz.TextWriter(page.rect, color=font_color)            
        tw.append(p, text, font=font, fontsize=font_size)
        tw.write_text(page)                    
        
        # page.insert_text(p, 
        #                  text, 
        #                  fontname="china-ss", 
        #                  fontsize=font_size,
        #                  color=font_color,
        #                  rotate=page.rotation,
        #                  render_mode=0)
        
        # page.insert_htmlbox(
        #     (x-5, y, x+text_width, y+25),                
        #     text, 
        #     css="* {font-family: cjk; font-size:9px; color: red;}", #
        #     rotate=page.rotation)    
       

    except Exception as e:
        print("err:", str(e))


def insert_text(self, pdffile, outfile):
    doc = fitz.open(pdffile)
    page = doc[0]
    font = fitz.Font("cjk")
    print(f"page-rotation:{page.rotation}")
    add_attached_text(self, page, "中文Text123试验test", font, True)
    add_attached_text(self, page, "日期2025-3-16", font, False)
    doc.save(outfile)


if __name__ == "__main__":
    # input_pdf = "test-1-portrait.pdf"  
    # output_pdf = "test1-out.pdf"  
    # insert_text(None, input_pdf, output_pdf)

    input_pdf = "test-2-landscape.pdf"  
    output_pdf = "test2-out.pdf"  
    insert_text(None, input_pdf, output_pdf)`

attached files:

test1-out.pdf

test-2-landscape.pdf

test2-out.pdf

test-1-portrait.pdf

[JorjMcKie]

It is unclear what you are actually reporting. None of your comments report an error or behavior contrary to what has been documented.
In addition, some of your difficulties could have been avoided by more thoroughly studying the documentation. For example:

1. File size issues because of Page.insert_htmlbox can be (and should be!) addressed by using Document.subset_fonts() directly before saving the file. When font-family is correctly specified, then additional fonts will only be pulled in when characters are not found in the named font(s).
2. TextWriter objects can be written using Page.write_text which supports rotation.
3. Pages with a non-zero rotation can be permanently de-rotated via Page.remove_rotation. This maintains the page's visibility - yet Page.rotationwill be 0 afterwards. And all insertions will behave as always in this case.
4. While it is true, that automatic line advancements (i.e. for text containing line breaks) in Page.insert_text will not behave as expected for rotated pages, nothing prevents you from using Page.insert_textbox instead. This supports a rotate parameter in addition to morph.

[JorjMcKie]

I have closed your other issue #4378 which documents how to resolve the "problem" you mention in your comment: By using the page's rotation matrix, you can insert text with desired position / rotation.
And you acknowledges my code snippet.
So I guess I don't really understand the comment in the introduction.

[sa168]

Hello, thank you for your detailed response. What I meant to express is:

When the page orientation is displayed as landscape and page.rotation returns 0, the output of write_text appears normal. However, when page.rotation returns 90, the text direction output by write_text is rotated 90 degrees to the right. According to your reply, page.remove_rotation() removes the rotation, and at this point page.rotation returns 0, but the output direction of write_text still has issues.

I am an amateur Python enthusiast who occasionally writes code to help solve work-related problems and improve efficiency. As such, my understanding of highly technical documentation is quite superficial. You mentioned that write_text supports rotation parameters, but I could only find its matrix parameter. I am unsure how to use this matrix to correct the coordinates.

Attached is the modified code I used to display different results on the same page using different methods.

Thank you again for your response.

`

import pymupdf as fitz

doc = fitz.open("test-2-landscape.pdf")
page = doc[0]
font = fitz.Font("cjk")
print(f"page-rotation:{page.rotation}")

out-put line 1

page.insert_text((30, 330),
"original direction: p(30,330)" + str(f"{page.rotation}"),
fontname="china-ss",
fontsize=12,
color= (1, 0, 0) ,
rotate=page.rotation,
render_mode=0)

page.remove_rotation()

out-put line 2

page.insert_text((100, 30),
"new direction: p(100,30)" + str(f"{page.rotation}"),
fontname="china-ss",
fontsize=12,
color= (1, 0, 0) ,
rotate=page.rotation,
render_mode=0)

out-put line 3

tw = fitz.TextWriter(page.rect, color= (1, 0, 0) )
tw.append((30,
230),
"new direction: p(100,30)" + str(f"{page.rotation}"),
font=font,
fontsize=12)
tw.write_text(page)

text = "中英文混合输入测试2025-03-17，test中en文"
x = 100
y_insert_text = 60
y_write_text = 90
y_insert_html = 120
font_size = 20

tw.append((x,
y_write_text),
"write_text method：" + text,
font=font,
fontsize=font_size)
tw.write_text(page)

page.insert_text((x, y_insert_text),
"insert_text method：" + text,
fontname="china-ss",
fontsize=font_size,
color= (1, 0, 0) ,
rotate=page.rotation,
render_mode=0)

page.insert_htmlbox(
(x, y_insert_html, x+300, y_insert_html+25),
"insert_htmlbox method: " + text,
css="* {font-family: cjk; font-size:20pt; color: red;}", #
rotate=page.rotation)

doc.save("test-2-landscape-OUTPUT.pdf")
doc.close()`

test-2-landscape.pdf