ITcVnImage

Inheritance Hierarchy

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.
GetImageData	ITcVnImageBase	Gets the data interface (Do not explicitly free the pointer in there!).
GetImageSize	ITcVnImageBase	Gets the image size.
GetWidth	ITcVnImageBase	Gets the image width (alternatively use F_VN_GetImageWidth).
GetHeight	ITcVnImageBase	Gets the image height (alternatively use F_VN_GetImageHeight).
GetXPadding	ITcVnImageBase	Gets the horizontal padding.
GetYPadding	ITcVnImageBase	Gets the vertical padding.
GetPixelFormat	ITcVnImageBase	Gets the pixel format (alternatively use F_VN_GetPixelFormat).
GetImageInfo	ITcVnImageBase	Gets a struct containing all common meta infos of the image. This basically encompasses all meta information accessible via this interface. (Alternatively use F_VN_GetImageInfo.)
Init	ITcVnImage	Initialize an image with an ITcVnImageBase interface.
GetRowPointer	ITcVnImage	Gets a pointer to a specific row of an image.
ReleaseRowPointer	ITcVnImage	Release the pointer to a specific row of an image.

Further information

The interface ITcVnImage is for handling images. It provides methods for obtaining metadata such as image size, number of channels, pixel type etc. and for accessing the raw image data.

This interface is not suitable for image display via ADS (e.g. with ADS Image Watch). The ITcVnDisplayableImage interface is required for image display via ADS. A conversion can be carried out with the following functions:

Related functions

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1.4024.59 or later	PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision