mirror of
https://git.lyx.org/repos/lyx.git
synced 2024-11-27 19:59:46 +00:00
103 lines
2.6 KiB
C++
103 lines
2.6 KiB
C++
// -*- C++ -*-
|
|
/**
|
|
* \file GraphicsCacheItem.h
|
|
* This file is part of LyX, the document processor.
|
|
* Licence details can be found in the file COPYING.
|
|
*
|
|
* \author Baruch Even
|
|
* \author Angus Leeming
|
|
*
|
|
* Full author contact details are available in file CREDITS.
|
|
*
|
|
* The graphics cache is a container of graphics::CacheItems.
|
|
* Each graphics::CacheItem, defined here represents a separate image file.
|
|
*
|
|
* The routines here can be used to load the graphics file into memory at
|
|
* which point (status() == graphics::Loaded).
|
|
* The user is then free to access image() in order to copy it and to then
|
|
* transform the copy (rotate, scale, clip) and to generate the pixmap.
|
|
*
|
|
* The graphics cache supports fully asynchronous:
|
|
* file conversion to a loadable format;
|
|
* file loading.
|
|
*
|
|
* Whether you get that, of course, depends on graphics::Converter and
|
|
* on the graphics::Image-derived image class.
|
|
*/
|
|
|
|
#ifndef GRAPHICSCACHEITEM_H
|
|
#define GRAPHICSCACHEITEM_H
|
|
|
|
#include "GraphicsTypes.h"
|
|
|
|
#include "support/signals.h"
|
|
|
|
|
|
namespace lyx {
|
|
|
|
namespace support { class FileName; }
|
|
|
|
namespace graphics {
|
|
|
|
class Image;
|
|
|
|
/// A graphics::Cache item holder.
|
|
class CacheItem {
|
|
public:
|
|
///
|
|
CacheItem(support::FileName const & file, support::FileName const & doc_file);
|
|
/// Needed for the pimpl
|
|
~CacheItem();
|
|
|
|
///
|
|
support::FileName const & filename() const;
|
|
|
|
/// Try to load a display format.
|
|
bool tryDisplayFormat() const;
|
|
|
|
/// It's in the cache. Now start the loading process.
|
|
void startLoading() const;
|
|
|
|
/** Monitor any changes to the file.
|
|
* There is no point monitoring the file before startLoading() is
|
|
* invoked.
|
|
*/
|
|
void startMonitoring() const;
|
|
///
|
|
bool monitoring() const;
|
|
/// perform a modification check asynchronously
|
|
void checkModifiedAsync() const;
|
|
|
|
/** Get the image associated with filename().
|
|
* If the image is not yet loaded, returns 0.
|
|
* This routine returns a pointer to const; if you want to modify it,
|
|
* create a copy and modify that.
|
|
*/
|
|
Image const * image() const;
|
|
|
|
/// How far have we got in loading the image?
|
|
ImageStatus status() const;
|
|
|
|
/** Connect and you'll be informed when the loading status of the image
|
|
* changes.
|
|
*/
|
|
typedef signal<void()>::slot_type slot_type;
|
|
///
|
|
connection connect(slot_type const &) const;
|
|
|
|
private:
|
|
/// noncopyable
|
|
CacheItem(CacheItem const &);
|
|
void operator=(CacheItem const &);
|
|
|
|
/// Use the Pimpl idiom to hide the internals.
|
|
class Impl;
|
|
/// The pointer never changes although *pimpl_'s contents may.
|
|
Impl * const pimpl_;
|
|
};
|
|
|
|
} // namespace graphics
|
|
} // namespace lyx
|
|
|
|
#endif // GRAPHICSCACHEITEM_H
|