read_regionread_regionReadRegionReadRegionread_region (Operator)

Name

read_regionread_regionReadRegionReadRegionread_region — Einlesen von Binärbildern oder HALCON-Regionen.

Signatur

Beschreibung

read_regionread_regionReadRegionReadRegionReadRegionread_region liest Regionen aus einer Binärdatei.

Folgende Datei-Formate werden unterstützt:

HALCON Iconic Object (HOBJ):

Dateiformat von HALCON zum Speichern von ikonischen Objekten. Die HOBJ-Datei darf ausschließlich Regionen enthalten um für read_regionread_regionReadRegionReadRegionReadRegionread_region lesbar zu sein. Falls andere Objekte (z.B. Bilder oder XLDs) enthalten sind, wird ein Fehler erzeugt. In diesem Fall kann die Datei mit read_objectread_objectReadObjectReadObjectReadObjectread_object gelesen werden. Das HOBJ-Format ist das Standardformat für Regionen. Daher muss die Extension '.hobj' beim Schreiben und Lesen nicht angegeben werden. Die Beschreibung des Operators write_objectwrite_objectWriteObjectWriteObjectWriteObjectwrite_object enthält weitere Informationen über das HOBJ-Format.

HALCON-Regionen:

Dateiformat von HALCON zum Speichern von Regionen. In diesem Format können auch mehrere Regionen mit write_regionwrite_regionWriteRegionWriteRegionWriteRegionwrite_region bzw. read_regionread_regionReadRegionReadRegionReadRegionread_region gleichzeitig (in einer Datei) gespeichert bzw. gelesen werden. Alle Regionendateien haben die Extension '.reg'. Dieses Dateiformat wird nur noch aus Kompatibilitätsgründen weiter unterstützt. Stattdessen sollte das HOBJ-Format verwendet werden.

Tiff:

Binäre Tiff-Bilder mit der Extension '.tiff' oder '.tif'. Eine Tiffdatei kann dabei beliebig viele Regionen enthalten. Die Farbe Weiß wird als Vordergrund interpretiert.

PNG:

PNG-Format mit der Extension '.png'. Man erhält immer eine Region. Die Farbe Weiß wird als Vordergrund interpretiert.

BMP:

Windows Bitmap-Format mit der Extension '.bmp'. Man erhält immer eine Region. Die Farbe Weiß wird als Vordergrund interpretiert.

Analog zu read_imageread_imageReadImageReadImageReadImageread_image kann ein Suchpfad (read_image{'image_dir'}) definiert werden.

Achtung

Das Clipping am aktuellen Bildformat wird durch set_system('clip_region',<'true'/'false'>)set_system("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)set_system("clip_region",<"true"/"false">) festgelegt. Falls also vor dem Aufruf von read_regionread_regionReadRegionReadRegionReadRegionread_region noch kein Bild hinreichender Größe erzeugt worden ist, sollte set_system('clip_region','false')set_system("clip_region","false")SetSystem("clip_region","false")SetSystem("clip_region","false")SetSystem("clip_region","false")set_system("clip_region","false") vor read_regionread_regionReadRegionReadRegionReadRegionread_region aufgerufen werden, um sicherzustellen, dass die Region nicht geclippt wird.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

* Reading of regions and giving them gray values.
  read_image(Img,'ima_test')
  read_region(Regs,'reg_test')
  reduce_domain(Img,Regs,Res)

/* Reading of regions and giving them gray values. */
  read_image(&Img,"ima_test");
  read_region(&Regs,"reg_test");
  reduce_domain(Img,Regs,&Res);

* Reading of regions and giving them gray values.
  read_image(Img,'ima_test')
  read_region(Regs,'reg_test')
  reduce_domain(Img,Regs,Res)

* Reading of regions and giving them gray values.
  read_image(Img,'ima_test')
  read_region(Regs,'reg_test')
  reduce_domain(Img,Regs,Res)

* Reading of regions and giving them gray values.
  read_image(Img,'ima_test')
  read_region(Regs,'reg_test')
  reduce_domain(Img,Regs,Res)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert read_regionread_regionReadRegionReadRegionReadRegionread_region den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_imageread_imageReadImageReadImageReadImageread_image

Nachfolger

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

Siehe auch

write_regionwrite_regionWriteRegionWriteRegionWriteRegionwrite_region, read_imageread_imageReadImageReadImageReadImageread_image, write_objectwrite_objectWriteObjectWriteObjectWriteObjectwrite_object

Modul

Foundation