通过指定的图像数据设置VI图标。LabVIEW通过图像创建称为VI图标的用户图层，同时删除图标编辑器中的其它图标信息。

如需使用像素图设置图标，通过该方法前可使用平化像素图VI将数据转换为图像数据簇。如需使用图片设置图标，通过该方法前可使用图片至像素图转换VI将数据转换为图像数据簇。通过创建屏蔽VI在连线图像数据至该方法前设置图像数据中的特定颜色为透明。

该方法可将连接至输入的图像数据转换为相应的图像深度。例如，如连线4位图像数据至256色输入端，该方法可将图像数据转换为8位的颜色深度。

如未连线图像数据至16色输入端，LabVIEW将把连线至256色输入端的图像数据转换为4位的颜色深度。如未连线图像数据至单色输入端，在可能情况下，LabVIEW将把连线至16色输入端的图像数据转换为1位的颜色深度。否则，LabVIEW将把连线至256色输入端的图像数据转换为1位的颜色深度。

如连接至方法的图像数据所表示的图像大于或小于32×32像素，该方法可将图像缩放至32×32像素。

也可使用VI图标:通过文件设置方法通过图像文件设置VI图标。

参数

名称 数据类型 必需 说明
颜色256 ccclst.png 是
指定作为8位VI图标的图像数据。图标编辑器对话框将图标保存为256色（8位）和单色（1位）格式。
  • 图像类型-保留供将来使用。
  • 图像深度-指定图像的颜色深度，也就是用来描述图像中每个像素的颜色的比特数。有效值包括每像素 1、 4、 8和 24位 。 图像深度 影响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）。右下边界不包含图像。
颜色16 ccclst.png 否
指定作为4位VI图标的图像数据。图标编辑器对话框可使图标保存为256色（8位）和单色（1位）。如使用该输入指定图标使用4位图像数据，则只能通过VI图标:按图像数据获取方法的16色输出获取图像数据。
  • 图像类型-保留供将来使用。
  • 图像深度-指定图像的颜色深度，也就是用来描述图像中每个像素的颜色的比特数。有效值包括每像素 1、 4、 8和 24位 。 图像深度 影响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）。右下边界不包含图像。
单色 ccclst.png 否
指定作为1位图标的图像数据。图标编辑器对话框将图标保存为256色（8位）和单色（1位）格式。
  • 图像类型-保留供将来使用。
  • 图像深度-指定图像的颜色深度，也就是用来描述图像中每个像素的颜色的比特数。有效值包括每像素 1、 4、 8和 24位 。 图像深度 影响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）。右下边界不包含图像。

注释

下表列出了该方法的特性。

短名称 VI Icon.Set from Image Data
数据类型 无返回值
可用于运行引擎 否
可用于实时操作系统 否
可在VI运行时设置 是
加载前面板至内存 否
使用前必须授权 是
加载程序框图至内存 否
允许远程访问 是
必须等待直到用户界面空闲 否
可用于控件VI 是
可用于全局VI 是
可用于严格自定义类型 否
可用于多态VI 是