Resample

Performs picture resampling defined in terms of picture area corner displacements.

Syntax

IppStatus ippiResample_H263_8u_P3R(const Ipp8u* pSrcY, int srcYStep, IppiSize ySrcRoiSize, const Ipp8u* pSrcCb, int srcCbStep, const Ipp8u* pSrcCr, int srcCrStep, Ipp8u* pDstY, int dstYStep, IppiSize dstYRoiSize, Ipp8u* pDstCb, int dstCbStep, Ipp8u* pDstCr, int dstCrStep, IppMotionVector warpParams[4], int wda, int rounding, int fillMode, int fillColor[3]);

Parameters

pSrcY

Pointer to the origin of the source image region of interest (ROI) in the luminance plane.

srcYStep

Width in bytes of the source image luminance (Y) plane, that is, distance in bytes between the starting ends of consecutive lines of the source image in the luminance plane.

ySrcRoiSize

Size of the source ROI in the luminance plane.

pSrcCb

Pointer to the origin of the source ROI in Cb chrominance plane.

srcCbStep

Width in bytes of the source image Cb chrominance plane.

pSrcCr

Pointer to the origin of the source image ROI in Cr chrominance plane.

srcCrStep

Width in bytes of the source image Cr chrominance plane.

pDstY

Pointer to the origin of the destination image ROI in the luminance plane.

dstYStep

Width in bytes of the destination image luminance plane.

yDstRoiSize

Size of the destination ROI in th eluminance plane.

pDstCb

Pointer to the origin of the destination image ROI in Cb chrominance plane.

dstCbStep

Width in bytes of the destination image Cb chrominance plane.

pDstCr

Pointer to the origin of the destination image ROI in Cr chrominance plane.

dstCrStep

Width in bytes of the destination image Cr chrominance plane.

warpParams

Array of warping parameters - 4 pairs of motion vectors, describing, in the order they are stored in the array, how the upper left, upper right, lower left, and lower right corners of the destination ROI are mapped onto the source image.

wda

Warping displacement accuracy flag, if set to 0, pixel displacements are quantized to half-pixel accuracy, otherwise - to 1/16-pixel accuracy.

rounding

Rounding value that is used in pixel iterpolation, can be 0 or 1.

fillMode

Flag that defines the fill-mode action for the values of the source pixels for which the calculated location in the source image lies outside of the source image ROI. This parameter takes one of the following values:

0,	indicating color fill mode, the “outside” Y, Cb, and Cr pixel values are set to fillColor[0], fillColor[1], and fillColor[2], respectively.
1	- black fill mode, the “outside” pixel values are set as follows: Y = 16, Cb = Cr = 128.
2	- gray fill mode, the “outside” pixel values are all set to 128.
3	- blackclip fill mode, the “outside” pixel values are extrapolated from the values of pixels at the ROI border, as specified in [ITUH263], Annex D.

fillColor

Array of fill color values used in color fill mode.

Description

The function ippiResample_H263_8u_P3R is declared in the ippvc.h header file. This function resamples a YCbCr picture as specified in [ITUH263], Annex P. The destination picture ROI is mapped onto the source picture ROI as defined by warpParams. The pixels falling outside the source image ROI are estimated according to fillMode.

Return Values

ippStsNoErr	Indicates no error.
ippStsNullPtrErr	Indicates an error condition if at least one of the specified pointers is NULL.
ippStsSizeErr	Indicates an error condition if yRoiSize or yDstRoiSize have a field that is odd or less than 4.