背景图像
- 更新时间2025-07-30
- 阅读时长3分钟
设置窗格所用的背景图像。LabVIEW支持BMP、JPEG和PNG格式的背景图像。
该属性的作用类似于窗格属性对话框中外观页的浏览选项。
如需使用图片设置图像，使用该方法前可通过图片至像素图转换VI将数据转换为图像数据簇。如使用文件设置图像，使用该方法前可通过读取JPEG文件、读取PNG文件或读取BMP文件VI将数据转换为图像数据簇。
元素
| 名称 | 说明信息 |
|---|---|
| 图像类型 | 保留以备后用。 |
| 图像深度 | 图像深度可指定图像的颜色深度（描述图像中每个像素的位数）。有效值包括每像素1位、4位、8位和24位（默认）。图像深度可确定LabVIEW解析“图像”和“颜色”的值的方式。 |
| 图像 | “图像”是一维字节数组，按光栅顺序描述图像中各个像素的颜色。“图像深度”的值可确定LabVIEW解析该输入的值的方式。 如“图像深度”为24，则每个像素的颜色用3个字节描述。每个像素的第一个字节代表红色值，第二个字节代表绿色值，第三个字节代表蓝色值。 如“图像深度”为8，则每个像素的颜色用一个字节描述。每位的值与“颜色”中的一个元素相对应，“颜色”中存储32位RGB值，最高字节为零，接下来分别是红色、绿色、蓝色值。有效值在0到255之间。 “图像深度”为4时与“图像深度”为8时的情况相似。图像有效值在0至15之间时例外。 如“图像深度”为1，则图像中的0值对应于“颜色”中的元素0。所有其它值对应于“颜色”中的元素1。 |
| 掩码 | “掩码”为字节数组，每位用于描述一个像素的掩码信息。第一个字节描述前八个像素，第二个字节描述后八个像素，依此类推。如某位为0，则对应的像素显示为透明。如数组为空，则所有像素为不透明。如图像中的像素在数组中无对应的位，则该像素为不透明。 |
| 颜色 | “颜色”是和图像值对应的RGB颜色值构成的数组。“图像深度”的值可确定LabVIEW解析该输入的值的方式。 如“图像深度”为24，则LabVIEW忽略该输入。 如“图像深度”为8，则数组可包含256个元素。 如“图像深度”为4，则数组可包含16个元素。 如“图像深度”为1，则数组可包含2个元素。 |
| 矩形 | 包含绘图区域边界坐标的簇。VI按照绘图区域的宽度和高度剪裁图像。绘图区域的下边界和右边界不包含图像的像素。水平坐标向右递增，垂直坐标向下递增。
|
注释
下表列出了该属性的特性。
| 短名称 | BackgroundImage |
| 数据类型 |  |
| 权限 | 读取/写入 |
| 可用于运行引擎 | 是 |
| 可用于实时操作系统 | 是 |
| 可在VI运行时设置 | 是 |
| 加载前面板至内存 | 是 |
| 使用前必须授权 | 否 |
| 加载程序框图至内存 | 否 |
| 允许远程访问 | 是 |