Class NPPNativeMethods.NPPi.ColorTwistBatch

Perform color twist pixel batch processing. Color twist consists of applying the following formula to each image pixel using coefficients from one or more user supplied color twist device memory matrix arrays as follows where dst[x] and src[x] represent destination pixel and source pixel channel or plane x.The full sized coefficient matrix should be sent for all pixel channel sizes, the function will process the appropriate coefficients and channels for the corresponding pixel size. ColorTwistBatch generally takes the same parameter list as ColorTwist except that there is a list of N instances of those parameters (N > 1) and that list is passed in device memory; The matrix pointers referenced for each image in the batch also need to point to device memory matrix values.A convenient data structure is provided that allows for easy initialization of the parameter lists.The only restriction on these functions is that there is one single ROI which is 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.

Inheritance

System.Object

NPPNativeMethods.NPPi.ColorTwistBatch

Inherited Members

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: ManagedCuda.NPP

Assembly: NPP.dll

Syntax

public static class ColorTwistBatch

Methods

nppiColorTwistBatch_32f_AC4IR(Single, Single, NppiSize, CUdeviceptr, Int32)

4 channel 32-bit floating point in place color twist batch, not affecting Alpha.

An input color twist matrix with floating-point coefficient values is applied within ROI for each image in batch. Color twist matrix can vary per image. The same ROI is applied to each image.

Declaration

public static NppStatus nppiColorTwistBatch_32f_AC4IR(float nMin, float nMax, NppiSize oSizeROI, CUdeviceptr pBatchList, int nBatchSize)

Parameters

Type	Name	Description
System.Single	nMin	Minimum clamp value.
System.Single	nMax	Maximum saturation and clamp value.
NppiSize	oSizeROI	Region-of-Interest (ROI).
CUdeviceptr	pBatchList	Device memory pointer to nBatchSize list of NppiColorTwistBatchCXR structures.
System.Int32	nBatchSize	Number of NppiColorTwistBatchCXR structures in this call (must be > 1).

Returns

Type	Description
NppStatus

nppiColorTwistBatch_32f_AC4R(Single, Single, NppiSize, CUdeviceptr, Int32)

4 channel 32-bit floating point color twist batch, not affecting Alpha.

An input color twist matrix with floating-point coefficient values is applied within the ROI for each image in batch. Color twist matrix can vary per image. The same ROI is applied to each image.

Declaration

public static NppStatus nppiColorTwistBatch_32f_AC4R(float nMin, float nMax, NppiSize oSizeROI, CUdeviceptr pBatchList, int nBatchSize)

Parameters

Type	Name	Description
System.Single	nMin	Minimum clamp value.
System.Single	nMax	Maximum saturation and clamp value.
NppiSize	oSizeROI	Region-of-Interest (ROI).
CUdeviceptr	pBatchList	Device memory pointer to nBatchSize list of NppiColorTwistBatchCXR structures.
System.Int32	nBatchSize	Number of NppiColorTwistBatchCXR structures in this call (must be > 1).

Returns

Type	Description
NppStatus

nppiColorTwistBatch_32f_C1IR(Single, Single, NppiSize, CUdeviceptr, Int32)

1 channel 32-bit floating point in place color twist batch.

An input color twist matrix with floating-point coefficient values is applied within ROI for each image in batch. Color twist matrix can vary per image. The same ROI is applied to each image.

Declaration

public static NppStatus nppiColorTwistBatch_32f_C1IR(float nMin, float nMax, NppiSize oSizeROI, CUdeviceptr pBatchList, int nBatchSize)

Parameters

Type	Name	Description
System.Single	nMin	Minimum clamp value.
System.Single	nMax	Maximum saturation and clamp value.
NppiSize	oSizeROI	Region-of-Interest (ROI).
CUdeviceptr	pBatchList	Device memory pointer to nBatchSize list of NppiColorTwistBatchCXR structures.
System.Int32	nBatchSize	Number of NppiColorTwistBatchCXR structures in this call (must be > 1).

Returns

Type	Description
NppStatus

nppiColorTwistBatch_32f_C1R(Single, Single, NppiSize, CUdeviceptr, Int32)

1 channel 32-bit floating point color twist batch.

An input color twist matrix with floating-point coefficient values is applied within the ROI for each image in batch. Color twist matrix can vary per image. The same ROI is applied to each image.

