ITcVnBitmapExportRpcUnlocked
Interface to export an image as a Windows Bitmap (BMP) into a given buffer by means of an unlocked remote procedure call.
Methods
Name |
Origin |
Description |
---|---|---|
ITcUnknown |
Increments the reference counter. | |
ITcUnknown |
Get a reference to an implemented interface. | |
ITcUnknown |
Decrements the reference counter. | |
ITcVnBitmapExport |
Gets size of the image if it is converted to a Windows Bitmap (BMP). | |
ITcVnBitmapExport |
Export the image as a Windows Bitmap (BMP) into a given buffer. | |
ITcVnBitmapExportRpcUnlocked |
Export the image as a Windows Bitmap (BMP) into a given buffer by means of an unlocked remote procedure call. It lies within the responsibility of the user to ensure that no conflicting accesses can occur. |
Further information
By definition, a bitmap can have only 8 bits (for 1-channel images) or 24 bits (for 3 and 4-channel images). Therefore, 16-bit images as well as images with the element type REAL or LREAL are converted for the bitmap export. In the case of 16-bit images the value range is simply scaled down to 8-bit (0 corresponds to 0 and 255 corresponds to 65,280). In the case of (L)REAL images the value range [-1, +1] is scaled to [-127, +127] and transferred as a signed integer. Values outside these limits will be interpreted as -1 or +1 respectively.
System Requirements
Development environment | Target platform | PLC libraries to include |
---|---|---|
TwinCAT V3.1.4024.54 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |