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.

Functions

Image Memory Allocation

Detailed Description

Function Documentation