IF_TrackingSource - SetCoordinateSystem (Methode)

Überblick

Typ:

Methode

Verfügbar ab:

V3.6.5.0

Dieses Kapitel enthält folgende Informationen:

Aufgabe

Erstellen und Konfigurieren des Tracking-Koordinatensystems.

Beschreibung

Die Methode muss einmal aufgerufen werden, um das Tracking-Koordinatensystem zu erstellen und zu konfigurieren. Um das Koordinatensystem zur Laufzeit zu ändern, kann die MethodeIF_TrackingSource.ModifyCoordinateSystem() verwendet werden.

Schnittstelle

Eingang

Datentyp

Beschreibung

i_etSystemId

ET_CoordinateSystem

ID des Trackingsystems.

Die ID des dem Roboter hinzugefügten Trackingsystems muss eindeutig sein.

Gültige Werte sind:ET_CoordinateSystem.Tracking1…ET_CoordinateSystem.Tracking30

i_stOffset

SE_Math.ST_Vector3D

Verschiebung des Ursprungs des Trackingsystems in Bezug auf das Roboterkoordinatensystem ET_CoordinateSystem.CSR.

Einheit: [mm]

i_etOrientationConvention

ET_OrientationConvention

Konvention für die Drehwinkel der Orientierung  i_stOrientation.

Gültige Werte:

  • ET_OrientationConvention.XYZ

  • ET_OrientationConvention.ZYX

  • ET_OrientationConvention.ZXY

i_stOrientation

SE_Math.ST_Vector3D

Rotation des Trackingsystems in Bezug auf das Roboterkoordinatensystem ET_CoordinateSystem.CSR.

Einheit: [°]

i_xInvertDirectionX

BOOL

Kehrt die positive X-Richtung des Trackingsystems um.

i_xInvertDirectionY

BOOL

Kehrt die positive Y-Richtung des Trackingsystems um.

i_xInvertDirectionZ

BOOL

Kehrt die positive Z-Richtung des Trackingsystems um.

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose.

Ein Wert ungleich GD.ET_Diag.Ok entspricht einer Diagnosemeldung.

q_etDiagExt

ET_DiagExt

POU-spezifischer Ausgang zur Diagnose.

q_etDiag = ET_Diag.Ok -> Statusmeldung

q_etDiag <> ET_Diag.Ok -> Diagnosemeldung

q_sMsg

STRING[80]

Ereignisabhängige Meldung, die zusätzliche Informationen zum Diagnosestatus liefert.

Rückgabewert

Datentyp

Beschreibung

ET_CoordinateSystem

ID des hinzugefügten Trackingsystems.

Diagnosemeldungen

q_etDiag

q_etDiagExt

Enumerationswert

Beschreibung

OK

OK

0

Ok

ExecutionAborted

CoordinateSystemAlreadyConfigured

252

Das Koordinatensystem ist bereits konfiguriert.

InputParameterInvalid

SystemIdInvalid

196

Die System-ID ist ungültig.

InputParameterInvalid

OrientationConventionInvalid

168

Die Orientierungskonvention ist ungültig.

CoordinateSystemAlreadyConfigured

Enumerationsname:

CoordinateSystemAlreadyConfigured

Enumerationswert:

252

Beschreibung:

Das Koordinatensystem ist bereits konfiguriert.

Problem

Ursache

Lösung

Die Konfiguration des Trackingsystems war nicht erfolgreich.

Die Konfiguration des Trackingsystems wurde bereits erfolgreich abgeschlossen. Die Methode SetCoordinateSystem wurde bereits erfolgreich aufgerufen.

Stellen Sie sicher, dass die Konfiguration der Trackingquelle nur einmal aufgerufen wird. Um das Koordinatensystem während einer Laufzeit zu ändern, verwenden Sie die MethodeIF_TrackingSource.ModifyCoordinateSystem.

Ok

Enumerationsname:

Ok

Enumerationswert:

0

Beschreibung:

Ok

Die Konfiguration des Tracking-Koordinatensystems war erfolgreich.

OrientationConventionInvalid

Enumerationsname:

OrientationConventionInvalid

Enumerationswert:

168

Beschreibung:

Die Orientierungskonvention ist ungültig.

Problem

Ursache

Lösung

Die Konfiguration des Trackingsystems war nicht erfolgreich.

Der am Eingang i_etOrientationConvention übergebene Wert ist kein gültiger Wert.

Am Eingang i_etOrientationConvention muss ein Wert von ET_OrientationConvention übergeben werden.

Gültige Werte:

  • ET_OrientationConvention.XYZ

  • ET_OrientationConvention.ZYX

  • ET_OrientationConvention.ZXY

SystemIdInvalid

Enumerationsname:

SystemIdInvalid

Enumerationswert:

196

Beschreibung:

Die System-ID ist ungültig.

Problem

Ursache

Lösung

Die Konfiguration des Trackingsystems war nicht erfolgreich.

Die am Eingang i_etSystemId übergebene System-ID ist ungültig.

Stellen Sie sicher, dass der Wert von i_etSystemId einem der folgenden Werte entspricht:

ET_CoordinateSystem.Tracking1…ET_CoordinateSystem.Tracking30