FB_VN_ReadCalibrationPattern
This FB reads calibration pattern reference points from an xml file on the targte pc.
Syntax
Definition:
FUNCTION_BLOCK FB_VN_ReadCalibrationPattern
VAR_INPUT
sFilePath : STRING;
ipDestContainer : Reference To ITcVnContainer;
bRead : BOOL;
nTimeout : TIME;
END_VAR
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrorId : UDINT;
END_VAR
Inputs
|
Name |
Type |
Default |
Description |
|---|---|---|---|
|
sFilePath |
STRING |
|
Full path of the file or relative path to the default directory on the target pc |
|
ipDestContainer |
Reference To ITcVnContainer |
|
Returns a container with the pattern points (ContainerType_Vector_TcVnPoint3_REAL) |
|
bRead |
BOOL |
|
Reading the file is triggered by a rising edge at this input. |
|
nTimeout |
TIME |
VISION_ADS_TIMEOUT |
Indicates the time before the function is cancelled. |
Outputs
|
Name |
Type |
Description |
|---|---|---|
|
bBusy |
BOOL |
This output remains TRUE until the function block has executed a command, but at the longest for the duration supplied to the 'nTimeout' input. While bBusy = TRUE, no new command will be accepted at the inputs. |
|
bError |
BOOL |
This output is switched to TRUE as soon as an error occurs during the execution of a command. The command-specific error code is contained in ‘nErrorId’. If the function block has a timeout error, 'bError' is TRUE and 'nErrorId' is 1861 (hexadecimal 0x745). Is reset to FALSE by the execution of a command at the inputs. |
|
nErrorId |
UDINT |
Contains the ADS error code or the command-specific error code of the last executed command. Is reset to 0 by the execution of a command at the inputs. |
Weiterführende Informationen
Der Funktionsblock FB_VN_ReadCalibrationPattern lädt die Beschreibung eines individuellen Kalibrationsmusters asynchron aus einer Datei.
 | Laden von geänderten Containern Beim Einladen der Container cached der Vision-Service die Daten intern. Ein Einladen von geänderten Containern ist somit im Standard nicht möglich. Passen Sie dazu die die Cache Einstellungen an oder sehen Sie das Beispiel Serielles Laden von Bildern in die SPS für eine Alternative. |
Parameter
Einige Parameter sind zentral in der Sektion File Access Parameter beschrieben.
Geladener Container (Rückgabewert)
Der geladene Container mit den Referenzpunkten des Kalibriermusters ist nach erfolgreichem Lesevorgang über den Interface Pointer ipPatternReferencePoints zu erreichen.
Anwendung
Das Laden der Referenzpunkte eines Kalibriermusters vom Pfad C:\TcVision\CalibrationPatternReferencePoints.xml sieht z. B. so aus:
fbReadCalibrationPattern(
sFilePath := 'C:\TcVision\CalibrationPatternReferencePoints.xml',
ipDestContainer := ipPatternReferencePoints,
bRead := TRUE,
nTimeout := T#500MS);
IF NOT fbReadCalibrationPattern.bBusy AND NOT fbReadCalibrationPattern.bError THEN
// reference points are accessible in ipPatternReferencePoints
END_IF
Required License
TC3 Vision Base
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1. 4024.44 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |