read_regionread_regionReadRegionread_regionReadRegionReadRegion (Operator)

Name

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

Signatur

Beschreibung

read_regionread_regionReadRegionread_regionReadRegionReadRegion 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_regionReadRegionread_regionReadRegionReadRegion 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_objectReadObjectread_objectReadObjectReadObject gelesen werden. Das HOBJ-Format ist das Standardformat für Regionen. Daher muss die Extension '.hobj'".hobj"".hobj"".hobj"".hobj"".hobj" beim Schreiben und Lesen nicht angegeben werden. Die Beschreibung des Operators write_objectwrite_objectWriteObjectwrite_objectWriteObjectWriteObject 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_regionWriteRegionwrite_regionWriteRegionWriteRegion bzw. read_regionread_regionReadRegionread_regionReadRegionReadRegion gleichzeitig (in einer Datei) gespeichert bzw. gelesen werden. Alle Regionendateien haben die Extension '.reg'".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""tiff" oder 'tif'"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""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""bmp". Man erhält immer eine Region. Die Farbe Weiß wird als Vordergrund interpretiert.

Analog zu read_imageread_imageReadImageread_imageReadImageReadImage kann ein Suchpfad ('image_dir'"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">)set_system("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">)SetSystem("clip_region",<"true"/"false">) festgelegt. Falls also vor dem Aufruf von read_regionread_regionReadRegionread_regionReadRegionReadRegion noch kein Bild hinreichender Größe erzeugt worden ist, sollte set_system('clip_region','false')set_system("clip_region","false")SetSystem("clip_region","false")set_system("clip_region","false")SetSystem("clip_region","false")SetSystem("clip_region","false") vor read_regionread_regionReadRegionread_regionReadRegionReadRegion aufgerufen werden, um sicherzustellen, dass die Region nicht geclippt wird.

Parallelisierung

• 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)

* 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_regionReadRegionread_regionReadRegionReadRegion den Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_imageread_imageReadImageread_imageReadImageReadImage

Nachfolger

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion

Siehe auch

write_regionwrite_regionWriteRegionwrite_regionWriteRegionWriteRegion, read_imageread_imageReadImageread_imageReadImageReadImage, write_objectwrite_objectWriteObjectwrite_objectWriteObjectWriteObject

Modul

Foundation