read_regionread_regionReadRegionread_regionReadRegionReadRegion (Operator)

Name

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

Signatur

Beschreibung

read_regionread_regionReadRegionread_regionReadRegionReadRegion liest Regionen aus einer Binärdatei. Die Daten sind in gepackter Form abgespeichert. Aus den eingelesenen Daten wird je nach Format eine oder mehrere Regionen erzeugt. Folgende Binärformate werden unterstützt:

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.

HALCON Regionen:

Dateiformat von HALCON zum Speichern von Regionen. Hiermit können auch mehrere Regionen mit write_regionwrite_regionWriteRegionwrite_regionWriteRegionWriteRegion und read_regionread_regionReadRegionread_regionReadRegionReadRegion gleichzeitig (in einer Datei) gespeichert bzw. gelesen werden. Alle Regionendateien haben die Extension '.reg'. Diese wird beim Lesen und Schreiben der Datei nicht angegeben.

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

Modul

Foundation