Images : acquisition, chargement, enregistrement

Famille « Image et prétraitement » : ce que fait chaque outil, ses paramètres (D à O) et ses résultats (P à Y).

25 outils

Acquisition par la caméra choisie dans le paramétrage (Basler, IDS, simulation…), chargement et enregistrement de fichiers image. L'enregistrement (IMAW…, paramètre M) se fait au choix en BMP / JPEG / PNG (ancienne méthode), en JPEG rapide, en JPEG-LS ou HTJ2K sans perte, en AVIF, ou en vidéo AV1 (la date de chaque image rangée dans le fichier, encodage par la carte graphique quand elle le permet) ; date, heure et caméra sont gardées dans les métadonnées des JPEG, JPEG-LS et PNG. IMAR relit une image de vidéo par sa date-heure ou son numéro (« fichier.avif|n ») ; la fenêtre des vidéos (WINAVIF, menu de la grille, clic droit sur « Ouvrir... » de la simulation) montre les images d'une vidéo en vignettes datées et en enregistre en PNG, JPG ou BMP. Résultats « plan » : Q largeur, R hauteur, T hauteur, U n° du plan, V type. Les noms de fichiers viennent du commentaire : relatifs au dossier des images (ou au dossier du programme s'ils commencent par « . »).

IMAA

Acquisition Caméra

Acquisition d'une image dans les plans D, E, F (rouge, vert, bleu ; par défaut 1, 2, 3) ; G > 1 = moyenne de G acquisitions.

Paramètres

D: Plan rouge (ou mono)
E: Plan vert
F: Plan bleu
G: Nombre d'acquisitions moyennées

Résultats

P: Numéro Plan Actif
Q: Largeur de l'image
R: Hauteur de l'image
S: Pointeur mémoire
T: Hauteur de l'image
U: Numéro Plan Actif
V: Type du plan
W: N° Erreur Acquisition
X: Taille de plan Maximum
Y: Nombre max de plans

P = 1 si l'image est acquise, 0 sinon (W = n° d'erreur), négatif = erreur de la carte d'acquisition ; W = compteur de trames (Basler). En version de démonstration, rien n'est acquis (P = 0).

IMAX

Réglage Acquisition

Réglages de la caméra : G = temps d'intégration (µs), H = contraste, I = jeu de réglages (UserSet) de −127 à 127.

Paramètres

G: Temps d'intégration (en μs)
H: Contraste
I: Jeu de réglages caméra (UserSet)

P = 0 si un des réglages échoue.

IMAS

Capture Ecran

Capture d'écran de la zone D,E - G,H (pixels de l'écran) dans le plan 1 (ou celui de PLADEST) ; le plan courant devient 0.

Paramètres

D: X1
E: Y1
G: X2
H: Y2

Résultats

P: Numéro Plan Actif
Q: Largeur de l'image
R: Hauteur de l'image
S: Pointeur mémoire
T: Hauteur de l'image
U: N° du plan de capture
V: Type du plan
W: N° Erreur Acquisition
X: Taille de plan Maximum
Y: Nombre max de plans

IMAF

Affichage Image

Affiche l'image (plan courant ou image couleur) ; publie aussi l'image sur le serveur web d'images s'il est actif.

Paramètres

Aucun paramètre.

Résultats

P: Opération Réussie si =1
Q: Q 0
R: R 0
S: S 0
T: T 0
U: U 0
V: V 0
W: W 0
X: X 0
Y: Y 0

IMASP

Capture Ecran Repère

Capture d'écran de la zone D,E - G,H donnée en repère pièce sur l'image affichée (convertie en position écran).

Paramètres

D: X1
E: Y1
G: X2
H: Y2

Résultats

P: Numéro Plan Actif
Q: Largeur de l'image
R: Hauteur de l'image
S: Pointeur mémoire
T: Hauteur de l'image
U: Numéro Plan Actif
V: Type du plan
W: N° Erreur Acquisition
X: Taille de plan Maximum
Y: Nombre max de plans

Paramètres et résultats communs à IMAPM, IMAPR

Résultats

P: Numéro Plan Actif
Q: Largeur de l'image
R: Hauteur de l'image
S: Pointeur mémoire
T: Hauteur de l'image
U: Numéro Plan Actif
V: Type du plan
W: N° Erreur Acquisition
X: Taille de plan Maximum
Y: Nombre max de plans

IMAPM

