NVIDIA 2D Image And Signal Performance Primitives (NPP)  Version 11.3.0.*
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
Functions
Memory Management
NPP Image Processing

Routines for allocating and deallocating pitched image storage. More...

Functions

void  nppiFree (void *pData)
  Free method for any 2D allocated memory. More...
 

Image Memory Allocation

ImageAllocator methods for 2D arrays of data.

The allocators have width and height parameters to specify the size of the image data being allocated. They return a pointer to the newly created memory and return the numbers of bytes between successive lines.

If the memory allocation failed due to lack of free device memory or device memory fragmentation the routine returns 0.

All allocators return memory with line strides that are beneficial for performance. It is not mandatory to use these allocators. Any valid CUDA device-memory pointers can be used by the NPP primitives and there are no restrictions on line strides.

Npp8u *  nppiMalloc_8u_C1 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  8-bit unsigned image memory allocator. More...
 
Npp8u *  nppiMalloc_8u_C2 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  2 channel 8-bit unsigned image memory allocator. More...
 
Npp8u *  nppiMalloc_8u_C3 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  3 channel 8-bit unsigned image memory allocator. More...
 
Npp8u *  nppiMalloc_8u_C4 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  4 channel 8-bit unsigned image memory allocator. More...
 
Npp16u *  nppiMalloc_16u_C1 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  16-bit unsigned image memory allocator. More...
 
Npp16u *  nppiMalloc_16u_C2 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  2 channel 16-bit unsigned image memory allocator. More...
 
Npp16u *  nppiMalloc_16u_C3 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  3 channel 16-bit unsigned image memory allocator. More...
 
Npp16u *  nppiMalloc_16u_C4 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  4 channel 16-bit unsigned image memory allocator. More...
 
Npp16s *  nppiMalloc_16s_C1 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  16-bit signed image memory allocator. More...
 
Npp16s *  nppiMalloc_16s_C2 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  2 channel 16-bit signed image memory allocator. More...
 
Npp16s *  nppiMalloc_16s_C4 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  4 channel 16-bit signed image memory allocator. More...
 
Npp16sc *  nppiMalloc_16sc_C1 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  1 channel 16-bit signed complex image memory allocator. More...
 
Npp16sc *  nppiMalloc_16sc_C2 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  2 channel 16-bit signed complex image memory allocator. More...
 
Npp16sc *  nppiMalloc_16sc_C3 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  3 channel 16-bit signed complex image memory allocator. More...
 
Npp16sc *  nppiMalloc_16sc_C4 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  4 channel 16-bit signed complex image memory allocator. More...
 
Npp32s *  nppiMalloc_32s_C1 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  32-bit signed image memory allocator. More...
 
Npp32s *  nppiMalloc_32s_C3 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  3 channel 32-bit signed image memory allocator. More...
 
Npp32s *  nppiMalloc_32s_C4 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  4 channel 32-bit signed image memory allocator. More...
 
Npp32sc *  nppiMalloc_32sc_C1 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  32-bit integer complex image memory allocator. More...
 
Npp32sc *  nppiMalloc_32sc_C2 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  2 channel 32-bit integer complex image memory allocator. More...
 
Npp32sc *  nppiMalloc_32sc_C3 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  3 channel 32-bit integer complex image memory allocator. More...
 
Npp32sc *  nppiMalloc_32sc_C4 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  4 channel 32-bit integer complex image memory allocator. More...
 
Npp32f *  nppiMalloc_32f_C1 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  32-bit floating point image memory allocator. More...
 
Npp32f *  nppiMalloc_32f_C2 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  2 channel 32-bit floating point image memory allocator. More...
 
Npp32f *  nppiMalloc_32f_C3 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  3 channel 32-bit floating point image memory allocator. More...
 
Npp32f *  nppiMalloc_32f_C4 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  4 channel 32-bit floating point image memory allocator. More...
 
Npp32fc *  nppiMalloc_32fc_C1 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  32-bit float complex image memory allocator. More...
 
