]> git.lyx.org Git - lyx.git/blobdiff - src/graphics/GraphicsCacheItem.C
clean code to export between different flavours, output different code for sgml to...
[lyx.git] / src / graphics / GraphicsCacheItem.C
index 9d839ff003cd6b28f9fe03cc38582971862e8e2c..59973327d441815b6bbf1ff202eb94fc5f7c8e6c 100644 (file)
@@ -1,35 +1,50 @@
-/*
+/**
  * \file GraphicsCacheItem.C
- * Copyright 2002 the LyX Team
- * Read the file COPYING
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
  *
- * \author Baruch Even <baruch.even@writeme.com>
- * \author Herbert Voss <voss@lyx.org>
- * \author Angus Leeming <leeming@lyx.org>
+ * \author Baruch Even
+ * \author Herbert Voß
+ * \author Angus Leeming
+ *
+ * Full author contact details are available in file CREDITS.
  */
 
 #include <config.h>
 
-#ifdef __GNUG__
-#pragma implementation
-#endif
-
 #include "GraphicsCacheItem.h"
-#include "GraphicsImage.h"
 #include "GraphicsConverter.h"
+#include "GraphicsImage.h"
 
 #include "debug.h"
 
-#include "support/LAssert.h"
 #include "support/filetools.h"
+#include "support/FileMonitor.h"
+#include "support/lyxlib.h"
 
-#include <boost/shared_ptr.hpp>
 #include <boost/bind.hpp>
-#include <boost/signals/trackable.hpp>
+
+
+namespace support = lyx::support;
+
+using support::ChangeExtension;
+using support::FileMonitor;
+using support::IsFileReadable;
+using support::MakeDisplayPath;
+using support::OnlyFilename;
+using support::getExtFromContents;
+using support::tempName;
+using support::unlink;
+using support::unzipFile;
+using support::unzippedFileName;
+using support::zippedFile;
 
 using std::endl;
+using std::string;
 
