Gimp.Drawable.levels

### Method

# Gimp Drawablelevels

since: 2.10

#### Declaration [src]

    gboolean
    gimp_drawable_levels (
      GimpDrawable* drawable,
      GimpHistogramChannel channel,
      gdouble low_input,
      gdouble high_input,
      gboolean clamp_input,
      gdouble gamma,
      gdouble low_output,
      gdouble high_output,
      gboolean clamp_output
    )

#### Description [src]

Modifies intensity levels in the specified drawable.

This tool allows intensity levels in the specified drawable to be remapped according to a set of parameters. The low/high input levels specify an initial mapping from the source intensities. The gamma value determines how intensities between the low and high input intensities are interpolated. A gamma value of 1.0 results in a linear interpolation. Higher gamma values result in more high-level intensities. Lower gamma values result in more low-level intensities. The low/high output levels constrain the final intensity mapping—that is, no final intensity will be lower than the low output level and no final intensity will be higher than the high output level. This tool is only valid on RGB color and grayscale images.

Available since: 2.10

#### Parameters

`channel`

  Type: `GimpHistogramChannel`

  The channel to modify.

`low_input`

  Type: `gdouble`

  Intensity of lowest input.

`high_input`

  Type: `gdouble`

  Intensity of highest input.

`clamp_input`

  Type: `gboolean`

  Clamp input values before applying output levels.

`gamma`

  Type: `gdouble`

  Gamma adjustment factor.

`low_output`

  Type: `gdouble`

  Intensity of lowest output.

`high_output`

  Type: `gdouble`

  Intensity of highest output.

`clamp_output`

  Type: `gboolean`

  Clamp final output values.

#### Return value

Type: `gboolean`

TRUE on success.