get_structured_light_objectT_get_structured_light_objectGetStructuredLightObjectGetStructuredLightObjectget_structured_light_object (Operator)

Name

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

Signatur

Beschreibung

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

Einerseits kann man so die Ergebnisse des Dekodiervorgangs ('correspondence_image'"correspondence_image""correspondence_image""correspondence_image""correspondence_image") abfragen, oder auch das weiterverarbeitete Defektbild ('defect_image'"defect_image""defect_image""defect_image""defect_image"). Andererseits ist get_structured_light_objectget_structured_light_objectGetStructuredLightObjectGetStructuredLightObjectget_structured_light_object auch hilfreich bei einer Problembehandlung des Dekodiervorgangs. Zu beachten ist, dass Zwischenergebnisse nur aus dem StructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModelstructured_light_model 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_paramSetStructuredLightModelParamSetStructuredLightModelParamset_structured_light_model_param 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 oder Projektor 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" (für Modelle für strukturiertes Licht vom Typ 'deflectometry'"deflectometry""deflectometry""deflectometry""deflectometry"):

Dieses Bild beschreibt mögliche Defekte der Oberfläche, die die angezeigten 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. Beachten Sie, dass dieses Objekt nur für Modelle für strukturiertes Licht vom Typ 'deflectometry'"deflectometry""deflectometry""deflectometry""deflectometry" verfügbar ist.

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 Oberflächenpunkte beobachtete, die von weißen oder schwarzen Regionen des angezeigten oder projizierten Musters beleuchtet wurden. Wurde 'normalization'"normalization""normalization""normalization""normalization" mit set_structured_light_model_paramset_structured_light_model_paramSetStructuredLightModelParamSetStructuredLightModelParamset_structured_light_model_param 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 angezeigten oder projizierten Phasenbildern gehörigen Winkel. Eine Periode deckt in den 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

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

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_objectGetStructuredLightObjectGetStructuredLightObjectget_structured_light_object 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_patternDecodeStructuredLightPatternDecodeStructuredLightPatterndecode_structured_light_pattern

Nachfolger

clear_structured_light_modelclear_structured_light_modelClearStructuredLightModelClearStructuredLightModelclear_structured_light_model

Siehe auch

gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatterngen_structured_light_pattern

Modul

3D Metrology