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.