get_metrology_object_resultT_get_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResult (Operator)
Name
get_metrology_object_resultT_get_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResult — Abfragen der Ergebnisse der Anpassung des Messmodells.
Signatur
void GetMetrologyObjectResult(const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& Instance, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* Parameter)
HTuple HMetrologyModel::GetMetrologyObjectResult(const HTuple& Index, const HTuple& Instance, const HTuple& GenParamName, const HTuple& GenParamValue) const
HTuple HMetrologyModel::GetMetrologyObjectResult(Hlong Index, const HString& Instance, const HTuple& GenParamName, const HTuple& GenParamValue) const
HTuple HMetrologyModel::GetMetrologyObjectResult(Hlong Index, const char* Instance, const HTuple& GenParamName, const HTuple& GenParamValue) const
HTuple HMetrologyModel::GetMetrologyObjectResult(Hlong Index, const wchar_t* Instance, const HTuple& GenParamName, const HTuple& GenParamValue) const
(Nur Windows)
static void HOperatorSet.GetMetrologyObjectResult(HTuple metrologyHandle, HTuple index, HTuple instance, HTuple genParamName, HTuple genParamValue, out HTuple parameter)
HTuple HMetrologyModel.GetMetrologyObjectResult(HTuple index, HTuple instance, HTuple genParamName, HTuple genParamValue)
HTuple HMetrologyModel.GetMetrologyObjectResult(int index, string instance, HTuple genParamName, HTuple genParamValue)
Beschreibung
get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResultGetMetrologyObjectResult erlaubt den Zugriff auf die
Ergebnisse der Messungen der Metrology-Messobjekte, die von
apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel berechnet wurden.
Das Konzept der 2D-Messtechnik ist bei der Einleitung zu Kapitel
2D-Messtechnik beschrieben.
Das Messmodell ist durch das Handle MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle definiert. Der
Parameter IndexIndexIndexIndexindex legt fest für welche Metrology-Messobjekte die
Ergebnisse abgefragt werden sollen. Wird für den Parameter IndexIndexIndexIndexindex
als Wert 'all'"all""all""all""all" übergeben, werden die Ergebnisse aller
Metrology-Messobjekte abgefragt. Mit dem Parameter InstanceInstanceInstanceInstanceinstance wird
angegeben, welche Instanz der Ergebnisse in ParameterParameterParameterParameterparameter zurückgegeben
wird. Wird InstanceInstanceInstanceInstanceinstance auf 'all'"all""all""all""all" gesetzt, werden alle
Instanzen zurückgegeben. Es können verschiedene generische Parameter
angegeben werden, mit denen die Rückgabewerte in ParameterParameterParameterParameterparameter gesteuert
werden können. Die generischen Parameternamen werden in
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName gesetzt. Die dazugehörigen Werte werden im Parameter
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue übergeben.
Folgende Parameter und Werte sind möglich:
- 'result_type'"result_type""result_type""result_type""result_type":
-
Setzt man GenParamNameGenParamNameGenParamNameGenParamNamegenParamName auf 'result_type'"result_type""result_type""result_type""result_type" kann mittels
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName bestimmt werden, wie und welche Resultate für
ein Metrology-Messobjekt ausgegeben werden. Alle für ein
Metrology-Messobjekt gemessenen Parameter können auf einmal abgerufen
werden. Weiterhin können spezielle Parameter oder der Score abgerufen
werden.
- Abfragen aller Parameter:
-
Wenn GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue auf 'all_param'"all_param""all_param""all_param""all_param" gesetzt wurde, dann
werden alle für ein Metrology-Messobjekt gemessenen Parameter
zurückgegeben. Wurden Kameraparameter und eine Messebene gesetzt
(siehe set_metrology_model_paramset_metrology_model_paramSetMetrologyModelParamSetMetrologyModelParamSetMetrologyModelParam), so werden die Ergebnisse in
metrischen Koordinaten zurückgegeben, andernfalls in Pixeln.
Für einen Kreis ist, werden die
Mittelpunktskoordinaten (Zeile 'row'"row""row""row""row" und Spalte
'column'"column""column""column""column") sowie der Radius 'radius'"radius""radius""radius""radius" des Kreises
zurückgegeben. Die Reihenfolge ist ['row'"row""row""row""row",
'column'"column""column""column""column", 'radius'"radius""radius""radius""radius"] oder ['x'"x""x""x""x",
'y'"y""y""y""y", 'radius'"radius""radius""radius""radius"].
Für eine Ellipse ist, werden die
Mittelpunktskoordinaten (Zeile 'row'"row""row""row""row" und Spalte
'column'"column""column""column""column"), die Orientierung der Hauptachse 'phi'"phi""phi""phi""phi",
die Länge der großen Halbachse 'radius1'"radius1""radius1""radius1""radius1" sowie die Länge
der kleinen Halbachse 'radius2'"radius2""radius2""radius2""radius2" der Ellipse
zurückgegeben. Die Reihenfolge ist ['row'"row""row""row""row", 'column'"column""column""column""column",
'phi'"phi""phi""phi""phi", 'radius1'"radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2"] oder
['x'"x""x""x""x", 'y'"y""y""y""y",
'phi'"phi""phi""phi""phi", 'radius1'"radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2"].
Für eine Linie ist, wird der
Start- und Endpunkt der Linie zurückgegeben
Die Reihenfolge ist ['row_begin'"row_begin""row_begin""row_begin""row_begin", 'column_begin'"column_begin""column_begin""column_begin""column_begin",
'row_end'"row_end""row_end""row_end""row_end", 'column_end'"column_end""column_end""column_end""column_end"] oder
['x_begin'"x_begin""x_begin""x_begin""x_begin", 'y_begin'"y_begin""y_begin""y_begin""y_begin", 'x_end'"x_end""x_end""x_end""x_end",
'y_end'"y_end""y_end""y_end""y_end"].
Für ein Rechteck ist, werden
die Mittelpunktskoordinaten (Zeile 'row'"row""row""row""row" und Spalte
'column'"column""column""column""column"), die Orientierung der Hauptachse 'phi'"phi""phi""phi""phi",
der erste Halbmesser (halbe Länge) 'length1'"length1""length1""length1""length1" und der
zweite Halbmesser (halbe Länge) 'length2'"length2""length2""length2""length2" des Rechtecks
zurückgegeben. Die Reihenfolge ist ['row'"row""row""row""row",
'column'"column""column""column""column",'phi'"phi""phi""phi""phi",'length1'"length1""length1""length1""length1",
'length2'"length2""length2""length2""length2"] oder ['x'"x""x""x""x",
'y'"y""y""y""y",'phi'"phi""phi""phi""phi",'length1'"length1""length1""length1""length1",
'length2'"length2""length2""length2""length2"].
- Abfragen spezieller Parameter:
-
Gemessene Objektparameter können auch einzeln abgerufen werden,
indem GenParamNameGenParamNameGenParamNameGenParamNamegenParamName auf den gewünschten Parameternamen gesetzt
wird.
Wurden keine Kameraparameter und keine Messebene gesetzt,
können die folgenden Parameter einzeln abgerufen werden, wenn
sie für das jeweilige Metrology-Messobjekts verfügbar sind.
Bitte beachten Sie, dass für Linien zusätzlich die drei Parameter der
Hesse-Normalform abgefragt werden können, d.h. der Einheitsvektor der
Normale 'nrow'"nrow""nrow""nrow""nrow", 'ncolumn'"ncolumn""ncolumn""ncolumn""ncolumn" und der orthogonale Abstand
[distance] der Linie vom Ursprung des Koordinatensystems.
Das Vorzeichen des Abstands legt die Seite der Linie fest, auf welcher
sich der Ursprung befindet.
Wertevorschläge: 'row'"row""row""row""row", 'column'"column""column""column""column",
'radius'"radius""radius""radius""radius", 'phi'"phi""phi""phi""phi" , 'radius1'"radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2",
'length1'"length1""length1""length1""length1", 'length2'"length2""length2""length2""length2", 'row_begin'"row_begin""row_begin""row_begin""row_begin",
'column_begin'"column_begin""column_begin""column_begin""column_begin", 'row_end'"row_end""row_end""row_end""row_end", 'column_end'"column_end""column_end""column_end""column_end",
'nrow'"nrow""nrow""nrow""nrow", 'ncolumn'"ncolumn""ncolumn""ncolumn""ncolumn", 'distance'"distance""distance""distance""distance"
Wurden Kameraparameter und eine Messebene gesetzt,
können die folgenden metrischen Parameter einzeln abgerufen werden, wenn
sie für das jeweilige Metrology-Messobjekts verfügbar sind.
Bitte beachten Sie, dass für Linien zusätzlich die drei Parameter der
Hesse-Normalform abgefragt werden können, d.h. der Einheitsvektor der
Normale 'nx'"nx""nx""nx""nx", 'ny'"ny""ny""ny""ny" und der orthogonale Abstand
[distance] der Linie vom Ursprung des Koordinatensystems.
Das Vorzeichen des Abstands legt die Seite der Linie fest, auf welcher
sich der Ursprung befindet.
Wertevorschläge: 'x'"x""x""x""x", 'y'"y""y""y""y",
'radius'"radius""radius""radius""radius", 'phi'"phi""phi""phi""phi" , 'radius1'"radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2",
'length1'"length1""length1""length1""length1", 'length2'"length2""length2""length2""length2", 'x_begin'"x_begin""x_begin""x_begin""x_begin",
'y_begin'"y_begin""y_begin""y_begin""y_begin",
'x_end'"x_end""x_end""x_end""x_end", 'y_end'"y_end""y_end""y_end""y_end", 'nx'"nx""nx""nx""nx", 'ny'"ny""ny""ny""ny",
'distance'"distance""distance""distance""distance"
- Abfragen des Scores:
-
Wird GenParamNameGenParamNameGenParamNameGenParamNamegenParamName auf den Wert
'score'"score""score""score""score" gesetzt, wird der Score der Ergebnisse
zurückgegeben. Der Score ist die Anzahl der Messungen, die für
die Berechnung des Ergebnisses verwendet werden dividiert durch die
maximale Anzahl von Messregionen.
- 'used_edges'"used_edges""used_edges""used_edges""used_edges":
-
Mit den folgenden Werten für
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue können Details zu den Kanten abgefragt werden, die
für die Anpassung eines Metrology-Messobjekts verwendet wurden.
- 'row'"row""row""row""row":
Die Zeilenkoordinaten der Kanten, die für
die Anpassung eines Metrology-Messobjektes verwendet wurden, werden
zurückgegeben.
- 'column'"column""column""column""column":
Die Spaltenkoordinaten der Kanten, die für die Anpassung eines
Metrology-Messobjektes verwendet wurden, werden zurückgegeben.
- 'amplitude'"amplitude""amplitude""amplitude""amplitude":
Die Amplitude der Kanten, die für die Anpassung eines
Metrology-Messobjektes verwendet wurden, werden zurückgegeben.
Wertevorschläge: 'row'"row""row""row""row", 'column'"column""column""column""column",
'amplitude'"amplitude""amplitude""amplitude""amplitude"
- 'angle_direction'"angle_direction""angle_direction""angle_direction""angle_direction":
-
Der Parameter legt die Drehrichtung
für Winkel fest, die Ergebnisse der Anpassung sind. Wird der
Parameter 'angle_direction'"angle_direction""angle_direction""angle_direction""angle_direction" auf 'positive'"positive""positive""positive""positive" gesetzt,
ist der Winkel zwischen der Hauptachse des Objekts und der horizontalen
Achse des Koordinatensystems im mathematisch positiven Sinn (gegen
den Uhrzeigersinn) definiert. Wird der Parameter
'angle_direction'"angle_direction""angle_direction""angle_direction""angle_direction" auf 'negative'"negative""negative""negative""negative" gesetzt, ist der
Winkel zwischen der Hauptachse des Objekts und der horizontalen Achse
des Koordinatensystems im mathematisch negativen Sinn (im
Uhrzeigersinn) definiert. Die Winkelergebnisse werden im
Bogenmaß ausgegeben.
Wertevorschläge: 'positive'"positive""positive""positive""positive", 'negative'"negative""negative""negative""negative"
Defaultwert: 'positive'"positive""positive""positive""positive"
Es ist möglich die Ergebnisse mehrerer Metrology-Messobjekte (siehe
Parameter IndexIndexIndexIndexindex) und mehrerer Instanzen (siehe Parameter
InstanceInstanceInstanceInstanceinstance) der Metrology-Messobjekte gleichzeitig zurückzugeben.
Die Ergebnisse werden in ParameterParameterParameterParameterparameter in der folgenden
Reihenfolge zurückgegeben: 1. Instanz des 1. Metrology-Messobjekts,
2. Instanz des 1. Metrology-Messobjekts, usw., 1. Instanz des
2. Metrology-Messobjekts, 2. Instanz des 2. Metrology-Messobjekts, usw.
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
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control) metrology_model → HMetrologyModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Messmodells.
IndexIndexIndexIndexindex (input_control) integer(-array) → HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Index des Metrology-Messobjektes.
Defaultwert: 0
Wertevorschläge: 'all'"all""all""all""all", 0, 1, 2
InstanceInstanceInstanceInstanceinstance (input_control) integer(-array) → HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Instanz des Metrology-Messobjektes
Defaultwert:
'all'
"all"
"all"
"all"
"all"
Wertevorschläge: 'all'"all""all""all""all", 0, 1, 2
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control) attribute.name-array → HTupleHTupleHtuple (string) (string) (HString) (char*)
Name des generischen Parameters.
Defaultwert:
'result_type'
"result_type"
"result_type"
"result_type"
"result_type"
Werteliste: 'angle_direction'"angle_direction""angle_direction""angle_direction""angle_direction", 'result_type'"result_type""result_type""result_type""result_type", 'used_edges'"used_edges""used_edges""used_edges""used_edges"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control) attribute.value-array → HTupleHTupleHtuple (string / real) (string / double) (HString / double) (char* / double)
Wert des generischen Parameters.
Defaultwert:
'all_param'
"all_param"
"all_param"
"all_param"
"all_param"
Wertevorschläge: 'all_param'"all_param""all_param""all_param""all_param", 'score'"score""score""score""score", 'true'"true""true""true""true", 'false'"false""false""false""false", 'row'"row""row""row""row", 'column'"column""column""column""column", 'amplitude'"amplitude""amplitude""amplitude""amplitude", 'radius'"radius""radius""radius""radius", 'phi'"phi""phi""phi""phi", 'radius1'"radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2", 'length1'"length1""length1""length1""length1", 'length2'"length2""length2""length2""length2", 'row_begin'"row_begin""row_begin""row_begin""row_begin", 'column_begin'"column_begin""column_begin""column_begin""column_begin", 'row_end'"row_end""row_end""row_end""row_end", 'column_end'"column_end""column_end""column_end""column_end", 'nrow'"nrow""nrow""nrow""nrow", 'ncolumn'"ncolumn""ncolumn""ncolumn""ncolumn", 'distance'"distance""distance""distance""distance", 'x'"x""x""x""x", 'y'"y""y""y""y", 'x_begin'"x_begin""x_begin""x_begin""x_begin", 'y_begin'"y_begin""y_begin""y_begin""y_begin", 'x_end'"x_end""x_end""x_end""x_end", 'y_end'"y_end""y_end""y_end""y_end", 'nx'"nx""nx""nx""nx", 'ny'"ny""ny""ny""ny", 'positive'"positive""positive""positive""positive", 'negative'"negative""negative""negative""negative"
ParameterParameterParameterParameterparameter (output_control) real(-array) → HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Ergebniswerte.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResultGetMetrologyObjectResult den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel
Nachfolger
clear_metrology_modelclear_metrology_modelClearMetrologyModelClearMetrologyModelClearMetrologyModel
Siehe auch
get_metrology_object_result_contourget_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContourGetMetrologyObjectResultContour,
get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures
Modul
2D Metrology