Convert To

group NVCV_C_ALGORITHM_CONVERT_TO

Functions

NVCVStatus cvcudaConvertToCreate(NVCVOperatorHandle *handle)

Constructs and an instance of the ConvertTo operator.

Parameters

handle – [out] Where the image 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 cvcudaConvertToSubmit(NVCVOperatorHandle handle, cudaStream_t stream, NVCVTensorHandle in, NVCVTensorHandle out, const double alpha, const double beta)

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

outputs(x,y) = saturate_cast<out_type>(α * inputs(x, y) + β)

Limitations:

Input: Data Layout: [kNHWC, kHWC] Channels: [1-4]

Data Type

Allowed

8bit Unsigned

Yes

8bit Signed

Yes

16bit Unsigned

Yes

16bit Signed

Yes

32bit Unsigned

No

32bit Signed

Yes

32bit Float

Yes

64bit Float

Yes

Output: Data Layout: [kNHWC, kHWC] Channels: [1-4]

Data Type

Allowed

8bit Unsigned

Yes

8bit Signed

Yes

16bit Unsigned

Yes

16bit Signed

Yes

32bit Unsigned

No

32bit Signed

Yes

32bit Float

Yes

64bit Float

Yes

Input/Output dependency 

 Property      |  Input == Output
-------------- | -------------
 Data Layout   | Yes
 Data Type     | No
 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.

  • alpha – [in] Scalar for output data.

  • beta – [in] Offset for the data.

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.