Modification Structure Plan

Modifie la structure du plan courant (largeur D, hauteur E, adresse mémoire F, n° H, type I), l'ancienne étant gardée dans l'emplacement J ; repère remis à zéro.

IMAPR

Restaure Structure Plan

Restaure la structure de plan et le repère gardés dans l'emplacement D par IMAPM.

IMAXT

Réglage Temps Exposition

Temps d'exposition = D (µs).

Paramètres

D: Valeur

Résultats

P: Opération Réussie si =1
Q: Q 0
R: R 0
S: S 0
T: T 0
U: U 0
V: V 0
W: W 0
X: X 0
Y: Y 0

Paramètres et résultats communs à IMAXGD, IMAXU, IMAXGA

Paramètres

D: Valeur Maximum

Résultats

P: Opération Réussie si =1
Q: Q 0
R: R 0
S: S 0
T: T 0
U: U 0
V: V 0
W: W 0
X: X 0
Y: Y 0

IMAXGD

Réglage GainDigital

Gain numérique = D.

IMAXU

Charge Userset

Charge le jeu de réglages (UserSet) n° D de la caméra.

IMAXGA

Réglage GainAnalog

Gain analogique = D.

IMAXTM

Mode de déclenchement

Mode de déclenchement D.

Paramètres

D: Mode de Trigger

Résultats

P: Opération Réussie si =1
Q: Q 0
R: R 0
S: S 0
T: T 0
U: U 0
V: V 0
W: W 0
X: X 0
Y: Y 0

IMAXST

SoftwareTrigger

Envoie un déclenchement logiciel (software trigger).

Paramètres

Aucun paramètre.

Résultats

P: Opération Réussie si =1
Q: Q 0
R: R 0
S: S 0
T: T 0
U: U 0
V: V 0
W: W 0
X: X 0
Y: Y 0

IMAXTS

Trigger mode et source

Mode de déclenchement D et source G.

Paramètres

D: Mode de Trigger
G: Trigger Source

Résultats

P: Opération Réussie si =1
Q: Q 0
R: R 0
S: S 0
T: T 0
U: U 0
V: V 0
W: W 0
X: X 0
Y: Y 0

IMAIO

I/O caméra Basler

Lit les entrées de la caméra (Basler) : Q, R, S = entrées 1 à 3, T = codeur.

Paramètres

Aucun paramètre.

Résultats

P: Opération Réussie si =1
Q: Q 0
R: R 0
S: S 0
T: T 0
U: U 0
V: V 0
W: W 0
X: X 0
Y: Y 0

IMACH

Choix Caméra

Choisit la caméra n° D (à partir de 1) ; Q = caméra en service, W = erreur, Y = 3333 en démonstration / simulation.

Paramètres

D: Numéro de Caméra (Commence à 1)

Résultats

Q: Numéro Source (Commence à 1)
W: Acquis.ErreurCarteAcquisition
Y: Si Acquisition en DEMO alors vaut 3333

Paramètres et résultats communs à IMAXGF, IMAXSF, IMAXSFV

Résultats

P: Opération Réussie si =1
Q: Q 0
R: R 0
S: S 0
T: T 0
U: U 0
V: V 0
W: W 0
X: X 0
Y: Y 0

IMAXGF

Lire une feature

Lit la propriété GenICam nommée dans le commentaire : Q = valeur (R = 1 si numérique), sinon T = chiffres extraits (U = 1) ; texte dans la chaîne globale D.

IMAXSF

Écrire une feature

Écrit la propriété GenICam du commentaire avec le texte de la chaîne globale D, puis la relit (Q, T = 1).

IMAXSFV

Écrire la valeur d'une feature

Écrit la propriété GenICam du commentaire avec la valeur numérique D, puis la relit.

IMAXMOD

Change _acq

Change de carte d'acquisition pendant le cycle : D = type, commentaire = configuration, G, H = lignes / colonnes des caméras.

Paramètres

D: Type de carte d'acquisition
G: Nombre de lignes de caméras
H: Nombre de colonnes de caméras

Résultats

P: Opération Réussie si =1
Q: Q 0
R: R 0
S: S 0
T: T 0
U: U 0
V: V 0
W: W 0
X: X 0
Y: Y 0

Paramètres et résultats communs à IMAW, IMAWF

Paramètres

