{"id":24209,"date":"2023-09-06T12:38:33","date_gmt":"2023-09-06T10:38:33","guid":{"rendered":"https:\/\/demdlx704as001.ad.harman.com\/?post_type=documentor-sections&p=24209"},"modified":"2023-12-15T15:17:20","modified_gmt":"2023-12-15T14:17:20","slug":"ducker-2","status":"publish","type":"post","link":"https:\/\/audioworx.transfunnel.co\/old\/?p=24209","title":{"rendered":"Ducker"},"content":{"rendered":"

The aim of Ducker is to attenuate the level of one audio signal in the presence of another signal. The ducker algorithm is primarily used for reducing the level of the background music track during announcement. This audio object works in tandem with a level detector block or a different control input. A very simple reference implementation of a peak level detector is included EconomyLevel.<\/span><\/p>\n

Ducker Properties<\/strong><\/span><\/p>\n

Below table describes about the Ducker audio object properties and functionality.<\/span><\/p>\n

\"\"<\/span><\/p>\n\n\n\n\n\n
Properties<\/strong><\/span><\/td>\nDescriptions<\/strong><\/span><\/td>\n<\/tr>\n
# of channels<\/strong><\/span><\/td>\nThe number of input channels are configurable.<\/span><\/p>\n
    \n
  • Range: 1 to 255. <\/span><\/li>\n
  • Default is 1.<\/span><\/li>\n<\/ul>\n

    The number of output channels are equal to the number of input channels.<\/span><\/td>\n<\/tr>\n

Display Name<\/strong><\/span><\/td>\nDisplay name of the Ducker audio object in signal flow design. It can be changed based on the intended usage of the object.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Mode<\/strong><\/span><\/p>\n

There are no mode available for Ducker audio object<\/span>.<\/p>\n

Additional Parameters<\/strong><\/span><\/p>\n\n\n\n\n\n
Parameter<\/strong><\/span><\/td>\nDescriptions<\/strong><\/span><\/td>\n<\/tr>\n
Side Chain Level Scale<\/strong><\/span><\/td>\n\n

Side Chain Level Scale is in linear or dB scale, which can be selected during design time.<\/span><\/p>\n

0 \u2013 Linear scale<\/span><\/p>\n

1 \u2013 dB scale<\/span><\/td>\n

\"\"<\/span><\/td>\n<\/tr>\n
Ducker Operation Mode<\/strong><\/span><\/td>\n\n

The Ducker audio object operates in two modes and the mode can be selected using an additional configuration “Ducker Operation Mode”.<\/span><\/p>\n

Ducker AO operation mode<\/span><\/p>\n

    \n
  • 0 \u2013 Standard mode (Exposes one control input (sidechain))<\/span><\/li>\n
  • 1 \u2013 Enhanced mode (Exposes four control inputs (sidechain, threshold, Attenuation, and bypass))<\/span><\/li>\n<\/ul>\n

    Standard mode is the default.<\/span><\/p>\n

     <\/td>\n

<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Tuning Parameters<\/strong><\/span><\/p>\n\n\n\n\n\n\n\n\n\n
Parameter<\/strong><\/span><\/td>\nData Type<\/strong><\/span><\/td>\nUnit<\/strong><\/span><\/td>\nDefault Value<\/strong><\/span><\/td>\nRange<\/strong><\/span><\/td>\n Description<\/strong><\/span><\/td>\n<\/tr>\n
Threshold<\/strong><\/span><\/td>\nFloat<\/span><\/td>\ndB<\/span><\/td>\n-30 dB<\/span><\/td>\n-128 to 0<\/span><\/td>\nminimal value of the incoming level parameter to trigger ducking<\/span><\/td>\n<\/tr>\n
Attenuation<\/strong><\/span><\/td>\nFloat<\/span><\/td>\ndB<\/span><\/td>\n20 dB<\/span><\/td>\n0 to 128<\/span><\/td>\nHow much the signal will be attenuated when ducking is active<\/span><\/td>\n<\/tr>\n
Attack time<\/strong><\/span><\/td>\nFloat<\/span><\/td>\ns<\/span><\/td>\n1 s<\/span><\/td>\n0.01 to 3<\/span><\/td>\nThe time it\u2019ll take for the signal to transition from the full level (0dB) to the ducking level.<\/span><\/td>\n<\/tr>\n
Release time<\/strong><\/span><\/td>\nFloat<\/span><\/td>\ns<\/span><\/td>\n1 s<\/span><\/td>\n0.01 to 10<\/span><\/td>\nThe time it\u2019ll take for the signal to transition from the ducking level back to the full level (0dB) after the ducking condition expires<\/span><\/td>\n<\/tr>\n
Hold time<\/strong><\/span><\/td>\nFloat<\/span><\/td>\ns<\/span><\/td>\n1 s<\/span><\/td>\n0.01 to 3<\/span><\/td>\nThe minimum amount of time from the start of the ducking or from the detection of incoming level above threshold (whichever is greater) for the ducking to start releasing<\/span><\/td>\n<\/tr>\n
Bypass<\/strong><\/span><\/td>\nULong<\/span><\/td>\n\u00a0<\/span><\/td>\n0<\/span><\/td>\n0 and 1<\/span><\/td>\nWhether the processing should be bypassed.<\/span><\/p>\n
    \n
  • 0 \u2013 Bypass disabled (Default)<\/span><\/li>\n
  • 1 \u2013 Bypass enabled<\/span><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Control Parameters<\/strong><\/span><\/p>\n\n\n\n\n\n\n\n
    Parameters<\/strong><\/span><\/td>\nDescriptions<\/strong><\/span><\/td>\nRange<\/strong><\/span><\/td>\n<\/tr>\n
    \n

    Control input in linear scale<\/strong><\/span><\/p>\n

    Or<\/span><\/p>\n

    Control input in dB scale<\/strong><\/span><\/td>\n

    		\n

    Control input (Side Chain Level) data in linear scale. The range is from 0.0 to 1.0 in normalized.<\/span><\/p>\n

    Control input (Side Chain Level) data in dB scale. The range is from -128.0 to 0.0<\/span><\/td>\n

    		\n

    0.0 to 1.0<\/span><\/p>\n

    -128.0 to 0.0<\/span><\/p>\n<\/td>\n<\/tr>\n

    Threshold<\/strong><\/span><\/td>\n\n

    The minimal value of incoming control signal to trigger ducking.<\/span><\/p>\n

    It is available only in enhanced mode.<\/span><\/td>\n

    		-128 to 0 dB<\/span><\/td>\n<\/tr>\n
    Attenuation<\/strong><\/span><\/td>\n\n

    The amount of the signal that will be attenuated when ducking is active.<\/span><\/p>\n

    It is available only in enhanced mode.<\/span><\/td>\n

    		0 to 128 dB<\/span><\/td>\n<\/tr>\n
    Bypass<\/strong><\/span><\/td>\n\n

    Whether the processing should be bypassed.<\/span><\/p>\n

    0 \u2013 Bypass disabled (Default)<\/span><\/p>\n

    1 \u2013 Bypass enabled<\/span><\/p>\n

    It is available only in enhanced mode.<\/span><\/td>\n

    		0 and 1<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    State Parameters<\/strong><\/span><\/p>\n

    Ducker exposes the following state parameters to indicate the status of the audio object, and these are streamable.<\/span><\/p>\n\n\n\n\n\n\n
    Parameter<\/strong><\/span><\/td>\nData Type<\/strong><\/span><\/td>\nDefault Value<\/strong><\/span><\/td>\nUnit<\/strong><\/span><\/td>\nRange<\/strong><\/span><\/td>\nDescription<\/strong><\/span><\/td>\n<\/tr>\n
    Side Chain Level<\/span><\/strong><\/td>\nFloat<\/span><\/td>\n0 dB<\/span><\/td>\ndB<\/span><\/td>\n-128 to 0 dB<\/span><\/td>\nThe control input amplitude value in dB.<\/span><\/td>\n<\/tr>\n
    Ducking status<\/span><\/strong><\/td>\nFloat<\/span><\/td>\n0<\/span><\/td>\n\u00a0<\/span><\/td>\n0 to 1<\/span><\/td>\nThe ducking process is applied or not.<\/span><\/td>\n<\/tr>\n
    Gain attenuation<\/span><\/strong><\/td>\nFloat<\/span><\/td>\n0 dB<\/span><\/td>\ndB<\/span><\/td>\n0 to 128 dB<\/span><\/td>\nThe amplitude difference between input and output audio in dB.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Native Panel<\/strong><\/span><\/p>\n

    The Ducker audio object don\u2019t have any native panel.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

    The aim of Ducker is to attenuate the level of one audio signal in the presence of another signal. The ducker algorithm is primarily used for reducing the level of the background music track during announcement. This audio object works in tandem with a level detector block or a different control input. A very simple […]<\/p>\n","protected":false},"author":107,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"ocean_post_layout":"","ocean_both_sidebars_style":"","ocean_both_sidebars_content_width":0,"ocean_both_sidebars_sidebars_width":0,"ocean_sidebar":"0","ocean_second_sidebar":"0","ocean_disable_margins":"enable","ocean_add_body_class":"","ocean_shortcode_before_top_bar":"","ocean_shortcode_after_top_bar":"","ocean_shortcode_before_header":"","ocean_shortcode_after_header":"","ocean_has_shortcode":"","ocean_shortcode_after_title":"","ocean_shortcode_before_footer_widgets":"","ocean_shortcode_after_footer_widgets":"","ocean_shortcode_before_footer_bottom":"","ocean_shortcode_after_footer_bottom":"","ocean_display_top_bar":"default","ocean_display_header":"default","ocean_header_style":"","ocean_center_header_left_menu":"0","ocean_custom_header_template":"0","ocean_custom_logo":0,"ocean_custom_retina_logo":0,"ocean_custom_logo_max_width":0,"ocean_custom_logo_tablet_max_width":0,"ocean_custom_logo_mobile_max_width":0,"ocean_custom_logo_max_height":0,"ocean_custom_logo_tablet_max_height":0,"ocean_custom_logo_mobile_max_height":0,"ocean_header_custom_menu":"0","ocean_menu_typo_font_family":"0","ocean_menu_typo_font_subset":"","ocean_menu_typo_font_size":0,"ocean_menu_typo_font_size_tablet":0,"ocean_menu_typo_font_size_mobile":0,"ocean_menu_typo_font_size_unit":"px","ocean_menu_typo_font_weight":"","ocean_menu_typo_font_weight_tablet":"","ocean_menu_typo_font_weight_mobile":"","ocean_menu_typo_transform":"","ocean_menu_typo_transform_tablet":"","ocean_menu_typo_transform_mobile":"","ocean_menu_typo_line_height":0,"ocean_menu_typo_line_height_tablet":0,"ocean_menu_typo_line_height_mobile":0,"ocean_menu_typo_line_height_unit":"","ocean_menu_typo_spacing":0,"ocean_menu_typo_spacing_tablet":0,"ocean_menu_typo_spacing_mobile":0,"ocean_menu_typo_spacing_unit":"","ocean_menu_link_color":"","ocean_menu_link_color_hover":"","ocean_menu_link_color_active":"","ocean_menu_link_background":"","ocean_menu_link_hover_background":"","ocean_menu_link_active_background":"","ocean_menu_social_links_bg":"","ocean_menu_social_hover_links_bg":"","ocean_menu_social_links_color":"","ocean_menu_social_hover_links_color":"","ocean_disable_title":"default","ocean_disable_heading":"default","ocean_post_title":"","ocean_post_subheading":"","ocean_post_title_style":"","ocean_post_title_background_color":"","ocean_post_title_background":0,"ocean_post_title_bg_image_position":"","ocean_post_title_bg_image_attachment":"","ocean_post_title_bg_image_repeat":"","ocean_post_title_bg_image_size":"","ocean_post_title_height":0,"ocean_post_title_bg_overlay":0.5,"ocean_post_title_bg_overlay_color":"","ocean_disable_breadcrumbs":"default","ocean_breadcrumbs_color":"","ocean_breadcrumbs_separator_color":"","ocean_breadcrumbs_links_color":"","ocean_breadcrumbs_links_hover_color":"","ocean_display_footer_widgets":"default","ocean_display_footer_bottom":"default","ocean_custom_footer_template":"0","footnotes":"","ocean_post_oembed":"","ocean_post_self_hosted_media":"","ocean_post_video_embed":"","ocean_link_format":"","ocean_link_format_target":"self","ocean_quote_format":"","ocean_quote_format_link":"post","ocean_gallery_link_images":"off","ocean_gallery_id":[]},"categories":[315],"tags":[],"coauthors":[292],"_links":{"self":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/24209"}],"collection":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/users\/107"}],"replies":[{"embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=24209"}],"version-history":[{"count":14,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/24209\/revisions"}],"predecessor-version":[{"id":26564,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/24209\/revisions\/26564"}],"wp:attachment":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=24209"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=24209"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=24209"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fcoauthors&post=24209"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}