get_structured_light_objectT_get_structured_light_objectGetStructuredLightObjectGetStructuredLightObject (Operator)

Name

get_structured_light_objectT_get_structured_light_objectGetStructuredLightObjectGetStructuredLightObject — Ikonische (Zwischen-)Ergebnisse vom Modell für strukturiertes Licht abfragen.

Signatur

get_structured_light_object( : Object : StructuredLightModel, ObjectName : )

Herror T_get_structured_light_object(Hobject* Object, const Htuple StructuredLightModel, const Htuple ObjectName)

void GetStructuredLightObject(HObject* Object, const HTuple& StructuredLightModel, const HTuple& ObjectName)

HObject HStructuredLightModel::GetStructuredLightObject(const HTuple& ObjectName) const

HObject HStructuredLightModel::GetStructuredLightObject(const HString& ObjectName) const

HObject HStructuredLightModel::GetStructuredLightObject(const char* ObjectName) const

HObject HStructuredLightModel::GetStructuredLightObject(const wchar_t* ObjectName) const   (Nur Windows)

static void HOperatorSet.GetStructuredLightObject(out HObject objectVal, HTuple structuredLightModel, HTuple objectName)

HObject HStructuredLightModel.GetStructuredLightObject(HTuple objectName)

HObject HStructuredLightModel.GetStructuredLightObject(string objectName)

Beschreibung

Der Operator get_structured_light_objectget_structured_light_objectGetStructuredLightObjectGetStructuredLightObjectGetStructuredLightObject greift auf ikonische (Zwischen-)Ergebnisse eines Modells für strukturiertes Licht zu, das bereits mit decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPattern dekodiert wurde.

Einerseits kann man so die Ergebnisse des Dekodiervorgangs ('correspondence_image'"correspondence_image""correspondence_image""correspondence_image""correspondence_image") abfragen, sowie das weiterverarbeitete Defektbild ('defect_image'"defect_image""defect_image""defect_image""defect_image"). Andererseits ist get_structured_light_objectget_structured_light_objectGetStructuredLightObjectGetStructuredLightObjectGetStructuredLightObject auch hilfreich bei einer Problembehandlung des Dekodiervorgangs. Zu beachten ist, dass Zwischenergebnisse nur aus dem StructuredLightModelStructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModel abgefragt werden können, wenn der 'persistence'"persistence""persistence""persistence""persistence"-Modus des Modells vor dem Dekodieren mit set_structured_light_model_paramset_structured_light_model_paramSetStructuredLightModelParamSetStructuredLightModelParamSetStructuredLightModelParam eingeschaltet wurde.

Verfügbare Objekte ohne persistence-Modus:

'correspondence_image'"correspondence_image""correspondence_image""correspondence_image""correspondence_image":

Diese Bilder beschreiben die Pixelkorrespondenzen zwischen Monitor und Kamera. Bei Dekodieren in vertikaler und horizontaler Richtung werden beide Korrespondenzbilder konkateniert zurückgegeben. Ansonsten wird nur das Bild der jeweiligen Richtung zurückgegeben.

'pattern_region'"pattern_region""pattern_region""pattern_region""pattern_region":

In dieser Region wurden die Kamerabilder dekodiert. Diese Region ist identisch zum Definitionsbereich der Korrespondenzbilder.

'defect_image'"defect_image""defect_image""defect_image""defect_image":

Dieses Bild beschreibt mögliche Defekte der Oberfläche, die die projizierten Muster zur Kamera reflektiert. Prinzipiell weisen hohe Grauwerte im Defektbild darauf hin, dass die Gradienten der Korrespondenzbilder signifikant von den Gradienten in ihrer Nachbarschaft abweichen.

Nur im persistence-Modus verfügbare Objekte:

Bei Dekodieren in vertikaler und horizontaler Richtung werden Bilder beider Richtungen konkateniert zurückgegeben. Ansonsten werden nur die Bilder der jeweiligen Richtung zurückgegeben.

'binarized_image'"binarized_image""binarized_image""binarized_image""binarized_image":

