transform_metrology_objectT_transform_metrology_objectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object (Operator)
Name
transform_metrology_objectT_transform_metrology_objectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object — Transformieren von Metrology-Messobjekten eines Messmodells,
z.B. für ein Alignment.
Warnung
transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object 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_modelAlignMetrologyModelAlignMetrologyModelAlignMetrologyModelalign_metrology_model 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)
def transform_metrology_object(metrology_handle: HHandle, index: MaybeSequence[Union[str, int]], row: MaybeSequence[Union[int, float]], column: MaybeSequence[Union[int, float]], phi: MaybeSequence[Union[int, float]], mode: MaybeSequence[str]) -> None
Beschreibung
transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object verschiebt die mit dem
Index IndexIndexIndexIndexindexindex angegebenen Metrology-Messobjekte in eine
Position, die mit RowRowRowRowrowrow und ColumnColumnColumnColumncolumncolumn sowie dem
Rotationswinkel PhiPhiPhiPhiphiphi festgelegt ist.
Das Konzept der 2D-Messtechnik ist bei der Einleitung zu Kapitel
2D-Messtechnik beschrieben.
Das Messmodell ist durch MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle definiert.
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle ist ein Handle welches von
create_metrology_modelcreate_metrology_modelCreateMetrologyModelCreateMetrologyModelCreateMetrologyModelcreate_metrology_model zurückgegeben wird.
Der Index IndexIndexIndexIndexindexindex ist der Index der von den
Operatoren add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasureadd_metrology_object_circle_measure,
add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureadd_metrology_object_ellipse_measure,
add_metrology_object_line_measureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasureadd_metrology_object_line_measure oder
add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure zurückgegeben wird.
Dem Parameter IndexIndexIndexIndexindexindex darf ein einzelner Wert oder ein Tupel
von Werten übergeben werden. Sollen alle Metrology-Messobjekte
transformiert werden, muss IndexIndexIndexIndexindexindex auf den Wert
'all'"all""all""all""all""all" gesetzt werden.
Der Parameter ModeModeModeModemodemode legt die Wirkung der Transformation
fest. Falls der Wert auf 'absolute'"absolute""absolute""absolute""absolute""absolute" gesetzt ist, werden die
Metrology-Messobjekte auf die Werte der Bildkoordinaten
RowRowRowRowrowrow und ColumnColumnColumnColumncolumncolumn im Bezug auf das
Bildkoordinatensystem transformiert sowie um PhiPhiPhiPhiphiphi rotiert.
Falls der Wert 'relative'"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_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureadd_metrology_object_ellipse_measure
oder add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure festgelegt ist.
Ist das Metrology-Messobjekt eine Linie und ist ModeModeModeModemodemode = 'relative'"relative""relative""relative""relative""relative",
liegt der Ursprung der Rotation im Startpunkt der Linie.
Wenn das Metrology-Messobjekt eine Linie ist und ModeModeModeModemodemode auf
'absolute'"absolute""absolute""absolute""absolute""absolute" gesetzt ist oder wenn das Metrology-Messobjekt ein
Kreis ist, wird der Parameter PhiPhiPhiPhiphiphi ignoriert.
transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object 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_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModelapply_metrology_model (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
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle (input_control, Zustand wird modifiziert) metrology_model → HMetrologyModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Messmodells.
IndexIndexIndexIndexindexindex (input_control) integer(-array) → HTupleMaybeSequence[Union[str, int]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Index der Metrology-Messobjekte.
Defaultwert:
'all'
"all"
"all"
"all"
"all"
"all"
Wertevorschläge: 'all'"all""all""all""all""all", 0, 1, 2
RowRowRowRowrowrow (input_control) real(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Verschiebung in Zeilenrichtung.
ColumnColumnColumnColumncolumncolumn (input_control) real(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Verschiebung in Spaltenrichtung.
PhiPhiPhiPhiphiphi (input_control) real(-array) → HTupleMaybeSequence[Union[int, float]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Rotationswinkel.
ModeModeModeModemodemode (input_control) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Modus der Transformation.
Defaultwert:
'absolute'
"absolute"
"absolute"
"absolute"
"absolute"
"absolute"
Wertevorschläge: 'absolute'"absolute""absolute""absolute""absolute""absolute", 'relative'"relative""relative""relative""relative""relative"
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object den Wert TRUE.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Modul
2D Metrology