kernelv_get_prg_target_positions()
Prototyp
KERNELV_RETURN
| kernelv_get_prg_target_positions (signed long int *positions, |
Beschreibung
Es werden die im NC-Programm programmierten Zielpositionen aller in der CNC vorhandenen Achsen in einem Array zurückgegeben.
Die zurückgegebenen Positionen sind die im gerade abgearbeiteten NC-Satz programmierten Positionen.
Falls durch die CNC Bewegungssätze eingefügt, bzw. programmierte Bewegungssätze aufgeteilt werden, ( z.B. beim Überschleifen) wird für alle erzeugten NC-Sätze die Zielposition des Ursprungssatzes ausgegeben.
Die Auflösung der Positionswerte beträgt 0,1 µm für translatorische Achsen bzw. 1*10-4° für Spindeln oder rotatorische Achsen.
Falls der vom Aufrufer bereitgestellte Speicher nicht zur Rückgabe aller Werte ausreicht, wird der Fehlercode ERR_CNC_RET_MEMORY zurückgegeben.
Zur Rückgabe aller Positionswerte müssen mindestens Achsanzahl * sizeof(signed long int) Bytes vom Aufrufer bereitgestellt werden.
Die Reihenfolge der Achspositionen im zurückgegebenen Array ist gleich der Konfigurationsreihenfolge der Achsen.
Falls eine Achse gerade keinem NC-Kanal zugeordnet ist, wird für diese Achse der Wert Null zurückgegeben.
Parameter
Name | Typ | Bedeutung |
positions | unsigned long* | Zeiger auf Speicherbereich für die zurückzugebenden Achspositionen. |
maxByteSize | unsigned long | Größe des Speicherbereiches für die Achspositionen. |
returnSize | unsigned long* | Anzahl der in positions zurückgegebenen Bytes. |
Rückgabewerte
Symbol | Wert | Bedeutung |
RET_FINISHED | 0 | Die Funktion wurde fehlerfrei durchgeführt. |
ERR_CNC_NOT_INIT | -3 | Der Simulations-CNC-Kern ist noch nicht initialisiert. |
ERR_CNC_RET_MEMORY | -4 | Der oder die Rückgabewerte passen nicht in den bereitgestellten Speicher. Im Parameter returnSize wird in diesem Fall der benötigte Speicher zurückgegeben. |