-namespace grfx {
+
+namespace lyx {
+namespace graphics {
 
 struct CacheItem::Impl : public boost::signals::trackable {
 
@@ -64,7 +79,7 @@ struct CacheItem::Impl : public boost::signals::trackable {
 
        /** Get a notification when the image loading is done.
         *  Connected to a signal on_finish_ which is passed to
-        *  grfx::Image::loadImage.
+        *  lyx::graphics::Image::loadImage.
         */
        void imageLoaded(bool);
 
@@ -73,8 +88,22 @@ struct CacheItem::Impl : public boost::signals::trackable {
         */
        void setStatus(ImageStatus new_status);
 
+       /** Can be invoked directly by the user, but is also connected to the
+        *  FileMonitor and so is invoked when the file is changed
+        *  (if monitoring is taking place).
+        */
+       void startLoading();
+
+       /** If we are asked to load the file for a second or further time,
+        *  (because the file has changed), then we'll have to first reset
+        *  many of the variables below.
+        */
+       void reset();
+
        /// The filename we refer too.
        string const filename_;
+       ///
+       FileMonitor const monitor_;
 
        /// Is the file compressed?
        bool zipped_;
@@ -123,10 +152,26 @@ string const & CacheItem::filename() const
 
 void CacheItem::startLoading() const
 {
-       if (pimpl_->status_ != WaitingToLoad)
-               return;
+       pimpl_->startLoading();
+}
+
+
+void CacheItem::startMonitoring() const
+{
+       if (!pimpl_->monitor_.monitoring())
+               pimpl_->monitor_.start();
+}
+
+
+bool CacheItem::monitoring() const
+{
+       return pimpl_->monitor_.monitoring();
+}
 
-       pimpl_->convertToDisplayFormat();
+
+unsigned long CacheItem::checksum() const
+{
+       return pimpl_->monitor_.checksum();
 }
 
 
@@ -154,9 +199,51 @@ boost::signals::connection CacheItem::connect(slot_type const & slot) const
 
 
 CacheItem::Impl::Impl(string const & file)
-       : filename_(file), zipped_(false),
-         remove_loaded_file_(false), status_(WaitingToLoad)
-{}
+       : filename_(file),
+         monitor_(file, 2000),
+         zipped_(false),
+         remove_loaded_file_(false),
+         status_(WaitingToLoad)
+{
+       monitor_.connect(boost::bind(&Impl::startLoading, this));
+}
+
+
+void CacheItem::Impl::startLoading()
+{
+       if (status_ != WaitingToLoad)
+               reset();
+
+       convertToDisplayFormat();
+}
+
+
+void CacheItem::Impl::reset()
+{
+       zipped_ = false;
+       if (!unzipped_filename_.empty())
+               unlink(unzipped_filename_);
+       unzipped_filename_.erase();
+
+       if (remove_loaded_file_ && !file_to_load_.empty())
+               unlink(file_to_load_);
+       remove_loaded_file_ = false;
+       file_to_load_.erase();
+
+       if (image_.get())
+               image_.reset();
+
+       status_ = WaitingToLoad;
+
+       if (cl_.connected())
+               cl_.disconnect();
+
+       if (cc_.connected())
+               cc_.disconnect();
+
+       if (converter_.get())
+               converter_.reset();
+}
 
 
 void CacheItem::Impl::setStatus(ImageStatus new_status)
@@ -172,7 +259,7 @@ void CacheItem::Impl::setStatus(ImageStatus new_status)
 void CacheItem::Impl::imageConverted(bool success)
 {
        string const text = success ? "succeeded" : "failed";
-       lyxerr[Debug::GRAPHICS] << "Image conversion " << text << "." << endl;
+       lyxerr[Debug::GRAPHICS] << "Image conversion " << text << '.' << endl;
 
        file_to_load_ = converter_.get() ?
                converter_->convertedFile() : string();
@@ -180,13 +267,14 @@ void CacheItem::Impl::imageConverted(bool success)
        cc_.disconnect();
 
        success = !file_to_load_.empty() && IsFileReadable(file_to_load_);
-       lyxerr[Debug::GRAPHICS] << "Unable to find converted file!" << endl;
 
        if (!success) {
+               lyxerr[Debug::GRAPHICS] << "Unable to find converted file!"
+                                       << endl;
                setStatus(ErrorConverting);
 
                if (zipped_)
-                       lyx::unlink(unzipped_filename_);
+                       unlink(unzipped_filename_);
 
                return;
        }
@@ -214,14 +302,14 @@ void CacheItem::Impl::loadImage()
 void CacheItem::Impl::imageLoaded(bool success)
 {
        string const text = success ? "succeeded" : "failed";
-       lyxerr[Debug::GRAPHICS] << "Image loading " << text << "." << endl;
+       lyxerr[Debug::GRAPHICS] << "Image loading " << text << '.' << endl;
 
        // Clean up after loading.
        if (zipped_)
-               lyx::unlink(unzipped_filename_);
+               unlink(unzipped_filename_);
 
        if (remove_loaded_file_ && unzipped_filename_ != file_to_load_)
-               lyx::unlink(file_to_load_);
+               unlink(file_to_load_);
 
        cl_.disconnect();
 
@@ -235,74 +323,87 @@ void CacheItem::Impl::imageLoaded(bool success)
 }
 
 
-} // namespace grfx
+} // namespace graphics
+} // namespace lyx
 
 
 namespace {
 
 string const findTargetFormat(string const & from)
 {
-       typedef grfx::Image::FormatList FormatList;
-       FormatList const formats = grfx::Image::loadableFormats();
+       typedef lyx::graphics::Image::FormatList FormatList;
+       FormatList const formats = lyx::graphics::Image::loadableFormats();
 
        // There must be a format to load from.
-       lyx::Assert(!formats.empty());
+       BOOST_ASSERT(!formats.empty());
 
        // First ascertain if we can load directly with no conversion
-       FormatList::const_iterator it1 = formats.begin();
+       FormatList::const_iterator it  = formats.begin();
        FormatList::const_iterator end = formats.end();
-       for (; it1 != end; ++it1) {
-               if (from == *it1)
-                       return *it1;
+       for (; it != end; ++it) {
+               if (from == *it)
+                       return *it;
        }
 
        // So, we have to convert to a loadable format. Can we?
-       FormatList::const_iterator it2 = formats.begin();
-       for (; it2 != end; ++it2) {
-               if (grfx::Converter::isReachable(from, *it2))
-                       return *it2;
+       it = formats.begin();
+       for (; it != end; ++it) {
+               if (lyx::graphics::Converter::isReachable(from, *it))
+                       return *it;
+               else
+                       lyxerr[Debug::GRAPHICS]
+                               << "Unable to convert from " << from
+                               << " to " << *it << std::endl;
        }
 
-       // Failed! so we have to try to convert it to XPM format
+       // Failed! so we have to try to convert it to PPM format
        // with the standard converter
-       return string("xpm");
+       return string("ppm");
 }
 
 } // anon namespace
 
 
-namespace grfx {
+namespace lyx {
+namespace graphics {
 
 void CacheItem::Impl::convertToDisplayFormat()
 {
        setStatus(Converting);
+
+       // First, check that the file exists!
+       if (!IsFileReadable(filename_)) {
+               if (status_ != ErrorNoFile) {
+                       setStatus(ErrorNoFile);
+                       lyxerr[Debug::GRAPHICS]
+                               << "\tThe file is not readable" << endl;
+               }
+               return;
+       }
+
        // Make a local copy in case we unzip it
-       string const filename = zippedFile(filename_) ?
-               unzipFile(filename_) : filename_;
+       string filename;
+       if ((zipped_ = zippedFile(filename_))) {
+               unzipped_filename_ = tempName(string(), filename_);
+               if (unzipped_filename_.empty()) {
+                       setStatus(ErrorConverting);
+                       lyxerr[Debug::GRAPHICS]
+                               << "\tCould not create temporary file." << endl;
+                       return;
+               }
+               filename = unzipFile(filename_, unzipped_filename_);
+       } else
+               filename = filename_;
+
        string const displayed_filename = MakeDisplayPath(filename_);
        lyxerr[Debug::GRAPHICS] << "[GrahicsCacheItem::convertToDisplayFormat]\n"
                << "\tAttempting to convert image file: " << filename
                << "\n\twith displayed filename: " << displayed_filename
                << endl;
 
-       // First, check that the file exists!
-       if (!IsFileReadable(filename)) {
-               setStatus(ErrorNoFile);
-               lyxerr[Debug::GRAPHICS] << "\tThe file is not readable" << endl;
-               return;
-       }
-
        string from = getExtFromContents(filename);
-       // Some old ps-files make problems, so we do not need direct
-       // loading of an ps-file
-       if (from == "ps") {
-               lyxerr[Debug::GRAPHICS]
-               << "\n\tThe file contains PostScript format data.\n"
-               << "\tchanging it to eps-format to get it converted to xpm\n";
-               from = "eps";
-       } else
-               lyxerr[Debug::GRAPHICS]
-                       << "\n\tThe file contains " << from << " format data." << endl;
+       lyxerr[Debug::GRAPHICS]
+               << "\n\tThe file contains " << from << " format data." << endl;
        string const to = findTargetFormat(from);
 
        if (from == to) {
@@ -319,11 +420,12 @@ void CacheItem::Impl::convertToDisplayFormat()
 
        // Add some stuff to create a uniquely named temporary file.
        // This file is deleted in loadImage after it is loaded into memory.
-       string const to_file_base = lyx::tempName(string(), temp);
+       string const to_file_base = tempName(string(), temp);
        remove_loaded_file_ = true;
 
        // Remove the temp file, we only want the name...
-       lyx::unlink(to_file_base);
+       // FIXME: This is unsafe!
+       unlink(to_file_base);
 
        // Connect a signal to this->imageConverted and pass this signal to
        // the graphics converter so that we can load the modified file
@@ -333,4 +435,5 @@ void CacheItem::Impl::convertToDisplayFormat()
        converter_->startConversion();
 }
 
-} // namespace grfx
+} // namespace graphics
+} // namespace lyx