transform_metrology_objectT_transform_metrology_objectTransformMetrologyObjectTransformMetrologyObject (Operator)
Name
transform_metrology_objectT_transform_metrology_objectTransformMetrologyObjectTransformMetrologyObject — Transformieren von Metrology-Messobjekten eines Messmodells,
z.B. für ein Alignment.
Warnung
transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObject ist veraltet und wird nur aus Gründen
der Rückwärtskompatibilität zur Verfügung gestellt. Neue Applikationen
sollten stattdessen den Operator align_metrology_modelalign_metrology_modelAlignMetrologyModelAlignMetrologyModelAlignMetrologyModel verwenden.
Signatur
void TransformMetrologyObject(const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Mode)
void HMetrologyModel::TransformMetrologyObject(const HTuple& Index, const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Mode) const
void HMetrologyModel::TransformMetrologyObject(const HString& Index, double Row, double Column, double Phi, const HString& Mode) const
void HMetrologyModel::TransformMetrologyObject(const char* Index, double Row, double Column, double Phi, const char* Mode) const
void HMetrologyModel::TransformMetrologyObject(const wchar_t* Index, double Row, double Column, double Phi, const wchar_t* Mode) const
(Nur Windows)
static void HOperatorSet.TransformMetrologyObject(HTuple metrologyHandle, HTuple index, HTuple row, HTuple column, HTuple phi, HTuple mode)
void HMetrologyModel.TransformMetrologyObject(HTuple index, HTuple row, HTuple column, HTuple phi, HTuple mode)
void HMetrologyModel.TransformMetrologyObject(string index, double row, double column, double phi, string mode)
Beschreibung
transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObject verschiebt die mit dem
Index IndexIndexIndexIndexindex angegebenen Metrology-Messobjekte in eine
Position, die mit RowRowRowRowrow und ColumnColumnColumnColumncolumn sowie dem
Rotationswinkel PhiPhiPhiPhiphi festgelegt ist.
Das Konzept der 2D-Messtechnik ist bei der Einleitung zu Kapitel
2D-Messtechnik beschrieben.
Das Messmodell ist durch MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle definiert.
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle ist ein Handle welches von
create_metrology_modelcreate_metrology_modelCreateMetrologyModelCreateMetrologyModelCreateMetrologyModel zurückgegeben wird.
Der Index IndexIndexIndexIndexindex ist der Index der von den
Operatoren add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasure,
add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure,
add_metrology_object_line_measureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasure oder
add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measure zurückgegeben wird.
Dem Parameter IndexIndexIndexIndexindex darf ein einzelner Wert oder ein Tupel
von Werten übergeben werden. Sollen alle Metrology-Messobjekte
transformiert werden, muss IndexIndexIndexIndexindex auf den Wert
'all'"all""all""all""all" gesetzt werden.
Der Parameter ModeModeModeModemode legt die Wirkung der Transformation
fest. Falls der Wert auf 'absolute'"absolute""absolute""absolute""absolute" gesetzt ist, werden die
Metrology-Messobjekte auf die Werte der Bildkoordinaten
RowRowRowRowrow und ColumnColumnColumnColumncolumn im Bezug auf das
Bildkoordinatensystem transformiert sowie um PhiPhiPhiPhiphi rotiert.
Falls der Wert 'relative'"relative""relative""relative""relative" gesetzt ist,
werden die Werte für die Transformation als relative Werte betrachtet,
d.h. sie sind relativ zur bisherigen Position und Rotation der
Metrology-Messobjekte festgelegt.
Für ein Metrology-Messobjekt vom Typ Ellipse oder Rechteck ist der Ursprung
der Rotation im Mittelpunkt des Messmodells definiert, welcher
von den Operatoren add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure
oder add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measure festgelegt ist.
Ist das Metrology-Messobjekt eine Linie und ist ModeModeModeModemode = 'relative'"relative""relative""relative""relative",
liegt der Ursprung der Rotation im Startpunkt der Linie.
Wenn das Metrology-Messobjekt eine Linie ist und ModeModeModeModemode auf
'absolute'"absolute""absolute""absolute""absolute" gesetzt ist oder wenn das Metrology-Messobjekt ein
Kreis ist, wird der Parameter PhiPhiPhiPhiphi ignoriert.
transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObject ist schneller, wenn keine
Rotation definiert ist und wenn die Messregionen und die
transformierten Messregionen beide vollständig innerhalb des
Bildes liegen. In allen anderen Fällen werden die Messregionen
neu erzeugt und der Operator wird langsamer.
Achtung
Zu beachten ist, dass, wenn Ergebnisse des Operators
apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel (angepasste geometrische Formen) im
Metrology-Messobjekt vorhanden sind, diese Ergebnisse
beim Aufruf des Operators gelöscht werden.
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 modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
Parameter
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control, Zustand wird modifiziert) metrology_model → HMetrologyModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Messmodells.
IndexIndexIndexIndexindex (input_control) integer(-array) → HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Index der Metrology-Messobjekte.
Defaultwert:
'all'
"all"
"all"
"all"
"all"
Wertevorschläge: 'all'"all""all""all""all", 0, 1, 2
RowRowRowRowrow (input_control) real(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Verschiebung in Zeilenrichtung.
ColumnColumnColumnColumncolumn (input_control) real(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Verschiebung in Spaltenrichtung.
PhiPhiPhiPhiphi (input_control) real(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Rotationswinkel.
ModeModeModeModemode (input_control) string(-array) → HTupleHTupleHtuple (string) (string) (HString) (char*)
Modus der Transformation.
Defaultwert:
'absolute'
"absolute"
"absolute"
"absolute"
"absolute"
Wertevorschläge: 'absolute'"absolute""absolute""absolute""absolute", 'relative'"relative""relative""relative""relative"
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObject den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Modul
2D Metrology