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