Adjust Saturation

group Adjust Saturation

Functions

NVCVStatus cvcudaAdjustSaturationCreate(NVCVOperatorHandle *handle)

Constructs an instance of the AdjustSaturation operator.

Parameters:

handle – [out] Where the operator instance handle will be written to.

  • Must not be NULL.

Return values:

  • NVCV_ERROR_INVALID_ARGUMENT – Handle is null.

  • NVCV_ERROR_OUT_OF_MEMORY – Not enough memory to create the operator.

  • NVCV_SUCCESS – Operation executed successfully.

NVCVStatus cvcudaAdjustSaturationSubmit(NVCVOperatorHandle handle, cudaStream_t stream, NVCVTensorHandle in, NVCVTensorHandle out, double saturation)

Executes the AdjustSaturation operation on the given cuda stream. This operation does not wait for completion.

Limitations:

Input: Data Layout: [NVCV_TENSOR_NHWC, NVCV_TENSOR_HWC, NVCV_TENSOR_NCHW, NVCV_TENSOR_CHW] Channels: [1, 3]

Data Type

Allowed

8bit Unsigned

Yes

8bit Signed

No

16bit Unsigned

No

16bit Signed

No

32bit Unsigned

No

32bit Signed

No

16bit Float

No

32bit Float

Yes

64bit Float

No

Output: Data Layout: [NVCV_TENSOR_NHWC, NVCV_TENSOR_HWC, NVCV_TENSOR_NCHW, NVCV_TENSOR_CHW] Channels: [1, 3]

Data Type

Allowed

8bit Unsigned

Yes

8bit Signed

No

16bit Unsigned

No

16bit Signed

No

32bit Unsigned

No

32bit Signed

No

16bit Float

No

32bit Float

Yes

64bit Float

No

Input/Output dependency 

 Property      |  Input == Output
-------------- | -------------
 Data Layout   | Yes
 Data Type     | Yes
 Number        | Yes
 Channels      | Yes
 Width         | Yes
 Height        | Yes

Parameters:

  • handle – [in] Handle to the operator.

    • Must not be NULL.

  • stream – [in] Handle to a valid CUDA stream.

  • in – [in] input tensor.

  • out – [out] output tensor.

  • saturation – [in] Saturation factor applied to all images. Must be >= 0; 1 leaves the image unchanged, 0 yields grayscale, values > 1 over-saturate.

Return values:

  • NVCV_ERROR_INVALID_ARGUMENT – Some parameter is outside valid range.

  • NVCV_ERROR_INTERNAL – Internal error in the operator, invalid types passed in.

  • NVCV_SUCCESS – Operation executed successfully.

NVCVStatus cvcudaAdjustSaturationVarShapeSubmit(NVCVOperatorHandle handle, cudaStream_t stream, NVCVImageBatchHandle in, NVCVImageBatchHandle out, double saturation)

Executes the AdjustSaturation operation on a batch of variable-shaped images on the given cuda stream. Same limitations as cvcudaAdjustSaturationSubmit.

Parameters:

  • handle – [in] Handle to the operator. Must not be NULL.

  • stream – [in] Handle to a valid CUDA stream.

  • in – [in] input image batch.

  • out – [out] output image batch.

  • saturation – [in] Saturation factor applied to all images (see cvcudaAdjustSaturationSubmit).

Return values:

  • NVCV_ERROR_INVALID_ARGUMENT – Some parameter is outside valid range.

  • NVCV_ERROR_INTERNAL – Internal error in the operator, invalid types passed in.

  • NVCV_SUCCESS – Operation executed successfully.