Vips.Image.hist_equal

### Method

# Vips Imagehist_equal

#### Declaration [src]

    int
    vips_hist_equal (
      VipsImage* in,
      VipsImage** out,
      ...
    )

#### Description [src]

Histogram-equalise `in`.

Equalise using band `bandno`, or if `bandno` is -1, equalise bands independently. The output format is always the same as the input format.

Optional arguments

- `band`: `gint`, band to equalise.

This method is not directly available to language bindings.

#### Parameters

`out`

  Type: `VipsImage`

  Output image.

  The argument will be set by the function.
  The caller of the method takes ownership of the returned data, and is responsible for freeing it.

`...`

  Type: ``

  `NULL`-terminated list of optional named arguments.

#### Return value

Type: `int`

0 on success, -1 on error.