Diese Bilder beschreiben die Gray-Code-Folge, wobei weiße und schwarze Grauwerte anzeigen, ob das Kamerapixel Reflexionen weißer oder schwarzer Regionen des projizierten Musters beobachtete. Wurde 'normalization'"normalization""normalization""normalization""normalization" mit set_structured_light_model_paramset_structured_light_model_paramSetStructuredLightModelParamSetStructuredLightModelParamSetStructuredLightModelParam auf 'inverted_pattern'"inverted_pattern""inverted_pattern""inverted_pattern""inverted_pattern" gesetzt, bezieht sich der Grauwert auf das erste Bild des invertierten Bildpaars.

'decoded_phase_shift_image'"decoded_phase_shift_image""decoded_phase_shift_image""decoded_phase_shift_image""decoded_phase_shift_image":

Diese Bilder enthalten die zu den projizierten Phasenbildern gehörigen Winkel. Eine Periode deckt in den projizierten Mustern Streifen der Ausdehnung 'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width" ab.

'decoded_single_stripe_image'"decoded_single_stripe_image""decoded_single_stripe_image""decoded_single_stripe_image""decoded_single_stripe_image":

Dekodiertes Einzelstreifen-Bild, das ausschließlich aus Einzelstreifen-Bildern berechnet wird. Wenn 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type" auf 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe" gesetzt wird, ergibt sich das Korrespondenzbild aus der Kombination des dekodierten Einzelstreifen-Bildes mit den dekodierten Gray-Code-Bildern und den dekodierten Phasenbildern.

'gray_code_correspondence_image'"gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image":

Aus Gray-Code-Bildern berechnetes Korrespondenzbild. Wenn 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type" auf 'gray_code_and_phase_shift'"gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift" gesetzt wird, ergibt sich das aktuelle Korrespondenzbild aus dem 'gray_code_correspondence_image'"gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image" und den dekodierten Phasenbildern. Wenn 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type" auf 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe" gesetzt wird, ergibt sich das aktuelle Korrespondenzbild aus dem 'gray_code_correspondence_image'"gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image", kombiniert mit den Gray-Code-Bildern und den Phasenbildern.

Ausführungsinformationen

Parameter

ObjectObjectObjectObjectobjectVal (output_object)  (multichannel-)object(-array) objectHObjectHObjectHobject *

Ikonisches Ergebnis.

StructuredLightModelStructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModel (input_control)  structured_light_model HStructuredLightModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle des Modells für strukturiertes Licht.

ObjectNameObjectNameObjectNameObjectNameobjectName (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Name des ikonischen Ergebnisses.

Defaultwert: 'correspondence_image' "correspondence_image" "correspondence_image" "correspondence_image" "correspondence_image"

Wertevorschläge: 'correspondence_image'"correspondence_image""correspondence_image""correspondence_image""correspondence_image", 'pattern_region'"pattern_region""pattern_region""pattern_region""pattern_region", 'decoded_single_stripe_image'"decoded_single_stripe_image""decoded_single_stripe_image""decoded_single_stripe_image""decoded_single_stripe_image", 'binarized_image'"binarized_image""binarized_image""binarized_image""binarized_image", 'decoded_phase_shift_image'"decoded_phase_shift_image""decoded_phase_shift_image""decoded_phase_shift_image""decoded_phase_shift_image", 'gray_code_correspondence_image'"gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image", 'defect_image'"defect_image""defect_image""defect_image""defect_image"

Beispiel (HDevelop)

* Create the model
create_structured_light_model ('deflectometry', StructuredLightModel)
* Generate the patterns to project
gen_structured_light_pattern (PatternImages, StructuredLightModel)
* Decode the camera images
decode_structured_light_pattern (CameraImages, StructuredLightModel)
* Get the computed correspondences and defects
get_structured_light_object (CorrespondenceImages, StructuredLightModel, \
                             'correspondence_image')
set_structured_light_model_param (StructuredLightModel, \
                                  'derivative_sigma', Sigma)
get_structured_light_object (DefectImage, StructuredLightModel, \
                             'defect_image')

Ergebnis

Der Operator get_structured_light_objectget_structured_light_objectGetStructuredLightObjectGetStructuredLightObjectGetStructuredLightObject gibt 2 (H_MSG_TRUE) zurück, sofern alle Parameter korrekt sind. Andernfalls wird eine Fehlerbehandlung ausgelöst.

Vorgänger

decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPattern

Nachfolger

clear_structured_light_modelclear_structured_light_modelClearStructuredLightModelClearStructuredLightModelClearStructuredLightModel

Siehe auch

gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPattern

Modul

3D Metrology