Adjust Sharpness

group Adjust Sharpness

Functions

NVCVStatus cvcudaAdjustSharpnessCreate(NVCVOperatorHandle *handle)

Constructs an instance of the AdjustSharpness 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 cvcudaAdjustSharpnessSubmit(NVCVOperatorHandle handle, cudaStream_t stream, NVCVTensorHandle in, NVCVTensorHandle out, float sharpnessFactor)

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

Limitations:

Input: Data Layout: [kNHWC, kHWC, kNCHW, kCHW] Channels: [1, 3, 4]

Data Type

Allowed

8bit Unsigned

Yes

8bit Signed

No

16bit Unsigned

Yes

16bit Signed

No

32bit Unsigned

No

32bit Signed

No

32bit Float

Yes

64bit Float

No

Output: Data Layout: [kNHWC, kHWC, kNCHW, kCHW] Channels: [1, 3, 4]

Data Type

Allowed

8bit Unsigned

Yes

8bit Signed

No

16bit Unsigned

Yes

16bit Signed

No

32bit Unsigned

No

32bit Signed

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.

  • sharpnessFactor – [in] Blend weight applied to the original image; the smoothed image receives weight (1 - sharpnessFactor). 1.0 leaves the image unchanged, 0.0 yields the fully-smoothed image, values above 1.0 sharpen. Must be non-negative. Only the image interior is blended; the 1-pixel border is copied unchanged, and images with height or width below 3 are copied unchanged in full.

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 cvcudaAdjustSharpnessVarShapeSubmit(NVCVOperatorHandle handle, cudaStream_t stream, NVCVImageBatchHandle in, NVCVImageBatchHandle out, float sharpnessFactor)

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

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.

  • sharpnessFactor – [in] Blend weight (see cvcudaAdjustSharpnessSubmit).

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.