1. 概述编辑
1.1 函数作用
Toimage 函数用于在报表中显示某一路径下的图片，显示的图片可以存储在部署报表工程的服务器上，也可以为网页图片。
注1：Toimag 函数作用为显示某一路径下的图片，并不代表将图片上传在模板中，所以将模板导出时图片不会存储在模板中。
注2：Toimage 函数，支持 jpg、png、bmp 常用格式的图片。
注3：用 Toimage 函数显示单元格图片，单元格设置了段间距，导出 PDF 或打印报表时，设置的「段间距」不生效。
1.2 函数解释
Toimage(patch,cache,width,height)
| 参数 | 含义 | 参数格式 |
|---|---|---|
| path | 图片路径，不可省略 | "F:/FineReport_10.0/webroot/logo.png" 或 "F:\\FineReport_10.0\\webroot\\logo.png" |
| cache | 是否开启图片缓存功能，可以省略，省略默认开启 | true 开启，false 关闭 |
| width | 图片宽度，可以省略，省略默认图片原宽度 | 整数：value 图片宽度像素 百分比："value" 图片宽度缩放比 |
| height | 图片高度，可以省略，省略默认图片原高度 | 整数：value 图片高度像素 百分比："value" 图片高度缩放比 |
注：path 参数必须存在，其余参数根据需要自行选择。
示例：
Toimage("d:/1.jpg")
Toimage("d:/1.jpg",false)
Toimage("d:/1.jpg",true,200,300)
Toimage("d:/1.jpg",true,"50%","200%")
注：使用 Toimage 函数返回的图片，「图片布局」为「默认」。可以在「单元格属性」>「对齐」>「图片布局」处选择其他布局方式。
2. 图片存储位置编辑
图片存储在部署报表工程的服务器上时，可以存储在报表工程 webroot 目录下，也可以在该服务器的其他位置。
图片存储的位置不同、图片来源不同，path 路径的写法不同。
| 图片存储位置 | path 路径 |
|---|---|
| 报表工程 webroot 目录下 | 相对路径：在 webroot 目录下的路径，如 help/logo-fanruan.png |
| 该服务器的其他位置 | 绝对路径：图片所在位置的完整路径，如 E:/图片/logo-fanruan.png |
| 网页中图片 | 图片网络地址，如 https://www.fanruan.com/images/logo-fanruan.png |
示例：
1）现有一图片存储路径为服务器 E 盘：E:\图片\logo-fanruan.png，公式：Toimage("E:/图片/logo-fanruan.png")。
2）现有一图片存储在服务器报表工程 webroot 目录下：D:\软件安装区\FineReport_10.0\webapps\webroot\help\logo-fanruan.png，公式：Toimage("help/logo-fanruan.png") 。
3）显示帆软官网 LOG 图片，公式：Toimage("https://www.fanruan.com/images/logo-fanruan.png") 。
![https://www.fanruan.com/images/logo-fanruan.png")](https://www.fanruan.com/images/logo-fanruan.png")){kind=link}
3. 图片路径存储位置编辑
图片路径可以直接在公式中输入，也可以引用存储在数据库的字段，如下示例。
若图片存在本地电脑 E 盘：E:\图片\logo-fanruan.png，图片路径存在数据库表中，如下图所示：
1）新建模板，新建数据集 ds1 ,SQL 语句为 select * from path ，如下图所示：
2）将图片路径所在字段「ds1.path」列拖到 A1 单元格中，在右侧「单元格属性」>「高级」>「显示值」位置，输入公式 :
Toimage($$$) ，如下图所示：
注：如果数据库存储的路径不完整，可以通过公式补全路径，如数据库存储的路径："图片\logo-fanruan.png" 不完整，使用公式 Toimage("E:\"+$$$) 补全。
3）点击 B2 单元格，输入公式 toimage("E:/图片/logo-fanruan.png")，如下图所示：
4）保存模板，点击「分页预览」，预览效果如下图所示：
