src/insets/graphicinset.h

   1 // -*- C++ -*-
   2 /**
   3  * \file graphicinset.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author Angus Leeming
   8  *
   9  * Full author contact details are available in file CREDITS
  10  */
  11
  12 #ifndef GRAPHICINSET_H
  13 #define GRAPHICINSET_H
  14
  15 #include "dimension.h"
  16
  17 #include "graphics/GraphicsLoader.h"
  18 #include "graphics/GraphicsParams.h"
  19 #include "graphics/GraphicsTypes.h"
  20
  21 #include <boost/weak_ptr.hpp>
  22 #include <boost/signals/signal0.hpp>
  23
  24
  25 class MetricsInfo;
  26 class PainterInfo;
  27
  28
  29 class GraphicInset
  30 {
  31 public:
  32         GraphicInset();
  33         GraphicInset(GraphicInset const &);
  34
  35         /** Set the message that the inset will show when the
  36          *  display of the graphic is deactivated.
  37          *  The default is nothing, meaning that the inset will
  38          *  show a message descibing the state of the image
  39          *  loading process.
  40          */
  41         void setNoDisplayMessage(string const & msg);
  42
  43         /// Refresh the info about which file to display and how to display it.
  44         void update(grfx::Params const & params);
  45         /// File name, image size, rotation angle etc.
  46         grfx::Params const & params() const;
  47
  48         /// compute the size of the object returned in dim
  49         void metrics(MetricsInfo & mi, Dimension & dim) const;
  50         /// draw inset and update (xo, yo)-cache
  51         void draw(PainterInfo & pi, int x, int y) const;
  52
  53         /// Is the stored checksum different to that of the graphics loader?
  54         bool hasFileChanged() const;
  55         /// An accessor function to the cached store.
  56         BufferView * view() const;
  57
  58         /** Connect and you'll be informed when the loading status of the image
  59          *  changes.
  60          */
  61         typedef boost::signal0<void>::slot_type slot_type;
  62         boost::signals::connection connect(slot_type const &) const;
  63
  64 private:
  65         enum DisplayType {
  66                 IMAGE,
  67                 STATUS_MESSAGE,
  68                 NODISPLAY_MESSAGE
  69         };
  70
  71         /// Is the image ready to draw, or should we display a message instead?
  72         DisplayType displayType() const;
  73
  74         /// The message to display instead of the graphic itself.
  75         string const statusMessage() const;
  76
  77         /// The stored data.
  78         grfx::Loader loader_;
  79         grfx::Params params_;
  80         string nodisplay_message_;
  81
  82         /// These are all cached variables.
  83         mutable int old_ascent_;
  84         mutable unsigned long checksum_;
  85         mutable boost::weak_ptr<BufferView> view_;
  86         mutable Dimension dim_;
  87 };
  88
  89
  90 #endif // NOT GRAPHICINSET_H