..
   Copyright (c) 2021-2022, NVIDIA CORPORATION. All rights reserved.
   NVIDIA CORPORATION and its licensors retain all intellectual property
   and proprietary rights in and to this software, related documentation
   and any modifications thereto. Any use, reproduction, disclosure or
   distribution of this software and related documentation without an express
   license agreement from NVIDIA CORPORATION is strictly prohibited.

NvDsConverterExt
------------------
NVIDIA DeepStream extension for converter components.

* UUID: 7fe1ae48-7bb3-49a8-98fb-142ba07eb273
* Version: 1.0.0
* Author: NVIDIA
* License: Proprietary

Components
~~~~~~~~~~~~

nvidia::deepstream::NvDsVideoConvert
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Convert and resize the video from one colorspace to another.

* Component ID: 83b74e7f-6d42-3676-b4ea-7812d0a7c6ed
* Base Type: nvidia::deepstream::INvDsElement

Parameters
++++++++++++

**bl-output**

Blocklinear output, applicable only for ``memory:NVMM NV12`` format output buffer.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_BOOL
* Default: False

|

**compute-hw**

Compute Scaling HW

Valid values:

  0: Default

  1: GPU

  2: VIC

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_INT64
* Default: 0

|

**dest-crop**

Pixel location ``left:top:width:height``. Use string with values of crop location to set the property. e.g. 20:20:40:50.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_STRING
* Default: 0:0:0:0

|

**flip-method**

video flip methods

Valid values:

  0: none

  1: counterclockwise

  2: rotate-180

  3: clockwise

  4: horizontal-flip

  5: upper-right-diagonal

  6: vertical-flip

  7: upper-left-diagonal

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_INT64
* Default: 0

|

**gpu-id**

Set GPU Device ID for operation.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_UINT64
* Default: 0

|

**interpolation-method**

Set interpolation methods.

Valid values:

  0: Nearest

  1: Bilinear

  2: Algo-1

  3: Algo-2

  4: Algo-3

  5: Algo-4

  6: Default

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_INT64
* Default: 6

|

**nvbuf-memory-type**

Type of ``NvBufSurface`` Memory to be allocated for output buffers.

Valid values:

  0: nvbuf-mem-default

  1: nvbuf-mem-cuda-pinned

  2: nvbuf-mem-cuda-device

  3: nvbuf-mem-cuda-unified

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_INT64
* Default: 0

|

**output-buffers**

number of output buffers

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_UINT64
* Default: 4

|

**src-crop**

Pixel location ``left:top:width:height``. Use string with values of crop location to set the property. e.g. 20:20:40:50.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_STRING
* Default: 0:0:0:0

|

**video-in**

Handle to an ``nvidia::deepstream::NvDsStaticInput`` component. Supported formats - ``video(I420, NV12, P010_10LE, BGRx, RGBA, GRAY8, GBR, RGB, BGR, UYVP)``.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_HANDLE
* Handle Type: nvidia::deepstream::NvDsStaticInput

|

**video-out**

Handle to an ``nvidia::deepstream::NvDsStaticOutput`` component. Supported formats - ``video(I420, NV12, P010_10LE, BGRx, RGBA, GRAY8, GBR, RGB, BGR, UYVP)``.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_HANDLE
* Handle Type: nvidia::deepstream::NvDsStaticOutput

nvidia::deepstream::AudioConvert
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Convert audio to different formats.

* Component ID: a9c7471a-9db7-3239-9acf-7ff1a29e250e
* Base Type: nvidia::deepstream::INvDsElement

Parameters
++++++++++++

**audio-in**

Handle to an ``nvidia::deepstream::NvDsStaticInput`` component. Supported formats - ``audio(S8, U8, S16LE, S16BE, U16LE, U16BE, S24_32LE, S24_32BE, U24_32LE, U24_32BE, S32LE, S32BE, U32LE, U32BE, S24LE, S24BE, U24LE, U24BE, S20LE, S20BE, U20LE, U20BE, S18LE, S18BE, U18LE, U18BE, F32LE, F32BE, F64LE, F64BE)``.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_HANDLE
* Handle Type: nvidia::deepstream::NvDsStaticInput

|

**audio-out**

Handle to an ``nvidia::deepstream::NvDsStaticOutput`` component. Supported formats - ``audio(S8, U8, S16LE, S16BE, U16LE, U16BE, S24_32LE, S24_32BE, U24_32LE, U24_32BE, S32LE, S32BE, U32LE, U32BE, S24LE, S24BE, U24LE, U24BE, S20LE, S20BE, U20LE, U20BE, S18LE, S18BE, U18LE, U18BE, F32LE, F32BE, F64LE, F64BE)``.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_HANDLE
* Handle Type: nvidia::deepstream::NvDsStaticOutput

|

**dithering**

Selects between different dithering methods.

Valid values:

  0: none

  1: rpdf

  2: tpdf

  3: tpdf-hf

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_INT64
* Default: 2

|

**noise-shaping**

Selects between different noise shaping methods.

Valid values:

  0: none

  1: error-feedback

  2: simple

  3: medium

  4: high

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_INT64
* Default: 0

nvidia::deepstream::AudioResample
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Resamples audio.

* Component ID: 87739bfc-dc3c-34ca-a936-4a748506ede0
* Base Type: nvidia::deepstream::INvDsElement

Parameters
++++++++++++

**audio-in**

Handle to an ``nvidia::deepstream::NvDsStaticInput`` component. Supported formats - ``audio(S8, U8, S16LE, S16BE, U16LE, U16BE, S24_32LE, S24_32BE, U24_32LE, U24_32BE, S32LE, S32BE, U32LE, U32BE, S24LE, S24BE, U24LE, U24BE, S20LE, S20BE, U20LE, U20BE, S18LE, S18BE, U18LE, U18BE, F32LE, F32BE, F64LE, F64BE)``.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_HANDLE
* Handle Type: nvidia::deepstream::NvDsStaticInput

|

**audio-out**

Handle to an ``nvidia::deepstream::NvDsStaticOutput`` component. Supported formats - ``audio(S8, U8, S16LE, S16BE, U16LE, U16BE, S24_32LE, S24_32BE, U24_32LE, U24_32BE, S32LE, S32BE, U32LE, U32BE, S24LE, S24BE, U24LE, U24BE, S20LE, S20BE, U20LE, U20BE, S18LE, S18BE, U18LE, U18BE, F32LE, F32BE, F64LE, F64BE)``.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_HANDLE
* Handle Type: nvidia::deepstream::NvDsStaticOutput

|

**quality**

Resample quality with 0 being the lowest and 10 being the best.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_INT64
* Default: 4

|

**resample-method**

What resample method to use

Valid values:

  0: nearest

  1: linear

  2: cubic

  3: blackman-nuttall

  4: kaiser

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_INT64
* Default: 4

|

**sinc-filter-auto-threshold**

Memory usage threshold to use if sinc filter mode is AUTO, given in bytes.

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_UINT64
* Default: 1048576

|

**sinc-filter-interpolation**

interpolate the sinc filter table.

Valid values:

  0: none

  1: linear

  2: cubic

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_INT64
* Default: 2

|

**sinc-filter-mode**

sinc filter table mode to use.

Valid values:

  0: interpolated

  1: full

  2: auto

* Flags: GXF_PARAMETER_FLAGS_OPTIONAL
* Type: GXF_PARAMETER_TYPE_INT64
* Default: 2