Declaration

public static NppStatus nppiColorTwistBatch_32f_C1R(float nMin, float nMax, NppiSize oSizeROI, CUdeviceptr pBatchList, int nBatchSize)

Parameters

Type	Name	Description
System.Single	nMin	Minimum clamp value.
System.Single	nMax	Maximum saturation and clamp value.
NppiSize	oSizeROI	Region-of-Interest (ROI).
CUdeviceptr	pBatchList	Device memory pointer to nBatchSize list of NppiColorTwistBatchCXR structures.
System.Int32	nBatchSize	Number of NppiColorTwistBatchCXR structures in this call (must be > 1).

Returns

Type	Description
NppStatus

nppiColorTwistBatch_32f_C3IR(Single, Single, NppiSize, CUdeviceptr, Int32)

3 channel 32-bit floating point in place color twist batch.

An input color twist matrix with floating-point coefficient values is applied within ROI for each image in batch. Color twist matrix can vary per image. The same ROI is applied to each image.

Declaration

public static NppStatus nppiColorTwistBatch_32f_C3IR(float nMin, float nMax, NppiSize oSizeROI, CUdeviceptr pBatchList, int nBatchSize)

Parameters

Type	Name	Description
System.Single	nMin	Minimum clamp value.
System.Single	nMax	Maximum saturation and clamp value.
NppiSize	oSizeROI	Region-of-Interest (ROI).
CUdeviceptr	pBatchList	Device memory pointer to nBatchSize list of NppiColorTwistBatchCXR structures.
System.Int32	nBatchSize	Number of NppiColorTwistBatchCXR structures in this call (must be > 1).

Returns

Type	Description
NppStatus

nppiColorTwistBatch_32f_C3R(Single, Single, NppiSize, CUdeviceptr, Int32)

3 channel 32-bit floating point color twist batch.

An input color twist matrix with floating-point coefficient values is applied within the ROI for each image in batch. Color twist matrix can vary per image. The same ROI is applied to each image.

Declaration

public static NppStatus nppiColorTwistBatch_32f_C3R(float nMin, float nMax, NppiSize oSizeROI, CUdeviceptr pBatchList, int nBatchSize)

Parameters

Type	Name	Description
System.Single	nMin	Minimum clamp value.
System.Single	nMax	Maximum saturation and clamp value.
NppiSize	oSizeROI	Region-of-Interest (ROI).
CUdeviceptr	pBatchList	Device memory pointer to nBatchSize list of NppiColorTwistBatchCXR structures.
System.Int32	nBatchSize	Number of NppiColorTwistBatchCXR structures in this call (must be > 1).

Returns

Type	Description
NppStatus

nppiColorTwistBatch_32f_C4IR(Single, Single, NppiSize, CUdeviceptr, Int32)

4 channel 32-bit floating point in place color twist batch.

An input color twist matrix with floating-point coefficient values is applied within ROI for each image in batch. Color twist matrix can vary per image. The same ROI is applied to each image.

Declaration

public static NppStatus nppiColorTwistBatch_32f_C4IR(float nMin, float nMax, NppiSize oSizeROI, CUdeviceptr pBatchList, int nBatchSize)

Parameters

Type	Name	Description
System.Single	nMin	Minimum clamp value.
System.Single	nMax	Maximum saturation and clamp value.
NppiSize	oSizeROI	Region-of-Interest (ROI).
CUdeviceptr	pBatchList	Device memory pointer to nBatchSize list of NppiColorTwistBatchCXR structures.
System.Int32	nBatchSize	Number of NppiColorTwistBatchCXR structures in this call (must be > 1).

Returns

Type	Description
NppStatus

nppiColorTwistBatch_32f_C4R(Single, Single, NppiSize, CUdeviceptr, Int32)

4 channel 32-bit floating point color twist batch.

An input color twist matrix with floating-point coefficient values is applied within the ROI for each image in batch. Color twist matrix can vary per image. The same ROI is applied to each image.

Declaration

public static NppStatus nppiColorTwistBatch_32f_C4R(float nMin, float nMax, NppiSize oSizeROI, CUdeviceptr pBatchList, int nBatchSize)

Parameters

