Buffers and Surfaces
The surface start address is specified by surface class integer collection parameter SurfaceAddr. The start address must be 32-bit aligned.
The integer collection channel parameter MinBufferPitch reports for each plane of a surface the smallest buffer pitch required to store the image. It is mandatory that the image size is already defined. This is a number multiple of 4.
See Image scaling and grabbing window control for the image size definition.
The effective pitch of each plane buffer of a surface is specified by means of two integer collection parameters: the channel class parameter BufferPitch and the surface class parameter SurfacePitch. Their values must be identical. The range of values is restricted to integer numbers multiple of 4 greater or equal to the respective values of MinBufferPitch.
Note. A gap is required between successive lines for most of the values of ImageSizeX.
The integer collection channel parameter MinBufferPitch reports for each plane of a surface the smallest buffer size required to store the image. It is mandatory that the image size and the buffer pitch are already defined. This is a number multiple of 4.
The effective size of each plane buffer of a surface is specified by means of two integer collection parameters: the channel class parameter BufferSize and the surface class parameter SurfaceSize. Their values must be identical. The range of values is restricted to integer numbers multiple of 4 greater or equal to the respective values of MinBufferPitch.
Note. All plane buffers are 32-bit word aligned.
The topmost leftmost pixel of the image is stored at the lowest address of the plane buffer. This remains valid when image flipping is applied.