Name
get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResult — Abfragen der Ergebnisse der Anpassung des Messmodells.
Herror get_metrology_object_result(const Hlong MetrologyHandle, const Hlong Index, const Hlong Instance, const char* GenParamName, const char* GenParamValue, double* Parameter)
Herror T_get_metrology_object_result(const Htuple MetrologyHandle, const Htuple Index, const Htuple Instance, const Htuple GenParamName, const Htuple GenParamValue, Htuple* Parameter)
Herror get_metrology_object_result(const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& Instance, const HTuple& GenParamName, const HTuple& GenParamValue, double* Parameter)
Herror get_metrology_object_result(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
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, Hlong Instance, const HString& GenParamName, const HString& GenParamValue) const
HTuple HMetrologyModel::GetMetrologyObjectResult(Hlong Index, Hlong Instance, const char* GenParamName, const char* GenParamValue) const
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, int instance, string genParamName, string genParamValue)
get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResult erlaubt den Zugriff auf die
Ergebnisse der Messungen der Metrology-Messobjekte, die von
apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel berechnet wurden (siehe
create_metrology_modelcreate_metrology_modelCreateMetrologyModelcreate_metrology_modelCreateMetrologyModelCreateMetrologyModel für das Grundprinzip der
2D-Messtechnik). Das Messmodell ist durch das Handle
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle definiert. Der Parameter IndexIndexIndexIndexIndexindex
legt fest für welche Metrology-Messobjekte die Ergebnisse abgefragt
werden sollen. Wird für den Parameter IndexIndexIndexIndexIndexindex als Wert
'all'"all""all""all""all""all" übergeben, werden die Ergebnisse aller
Metrology-Messobjekte abgefragt. Mit dem Parameter InstanceInstanceInstanceInstanceInstanceinstance
wird angegeben, welche Instanz der Ergebnisse in ParameterParameterParameterParameterParameterparameter
zurückgegeben wird. Wird InstanceInstanceInstanceInstanceInstanceinstance auf 'all'"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
ParameterParameterParameterParameterParameterparameter gesteuert werden können. Die generischen
Parameternamen werden in GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName gesetzt. Die
dazugehörigen Werte werden im Parameter GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue
übergeben. Folgende Parameter und Werte sind möglich:
- 'result_type'"result_type""result_type""result_type""result_type""result_type":
-
Setzt man GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName auf 'result_type'"result_type""result_type""result_type""result_type""result_type" kann mittels
GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName 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 GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue auf 'all_param'"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_paramSetMetrologyModelParamset_metrology_model_paramSetMetrologyModelParamSetMetrologyModelParam), 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""row" und Spalte
'column'"column""column""column""column""column") sowie der Radius 'radius'"radius""radius""radius""radius""radius" des Kreises
zurückgegeben. Die Reihenfolge ist ['row'"row""row""row""row""row",
'column'"column""column""column""column""column", 'radius'"radius""radius""radius""radius""radius"] oder ['x'"x""x""x""x""x",
'y'"y""y""y""y""y", 'radius'"radius""radius""radius""radius""radius"].
Für eine Ellipse ist, werden die
Mittelpunktskoordinaten (Zeile 'row'"row""row""row""row""row" und Spalte
'column'"column""column""column""column""column"), die Orientierung der Hauptachse 'phi'"phi""phi""phi""phi""phi",
die Länge der großen Halbachse 'radius1'"radius1""radius1""radius1""radius1""radius1" sowie die Länge
der kleinen Halbachse 'radius2'"radius2""radius2""radius2""radius2""radius2" der Ellipse
zurückgegeben. Die Reihenfolge ist ['row'"row""row""row""row""row", 'column'"column""column""column""column""column",
'phi'"phi""phi""phi""phi""phi", 'radius1'"radius1""radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2""radius2"] oder
['x'"x""x""x""x""x", 'y'"y""y""y""y""y",
'phi'"phi""phi""phi""phi""phi", 'radius1'"radius1""radius1""radius1""radius1""radius1", 'radius2'"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""row_begin", 'column_begin'"column_begin""column_begin""column_begin""column_begin""column_begin",
'row_end'"row_end""row_end""row_end""row_end""row_end", 'column_end'"column_end""column_end""column_end""column_end""column_end"] oder
['x_begin'"x_begin""x_begin""x_begin""x_begin""x_begin", 'y_begin'"y_begin""y_begin""y_begin""y_begin""y_begin", 'x_end'"x_end""x_end""x_end""x_end""x_end",
'y_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""row" und Spalte
'column'"column""column""column""column""column"), die Orientierung der Hauptachse 'phi'"phi""phi""phi""phi""phi",
der erste Halbmesser (halbe Länge) 'length1'"length1""length1""length1""length1""length1" und der
zweite Halbmesser (halbe Länge) 'length2'"length2""length2""length2""length2""length2" des Rechtecks
zurückgegeben. Die Reihenfolge ist ['row'"row""row""row""row""row",
'column'"column""column""column""column""column",'phi'"phi""phi""phi""phi""phi",'length1'"length1""length1""length1""length1""length1",
'length2'"length2""length2""length2""length2""length2"] oder ['x'"x""x""x""x""x",
'y'"y""y""y""y""y",'phi'"phi""phi""phi""phi""phi",'length1'"length1""length1""length1""length1""length1",
'length2'"length2""length2""length2""length2""length2"].
- Abfragen spezieller Parameter:
-
Gemessene Objektparameter können auch einzeln abgerufen werden,
indem GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName 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""nrow", 'ncolumn'"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""row", 'column'"column""column""column""column""column",
'radius'"radius""radius""radius""radius""radius", 'phi'"phi""phi""phi""phi""phi" , 'radius1'"radius1""radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2""radius2",
'length1'"length1""length1""length1""length1""length1", 'length2'"length2""length2""length2""length2""length2", 'row_begin'"row_begin""row_begin""row_begin""row_begin""row_begin",
'column_begin'"column_begin""column_begin""column_begin""column_begin""column_begin", 'row_end'"row_end""row_end""row_end""row_end""row_end", 'column_end'"column_end""column_end""column_end""column_end""column_end",
'nrow'"nrow""nrow""nrow""nrow""nrow", 'ncolumn'"ncolumn""ncolumn""ncolumn""ncolumn""ncolumn", 'distance'"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""nx", 'ny'"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""x", 'y'"y""y""y""y""y",
'radius'"radius""radius""radius""radius""radius", 'phi'"phi""phi""phi""phi""phi" , 'radius1'"radius1""radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2""radius2",
'length1'"length1""length1""length1""length1""length1", 'length2'"length2""length2""length2""length2""length2", 'x_begin'"x_begin""x_begin""x_begin""x_begin""x_begin",
'y_begin'"y_begin""y_begin""y_begin""y_begin""y_begin",
'x_end'"x_end""x_end""x_end""x_end""x_end", 'y_end'"y_end""y_end""y_end""y_end""y_end", 'nx'"nx""nx""nx""nx""nx", 'ny'"ny""ny""ny""ny""ny",
'distance'"distance""distance""distance""distance""distance"
- Abfragen des Scores:
-
Wird GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName auf den Wert
'score'"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""used_edges":
-
Mit den folgenden Werten für
GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue können Details zu den Kanten abgefragt werden, die
für die Anpassung eines Metrology-Messobjekts verwendet wurden.
- 'row'"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""column":
Die Spaltenkoordinaten der Kanten, die für die Anpassung eines
Metrology-Messobjektes verwendet wurden, werden zurückgegeben.
- 'amplitude'"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""row", 'column'"column""column""column""column""column",
'amplitude'"amplitude""amplitude""amplitude""amplitude""amplitude"
- 'angle_direction'"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""angle_direction" auf 'positive'"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""angle_direction" auf 'negative'"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""positive", 'negative'"negative""negative""negative""negative""negative"
Defaultwert: 'positive'"positive""positive""positive""positive""positive"
Es ist möglich die Ergebnisse mehrerer Metrology-Messobjekte (siehe
Parameter IndexIndexIndexIndexIndexindex) und mehrerer Instanzen (siehe Parameter
InstanceInstanceInstanceInstanceInstanceinstance) der Metrology-Messobjekte gleichzeitig zurückzugeben.
Die Ergebnisse werden in ParameterParameterParameterParameterParameterparameter 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.
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Index des Metrology-Messobjektes.
Defaultwert:
'all'
"all"
"all"
"all"
"all"
"all"
Wertevorschläge: 'all'"all""all""all""all""all", 0, 1, 2
Instanz des Metrology-Messobjektes
Defaultwert:
'all'
"all"
"all"
"all"
"all"
"all"
Wertevorschläge: 'all'"all""all""all""all""all", 0, 1, 2
Name des generischen Parameters.
Defaultwert:
'result_type'
"result_type"
"result_type"
"result_type"
"result_type"
"result_type"
Werteliste: 'angle_direction'"angle_direction""angle_direction""angle_direction""angle_direction""angle_direction", 'result_type'"result_type""result_type""result_type""result_type""result_type", 'used_edges'"used_edges""used_edges""used_edges""used_edges""used_edges"
Wert des generischen Parameters.
Defaultwert:
'all_param'
"all_param"
"all_param"
"all_param"
"all_param"
"all_param"
Wertevorschläge: 'all_param'"all_param""all_param""all_param""all_param""all_param", 'score'"score""score""score""score""score", 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", 'row'"row""row""row""row""row", 'column'"column""column""column""column""column", 'amplitude'"amplitude""amplitude""amplitude""amplitude""amplitude", 'radius'"radius""radius""radius""radius""radius", 'phi'"phi""phi""phi""phi""phi", 'radius1'"radius1""radius1""radius1""radius1""radius1", 'radius2'"radius2""radius2""radius2""radius2""radius2", 'length1'"length1""length1""length1""length1""length1", 'length2'"length2""length2""length2""length2""length2", 'row_begin'"row_begin""row_begin""row_begin""row_begin""row_begin", 'column_begin'"column_begin""column_begin""column_begin""column_begin""column_begin", 'row_end'"row_end""row_end""row_end""row_end""row_end", 'column_end'"column_end""column_end""column_end""column_end""column_end", 'nrow'"nrow""nrow""nrow""nrow""nrow", 'ncolumn'"ncolumn""ncolumn""ncolumn""ncolumn""ncolumn", 'distance'"distance""distance""distance""distance""distance", 'x'"x""x""x""x""x", 'y'"y""y""y""y""y", 'x_begin'"x_begin""x_begin""x_begin""x_begin""x_begin", 'y_begin'"y_begin""y_begin""y_begin""y_begin""y_begin", 'x_end'"x_end""x_end""x_end""x_end""x_end", 'y_end'"y_end""y_end""y_end""y_end""y_end", 'nx'"nx""nx""nx""nx""nx", 'ny'"ny""ny""ny""ny""ny", 'positive'"positive""positive""positive""positive""positive", 'negative'"negative""negative""negative""negative""negative"
Sind die Parameterwerte korrekt, dann liefert
get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResult den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel
clear_metrology_modelclear_metrology_modelClearMetrologyModelclear_metrology_modelClearMetrologyModelClearMetrologyModel
get_metrology_object_result_contourget_metrology_object_result_contourGetMetrologyObjectResultContourget_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContour,
get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures
2D Metrology