C: Nom du Fichier Image
D: Fait l'enregistrement si =1
F: Encodeur (modes 4, 5)
I: Caméra (chaîne globale)
J: Couleur si < 0
K: Date-heure de l'image
L: Qualité
M: Méthode (0 à 5)
N: Erreur maxi / images
O: Vitesse AVIF / vidéo

Résultats

P: 1 si enregistré
Q: Octets écrits (vidéo : n° de l'image dans son fichier)
R: Durée en ms (vidéo : images en attente)
S: 1 si la carte graphique a encodé

IMAW

Enregistrement Image

Enregistre le plan courant (J < 0 ou plan 0 : l'image couleur, plans R, V, B) dans le fichier du commentaire (.bmp par défaut), seulement si le mode enregistrement des images est actif (Ctrl+I, ou /I en ligne de commande) et D > 0. M = méthode : 0 (ou vide) ancienne méthode d'après l'extension (.bmp, .jpg, .png, L = qualité JPEG) ; 1 JPEG libjpeg-turbo (.jpg, environ 5 fois plus rapide, une image grise reste sur une composante ; L = qualité, 0 = 90) ; 2 JPEG-LS (.jls ; N = erreur maxi par pixel, 0 = sans perte) ; 3 HTJ2K (.j2c, sans perte, le plus rapide des formats sans perte) ; 4 vidéo AV1 (fichiers « nom date.avif » de N images, 0 = 100, avec la date de chaque image dans un index rangé dans le fichier lui-même, lisibles par VLC ; L = qualité, 0 = 60 ; O = vitesse, 0 = 8 ; N = -1 termine le fichier en cours ; encodage dans un fil à part, fichier écrit à sa fin et à la fin du cycle) ; 5 AVIF image fixe (.avif ; L = qualité, 0 = 70 ; O = vitesse). Avec M > 0, l'extension du nom est remplacée et le dossier est créé s'il manque. F (modes 4 et 5) = encodeur : 0 = carte graphique si elle accepte la taille (AV1 matériel par Media Foundation : NVIDIA RTX 40 et suivantes, Intel Arc / Core Ultra, AMD RX 7000 et suivantes ; largeur et hauteur paires, jusqu'à 8192), sinon processeur ; 1 = processeur ; 2 = carte seulement (échec sinon) ; même qualité L dans les deux cas. K = date-heure de l'image (jours, comme le P de TIMNOW ; 0 = maintenant) et I = n° de la chaîne globale du nom de la caméra : rangés dans les métadonnées des JPEG (M = 0 ou 1) et JPEG-LS (Exif : prise de vue, modèle d'appareil photo) et des PNG de l'ancienne méthode (Exif, et XMP lu par l'Explorateur de Windows), relus par IMAR (L, M) ; BMP, HTJ2K et AVIF fixe n'en ont pas, une vidéo garde les dates de ses images dans son index.

Avec M > 0 : Q = octets écrits (vidéo : n° de l'image dans son fichier), R = durée en ms (vidéo : images en attente d'encodage), S = 1 si la carte graphique a encodé ; en cas d'échec, P = 0 et le message s'affiche dans la case P.
Carte graphique (F = 0 ou 2) : la première image d'une taille prend environ 0,7 s, puis quelques ms par image ; à qualité égale, la vidéo est environ 40 % plus petite qu'en encodage par le processeur.

IMAWF

Enregistrement Image Force

Comme IMAW, mais enregistre toujours (mode Ctrl+I non requis), si D > 0. Mêmes méthodes M (JPEG rapide, JPEG-LS, HTJ2K, vidéo AV1, AVIF), même choix de l'encodeur F, même date K et caméra I.

Avec M > 0 : Q = octets écrits (vidéo : n° de l'image dans son fichier), R = durée en ms (vidéo : images en attente d'encodage), S = 1 si la carte graphique a encodé ; en cas d'échec, P = 0 et le message s'affiche dans la case P.

Paramètres et résultats communs à IMAWP, IMAWPF

Paramètres

C: Nom du Fichier Image
D: X1
E: Y1
F: Encodeur (4, 5)
G: X2
H: Y2
I: Caméra (chaîne)
J: Couleur si < 0
K: Date-heure
L: Qualité
M: Méthode (0 à 5)
N: Erreur / images
O: Vitesse

Résultats

