poi-tl图片排版

### 使用POI-TL进行图片排版的方法

在处理Word文档中的图片排版时，`poi-tl` 提供了多种方式来控制图片的尺寸、位置以及其他属性。以下是具体实现方法：

#### 设置图片大小

当向Word文档中插入图片时，可以通过指定宽度和高度精确控制其显示效果。对于希望将图片缩小至原始尺寸四分之三的情况，在Java代码里可以这样操作[^2]:

public static void renderImageData(String imagePath, String renderKey, Map<String, Object> renderMap) throws IOException {
    BufferedImage picture = ImageIO.read(new FileInputStream(imagePath));
    
    // 将图片调整为原来大小的3/4
    int width = picture.getWidth() * 3 / 4;
    int height = picture.getHeight() * 3 / 4;

    renderMap.put(renderKey, new PictureRenderData(width, height, imagePath));
}

此函数读取给定路径下的图像文件，并创建一个新的`PictureRenderData`实例用于后续渲染。

#### 插入带有特定参数的占位符

为了更灵活地管理不同场景下图片的表现形式，可以在模板内定义特殊的标记语法。例如，通过如下格式化字符串来指示图片应占据的空间及其外观特性[^3]:
- `##{image_placeholder1:width=2.6&height=3.5}`：设定固定的宽高比例；
- `##{image_placeholder1:size=auto}`：允许根据上下文自适应调整大小；

这些指令会被解析器识别并应用于最终生成的内容之中。

#### 自动适配多张图片布局

针对多个连续排列的小图情况，还可以利用额外选项来自定义它们之间的相对关系。比如构建网格状结构（如2×2或3×3），只需简单声明即可完成配置:

前提条件：表格中，固定宽度，
否则该参数失效。
如根据图片数量，设置自动调整图片大小，布局为：2*2 3*3

这意味着只要满足一定条件下，系统会智能分配每幅作品所占用的位置份额，从而达到美观整齐的效果。