{"id":24007,"date":"2023-08-22T09:05:57","date_gmt":"2023-08-22T07:05:57","guid":{"rendered":"https:\/\/demdlx704as001.ad.harman.com\/?post_type=documentor-sections&p=24007"},"modified":"2023-12-12T11:48:45","modified_gmt":"2023-12-12T10:48:45","slug":"multistage-envelope-2","status":"publish","type":"post","link":"https:\/\/audioworx.transfunnel.co\/old\/?p=24007","title":{"rendered":"MultiStage Envelope"},"content":{"rendered":"

The MultiStage Envelope creates a control signal that changes over time in both deterministic and non-deterministic ways. It is a control-signal generator that generates a signal that changes over time by successively interpolating from one stage to the next, where each stage consists of a time and level pair.<\/span><\/p>\n

It enables the randomization or adjustment of time, level, and curve shape within deterministic ranges. When the final stage is reached, it is possible to loop back to a specific segment.<\/span><\/p>\n

MultiStage Envelope Properties<\/strong><\/span><\/p>\n

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

\"A<\/span><\/p>\n\n\n\n\n\n
Properties<\/strong><\/span><\/td>\nDescription<\/strong><\/span><\/td>\n<\/tr>\n
No. of Steps<\/strong><\/span><\/td>\n\n

Enter the number of stages or steps (nSteps).<\/span><\/p>\n

Multistage Envelope supports up to a maximum of 16 stages and looping back to any stage based on the configuration is allowed. So, the envelope generation can be continued in loop between stages. Time and level of each step is controlled by a fade parameter enabling the randomness and adjustments.<\/span><\/p>\n

    \n
  • Range: 2 to 16<\/span><\/li>\n
  • Data Type: uint32_t<\/span><\/li>\n
  • Default number of stages or steps (nSteps) is set to 2.<\/span><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
Display Name<\/strong><\/span><\/td>\nDisplay name of the MultiStage Envelope 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

Below are the control input params:<\/span><\/p>\n

    \n
  • Reset<\/span><\/li>\n
  • Loop<\/span><\/li>\n
  • Shape<\/span><\/li>\n
  • Shape_Random<\/span><\/li>\n
  • Fader<\/span><\/li>\n
  • Fader_Random<\/span><\/li>\n<\/ul>\n

    First 6 of the Tuning params mentioned below are same as the control input params above. So, these 6 params can be controlled externally as well as internally.<\/span><\/p>\n

    \"A<\/span><\/p>\n

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

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

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

    There are no additional parameters available for MultiStage Envelope audio object<\/span>.<\/span><\/p>\n

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

    The following are the parameters you can tune in GTT.<\/span><\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Parameter<\/strong><\/span><\/td>\nData Type<\/strong><\/span><\/td>\nDefault Value<\/strong><\/span><\/td>\nRange<\/strong><\/span><\/td>\nDetails<\/strong><\/span><\/td>\n<\/tr>\n
    Reset<\/span><\/strong><\/span><\/td>\nUInt<\/span><\/td>\n0<\/span><\/td>\n0 to 2<\/span><\/td>\n\n
      \n
    • RESET =1: Reset the envelope generation from initial stage.<\/span><\/li>\n
    • RESET =2: AO<\/span>\u00a0stops envelope generation immediately and continue outputting last stage target value<\/span><\/li>\n
    • RESET=0: Do nothing and continue generation.<\/span><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
    Loop<\/span><\/strong><\/span><\/td>\nUInt<\/span><\/td>\n0<\/span><\/td>\n0 to nSteps<\/span><\/td>\nLoop back to specified segment when last step is completed and continues envelope generation in loop when Loop is not 0.<\/span><\/td>\n<\/tr>\n
    Shape<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n0.0<\/span><\/td>\n-1.0 to 1.0<\/span><\/td>\nSpecify shape or slope of envelope segments. The shape shall be varied in between the values.<\/span><\/p>\n
      \n
    • -1.0 (inverse exponential)<\/span><\/li>\n
    • 0.0 (linear)<\/span><\/li>\n
    • 1.0 (quasi exponential)<\/span><\/li>\n<\/ul>\n<\/td>\n<\/tr>\n
    Shape_Random<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n0.0<\/span><\/td>\n0.0 to 1.0<\/span><\/td>\nFor a new random value to be created on start of each new segment, the value is added to SHAPE, and result is limited to [-1:1].
    \n<\/span>Full scale generated shape value will then be in the range [SHAPE_RND to SHAPE_RANDOM]<\/span><\/td>\n<\/tr>\n
    Fader<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n0.0<\/span><\/td>\n0.0 to 1.0<\/span><\/td>\nSpecify fade to linearly vary between levels\/times. Pair of values of level and time is configured for each step.
    \n<\/span>For each next level\/time, the value is varied linearly between the pairs with FADER and FADER_RANDOM to get the target level\/time.<\/span><\/td>\n<\/tr>\n
    Fader_Random<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n0.0<\/span><\/td>\n0.0 to 1.0<\/span><\/td>\nFor a new random value to be created on start of each new segment, the value is added to FADER and result is limited to [0:1].
    \n<\/span>Full scale generated fader value will then be in the range<\/span>[-FADER_RANDOM to SHAPE_RANDOM]<\/span><\/td>\n<\/tr>\n
    OutScalFac<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n1.0<\/span><\/td>\n-32767.0 to 32767.0<\/span><\/td>\nScale the envelope output level. <\/span>This parameter is used to scale the envelope output range. By default, the env output range will be between 0.0 to 1.0.
    \n<\/span>So, this param value is used to scale that value to a bigger range specified in the next column.<\/span><\/td>\n<\/tr>\n
    LevelMinValue<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n0.0<\/span><\/td>\n-32767.0 to 32767.0<\/span><\/td>\nUsed to set lower value of envelope output range. By default, the env output range is\u00a0 between 0.0 to 1.0. The output envelope is scaled in range LevelMinValue and LevelMaxValue.<\/span><\/td>\n<\/tr>\n
    LevelMaxValue<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n1.0<\/span><\/td>\n-32767.0 to 32767.0<\/span><\/td>\nUsed to set highest value of envelope output range. By default, the env output range will be between 0.0 to 1.0. The output envelope is scaled in range LevelMinValue and LevelMaxValue.<\/span><\/td>\n<\/tr>\n
    TimeA1<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n100.0 ms<\/span><\/td>\n1.0 to 10000.0 ms<\/span><\/td>\nFirst time value from the time pair of Step 1. The time duration to reach next step from Step1 is varied between TimeA1 and TimeB1.<\/span><\/td>\n<\/tr>\n
    TimeB1<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n100.0 ms<\/span><\/td>\n1.0 to 10000.0 ms<\/span><\/td>\nSecond time value from the time pair of Step 1. The time duration to reach next step from Step1 is varied between TimeA1 and TimeB1.<\/span><\/td>\n<\/tr>\n
    LevelA1<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n0.0<\/span><\/td>\n0.0 to 1.0<\/span><\/td>\nFirst level value from the level pair of Step1. The source level of Step1 is varied between LevelA1 and LevelB1.<\/span><\/td>\n<\/tr>\n
    LevelB1<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n0.0<\/span><\/td>\n0.0 to 1.0<\/span><\/td>\nSecond level value from the level pair of Step1. The source level of Step1 is varied between LevelA1 and LevelB1.<\/span><\/td>\n<\/tr>\n
    Shape1<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n0.0<\/span><\/td>\n-1.0 to 1.0<\/span><\/td>\nThis value determines the shape of the envelope from step1 to the next step. This value can be overridden by the 3rd tuning param, i.e. Shape which overwrites the shape of all steps.<\/span><\/td>\n<\/tr>\n
    TimeAN<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n100.0 ms<\/span><\/td>\n1.0 to 10000.0 ms<\/span><\/td>\nFirst time value from the time pair of Step N. The time duration to reach next step from Step N is varied between TimeAN and TimeBN.<\/span><\/td>\n<\/tr>\n
    TimeBN<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n100.0 ms<\/span><\/td>\n1.0 to 10000.0 ms<\/span><\/td>\nSecond time value from the time pair of Step N. The time duration to reach next step from Step N is varied between TimeAN and TimeBN.<\/span><\/td>\n<\/tr>\n
    LevelAN<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n\n

    0.0 if N is odd<\/span><\/p>\n

    1.0 if N is even<\/span><\/td>\n

    		0.0 to 1.0<\/span><\/td>\nFirst level value from the level pair of Step N. The source level of Step N is varied between LevelAN and LevelBN.<\/span><\/td>\n<\/tr>\n
    LevelBN<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n\n

    0.0 if N is odd<\/span><\/p>\n

    1.0 if N is even<\/span><\/td>\n

    		0.0 to 1.0<\/span><\/td>\nSecond level value from the level pair of Step N. The source level of Step N is varied between LevelAN and LevelBN.<\/span><\/td>\n<\/tr>\n
    ShapeN<\/span><\/strong><\/span><\/td>\nFloat<\/span><\/td>\n0.0<\/span><\/td>\n-1.0 to 1.0<\/span><\/td>\n\n

    Specify shape of the envelope between Step N and the next Step. This value can be overridden by the 3rd Tuning param,<\/span><\/p>\n

    i.e. Shape, which is common for all the steps.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    State Parameters<\/strong><\/p>\n\n\n\n\n
    Parameter<\/strong><\/td>\nData Type<\/strong><\/td>\nDefault Value<\/strong><\/td>\nRange<\/strong><\/td>\nNotes<\/strong><\/td>\n<\/tr>\n
    Envelope<\/strong><\/span><\/td>\nFloat<\/span><\/td>\n0.0<\/span><\/td>\n-32767.0 to 32767.0<\/span><\/td>\nTo stream the control output. This parameter\u00a0is streamable.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

     <\/p>\n

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

    The following are the control input parameters in GTT, there are 6 control inputs.<\/span><\/p>\n\n\n\n\n\n\n\n\n\n
    Parameter<\/strong><\/span><\/td>\nDescription<\/strong><\/span><\/td>\nRange<\/strong><\/span><\/td>\n<\/tr>\n
    RESET<\/span><\/strong><\/td>\n\n

    RESET = 1: Reset the envelope generation from initial stage.<\/span><\/p>\n

    RESET = 2: Deactivate envelope generation. Outputs last stage level value.<\/span><\/p>\n

    RESET = 0: Do nothing<\/span><\/td>\n

    		0 or 2<\/span><\/td>\n<\/tr>\n
    LOOP<\/span><\/strong><\/td>\nLoop back to specified segment when last step is completed and continues envelope generation in loop.<\/span><\/td>\n0 to nSteps<\/span><\/td>\n<\/tr>\n
    SHAPE<\/span><\/strong><\/td>\nSpecify shape or slope of envelope segments. The shape shall be varied in between the values.<\/span><\/p>\n
      \n
    • -1.0: inverse exponantial<\/span><\/li>\n
    • 0.0: linear<\/span><\/li>\n
    • 1.0: quasi exponential<\/span><\/li>\n<\/ul>\n<\/td>\n
    		-1.0 to 1.0<\/span><\/td>\n<\/tr>\n
    SHAPE_RND<\/span><\/strong><\/td>\n\n

    For a new random value to be created on start of each new segment, the value is added to SHAPE and result limited to [-1:1]<\/span><\/p>\n

    Full scale generated random value is in the range -SHAPE_RND…SHAPE_RND,<\/span><\/td>\n

    		0.0 to 1.0<\/span><\/td>\n<\/tr>\n
    FADER<\/span><\/strong><\/td>\nSpecify fade to linearly vary between levels\/times. Pair of values of level and time is configured for each step. For each next level\/time, the value is varied linearly between the pairs with FADER and FADER_RND to get the target level\/time.<\/span><\/td>\n0.0 to 1.0<\/span><\/td>\n<\/tr>\n
    FADER_RND<\/span><\/strong><\/td>\nFor a new random value to be created on start of each new segment. the value is added to FADER and result limited to [0:1] Full scale generated random value is in the range 0…FADER_RND,<\/span><\/td>\n0.0 to 1.0<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

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

    The below diagram shows four 8-stage envelopes obtained from different settings of Time, Level and Shape. Each color-coding describes envelopes obtained from different runs of the algorithm.<\/span><\/p>\n

    \"Different<\/span><\/p>\n

    For Example, settings of orange color envelope are show below.<\/span><\/p>\n

      \n
    1. nSteps = 8<\/span><\/li>\n
    2. So, Time and Level pairs will be: TimeA1,TimeB1,LevelA1,LevelB1,…,TimeA8,TimeB8,LevelA8,LevelB8<\/span><\/li>\n
    3. TimeA1=30ms, TimeB1=30ms<\/span><\/li>\n
    4. TimeA2=20ms, TimeB2=100ms<\/span><\/li>\n
    5. Fader=1.0<\/span><\/li>\n
    6. Fader_Random=0.0<\/span><\/li>\n
    7. LevelA1=0.8, LevelB1=0.8<\/span><\/li>\n
    8. LevelA2=0.1, LevelB2=0.03<\/span><\/li>\n<\/ol>\n

      To scale envelope output tuning parameter \u201cLevelMinValue\u201d and \u201cLevelMaxValue\u201d are used. There is no restriction added for \u201cLevelMinValue\u201d to be lower than \u201cLevelMaxValue\u201d in Tuning. It is required to set \u201cLevelMinValue\u201d to be smaller than \u201cLevelMaxValue\u201d. User can choose the values as per requirement of envelope output scaling.
      \n<\/span>Linear regrssion is used to scale the envelope output. Below is formula used for scaling the output.<\/span>
      \noutValue = LevelMinValue + (LevelMaxValue \u2013 LevelMinValue)*stepLevelValue<\/em><\/span>
      \nif want to scale level value from 0 to 1 to -128 to 128 LevelMinValue and LevelMaxValue value used should be
      \n<\/span>LevelMinValue = -128
      \nLevelMaxValue = 128<\/p>\n

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

      MultiStage Envelope audio objec<\/span>t does not support native panel.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

      The MultiStage Envelope creates a control signal that changes over time in both deterministic and non-deterministic ways. It is a control-signal generator that generates a signal that changes over time by successively interpolating from one stage to the next, where each stage consists of a time and level pair. It enables the randomization or adjustment […]<\/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":"on","ocean_gallery_id":[]},"categories":[315],"tags":[],"coauthors":[292],"_links":{"self":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/24007"}],"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=24007"}],"version-history":[{"count":21,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/24007\/revisions"}],"predecessor-version":[{"id":26413,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=\/wp\/v2\/posts\/24007\/revisions\/26413"}],"wp:attachment":[{"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=24007"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=24007"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=24007"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/audioworx.transfunnel.co\/old\/index.php?rest_route=%2Fwp%2Fv2%2Fcoauthors&post=24007"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}