# Block-level use merged sample defaults

``

    with_merged_sample_defaults

Specify new default values to be used by all subsequent calls to `sample` within the `do`/`end` block. Merges the specified values with any previous sample defaults, rather than replacing them. After the `do`/`end` block has completed, the previous sampled defaults (if any) are restored.

Introduced in v2.9

## Example

# Example 1
``
    sample :loop_amen

    use_merged_sample_defaults amp: 0.5, cutoff: 70

    sample :loop_amen

    with_merged_sample_defaults cutoff: 90 do
      sample :loop_amen
    end

    sample :loop_amen
| ``
    # plays amen break with default arguments

    # plays amen break with an amp of 0.5, cutoff of 70 and defaults for rest of args

    # plays amen break with a cutoff of 90 and amp of 0.5

    # plays amen break with a cutoff of 70 and amp is 0.5 again as the previous defaults are restored.