]> git.lyx.org Git - features.git/blobdiff - src/graphics/GraphicsImage.h
Replace LString.h with support/std_string.h,
[features.git] / src / graphics / GraphicsImage.h
index b5fd32815c9bee5c80c7bd953ebf2ad495688504..ec39bc1b5aec732d66c905fe72bbf30f5acad684 100644 (file)
@@ -1,68 +1,66 @@
 // -*- C++ -*-
 /**
- *  \file GraphicsImage.h
- *  Copyright 2002 the LyX Team
- *  Read the file COPYING
+ * \file GraphicsImage.h
+ * 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 Angus Leeming <a.leeming@ic.ac.uk>
+ * \author Baruch Even
+ * \author Angus Leeming
  *
- *  An abstract base class for the images themselves.
- *  Allows the user to retrieve the pixmap, once loaded and to issue commands
- *  to modify it.
+ * Full author contact details are available in file CREDITS.
  *
- *  The signals newImage and loadableFormats are connected to the approriate
- *  derived classes elsewhere, allowing the graphics cache to access them
- *  without knowing anything about their instantiation.
+ * An abstract base class for the images themselves.
+ * Allows the user to retrieve the pixmap, once loaded and to issue commands
+ * to modify it.
  *
- *  The loading process can be asynchronous, but cropping, rotating and
- *  scaling block execution.
+ * The boost::functions newImage and loadableFormats are connected to the
+ * appropriate derived classes elsewhere, allowing the graphics cache to
+ * access them without knowing anything about their instantiation.
+ *
+ * The loading process can be asynchronous, but cropping, rotating and
+ * scaling block execution.
  */
 
 #ifndef GRAPHICSIMAGE_H
 #define GRAPHICSIMAGE_H
 
-#include "LString.h"
-#include "GraphicsTypes.h"
+#include "support/std_string.h"
 
 #include <boost/shared_ptr.hpp>
-
-#include <sigc++/signal_system.h>
-
-#include <X11/X.h>
+#include <boost/function/function0.hpp>
+#include <boost/signals/signal1.hpp>
 
 #include <vector>
 #include <utility>
 
-#ifdef __GNUG__
-#pragma interface
-#endif
-
-namespace grfx {
+namespace lyx {
+namespace graphics {
 
-class GParams;
+class Params;
 
-class GImage
-{
+class Image {
 public:
-       /// A list of supported formats.
-       typedef std::vector<string> FormatList;
-       /** This will be connected to a function that will return whichever
-        *  derived class we desire.
+       /** This is to be connected to a function that will return a new
+        *  instance of a viable derived class.
         */
-       static SigC::Signal0<ImagePtr> newImage;
+       typedef boost::shared_ptr<Image> ImagePtr;
+       ///
+       static boost::function0<ImagePtr> newImage;
 
        /// Return the list of loadable formats.
-       static SigC::Signal0<FormatList> loadableFormats;
+       typedef std::vector<string> FormatList;
+       ///
+       static boost::function0<FormatList> loadableFormats;
 
+       /// Must define default c-tor explicitly as we define a copy c-tor.
+       Image() {}
+       /// Don't copy the signal finishedLoading
+       Image(Image const &) {}
        ///
-       virtual ~GImage() {}
+       virtual ~Image() {}
 
        /// Create a copy
-       virtual GImage * clone() const = 0;
-
-       ///
-       virtual Pixmap getPixmap() const = 0;
+       virtual Image * clone() const = 0;
 
        /// Get the image width
        virtual unsigned int getWidth() const = 0;
@@ -70,39 +68,47 @@ public:
        /// Get the image height
        virtual unsigned int getHeight() const = 0;
 
-       /** At the end of the loading or modification process, return the new
-        *  image by emitting this signal */
-       typedef SigC::Signal1<void, bool> SignalType;
+       /// is the image drawable ?
+       virtual bool isDrawable() const = 0;
+
+       /** At the end of the loading process inform the outside world
+        *  by emitting a signal.
+        */
+       typedef boost::signal1<void, bool> SignalType;
        ///
-       typedef boost::shared_ptr<SignalType> SignalTypePtr;
+       SignalType finishedLoading;
 
-       /// Start loading the image file.
-       virtual void load(string const & filename, SignalTypePtr) = 0;
+       /** Start loading the image file.
+        *  The caller should expect this process to be asynchronous and
+        *  so should connect to the "finished" signal above.
+        */
+       virtual void load(string const & filename) = 0;
 
        /** Generate the pixmap.
         *  Uses the params to decide on color, grayscale etc.
         *  Returns true if the pixmap is created.
         */
-       virtual bool setPixmap(GParams const & params) = 0;
+       virtual bool setPixmap(Params const & params) = 0;
 
        /// Clip the image using params.
-       virtual void clip(GParams const & params) = 0;
+       virtual void clip(Params const & params) = 0;
 
        /// Rotate the image using params.
-       virtual void rotate(GParams const & params) = 0;
+       virtual void rotate(Params const & params) = 0;
 
        /// Scale the image using params.
-       virtual void scale(GParams const & params) = 0;
+       virtual void scale(Params const & params) = 0;
 
 protected:
        /** Uses the params to ascertain the dimensions of the scaled image.
         *  Returned as make_pair(width, height).
-        *  If something geso wrong, returns make_pair(getWidth(), getHeight())
+        *  If something goes wrong, returns make_pair(getWidth(), getHeight())
         */
        std::pair<unsigned int, unsigned int>
-       getScaledDimensions(GParams const & params) const;
+       getScaledDimensions(Params const & params) const;
 };
 
-} // namespace grfx
+} // namespace graphics
+} // namespace lyx
 
 #endif // GRAPHICSIMAGE_H