Question

如何通过python-docx将图像插入背景中的文本（例如重叠）中？

我知道图像可以放在文本的右侧或左侧。

但是我想要类似浮动图像的文字。像背景图片。

有可能吗？

谢谢。

Answer 1

python-docx v0.8.10尚不支持浮动图片。但是基于创建内联图片的实现，我探索了一种解决方法，并将其用于我的项目中。

https://github.com/dothinking/pdf2docx/issues/54#issuecomment-715925252

探索浮动图片的步骤：

创建两个docx文件，一个插入一个嵌入式图像，另一个插入一个浮动图像（在这种情况下，请使用behind text模式）
检查这两个文件之间源xml的区别
基于观察到的结构和python-docx内嵌图像的源代码实现浮动图像

xml结构结果：

内嵌图片是<wp:inline>下的<w:drawing>节点
浮动图像是<wp:anchor>下的<w:drawing>节点
除了内联图像的所有子节点之外，浮动图像还包含<wp:positionH>和<wp:positionV>来定义固定位置

因此，我们的想法是创建<wp:anchor>节点，然后追加子节点：不仅所有具有内嵌图像的相同节点，而且还有额外的<wp:positionH>和<wp:positionV>。 / p>

# -*- coding: utf-8 -*-

'''
Implement floating image based on python-docx 0.8.10.

- Text wrapping style: BEHIND TEXT <wp:anchor behindDoc="1">
- Picture position: top-left corner of PAGE `<wp:positionH relativeFrom="page">`.

Create a docx sample (Layout | Positions | More Layout Options) and explore the 
source xml (Open as a zip | word | document.xml) to implement other text wrapping
styles and position modes per `CT_Anchor._anchor_xml()`.
'''

from docx.oxml import parse_xml, register_element_cls
from docx.oxml.ns import nsdecls
from docx.oxml.shape import CT_Picture
from docx.oxml.xmlchemy import BaseOxmlElement, OneAndOnlyOne

# refer to docx.oxml.shape.CT_Inline
class CT_Anchor(BaseOxmlElement):
    """
    ``<w:anchor>`` element, container for a floating image.
    """
    extent = OneAndOnlyOne('wp:extent')
    docPr = OneAndOnlyOne('wp:docPr')
    graphic = OneAndOnlyOne('a:graphic')

    @classmethod
    def new(cls, cx, cy, shape_id, pic, pos_x, pos_y):
        """
        Return a new ``<wp:anchor>`` element populated with the values passed
        as parameters.
        """
        anchor = parse_xml(cls._anchor_xml(pos_x, pos_y))
        anchor.extent.cx = cx
        anchor.extent.cy = cy
        anchor.docPr.id = shape_id
        anchor.docPr.name = 'Picture %d' % shape_id
        anchor.graphic.graphicData.uri = (
            'http://schemas.openxmlformats.org/drawingml/2006/picture'
        )
        anchor.graphic.graphicData._insert_pic(pic)
        return anchor

    @classmethod
    def new_pic_anchor(cls, shape_id, rId, filename, cx, cy, pos_x, pos_y):
        """
        Return a new `wp:anchor` element containing the `pic:pic` element
        specified by the argument values.
        """
        pic_id = 0  # Word doesn't seem to use this, but does not omit it
        pic = CT_Picture.new(pic_id, filename, rId, cx, cy)
        anchor = cls.new(cx, cy, shape_id, pic, pos_x, pos_y)
        anchor.graphic.graphicData._insert_pic(pic)
        return anchor

    @classmethod
    def _anchor_xml(cls, pos_x, pos_y):
        return (
            '<wp:anchor distT="0" distB="0" distL="0" distR="0" simplePos="0" relativeHeight="0" \n'
            '           behindDoc="1" locked="0" layoutInCell="1" allowOverlap="1" \n'
            '           %s>\n'
            '  <wp:simplePos x="0" y="0"/>\n'
            '  <wp:positionH relativeFrom="page">\n'
            '    <wp:posOffset>%d</wp:posOffset>\n'
            '  </wp:positionH>\n'
            '  <wp:positionV relativeFrom="page">\n'
            '    <wp:posOffset>%d</wp:posOffset>\n'
            '  </wp:positionV>\n'                    
            '  <wp:extent cx="914400" cy="914400"/>\n'
            '  <wp:wrapNone/>\n'
            '  <wp:docPr id="666" name="unnamed"/>\n'
            '  <wp:cNvGraphicFramePr>\n'
            '    <a:graphicFrameLocks noChangeAspect="1"/>\n'
            '  </wp:cNvGraphicFramePr>\n'
            '  <a:graphic>\n'
            '    <a:graphicData uri="URI not set"/>\n'
            '  </a:graphic>\n'
            '</wp:anchor>' % ( nsdecls('wp', 'a', 'pic', 'r'), int(pos_x), int(pos_y) )
        )


# refer to docx.parts.story.BaseStoryPart.new_pic_inline
def new_pic_anchor(part, image_descriptor, width, height, pos_x, pos_y):
    """Return a newly-created `w:anchor` element.

    The element contains the image specified by *image_descriptor* and is scaled
    based on the values of *width* and *height*.
    """
    rId, image = part.get_or_add_image(image_descriptor)
    cx, cy = image.scaled_dimensions(width, height)
    shape_id, filename = part.next_id, image.filename    
    return CT_Anchor.new_pic_anchor(shape_id, rId, filename, cx, cy, pos_x, pos_y)


# refer to docx.text.run.add_picture
def add_float_picture(p, image_path_or_stream, width=None, height=None, pos_x=0, pos_y=0):
    """Add float picture at fixed position `pos_x` and `pos_y` to the top-left point of page.
    """
    run = p.add_run()
    anchor = new_pic_anchor(run.part, image_path_or_stream, width, height, pos_x, pos_y)
    run._r.add_drawing(anchor)

# refer to docx.oxml.shape.__init__.py
register_element_cls('wp:anchor', CT_Anchor)


if __name__ == '__main__':

    from docx import Document
    from docx.shared import Inches, Pt

    document = Document()

    # add a floating image
    p = document.add_paragraph()
    add_float_picture(p, 'test.png', width=Inches(5.0), pos_x=Pt(20), pos_y=Pt(30))

    # add text
    p.add_run('Hello World'*50)


    document.save('output.docx')

Answer 2

根据目前的documentation，他们仅支持嵌入式图片。我有同样的问题。

所以目前无法使用python-docx做到这一点

将内联形状视为大文本字符（字符字形）。线高会增加以适应形状，并且形状会被包裹成一条线，使其适合宽度方向，就像文本一样。在其前面插入文本将导致其向右移动。通常，图片本身是放在段落中的，但这不是必需的。它可以在其所在段落的前面和后面带有文本。

在撰写本文时，python-docx仅支持嵌入式图片。可以添加浮动图片。如果您有活跃的用例，请在问题跟踪器上提交功能请求。 Document.add_picture（）方法将指定的图片添加到文档末尾的自己的段落中。但是，通过更深入地了解API，您可以将文本放置在图片段落的任一侧，或者同时放置在这两个段落中。

Answer 3

当您在表格的模板文件中插入图像时，该 docx 然后重新导入图像似乎有效

如何在python-docx中使用add_picture（）在背景上插入图像（与文本重叠）？

3 个答案: