]> git.lyx.org Git - lyx.git/blobdiff - src/insets/insetexternal.h
Enable the external inset to handle unknown templates gracefully.
[lyx.git] / src / insets / insetexternal.h
index c0a605b804307cf1b09f32fd7b0dd791aa9c183d..4916bae6dae61476b8a3702cea3f9a48cb38cd1a 100644 (file)
@@ -1,53 +1,59 @@
 // -*- C++ -*-
-/* This file is part of*
- * ======================================================
+/**
+ * \file insetexternal.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
  *
- *           LyX, The Document Processor
+ * \author Asger Alstrup Nielsen
  *
- *           Copyright 1995 Matthias Ettrich
- *           Copyright 1995-2001 The LyX Team.
- *
- * ====================================================== */
+ * Full author contact details are available in file CREDITS
+ */
 
 #ifndef INSET_EXTERNAL_H
 #define INSET_EXTERNAL_H
 
-#ifdef __GNUG__
-#pragma interface
-#endif
-
-#include "insetbutton.h"
-#include "ExternalTemplate.h"
+#include "inset.h"
+#include "graphics/GraphicsTypes.h"
 #include "LString.h"
 
-#include <boost/signals/signal0.hpp>
+#include <boost/scoped_ptr.hpp>
+#include <boost/signals/trackable.hpp>
+
+
+class GraphicInset;
 
 ///
-class InsetExternal : public InsetButton {
+class InsetExternal : public Inset, public boost::signals::trackable {
 public:
        /// hold parameters settable from the GUI
        struct Params {
-               Params(string const & f = string(),
-                                       string const & p = string(),
-                                       ExternalTemplate const & t = ExternalTemplate())
-                       : filename(f), parameters(p), templ(t) {}
+               Params();
+               ~Params();
                /// the filename
                string filename;
-               /// the parameters of the current choice
-               string parameters;
                /// the current template used
-               ExternalTemplate templ;
+               string templatename;
+               /// The name of the tempfile used for manipulations.
+               string tempname;
+               /// how the inset is displayed by LyX
+               grfx::DisplayType display;
+               /// The scale of the displayed graphic (If shown).
+               unsigned int lyxscale;
        };
 
        InsetExternal();
        ///
+       InsetExternal(InsetExternal const &);
+       ///
        virtual ~InsetExternal();
-       /// what appears in the minibuffer when opening
-       virtual string const editMessage() const;
        ///
-       virtual void edit(BufferView *, int x, int y, mouse_button::state button);
+       virtual dispatch_result localDispatch(FuncRequest const & cmd);
+       ///
+       void metrics(MetricsInfo &, Dimension &) const;
        ///
-       virtual void edit(BufferView * bv, bool front = true);
+       void draw(PainterInfo & pi, int x, int y) const;
+       /// what appears in the minibuffer when opening
+       virtual string const editMessage() const;
        ///
        virtual EDITABLE editable() const { return IS_EDITABLE; }
        ///
@@ -61,14 +67,14 @@ public:
         If the free_spc (freespacing) variable is set, then this inset
         is in a free-spacing paragraph.
         */
-       virtual int latex(Buffer const *, std::ostream &, bool fragile,
-                         bool free_spc) const;
+       virtual int latex(Buffer const *, std::ostream &,
+                         LatexRunParams const &) const;
        /// write ASCII output to the ostream
        virtual int ascii(Buffer const *, std::ostream &, int linelen) const;
        /// write LinuxDoc output to the ostream
        virtual int linuxdoc(Buffer const *, std::ostream &) const;
        /// write DocBook output to the ostream
-       virtual int docbook(Buffer const *, std::ostream &) const;
+       virtual int docbook(Buffer const *, std::ostream &, bool mixcont) const;
 
        /// Updates needed features for this inset.
        virtual void validate(LaTeXFeatures & features) const;
@@ -77,58 +83,64 @@ public:
        virtual Inset::Code lyxCode() const { return EXTERNAL_CODE; }
 
        ///
-       virtual Inset * clone(Buffer const &, bool same_id = false) const;
-
-       /// returns the text of the button
-       virtual string const getScreenLabel(Buffer const *) const;
+       virtual Inset * clone() const;
 
-       // The following public members are used from the frontends code
+       /// Set the inset parameters.
+       virtual void setParams(Params const &, string const & filepath);
 
-       /// set the parameters from a Params structure
-       virtual void setFromParams(Params const &);
-
-       ///
-       void updateExternal() const;
-
-       /// update the file represented by the template
-       void updateExternal(string const &, Buffer const *) const;
-
-       /// edit file of this template
-       void editExternal() const;
-
-       /// view file of this template
-       void viewExternal() const;
+       /** update the file represented by the template.
+           If \param external_in_tmpdir == true, then the generated file is
+           place in the buffer's temporary directory.
+       */
+       void updateExternal(string const &, Buffer const *,
+                           bool external_in_tmpdir) const;
 
        /// return a copy of our current params
-       Params params() const;
-
-       /// hide connection
-       boost::signal0<void> hideDialog;
+       Params const & params() const;
 
 private:
-       /// Write the output for a specific file format
-       int write(string const & format, Buffer const *,
-                 std::ostream &) const;
-
-       /// Execute this command in the directory of this document
-       void executeCommand(string const & s, Buffer const * buf) const;
-
-       /// Substitute meta-variables in this string
-       string const doSubstitution(Buffer const *, string const & s) const;
+       /** This method is connected to the graphics loader, so we are
+        *  informed when the image has been loaded.
+        */
+       void statusChanged();
 
-       /// our owning view
-       BufferView * view_;
+       /** Write the output for a specific file format
+           and generate any external data files.
+           If \param external_in_tmpdir == true, then the generated file is
+           place in the buffer's temporary directory.
+       */
+       int write(string const & format, Buffer const *, std::ostream &,
+                 bool external_in_tmpdir = false) const;
 
        /// the current params
        Params params_;
 
-       /// A temp filename
-       string tempname_;
+       /// The thing that actually draws the image on LyX's screen.
+       boost::scoped_ptr<GraphicInset> const renderer_;
 };
 
-///
-bool operator==(InsetExternal::Params const &, InsetExternal::Params const &);
-///
-bool operator!=(InsetExternal::Params const &, InsetExternal::Params const &);
+
+#include "mailinset.h"
+
+class InsetExternalMailer : public MailInset {
+public:
+       ///
+       InsetExternalMailer(InsetExternal & inset);
+       ///
+       virtual InsetBase & inset() const { return inset_; }
+       ///
+       virtual string const & name() const { return name_; }
+       ///
+       virtual string const inset2string() const;
+       ///
+       static void string2params(string const &, InsetExternal::Params &);
+       ///
+       static string const params2string(InsetExternal::Params const &);
+private:
+       ///
+       static string const name_;
+       ///
+       InsetExternal & inset_;
+};
 
 #endif