Gimp.Drawable.merge_new_filter

### Method

# Gimp Drawablemerge_new_filter

#### Declaration [src]

    void
    gimp_drawable_merge_new_filter (
      GimpDrawable* drawable,
      const gchar* operation_name,
      const gchar* name,
      GimpLayerMode mode,
      gdouble opacity,
      ...
    )

#### Description [src]

Utility function which combines `gimp_drawable_filter_new()` followed by setting arguments for the `GimpDrawableFilterConfig` returned by `gimp_drawable_filter_get_config()`, and finally applying the effect to `drawable` with `gimp_drawable_merge_filter()`

The variable arguments are couples of an argument name followed by a value, NULL-terminated, such as:

    filter = gimp_drawable_merge_new_filter (drawable,
                                             GIMP_LAYER_MODE_REPLACE, 1.0,
                                             "gegl:gaussian-blur", "My Gaussian Blur",
                                             "std-dev-x", 2.5,
                                             "std-dev-y", 2.5,
                                             "abyss-policy", "clamp",
                                             NULL);

This method is not directly available to language bindings.

#### Parameters

`operation_name`

  Type: `const gchar*`

  The GEGL operation’s name.

  The data is owned by the caller of the method.
  The value is a NUL terminated UTF-8 string.

`name`

  Type: `const gchar*`

  The effect name which will show in undo step.

  The data is owned by the caller of the method.
  The value is a NUL terminated UTF-8 string.

`mode`

  Type: `GimpLayerMode`

  The blend mode.

`opacity`

  Type: `gdouble`

  The opacity from 0.0 (transparent) to 1.0 (opaque).

`...`

  Type: ``

  A `NULL`-terminated list of operation argument names and values.