/* LIBGIMP - The GIMP Library
 * Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

#ifndef __GIMP_UTILS_H__
#define __GIMP_UTILS_H__

G_BEGIN_DECLS


gchar         * gimp_utf8_strtrim         (const gchar  *str,
                                           gint          max_chars);
gchar         * gimp_any_to_utf8          (const gchar  *str,
                                           gssize        len,
                                           const gchar  *warning_format,
                                           ...) G_GNUC_PRINTF (3, 4);
const gchar   * gimp_filename_to_utf8     (const gchar  *filename);

gchar         * gimp_strip_uline          (const gchar  *str);
gchar         * gimp_escape_uline         (const gchar  *str);

GimpEnumDesc  * gimp_enum_get_desc        (GEnumClass   *enum_class,
                                           gint          value);
GimpFlagsDesc * gimp_flags_get_first_desc (GFlagsClass  *flags_class,
                                           guint         value);

gboolean        gimp_enum_get_value       (GType         enum_type,
                                           gint          value,
                                           const gchar **value_name,
                                           const gchar **value_nick,
                                           const gchar **value_desc,
                                           const gchar **value_help);
gboolean        gimp_flags_get_value      (GType         flags_type,
                                           guint         value,
                                           const gchar **value_name,
                                           const gchar **value_nick,
                                           const gchar **value_desc,
                                           const gchar **value_help);

const gchar   * gimp_enum_value_get_desc  (GEnumClass   *enum_class,
                                           GEnumValue   *enum_value);
const gchar   * gimp_enum_value_get_help  (GEnumClass   *enum_class,
                                           GEnumValue   *enum_value);

const gchar   * gimp_flags_value_get_desc (GFlagsClass  *flags_class,
                                           GFlagsValue  *flags_value);
const gchar   * gimp_flags_value_get_help (GFlagsClass  *flags_class,
                                           GFlagsValue  *flags_value);


G_END_DECLS

#endif  /* __GIMP_UTILS_H__ */