Npp32fc *  nppiMalloc_32fc_C2 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  2 channel 32-bit float complex image memory allocator. More...
 
Npp32fc *  nppiMalloc_32fc_C3 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  3 channel 32-bit float complex image memory allocator. More...
 
Npp32fc *  nppiMalloc_32fc_C4 (int nWidthPixels, int nHeightPixels, int *pStepBytes)
  4 channel 32-bit float complex image memory allocator. More...
 

Detailed Description

Routines for allocating and deallocating pitched image storage.

These methods are provided for convenience. They allocate memory that may contain additional padding bytes at the end of each line of pixels. Though padding is not necessary for any of the NPP image-processing primitives to work correctly, its absense may cause sever performance degradation compared to properly padded images.

These functions can be found in the nppisu library. Linking to only the sub-libraries that you use can significantly save link time, application load time, and CUDA runtime startup time when using dynamic libraries.

Function Documentation

void nppiFree ( void *  pData )

Free method for any 2D allocated memory.

This method should be used to free memory allocated with any of the nppiMalloc_<modifier> methods.

Parameters
pData A pointer to memory allocated using nppiMalloc_<modifier>.
Npp16s* nppiMalloc_16s_C1 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

16-bit signed image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp16s* nppiMalloc_16s_C2 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

2 channel 16-bit signed image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp16s* nppiMalloc_16s_C4 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

4 channel 16-bit signed image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp16sc* nppiMalloc_16sc_C1 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

1 channel 16-bit signed complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp16sc* nppiMalloc_16sc_C2 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

2 channel 16-bit signed complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp16sc* nppiMalloc_16sc_C3 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

3 channel 16-bit signed complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp16sc* nppiMalloc_16sc_C4 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

4 channel 16-bit signed complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp16u* nppiMalloc_16u_C1 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

16-bit unsigned image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp16u* nppiMalloc_16u_C2 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

2 channel 16-bit unsigned image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp16u* nppiMalloc_16u_C3 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

3 channel 16-bit unsigned image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp16u* nppiMalloc_16u_C4 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

4 channel 16-bit unsigned image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32f* nppiMalloc_32f_C1 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

32-bit floating point image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32f* nppiMalloc_32f_C2 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

2 channel 32-bit floating point image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32f* nppiMalloc_32f_C3 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

3 channel 32-bit floating point image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32f* nppiMalloc_32f_C4 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

4 channel 32-bit floating point image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32fc* nppiMalloc_32fc_C1 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

32-bit float complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32fc* nppiMalloc_32fc_C2 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

2 channel 32-bit float complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32fc* nppiMalloc_32fc_C3 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

3 channel 32-bit float complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32fc* nppiMalloc_32fc_C4 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

4 channel 32-bit float complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32s* nppiMalloc_32s_C1 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

32-bit signed image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32s* nppiMalloc_32s_C3 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

3 channel 32-bit signed image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32s* nppiMalloc_32s_C4 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

4 channel 32-bit signed image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32sc* nppiMalloc_32sc_C1 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

32-bit integer complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32sc* nppiMalloc_32sc_C2 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

2 channel 32-bit integer complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32sc* nppiMalloc_32sc_C3 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

3 channel 32-bit integer complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp32sc* nppiMalloc_32sc_C4 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

4 channel 32-bit integer complex image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp8u* nppiMalloc_8u_C1 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

8-bit unsigned image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp8u* nppiMalloc_8u_C2 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

2 channel 8-bit unsigned image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp8u* nppiMalloc_8u_C3 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

3 channel 8-bit unsigned image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.
Npp8u* nppiMalloc_8u_C4 ( int  nWidthPixels,
int  nHeightPixels,
int *  pStepBytes 
)

4 channel 8-bit unsigned image memory allocator.

Parameters
nWidthPixels Image width.
nHeightPixels Image height.
pStepBytes Line Step.
Returns
Pointer to new image data.