read_regionread_regionReadRegionReadRegion (Operator)

Name

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

Signatur

Beschreibung

read_regionread_regionReadRegionReadRegionReadRegion liest Regionen aus einer Binärdatei.

Folgende Datei-Formate werden unterstützt:

HALCON Iconic Object (HOBJ) (HALCON 12.0 oder neuer):

Dateiformat von HALCON zum Speichern von ikonischen Objekten. Die HOBJ-Datei darf ausschließlich Regionen enthalten um für read_regionread_regionReadRegionReadRegionReadRegion 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_objectReadObjectReadObjectReadObject gelesen werden. Das HOBJ-Format ist das Standardformat für Regionen. Daher muss die Extension '.hobj'".hobj"".hobj"".hobj"".hobj" beim Schreiben und Lesen nicht angegeben werden. Die Beschreibung des Operators write_objectwrite_objectWriteObjectWriteObjectWriteObject 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_regionWriteRegionWriteRegionWriteRegion bzw. read_regionread_regionReadRegionReadRegionReadRegion gleichzeitig (in einer Datei) gespeichert bzw. gelesen werden. Alle Regionendateien haben die Extension '.reg'".reg"".reg"".reg"".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'"tiff""tiff""tiff""tiff" oder 'tif'"tif""tif""tif""tif". Eine Tiffdatei kann dabei beliebig viele Regionen enthalten. Die Farbe Weiß wird als Vordergrund interpretiert.

PNG:

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

BMP:

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

Analog zu read_imageread_imageReadImageReadImageReadImage kann ein Suchpfad ('image_dir'"image_dir""image_dir""image_dir""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">) festgelegt. Falls also vor dem Aufruf von read_regionread_regionReadRegionReadRegionReadRegion 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") vor read_regionread_regionReadRegionReadRegionReadRegion 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_regionReadRegionReadRegionReadRegion den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_imageread_imageReadImageReadImageReadImage

Nachfolger

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, disp_regiondisp_regionDispRegionDispRegionDispRegion

Siehe auch

write_regionwrite_regionWriteRegionWriteRegionWriteRegion, read_imageread_imageReadImageReadImageReadImage, write_objectwrite_objectWriteObjectWriteObjectWriteObject

Modul

Foundation