P: 1 si enregistré
Q: Octets écrits (vidéo : n° de l'image dans son fichier)
R: Durée en ms (vidéo : images en attente)
S: 1 si la carte graphique a encodé

IMAWP

Enregistrement Portion Image

Enregistre la zone D,E - G,H du plan courant (en mode Ctrl+I) ; J < 0 : l'image couleur. Mêmes méthodes M qu'IMAW : 0 ancienne, 1 JPEG libjpeg-turbo, 2 JPEG-LS (N = erreur maxi), 3 HTJ2K, 4 vidéo AV1 (N images par fichier, -1 = terminer), 5 AVIF ; F = encodeur (0 carte graphique si possible, 1 processeur, 2 carte seulement), K = date-heure de l'image, I = chaîne de la caméra.

Avec M > 0 : Q = octets écrits (vidéo : n° de l'image dans son fichier), R = durée en ms (vidéo : images en attente d'encodage), S = 1 si la carte graphique a encodé ; en cas d'échec, P = 0 et le message s'affiche dans la case P.

IMAWPF

Enregistrement Portion Image Force

Enregistre la zone D,E - G,H du plan courant, toujours (mode Ctrl+I non requis). Mêmes méthodes M, encodeur F, date K et caméra I qu'IMAW.

Avec M > 0 : Q = octets écrits (vidéo : n° de l'image dans son fichier), R = durée en ms (vidéo : images en attente d'encodage), S = 1 si la carte graphique a encodé ; en cas d'échec, P = 0 et le message s'affiche dans la case P.

IMAR

Chargement Image

Charge l'image du commentaire : image grise dans le plan G (0 = plan actif), image couleur avec le bleu dans G, le vert dans H et le rouge dans I si les trois sont > 0 (sinon rouge, vert, bleu dans les plans 1, 2, 3) ; D > 0 = nom du fichier chargé dans la chaîne globale D ; J = 1 = propose de choisir le fichier s'il n'existe pas. Lit aussi .jls (JPEG-LS), .j2c (HTJ2K) et .avif (1re image d'une vidéo). Image d'une vidéo enregistrée par IMAW M = 4 : nom = celui donné à IMAW (ou un .avif précis), puis E = date-heure (jours, comme le P de TIMNOW) ou F = n° de la chaîne globale qui contient la date en texte (aaaa-mm-jj hh:mm:ss.zzz, jj/mm/aaaa…) : l'image la plus proche ; sinon K = n° de l'image dans toute la vidéo (1 = première, plusieurs fichiers dans l'ordre de leur nom). Le nom peut aussi désigner une image précise d'une vidéo : « fichier.avif|n » (n à partir de 1), notation rendue par la simulation d'acquisition, par WINAVIF et par la fenêtre des vidéos. L / M = n° des chaînes globales qui reçoivent la date-heure (aaaa-mm-jj hh:mm:ss.zzz) et le nom de la caméra lus dans l'image (Exif d'un JPEG ou d'un JPEG-LS, PNG, index d'une vidéo) ; vides si l'image n'en a pas.

Paramètres

C: Nom du Fichier Image
D: ChaineGlobale NomImage
E: Date-heure vidéo
F: Chaîne de la date
G: Plan Monochrome / Plan Bleu
H: Plan Vert
I: Plan Rouge
J: Si 1 demande ouverture si fichier inexistant
K: N° d'image vidéo
L: Chaîne date lue
M: Chaîne caméra lue

Résultats

P: Chargement Réussi
Q: Largeur de l'image
R: Hauteur de l'image
S: Pointeur mémoire
T: Hauteur de l'image
U: Numéro Plan Actif
V: Type du plan
W: N° image vidéo
X: Taille de plan max
Y: Nombre max de plans

Plans de destination : une image en niveaux de gris va dans le plan G (0 = plan actif). Une image couleur met le bleu dans G, le vert dans H et le rouge dans I si les trois sont renseignés, sinon le rouge, le vert et le bleu dans les plans 1, 2 et 3. Un JPEG en niveaux de gris est lu comme une image couleur : G seul ne suffit pas.
Vidéo (IMAW M = 4) : D reçoit la date-heure de l'image lue, W son n° dans la vidéo ; un n° K au-delà de la fin donne P = 0 et un message dans la case P.
Commentaire AUTO = image suivante du dossier de la dernière image chargée ; DELETE = déplace la dernière image dans le dossier Delete<J> puis charge la suivante. P = 1 chargée, 0 sinon (« No Image » dans la chaîne D). Un IMAR remet aussi le repère à zéro.