ITcVnBitmapExportRpcUnlocked

Interface to export an image as a Windows Bitmap (BMP) into a given buffer by means of an unlocked remote procedure call.

Inheritance Hierarchy

ITcUnknown
    ITcVnBitmapExport
        ITcVnBitmapExportRpcUnlocked

ITcVnBitmapExportRpcUnlocked 1: Methods

Name

Origin

Description

TcAddRef

ITcUnknown

Increments the reference counter.

TcQueryInterface

ITcUnknown

Get a reference to an implemented interface.

TcRelease

ITcUnknown

Decrements the reference counter.

GetBitmapSize

ITcVnBitmapExport

Gets size of the image if it is converted to a Windows Bitmap (BMP).

GetBitmapImage

ITcVnBitmapExport

Export the image as a Windows Bitmap (BMP) into a given buffer.

GetBitmapImageRpcUnlocked

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