You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdelibs/kio/kio/thumbcreator.h

125 lines
4.1 KiB

/* This file is part of the KDE libraries
Copyright (C) 2000 Malte Starostik <malte@kde.org>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library 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 Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
#ifndef _THUMBCREATOR_H_
#define _THUMBCREATOR_H_
#include <tqstring.h>
class TQString;
class TQImage;
/**
* This is the baseclass for "thumbnail-plugins" in KDE. Using the class
* KIO::PreviewJob allows you to generate small images (thumbnails)
* for any kind of file, where a "ThumbCreator" is available. Have a look
* at kdebase/kioslave/thumbnail/ for existing ThumbCreators.
*
* What you need to do to create and register a ThumbCreator:
* @li Inherit from this class and reimplement the create() method to
* generate a thumbnail for the given file-path.
* @li Provide a factory method in your implementation file to instantiate
* your plugin, e.g.:
* \code
* extern "C"
* {
* ThumbCreator *new_creator()
* {
* return new YourThumbCreator();
* }
* };
* \endcode
*
* Compile your ThumbCreator as a module. The contents of Makefile.am
* need to look like this:
* \code
* INCLUDES = $(all_includes)
* kde_module_LTLIBRARIES = yourthumbcreator.la
* yourthumbcreator_la_SOURCES = yourthumbcreator.cpp
* yourthumbcreator_la_LIBADD = $(LIB_KIO)
* yourthumbcreator_la_LDFLAGS = $(all_libraries) -module $(KDE_PLUGIN)
* kde_services_DATA = yourthumbcreator.desktop
* \endcode
*
* @li Create a file yourthumbcreator.desktop with the following contents:
* \code
* [Desktop Entry]
* Encoding=UTF-8
* Type=Service
* Name=Name of the type of files your ThumbCreator supports
* ServiceTypes=ThumbCreator
* MimeTypes=application/x-somemimetype
* CacheThumbnail=true
* X-KDE-Library=yourthumbcreator
* \endcode
*
* You can supply a comma-separated list of mimetypes to the MimeTypes entry,
* naming all mimetypes your ThumbCreator supports. You can also use simple
* wildcards, like (where you see [slash], put a /)
* \code
* text[slash]* or image[slash]*.
* \endcode
*
* If your plugin is rather inexpensive (e.g. like the text preview ThumbCreator),
* you can set CacheThumbnail=false to prevent your thumbnails from being cached
* on disk.
*
* @short Baseclass for thumbnail-generating plugins.
*/
class ThumbCreator
{
public:
/**
* The flags of this plugin.
* @see flags()
*/
enum Flags { None = 0, DrawFrame = 1, BlendIcon = 2 };
virtual ~ThumbCreator() {}
/**
* Creates a thumbnail
* Note that the width and height parameters should not be used
* for scaling. Only plugins that create an image "from scratch",
* like the TextCreator should directly use the specified size.
* If the resulting preview is larger than width x height, it will be
* scaled down.
*
* @param path the (always local) file path to create a preview for
* @param width maximum width for the preview
* @param height maximum height for the preview
* @param img this image will contain the preview on success
*
* @return true if preview generation succeeded
*/
virtual bool create(const TQString &path, int width, int height, TQImage &img) = 0;
/**
* The flags of this plugin:
* @li None nothing special
* @li DrawFrame a frame should be painted around the preview
* @li BlendIcon the mimetype icon should be blended over the preview
*
* @return flags for this plugin
*/
virtual Flags flags() const { return None; }
};
typedef ThumbCreator *(*newCreator)();
#endif