获取VI层次结构的缩放图像。

语法

object.GetHierImgScaled(imgdepth, imgdata, maxwidth, maxheight, VIToHighlight)

参数

名称类型说明信息
imgdepth长整型表示图像的颜色深度或支持的颜色数量：1（1位，黑白）、4（4位，16色）、8（8位，256色）或24（24位，真彩色）。默认值为8。
imgdataImageData

图像信息，可通过绘制平化像素图VI绘制图片，或保存为不同图形格式的文件。

  • 图像类型－保留供将来使用。
  • 图像深度－指定图像的颜色深度，即用于描述图像中每个像素颜色的位数。有效值 包括 每像素 1、4、8和 24 位。 图像深度 影响LabVIEW解释 图像 和 颜色值的方式。
  • image- 字节数组，按光栅顺序描述图像中每个像素的颜色。图像深度的值将决定LabVIEW如何解析输入值。

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

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

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

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

    进行填充后，数组大小可能比预期的大。

  • mask—字节数组，其中每位描述像素的掩码信息。第一个字节描述前八个像素，第二个字节描述接下来的八个像素，并以此类推。如某位为0，则对应的像素显示为透明。如数组为空，则所有像素为不透明。如图像中的像素在数组中无对应的位，则该像素为不透明。
  • 颜色- RGB颜色值数组，对应于 图像中的值。图像深度的值将决定LabVIEW如何解析输入值。如图像深度为24，LabVIEW忽略该输出。如图像深度为8，则数组可包含256个元素。如 图像深度 为 4，则数组包含16个元素。如果 图像深度 为 1，则数组包含2个元素。
  • 矩形－包含描述图像边界矩形（左上角位于(0,0)处）的坐标的簇。右下边界不包含图像。
maxwidth长整型指定返回图像的宽度。如输入为0，返回的图像和默认图像在LabVIEW VI层次结构窗口中显示的宽度一致。另外，如最大宽度和最小宽度没有保持默认图像的比例，LabVIEW无法使返回的图像变形。
maxheight长整型指定返回图像的高度。如输入为0，返回的图像和默认图像在LabVIEW VI层次结构窗口中显示的高度一致。另外，如最大宽度和最小宽度没有保持默认图像的比例，LabVIEW无法使返回的图像变形。
VIToHighlight变体指定层次结构中高亮显示的VI。除了在VI图标外添加一个紫色的外框，展开和折叠层次结构均基于高亮显示的VI。

返回值

无