// -*- C++ -*-
-/* This file is part of
- * =================================================
- *
- * LyX, The Document Processor
- * Copyright 1995 Matthias Ettrich.
- * Copyright 1995-2001 The LyX Team.
+/**
+ * \file GraphicsCacheItem.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
*
- * This file Copyright 2000 Baruch Even
- * ================================================= */
+ * \author Baruch Even
+ * \author Angus Leeming
+ *
+ * Full author contact details are available in file CREDITS.
+ *
+ * The graphics cache is a container of lyx::graphics::CacheItems.
+ * Each lyx::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() == lyx::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 lyx::graphics::Converter and
+ * on the lyx::graphics::Image-derived image class.
+ */
#ifndef GRAPHICSCACHEITEM_H
#define GRAPHICSCACHEITEM_H
-#ifdef __GNUG__
-#pragma interface
-#endif
-
-#include XPM_H_LOCATION
-#include "LString.h"
+#include "GraphicsTypes.h"
#include <boost/utility.hpp>
-#include <boost/smart_ptr.hpp>
+#include <boost/scoped_ptr.hpp>
+#include <boost/signal.hpp>
+
-#include <sigc++/signal_system.h>
+namespace lyx {
-class LyXImage;
+namespace support { class FileName; }
-/// A GraphicsCache item holder.
-class GraphicsCacheItem : boost::noncopyable {
+namespace graphics {
+
+class Image;
+class Converter;
+
+/// A lyx::graphics::Cache item holder.
+class CacheItem : boost::noncopyable {
public:
- /// c-tor
- GraphicsCacheItem(string const & filename);
- /// d-tor, frees the image structures.
- ~GraphicsCacheItem();
-
- /// Return a pixmap that can be displayed on X server.
- LyXImage * getImage() const;
///
- enum ImageStatus {
- ///
- Loading = 1,
- ///
- Converting,
- ///
- ErrorConverting,
- ///
- ErrorReading,
- ///
- UnknownError,
- ///
- Loaded
- };
-
- /// Is the pixmap ready for display?
- ImageStatus getImageStatus() const;
-
- /** Get a notification when the image conversion is done.
- used by an internal callback mechanism.
- */
- void imageConverted(bool success);
+ CacheItem(support::FileName const & file);
-private:
- /** Start image conversion process, checks first that it is necessary
- * if necessary will start an (a)synchronous task and notify upon
- * completion by calling imageConverted(bool) where true is for success
- * and false is for a failure.
- *
- * Returns a bool to denote success or failure of starting the conversion
- * task.
+ /// Define an empty d-tor out-of-line to keep boost::scoped_ptr happy.
+ ~CacheItem();
+
+ ///
+ support::FileName const & filename() 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;
+ /** Returns the check sum of filename() so that, for example, you can
+ * ascertain whether to output a new PostScript version of the file
+ * for a LaTeX run.
*/
- bool convertImage(string const & filename);
-
- /// Load the image into memory, this gets called from imageConverted(bool).
- void loadImage();
-
- /// Sets the status of the image, in the future will also notify listeners
- /// that the status is updated.
- void setStatus(ImageStatus new_status);
-
- /** The filename we refer too.
- This is used when removing ourselves from the cache.
- */
- string filename_;
- /// The temporary file that we use
- string tempfile;
- /// The image status
- ImageStatus imageStatus_;
- /// The image (if it got loaded)
- boost::scoped_ptr<LyXImage> image_;
+ unsigned long checksum() 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 boost::signal<void()> sig_type;
+ typedef sig_type::slot_type slot_type;
+ ///
+ boost::signals::connection connect(slot_type const &) const;
+
+private:
+ /// Use the Pimpl idiom to hide the internals.
+ class Impl;
+
+ /// The pointer never changes although *pimpl_'s contents may.
+ boost::scoped_ptr<Impl> const pimpl_;
};
-#endif
+} // namespace graphics
+} // namespace lyx
+
+#endif // GRAPHICSCACHEITEM_H