Image Manager (CVCImg.dll) 14.1
VPAEntry Struct Reference

Individual entry in the IImageVPA object's PVPAT. More...

Data Fields

intptr_t XEntry
 Memory x-offset in bytes (columns). More...
 
intptr_t YEntry
 Memory y-offset in bytes (lines). More...
 

Detailed Description

Individual entry in the IImageVPA object's PVPAT.

The VPAEntry array PVPAT is returned from GetImageVPA. The overall size (or length in element units) of the array is

cvbdim_t GetVPATLength(IMG Image)
{
return max(ImageWidth(Image), ImageHeight(Image));
}
cvbdim_t ImageWidth(IMG Image)
Gets the width of the Image.
Definition: PseudoCOMExports.cpp:387
cvbdim_t ImageHeight(IMG Image)
Gets the height of the Image.
Definition: PseudoCOMExports.cpp:413
void * IMG
CVB 2D image handle.
Definition: CVTypes.h:95
Note
The XEntry entries are only valid up to the ImageWidth and the YEntry entries up to ImageHeight.
In the picture at VPAT you see the logical setup of the VPAT. But if you look at this struct, you see that it combines XEntry and YEntry. Using this is a little unusual, but yields better cache behavior as all the offsets are in one contiguous memory block and all offsets are known.
If you take the two logical tables (X-table and Y-table from the VPAT image), you get the valid portion of the PVPAT array:
See also
VPAT for an explanation on how to use this data structure.

Field Documentation

◆ XEntry

VPAEntry::XEntry

Memory x-offset in bytes (columns).

Validity of this value depends on the ImageWidth. The offset is calculated from the base pointer returned by GetImageVPA.

◆ YEntry

VPAEntry::YEntry

Memory y-offset in bytes (lines).

Validity of this value depends on the ImageHeight. The offset is calculated from the base pointer returned by GetImageVPA.