/* LIBPIKA - The PIKA Library
 * Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
 *
 * Thumbnail handling according to the Thumbnail Managing Standard.
 * https://specifications.freedesktop.org/thumbnail-spec/
 *
 * Copyright (C) 2001-2003  Sven Neumann <sven@gimp.org>
 *                          Michael Natterer <mitch@gimp.org>
 *
 * 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 3 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
 * Lesser 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, see
 * <https://www.gnu.org/licenses/>.
 */

#if !defined (__PIKA_THUMB_H_INSIDE__) && !defined (PIKA_THUMB_COMPILATION)
#error "Only <libpikathumb/pikathumb.h> can be included directly."
#endif

#ifndef __PIKA_THUMB_UTILS_H__
#define __PIKA_THUMB_UTILS_H__

G_BEGIN_DECLS


gboolean            pika_thumb_init                   (const gchar    *creator,
                                                       const gchar    *thumb_basedir);

const gchar       * pika_thumb_get_thumb_base_dir     (void);

gchar             * pika_thumb_find_thumb             (const gchar    *uri,
                                                       PikaThumbSize  *size) G_GNUC_MALLOC;

PikaThumbFileType   pika_thumb_file_test              (const gchar    *filename,
                                                       gint64         *mtime,
                                                       gint64         *size,
                                                       gint           *err_no);

gchar             * pika_thumb_name_from_uri          (const gchar    *uri,
                                                       PikaThumbSize   size) G_GNUC_MALLOC;
const gchar       * pika_thumb_get_thumb_dir          (PikaThumbSize   size);
gboolean            pika_thumb_ensure_thumb_dir       (PikaThumbSize   size,
                                                       GError        **error);
void                pika_thumbs_delete_for_uri        (const gchar    *uri);

gchar             * pika_thumb_name_from_uri_local    (const gchar    *uri,
                                                       PikaThumbSize   size) G_GNUC_MALLOC;
gchar             * pika_thumb_get_thumb_dir_local    (const gchar    *dirname,
                                                       PikaThumbSize   size) G_GNUC_MALLOC;
gboolean            pika_thumb_ensure_thumb_dir_local (const gchar    *dirname,
                                                       PikaThumbSize   size,
                                                       GError        **error);
void                pika_thumbs_delete_for_uri_local  (const gchar    *uri);


/*  for internal use only   */
G_GNUC_INTERNAL void    _pika_thumbs_delete_others    (const gchar    *uri,
                                                       PikaThumbSize   size);
G_GNUC_INTERNAL gchar * _pika_thumb_filename_from_uri (const gchar    *uri);


G_END_DECLS

#endif /* __PIKA_THUMB_UTILS_H__ */