NVIDIA 2D Image And Signal Performance Primitives (NPP)  Version 10.2.*.*
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
Data Structures | Functions
Affine Transform Batch

Details of the warp affine operation are described above in the WarpAffine section. More...

Data Structures

struct   NppiWarpAffineBatchCXR
 

Functions

NppStatus  nppiWarpAffineBatchInit_Ctx (NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  Initializes the aTransformdedCoeffs array in pBatchList for each image in the list. More...
 
NppStatus  nppiWarpAffineBatchInit (NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 
NppStatus  nppiWarpAffineBatch_8u_C1R_Ctx (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  1 channel 8-bit unsigned integer image warp affine batch. More...
 
NppStatus  nppiWarpAffineBatch_8u_C1R (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 
NppStatus  nppiWarpAffineBatch_8u_C3R_Ctx (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  3 channel 8-bit unsigned integer image warp affine batch. More...
 
NppStatus  nppiWarpAffineBatch_8u_C3R (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 
NppStatus  nppiWarpAffineBatch_8u_C4R_Ctx (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  4 channel 8-bit unsigned integer image warp affine batch. More...
 
NppStatus  nppiWarpAffineBatch_8u_C4R (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 
NppStatus  nppiWarpAffineBatch_8u_AC4R_Ctx (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  4 channel 8-bit unsigned integer image warp affine batch not affecting alpha. More...
 
NppStatus  nppiWarpAffineBatch_8u_AC4R (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 
NppStatus  nppiWarpAffineBatch_16f_C1R_Ctx (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  1 channel 16-bit floating point image warp affine batch. More...
 
NppStatus  nppiWarpAffineBatch_16f_C1R (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 
NppStatus  nppiWarpAffineBatch_16f_C3R_Ctx (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  3 channel 16-bit floating point image warp affine batch. More...
 
NppStatus  nppiWarpAffineBatch_16f_C3R (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 
NppStatus  nppiWarpAffineBatch_16f_C4R_Ctx (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  4 channel 16-bit floating point image warp affine batch. More...
 
NppStatus  nppiWarpAffineBatch_16f_C4R (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 
NppStatus  nppiWarpAffineBatch_32f_C1R_Ctx (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  1 channel 32-bit floating point image warp affine batch. More...
 
NppStatus  nppiWarpAffineBatch_32f_C1R (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 
NppStatus  nppiWarpAffineBatch_32f_C3R_Ctx (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  3 channel 32-bit floating point image warp affine batch. More...
 
NppStatus  nppiWarpAffineBatch_32f_C3R (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 
NppStatus  nppiWarpAffineBatch_32f_C4R_Ctx (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  4 channel 32-bit floating point image warp affine batch. More...
 
NppStatus  nppiWarpAffineBatch_32f_C4R (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 
NppStatus  nppiWarpAffineBatch_32f_AC4R_Ctx (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize, NppStreamContext nppStreamCtx)
  4 channel 32-bit floating point image warp affine batch not affecting alpha. More...
 
NppStatus  nppiWarpAffineBatch_32f_AC4R (NppiSize oSmallestSrcSize, NppiRect oSrcRectROI, NppiRect oDstRectROI, int eInterpolation, NppiWarpAffineBatchCXR *pBatchList, unsigned int nBatchSize)
 

Detailed Description

Details of the warp affine operation are described above in the WarpAffine section.

WarpAffineBatch generally takes the same parameter list as WarpAffine except that there is a list of N instances of those parameters (N > 1) and that list is passed in device memory. A convenient data structure is provided that allows for easy initialization of the parameter lists. The aTransformedCoeffs array is for internal use only and should not be directly initialized by the application. The only restriction on these functions is that there is one single source ROI rectangle and one single destination ROI rectangle which are applied respectively to each image in the batch. The primary purpose of this function is to provide improved performance for batches of smaller images as long as GPU resources are available. Therefore it is recommended that the function not be used for very large images as there may not be resources available for processing several large images simultaneously. A single set of oSrcRectROI and oDstRectROI values are applied to each source image and destination image in the batch. Source and destination image sizes may vary but oSmallestSrcSize must be set to the smallest source and image size in the batch. The parameters in the NppiWarpAffineBatchCXR structure represent the corresponding per-image nppiWarpAffine parameters for each image in the batch. The NppiWarpAffineBatchCXR array must be in device memory. The nppiWarpAffineBatchInit function MUST be called AFTER the application has initialized the array of NppiWarpAffineBatchCXR structures and BEFORE calling any of the nppiWarpAffineBatch functions to so that the aTransformedCoeffs array can be internally pre-initialized for each image in the batch. The batch size passed to nppiWarpAffineBatchInit must match the batch size passed to the corresponding warp affine batch function.

WarpAffineBatch supports the following interpolation modes:

*

Codes

The warp affine primitives return the following error codes:

    - ::NPP_RECTANGLE_ERROR if either destination ROI width or
      height is less than 1 pixel.
    - ::NPP_INTERPOLATION_ERROR if eInterpolation has an illegal value.
    - ::NPP_SIZE_ERROR if source size width or height is less than 2 pixels.

Common parameters for nppiWarpAffineBatch functions include:

Parameters
oSmallestSrcSize Size in pixels of the entire smallest source image width and height, may be from different images.
oSrcRectROI Region of interest in the source images.
oDstRectROI Region of interest in the destination images.
eInterpolation The type of eInterpolation to perform resampling. Currently limited to NPPI_INTER_NN, NPPI_INTER_LINEAR, or NPPI_INTER_CUBIC.
pBatchList Device memory pointer to nBatchSize list of NppiWarpAffineBatchCXR structures.
nBatchSize Number of NppiWarpAffineBatchCXR structures in this call (must be > 1).
nppStreamCtx Application Managed Stream Context.
Returns
Image Data Related Error Codes, ROI Related Error Codes

Function Documentation

NppStatus nppiWarpAffineBatch_16f_C1R ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatch_16f_C1R_Ctx ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

1 channel 16-bit floating point image warp affine batch.

For common parameter descriptions, see Common parameters for nppiWarpAffineBatch functions.

NppStatus nppiWarpAffineBatch_16f_C3R ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatch_16f_C3R_Ctx ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

3 channel 16-bit floating point image warp affine batch.

For common parameter descriptions, see Common parameters for nppiWarpAffineBatch functions.

NppStatus nppiWarpAffineBatch_16f_C4R ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatch_16f_C4R_Ctx ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

4 channel 16-bit floating point image warp affine batch.

For common parameter descriptions, see Common parameters for nppiWarpAffineBatch functions.

NppStatus nppiWarpAffineBatch_32f_AC4R ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatch_32f_AC4R_Ctx ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

4 channel 32-bit floating point image warp affine batch not affecting alpha.

For common parameter descriptions, see Common parameters for nppiWarpAffineBatch functions.

NppStatus nppiWarpAffineBatch_32f_C1R ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatch_32f_C1R_Ctx ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

1 channel 32-bit floating point image warp affine batch.

For common parameter descriptions, see Common parameters for nppiWarpAffineBatch functions.

NppStatus nppiWarpAffineBatch_32f_C3R ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatch_32f_C3R_Ctx ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

3 channel 32-bit floating point image warp affine batch.

For common parameter descriptions, see Common parameters for nppiWarpAffineBatch functions.

NppStatus nppiWarpAffineBatch_32f_C4R ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatch_32f_C4R_Ctx ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

4 channel 32-bit floating point image warp affine batch.

For common parameter descriptions, see Common parameters for nppiWarpAffineBatch functions.

NppStatus nppiWarpAffineBatch_8u_AC4R ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatch_8u_AC4R_Ctx ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

4 channel 8-bit unsigned integer image warp affine batch not affecting alpha.

For common parameter descriptions, see Common parameters for nppiWarpAffineBatch functions.

NppStatus nppiWarpAffineBatch_8u_C1R ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatch_8u_C1R_Ctx ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

1 channel 8-bit unsigned integer image warp affine batch.

For common parameter descriptions, see Common parameters for nppiWarpAffineBatch functions.

NppStatus nppiWarpAffineBatch_8u_C3R ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatch_8u_C3R_Ctx ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

3 channel 8-bit unsigned integer image warp affine batch.

For common parameter descriptions, see Common parameters for nppiWarpAffineBatch functions.

NppStatus nppiWarpAffineBatch_8u_C4R ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatch_8u_C4R_Ctx ( NppiSize  oSmallestSrcSize,
NppiRect  oSrcRectROI,
NppiRect  oDstRectROI,
int  eInterpolation,
NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

4 channel 8-bit unsigned integer image warp affine batch.

For common parameter descriptions, see Common parameters for nppiWarpAffineBatch functions.

NppStatus nppiWarpAffineBatchInit ( NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize 
)
NppStatus nppiWarpAffineBatchInit_Ctx ( NppiWarpAffineBatchCXR pBatchList,
unsigned int  nBatchSize,
NppStreamContext  nppStreamCtx 
)

Initializes the aTransformdedCoeffs array in pBatchList for each image in the list.

MUST be called before calling the corresponding warp affine batch function whenever any of the transformation matrices in the list have changed.

Parameters
pBatchList Device memory pointer to nBatchSize list of NppiWarpAffineBatchCXR structures.
nBatchSize Number of NppiWarpAffineBatchCXR structures in this call (must be > 1).
nppStreamCtx Application Managed Stream Context.