返回前面板控件的图像

该方法的作用类似于前面板:获取图像方法。

如前面板不可见,则LabVIEW不更新前面板上对象的值。如调用前面板不可见的VI并使用“获取图像”方法创建前面板对象的图像,则图像不反映VI运行时发生的任何值的改变。

如需使图像显示值的改变,应确保值的改变发生在前面板打开之后。如无需显示前面板,但需通过图像显示值的改变,在程序框图上,可通过要创建前面板控件图像的VI的任意程序框图接线端创建属性节点

通过添加控件图像至报表VI可创建前面板对象图像并将其添加至报表。

参数

名称 数据类型 必需 说明
图像深度 ci32.png

表明图像的颜色深度,即支持的颜色数量:1(1位,黑白)、4(4位,16色)、8(8位、256色)或24(24位,真彩色)。默认值为8。

背景色 cu32.png

指定图像的背景颜色。

图像数据 icclst.png
图像信息,可通过绘制平化像素图VI绘制图片,或保存为不同图形格式的文件。该簇与读取JPEG文件读取PNG文件读取BMP文件等VI的图像数据输出类似。
  • 图像类型-保留供将来使用。
  • 图像深度-指定图像的颜色深度,也就是用来描述图像中每个像素的颜色的比特数。有效值包括每像素 14824位图像深度 影响LabVIEW如何解释 图像颜色的值。
  • Image--描述图像中每个像素的颜色的字节数,按光栅顺序排列。图像深度的值将决定LabVIEW如何解析输入值。

    图像深度24,每个像素的颜色用三个字节描述。第一个字节代表红色值,第二个字节代表绿色值,第三个字节代表蓝色值。

    图像深度8,每个像素的颜色用一个字节描述。每一位的值与颜色中的一个元素相对应,颜色中包含32位RGB值,最高有效字节为零,然后分别是红色、绿色和蓝色的值。

    图像深度4,除图像的有效值范围为0-15外,其他类似于图像深度8的情况。

    图像深度1图像中的0值对应于颜色中的元素0。所有其它值对应于颜色中的元素1。

    进行填充后,数组大小可能比预期的大。
  • mask -字节阵列,其中每一位都描述了一个像素的掩码信息。第一个字节描述前八个像素,第二个字节描述接下来的八个像素,并以此类推。如某位为0,则对应的像素显示为透明。如数组为空,则所有像素为不透明。如图像中的像素在数组中无对应的位,则该像素为不透明。
  • colors-图像中的值相对应的RGB颜色值的数组图像深度的值将决定LabVIEW如何解析输入值。如图像深度24,LabVIEW忽略该输出。如图像深度8,则数组可包含256个元素。如图像深度4,则数组可包含16个元素。如图像深度1,则数组可包含2个元素。
  • 矩形-簇,包含描述图像边界矩形的坐标,其中左上角在(0,0)。右下边界不包含图像。

注释

下表列出了该方法的特性

短名称 Get Image
数据类型 无返回值
可用于运行引擎
可用于实时操作系统
可在VI运行时设置
加载前面板至内存
使用前必须授权
加载程序框图至内存
允许远程访问