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
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
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
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