Type	Name	Description
System.Single	nMin	Minimum clamp value.
System.Single	nMax	Maximum saturation and clamp value.
NppiSize	oSizeROI	Region-of-Interest (ROI).
CUdeviceptr	pBatchList	Device memory pointer to nBatchSize list of NppiColorTwistBatchCXR structures.
System.Int32	nBatchSize	Number of NppiColorTwistBatchCXR structures in this call (must be > 1).

Returns

Type	Description
NppStatus

nppiColorTwistBatch_32fC_C4IR(Single, Single, NppiSize, CUdeviceptr, Int32)

4 channel in place 32-bit floating point color twist with 4x5 matrix including a constant vector (20 coefficients total). An input 4x5 color twist matrix with floating-point coefficient values including a constant (in the fourth column) vector is applied within ROI. For this particular version of the function the result is generated as shown below. \code dst[0] = aTwist[0][0] /// src[0] + aTwist[0][1] /// src[1] + aTwist[0][2] /// src[2] + aTwist[0][3] /// src[3] + aTwist[0][4] dst[1] = aTwist[1][0] /// src[0] + aTwist[1][1] /// src[1] + aTwist[1][2] /// src[2] + aTwist[1][3] /// src[3] + aTwist[1][4] dst[2] = aTwist[2][0] /// src[0] + aTwist[2][1] /// src[1] + aTwist[2][2] /// src[2] + aTwist[2][3] /// src[3] + aTwist[2][4] dst[3] = aTwist[3][0] /// src[0] + aTwist[3][1] /// src[1] + aTwist[3][2] /// src[2] + aTwist[3][3] /// src[3] + aTwist[3][4] \endcode An input color twist matrix with floating-point coefficient values is applied within ROI for each image in batch. Color twist matrix can vary per image. The same ROI is applied to each image.

Declaration

public static NppStatus nppiColorTwistBatch_32fC_C4IR(float nMin, float nMax, NppiSize oSizeROI, CUdeviceptr pBatchList, int nBatchSize)

Parameters

Type	Name	Description
System.Single	nMin	Minimum clamp value.
System.Single	nMax	Maximum saturation and clamp value.
NppiSize	oSizeROI	Region-of-Interest (ROI).
CUdeviceptr	pBatchList	Device memory pointer to nBatchSize list of NppiColorTwistBatchCXR structures.
System.Int32	nBatchSize	Number of NppiColorTwistBatchCXR structures in this call (must be > 1).

Returns

Type	Description
NppStatus

nppiColorTwistBatch_32fC_C4R(Single, Single, NppiSize, CUdeviceptr, Int32)

4 channel 32-bit floating point color twist with 4x5 matrix including a constant vector (20 coefficients total). An input 4x5 color twist matrix with floating-point coefficient values including a constant (in the fourth column) vector is applied within ROI. For this particular version of the function the result is generated as shown below. \code dst[0] = aTwist[0][0] /// src[0] + aTwist[0][1] /// src[1] + aTwist[0][2] /// src[2] + aTwist[0][3] /// src[3] + aTwist[0][4] dst[1] = aTwist[1][0] /// src[0] + aTwist[1][1] /// src[1] + aTwist[1][2] /// src[2] + aTwist[1][3] /// src[3] + aTwist[1][4] dst[2] = aTwist[2][0] /// src[0] + aTwist[2][1] /// src[1] + aTwist[2][2] /// src[2] + aTwist[2][3] /// src[3] + aTwist[2][4] dst[3] = aTwist[3][0] /// src[0] + aTwist[3][1] /// src[1] + aTwist[3][2] /// src[2] + aTwist[3][3] /// src[3] + aTwist[3][4] \endcode An input color twist matrix with floating-point coefficient values is applied within ROI for each image in batch. Color twist matrix can vary per image. The same ROI is applied to each image.

Declaration

public static NppStatus nppiColorTwistBatch_32fC_C4R(float nMin, float nMax, NppiSize oSizeROI, CUdeviceptr pBatchList, int nBatchSize)

Parameters

Type	Name	Description
System.Single	nMin	Minimum clamp value.
System.Single	nMax	Maximum saturation and clamp value.
NppiSize	oSizeROI	Region-of-Interest (ROI).
CUdeviceptr	pBatchList	Device memory pointer to nBatchSize list of NppiColorTwistBatchCXR structures.
System.Int32	nBatchSize	Number of NppiColorTwistBatchCXR structures in this call (must be > 1).

Returns

Type	Description
NppStatus