get_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d (Operator)

Name

get_sheet_of_light_result_object_model_3dT_get_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d — Zugriff auf das Ergebnis einer vollständig kalibrierten Lichtschnittmessung als 3D-Objektmodell.

Signatur

get_sheet_of_light_result_object_model_3d( : : SheetOfLightModelID : ObjectModel3D)

Beschreibung

Der Operator get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d liefert das Ergebnis einer vollständig kalibrierten Lichtschnittmessung als 3D-Objektmodell. Das Handle des Lichtschnitt-Modells, dessen Messergebnis benötigt wird, muss in SheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDsheetOfLightModelID übergeben werden. Der Parameter 'calibration'"calibration""calibration""calibration""calibration" des Lichtschnitt-Modells muss auf den Wert 'xyz'"xyz""xyz""xyz""xyz" oder 'offset_scale'"offset_scale""offset_scale""offset_scale""offset_scale" gesetzt worden sein. Ansonsten können die gemessenen Punktkoordinaten nicht in ein 3D-Objektmodell überführt werden und eine Fehlerbehandlung wird durchgeführt.

Das Handle des 3D-Objektmodells, das das Ergebnis der Lichtschnittmessung beinhaltet, wird in ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D zurückgegeben. Die 3D-Punkte im 3D-Objektmodell sind nicht vermascht, so dass keine Oberflächenelemente (Facetten) im Modell verfügbar sind. Wenn ein 3D-Objektmodell mit vermaschten 3D-Punkten benötigt wird, muss zunächst der Operator get_sheet_of_light_resultget_sheet_of_light_resultGetSheetOfLightResultGetSheetOfLightResultGetSheetOfLightResult aufgerufen werden, um die gemessenen 'x'"x""x""x""x", 'y'"y""y""y""y" und 'z'"z""z""z""z" Koordinaten zu erhalten. Anschließend muss der Operator xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3dXyzToObjectModel3d mit passenden Parametern aufgerufen werden. Siehe xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3dXyzToObjectModel3d für weitere Informationen über 3D-Objektmodelle.

Die Einheit der aus dem Lichtschnitt-Modell erhaltenen Koordinaten ist vom Wert des Parameters 'scale''scale''scale''scale''scale' abhängig. Der Operator set_sheet_of_light_paramset_sheet_of_light_paramSetSheetOfLightParamSetSheetOfLightParamSetSheetOfLightParam liefert weitere Details über die möglichen Werte des Parameters 'scale''scale''scale''scale''scale'.

get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d liefert ein leeres 3D-Objektmodell zurück, wenn das angeforderte Ergebnis nicht gemessen wurde und im Lichtschnitt-Modell nicht vorhanden ist.

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.

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

SheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDSheetOfLightModelIDsheetOfLightModelID (input_control) sheet_of_light_model → (handle)

Handle für den Zugriff auf das Lichtschnitt-Modell.

ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D (output_control) object_model_3d → (handle)

Handle des resultierenden 3D-Objektmodells.

Ergebnis

get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d liefert den Wert 2 (H_MSG_TRUE), falls die übergebenen Parameter korrekt sind. Ansonsten wird eine Fehlerbehandlung durchgeführt.