expand_grayexpand_grayExpandGrayExpandGrayexpand_gray (Operator)
Name
expand_grayexpand_grayExpandGrayExpandGrayexpand_gray — Auffüllen von „Lücken“ zwischen Regionen (abhängig vom Grau- oder Farbwert)
oder Trennen überlappender Regionen.
Signatur
Herror expand_gray(const Hobject Regions, const Hobject Image, const Hobject ForbiddenArea, Hobject* RegionExpand, const char* Iterations, const char* Mode, const Hlong Threshold)
Herror T_expand_gray(const Hobject Regions, const Hobject Image, const Hobject ForbiddenArea, Hobject* RegionExpand, const Htuple Iterations, const Htuple Mode, const Htuple Threshold)
void ExpandGray(const HObject& Regions, const HObject& Image, const HObject& ForbiddenArea, HObject* RegionExpand, const HTuple& Iterations, const HTuple& Mode, const HTuple& Threshold)
HRegion HImage::ExpandGray(const HRegion& Regions, const HRegion& ForbiddenArea, const HTuple& Iterations, const HString& Mode, const HTuple& Threshold) const
HRegion HImage::ExpandGray(const HRegion& Regions, const HRegion& ForbiddenArea, const HString& Iterations, const HString& Mode, Hlong Threshold) const
HRegion HImage::ExpandGray(const HRegion& Regions, const HRegion& ForbiddenArea, const char* Iterations, const char* Mode, Hlong Threshold) const
HRegion HImage::ExpandGray(const HRegion& Regions, const HRegion& ForbiddenArea, const wchar_t* Iterations, const wchar_t* Mode, Hlong Threshold) const
(Nur Windows)
HRegion HRegion::ExpandGray(const HImage& Image, const HRegion& ForbiddenArea, const HTuple& Iterations, const HString& Mode, const HTuple& Threshold) const
HRegion HRegion::ExpandGray(const HImage& Image, const HRegion& ForbiddenArea, const HString& Iterations, const HString& Mode, Hlong Threshold) const
HRegion HRegion::ExpandGray(const HImage& Image, const HRegion& ForbiddenArea, const char* Iterations, const char* Mode, Hlong Threshold) const
HRegion HRegion::ExpandGray(const HImage& Image, const HRegion& ForbiddenArea, const wchar_t* Iterations, const wchar_t* Mode, Hlong Threshold) const
(Nur Windows)
static void HOperatorSet.ExpandGray(HObject regions, HObject image, HObject forbiddenArea, out HObject regionExpand, HTuple iterations, HTuple mode, HTuple threshold)
HRegion HImage.ExpandGray(HRegion regions, HRegion forbiddenArea, HTuple iterations, string mode, HTuple threshold)
HRegion HImage.ExpandGray(HRegion regions, HRegion forbiddenArea, string iterations, string mode, int threshold)
HRegion HRegion.ExpandGray(HImage image, HRegion forbiddenArea, HTuple iterations, string mode, HTuple threshold)
HRegion HRegion.ExpandGray(HImage image, HRegion forbiddenArea, string iterations, string mode, int threshold)
Beschreibung
expand_grayexpand_grayExpandGrayExpandGrayExpandGrayexpand_gray dient dazu, Lücken zwischen den Regionen
der Eingabebilder, wie sie z.B. durch Unterdrückung zu kleiner
Regionen nach einer Bildsegmentierung entstehen, zu schließen (Modus
'image'"image""image""image""image""image") oder überlappende Regionen zu trennen (Modus
'region'"region""region""region""region""region"). Beide Effekte beruhen auf der Expansion von
Regionen. Dabei wird bei jeder Iteration der Expansion die
Bildpunkte innerhalb eines 1-Punkt breiten Streifens um die
Region zu dieser hinzugefügt, deren Grau- bzw. Farbwerte sich von
den Werten der benachbarten Randpunkte der Region um höchstens
ThresholdThresholdThresholdThresholdthresholdthreshold (je Kanal) unterscheiden. Bei Bildern vom Typ
'cyclic'"cyclic""cyclic""cyclic""cyclic""cyclic" (z.B. Richtungsbilder) werden auch Bildpunkte mit
einer Grauwertdifferenz von mindestens 255 - ThresholdThresholdThresholdThresholdthresholdthreshold
zur Region hinzugenommen.
Expandiert wird dabei nur in Bildbereiche, die nicht als „verbotene
Bereiche“ (Parameter ForbiddenAreaForbiddenAreaForbiddenAreaForbiddenAreaforbiddenAreaforbidden_area) ausgewiesen sind.
Die Zahl der Iterationen wird mit dem Parameter
IterationsIterationsIterationsIterationsiterationsiterations festgelegt. Die Übergabe des strings
'maximal'"maximal""maximal""maximal""maximal""maximal" veranlasst bei expand_grayexpand_grayExpandGrayExpandGrayExpandGrayexpand_gray, das
Verfahren so lange zu iterieren, bis es konvergiert, also keine
Änderungen mehr auftreten. Eine 0 auf dieser Parameterposition
bewirkt die Elimination der überlappenden Bildbereiche der
Eingaberegionen. Im Detail unterscheiden sich die beiden Modi
'image'"image""image""image""image""image" und 'region'"region""region""region""region""region" wie folgt:
- 'image'"image""image""image""image""image"
Die Eingaberegionen werden iterativ so lange ausgedehnt,
bis sie eine andere Region oder einen Bildrand berühren
(bzw. das Wachstum aufgrund zu hoher Grauwertdifferenzen
zum Stillstand kommt). Da expand_gray_refexpand_gray_refExpandGrayRefExpandGrayRefExpandGrayRefexpand_gray_ref alle
Regionen simultan bearbeitet, werden die „Lücken“
zwischen den Regionen „gerecht“ auf Regionen mit
ähnlichem Grau- oder Farbwert verteilt. Überlappende
Regionen werden getrennt, indem ihre gemeinsamen
Teilregionen (wiederum „gerecht“) auf sie verteilt
werden.
- 'region'"region""region""region""region""region"
Es wird keine Expansion der Eingaberegionen durchgeführt,
sondern es werden nur überlappende Bildregionen getrennt,
indem die gemeinsamen Teilregionen „gerecht“ auf die
bzgl. Grau- bzw. Farbwert passende Regionen aufgeteilt
werden.
Achtung
Da Regionen nur in Bereiche mit passenden Grau- bzw. Farbwerten
expandiert werden, bleiben im allgemeinen Lücken zwischen den
Ausgaberegionen bestehen. Die Segmentierung der Bildebene ist also
nicht total.
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
RegionsRegionsRegionsRegionsregionsregions (input_object) region(-array) → objectHRegionHObjectHRegionHobject
Regionen, zwischen denen Lücken geschlossen oder die
getrennt werden sollen.
ImageImageImageImageimageimage (input_object) (multichannel-)image → objectHImageHObjectHImageHobject (byte / cyclic)
Bild (evtl. mehrkanalig) für Graustufen- bzw.
Farbtest.
ForbiddenAreaForbiddenAreaForbiddenAreaForbiddenAreaforbiddenAreaforbidden_area (input_object) region → objectHRegionHObjectHRegionHobject
In diesen Bereich darf nicht expandiert werden.
RegionExpandRegionExpandRegionExpandRegionExpandregionExpandregion_expand (output_object) region(-array) → objectHRegionHObjectHRegionHobject *
Expandierte oder getrennte Regionen.
IterationsIterationsIterationsIterationsiterationsiterations (input_control) string → HTupleUnion[int, str]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Zahl der Iterationen.
Defaultwert:
'maximal'
"maximal"
"maximal"
"maximal"
"maximal"
"maximal"
Wertevorschläge: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 'maximal'"maximal""maximal""maximal""maximal""maximal"
Typischer Wertebereich: 1
≤
Iterations
Iterations
Iterations
Iterations
iterations
iterations
≤
500 (lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 1
ModeModeModeModemodemode (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Gewünschter Modus.
Defaultwert:
'image'
"image"
"image"
"image"
"image"
"image"
Werteliste: 'image'"image""image""image""image""image", 'region'"region""region""region""region""region"
ThresholdThresholdThresholdThresholdthresholdthreshold (input_control) integer(-array) → HTupleMaybeSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Maximalabweichung zwischen Randpixeln und Kandidaten
für die Expansion.
Defaultwert: 32
Wertevorschläge: 5, 10, 15, 20, 25, 30, 40, 50
Typischer Wertebereich: 1
≤
Threshold
Threshold
Threshold
Threshold
threshold
threshold
≤
255 (lin)
Minimale Schrittweite: 1
Empfohlene Schrittweite: 5
Beispiel (C++)
#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;
int main (int argc, char *argv[])
{
HImage image (argv[1]);
HRegion empty_region;
HWindow win;
image.Display (win);
HRegionArray seg = (image >= 100).Connection ();
seg.Display (win);
HRegionArray exp = seg.ExpandGray1 (image, empty_region,
"maximal", "image", 32);
win.SetDraw ("margin");
win.SetColored (12);
exp.Display (win);
win.Click ();
return (0);
}
Beispiel (C)
read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
regiongrowing(Image,&RawSegments,3,3,6.0,100);
set_colored(WindowHandle,12);
disp_region(RawSegments,WindowHandle);
expand_gray(RawSegments,Image,EMPTY_REGION,&Segments,"maximal","image",24);
disp_region(Segments,WindowHandle)
Beispiel (C++)
#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;
int main (int argc, char *argv[])
{
HImage image (argv[1]);
HRegion empty_region;
HWindow win;
image.Display (win);
HRegionArray seg = (image >= 100).Connection ();
seg.Display (win);
HRegionArray exp = seg.ExpandGray1 (image, empty_region,
"maximal", "image", 32);
win.SetDraw ("margin");
win.SetColored (12);
exp.Display (win);
win.Click ();
return (0);
}
Beispiel (C++)
#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;
int main (int argc, char *argv[])
{
HImage image (argv[1]);
HRegion empty_region;
HWindow win;
image.Display (win);
HRegionArray seg = (image >= 100).Connection ();
seg.Display (win);
HRegionArray exp = seg.ExpandGray1 (image, empty_region,
"maximal", "image", 32);
win.SetDraw ("margin");
win.SetColored (12);
exp.Display (win);
win.Click ();
return (0);
}
Beispiel (C++)
#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;
int main (int argc, char *argv[])
{
HImage image (argv[1]);
HRegion empty_region;
HWindow win;
image.Display (win);
HRegionArray seg = (image >= 100).Connection ();
seg.Display (win);
HRegionArray exp = seg.ExpandGray1 (image, empty_region,
"maximal", "image", 32);
win.SetDraw ("margin");
win.SetColored (12);
exp.Display (win);
win.Click ();
return (0);
}
Ergebnis
expand_grayexpand_grayExpandGrayExpandGrayExpandGrayexpand_gray liefert normalerweise den Wert 2 (H_MSG_TRUE).
Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden)
lässt sich mittels
set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>), das bei
leerer Region mit
set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>), und das
bei leerer Ergebnisregion mit
set_system('store_empty_region',<'true'/'false'>)set_system("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)SetSystem("store_empty_region",<"true"/"false">)set_system("store_empty_region",<"true"/"false">)
festlegen. Gegebenenfalls wird eine Fehlerbehandlung
durchgeführt.
Vorgänger
connectionconnectionConnectionConnectionConnectionconnection,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing,
pouringpouringPouringPouringPouringpouring,
class_ndim_normclass_ndim_normClassNdimNormClassNdimNormClassNdimNormclass_ndim_norm
Nachfolger
select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape
Siehe auch
expand_gray_refexpand_gray_refExpandGrayRefExpandGrayRefExpandGrayRefexpand_gray_ref,
expand_regionexpand_regionExpandRegionExpandRegionExpandRegionexpand_region
Modul
Foundation