Package org.bytedeco.cuda.nppig

Class NppiWarpPerspectiveBatchCXR

  • All Implemented Interfaces:
    AutoCloseable
    @Properties(inherit=nppig.class)
public class NppiWarpPerspectiveBatchCXR
extends Pointer
    \defgroup perspective_transform_batch Perspective Transform Batch Details of the warp perspective operation are described above in the WarpPerspective section. WarpPerspectiveBatch generally takes the same parameter list as WarpPerspective 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 NppiWarpPerspectiveBatchCXR structure represent the corresponding per-image nppiWarpPerspective parameters for each image in the batch. The NppiWarpPerspectiveBatchCXR array must be in device memory. The nppiWarpPerspectiveBatchInit function MUST be called AFTER the application has initialized the array of NppiWarpPerspectiveBatchCXR structures and BEFORE calling any of the nppiWarpPerspectiveBatch functions to so that the aTransformedCoeffs array can be internally pre-initialized for each image in the batch. The batch size passed to nppiWarpPerspectiveBatchInit must match the batch size passed to the corresponding warp perspective batch function. WarpPerspectiveBatch supports the following interpolation modes: 
    
   NPPI_INTER_NN
   NPPI_INTER_LINEAR
   NPPI_INTER_CUBIC
    \section Error Codes The warp perspective 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 nppiWarpPerspectiveBatch functions include: