Obtient l'image ajustée de la hiérarchie du VI.

Syntaxe

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

Paramètres

NomTypeDescription
imgdepthmot longIndique la profondeur de couleurs, ou nombre de couleurs supportées, de l'image : 1 (1 bit, noir et blanc), 4 (4 bits, 16 couleurs), 8 (8 bits, 256 couleurs) ou 24 (24 bits, couleurs vraies). La valeur par défaut est 8.
imgdataImageData

Informations concernant l'image de façon à ce que vous puissiez la tracer sous forme d'image à l'aide du VI Tracer une table de pixels aplatie ou enregistrer cette image dans un fichier au moyen des VIs Formats graphiques.

  • type d'image: réservé pour un usage futur.
  • image depth— Spécifie la profondeur de couleurs de l'image, c'est-à-dire le nombre de bits à utiliser pour décrire la couleur de chaque pixel de l'image. Les valeurs valides comprennent 1, 4, 8et 24 bits par pixel. profondeur d'image affecte la façon dont LabVIEW interprète les valeurs d' image et de couleurs.
  • image— Tableau d'octets qui décrit la couleur de chaque pixel de l'image dans l'ordre des trames. La valeur de prof. d'image détermine comment LabVIEW interprète la valeur de cette sortie.

    Si prof. d'image est 24, chaque pixel a trois octets pour décrire sa couleur. Pour chaque pixel, le premier octet décrit la couleur rouge, le second octet la couleur verte et le troisième octet la couleur bleue.

    Si prof. d'image est 8, chaque pixel a un octet pour décrire sa couleur. La valeur de chaque bit correspond à un élément de couleurs, qui contient les valeurs RGB 32 bits où l'octet de poids fort est 0, suivi dans l'ordre par les valeurs de rouge, de vert et de bleu.

    Si prof. d'image est 4, le comportement est le même que si prof. d’image est 8, sauf que les valeurs valides pour image vont alors de 0 à 15 inclus.

    Si prof. d'image est 1, toute valeur de 0 dans image correspond à l'élément 0 dans couleurs. Toute autre valeur correspond à l'élément 1 dans couleurs.

    La taille du tableau pourrait être plus grande que celle attendue à cause du comblement par des zéros.

  • masque— Tableau d'octets dans lequel chaque bit décrit les informations de masque pour un pixel. Le premier octet décrit les huit premiers pixels, le second octet décrit les huit pixels suivants, et ainsi de suite. Si un bit est égal à zéro, LabVIEW trace le pixel correspondant comme étant transparent. Si le tableau est vide, LabVIEW trace tous les pixels sans en rendre aucun transparent. Si le tableau ne contient pas de bit pour chaque pixel de l'image, LabVIEW trace les pixels manquants du tableau sans qu'aucun ne soit transparent.
  • couleurs— Tableau de valeurs de couleurs RGB qui correspondent aux valeurs de l' image. La valeur de prof. d'image détermine comment LabVIEW interprète la valeur de cette sortie. Si prof. d'image est 24, cette sortie n'est pas prise en compte par LabVIEW. Si prof. d'image est 8, le tableau a 256 éléments. Si prof. d'image est 4, le tableau a 16 éléments. Si prof. d'image est 1, le tableau a 2 éléments.
  • Rectangle—Cluster qui contient les coordonnées décrivant le rectangle délimitant l'image, où le coin supérieur gauche est à (0,0). L'angle inférieur droit des limites n'inclut pas l'image.
maxwidthmot longSpécifie l'épaisseur de l'image renvoyée. Si cette entrée est de 0, l'épaisseur de l'image renvoyée est la même que celle de l'image par défaut lorsqu'elle est affichée dans la fenêtre Hiérarchie du VI de LabVIEW. De plus, LabVIEW ne peut pas déformer l'image renvoyée si les paramètres Largeur maximum et Hauteur maximum spécifiés ne conservent pas le même ratio que celui de l'image par défaut.
maxheightmot longSpécifie la hauteur de l'image renvoyée. Si cette entrée est de 0, la hauteur de l'image renvoyée est la même que celle de l'image par défaut lorsqu'elle est affichée dans la fenêtre Hiérarchie du VI de LabVIEW. De plus, LabVIEW ne peut pas déformer l'image renvoyée si les paramètres Largeur maximum et Hauteur maximum spécifiés ne conservent pas le même ratio que celui de l'image par défaut.
VIToHighlightvariantIndique le VI à sélectionner dans l'image de hiérarchie. En plus d'entourer le VI spécifié d'une bordure pourpre, LabVIEW développe ou réduit la hiérarchie pour se concentrer sur le VI.

Valeur renvoyée

aucun