## gimpbuffer gimpbuffer — |

## Synopsis

    gchar**     gimp_buffers_get_list           (const gchar *filter,
                                                 gint *num_buffers);
    gchar*      gimp_buffer_rename              (const gchar *buffer_name,
                                                 const gchar *new_name);
    gboolean    gimp_buffer_delete              (const gchar *buffer_name);
    gint        gimp_buffer_get_width           (const gchar *buffer_name);
    gint        gimp_buffer_get_height          (const gchar *buffer_name);
    gint        gimp_buffer_get_bytes           (const gchar *buffer_name);
    GimpImageBaseType gimp_buffer_get_image_type
                                                (const gchar *buffer_name);

## Description

## Details

### gimp_buffers_get_list ()

    gchar**     gimp_buffers_get_list           (const gchar *filter,
                                                 gint *num_buffers);

Retrieve a complete listing of the available buffers.

This procedure returns a complete listing of available named buffers.

`filter` : | An optional regular expression used to filter the list.
`num_buffers` : | The number of buffers.
Returns : | The list of buffer names.

Since GIMP 2.4

### gimp_buffer_rename ()

    gchar*      gimp_buffer_rename              (const gchar *buffer_name,
                                                 const gchar *new_name);

Renames a named buffer.

This procedure renames a named buffer.

`buffer_name` : | The buffer name.
`new_name` : | The buffer's new name.
Returns : | The real name given to the buffer.

Since GIMP 2.4

### gimp_buffer_delete ()

    gboolean    gimp_buffer_delete              (const gchar *buffer_name);

Deletes a named buffer.

This procedure deletes a named buffer.

`buffer_name` : | The buffer name.
Returns : | TRUE on success.

Since GIMP 2.4

### gimp_buffer_get_width ()

    gint        gimp_buffer_get_width           (const gchar *buffer_name);

Retrieves the specified buffer's width.

This procedure retrieves the specified named buffer's width.

`buffer_name` : | The buffer name.
Returns : | The buffer width.

Since GIMP 2.4

### gimp_buffer_get_height ()

    gint        gimp_buffer_get_height          (const gchar *buffer_name);

Retrieves the specified buffer's height.

This procedure retrieves the specified named buffer's height.

`buffer_name` : | The buffer name.
Returns : | The buffer height.

Since GIMP 2.4

### gimp_buffer_get_bytes ()

    gint        gimp_buffer_get_bytes           (const gchar *buffer_name);

Retrieves the specified buffer's bytes.

This procedure retrieves the specified named buffer's bytes.

`buffer_name` : | The buffer name.
Returns : | The buffer bpp.

Since GIMP 2.4

### gimp_buffer_get_image_type ()

    GimpImageBaseType gimp_buffer_get_image_type
                                                (const gchar *buffer_name);

Retrieves the specified buffer's image type.

This procedure retrieves the specified named buffer's image type.

`buffer_name` : | The buffer name.
Returns : | The buffer image type.

Since GIMP 2.4