]> git.lyx.org Git - lyx.git/blobdiff - src/insets/insetexternal.h
Rename ascii to plaintext and LatexRunParams to OutputParams.
[lyx.git] / src / insets / insetexternal.h
index e200b5f1d5672f1eed63de0bc3e9cdfbceecb629..c9d5ab2b2fb45e241fd8af8250f4170d20b8dfab 100644 (file)
  *
  * \author Asger Alstrup Nielsen
  *
- * Full author contact details are available in file CREDITS
+ * Full author contact details are available in file CREDITS.
  */
 
 #ifndef INSET_EXTERNAL_H
 #define INSET_EXTERNAL_H
 
-#include "insetbutton.h"
-#include "ExternalTemplate.h"
-#include "LString.h"
+#include "inset.h"
+#include "ExternalTransforms.h"
+
+#include "support/filename.h"
+#include "support/translator.h"
+
+#include <boost/scoped_ptr.hpp>
+#include <boost/signals/trackable.hpp>
+
+
+/** No two InsetExternalParams variables can have the same temporary file.
+ *  This struct has copy-semantics but the copy constructor
+ *  and assignment operator simply call the default constructor.
+ *  Use of this struct enables us to use the compiler-generated
+ *  copy constructor and assignment operator for the
+ *  InsetExternalParams struct.
+ */
+namespace lyx {
+namespace external {
+
+struct TempName {
+       TempName();
+       TempName(TempName const &);
+       ~TempName();
+       TempName & operator=(TempName const &);
+       std::string const & operator()() const { return tempname_; }
+private:
+       std::string tempname_;
+};
+
+/// How is the image to be displayed on the LyX screen?
+enum DisplayType {
+       DefaultDisplay,
+       MonochromeDisplay,
+       GrayscaleDisplay,
+       ColorDisplay,
+       PreviewDisplay,
+       NoDisplay
+};
+
+
+/// The translator between the Display enum and corresponding lyx string.
+Translator<DisplayType, std::string> const & displayTranslator();
+
+} // namespace external
+} // namespace lyx
+
+
+/// hold parameters settable from the GUI
+struct InsetExternalParams {
+       InsetExternalParams();
+
+       void write(Buffer const &, std::ostream &) const;
+       bool read(Buffer const &, LyXLex &);
+
+       /// The name of the tempfile used for manipulations.
+       std::string const & tempname() const { return tempname_(); }
+
+       /// The template currently in use.
+       void settemplate(std::string const &);
+       std::string const & templatename() const { return templatename_; }
+
+       /// The external file.
+       lyx::support::FileName filename;
+       /// How the inset is to be displayed by LyX.
+       lyx::external::DisplayType display;
+       /// The scale of the displayed graphic (if shown).
+       unsigned int lyxscale;
+
+       lyx::external::ClipData     clipdata;
+       lyx::external::ExtraData    extradata;
+       lyx::external::ResizeData   resizedata;
+       lyx::external::RotationData rotationdata;
+
+private:
+       lyx::external::TempName tempname_;
+       std::string templatename_;
+};
+
+
+class RenderBase;
 
 ///
-class InsetExternal : public InsetButton {
+class InsetExternal : public InsetOld, 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) {}
-               /// the filename
-               string filename;
-               /// the parameters of the current choice
-               string parameters;
-               /// the current template used
-               ExternalTemplate templ;
-       };
-
        InsetExternal();
        ///
+       InsetExternal(InsetExternal const &);
+       ///
        virtual ~InsetExternal();
        ///
-       virtual dispatch_result localDispatch(FuncRequest const & cmd);
-       /// what appears in the minibuffer when opening
-       virtual string const editMessage() const;
+       virtual std::auto_ptr<InsetBase> clone() const;
+       ///
+       virtual InsetOld::Code lyxCode() const { return EXTERNAL_CODE; }
        ///
        virtual EDITABLE editable() const { return IS_EDITABLE; }
+
        ///
-       virtual void write(Buffer const *, std::ostream &) const;
+       void metrics(MetricsInfo &, Dimension &) const;
        ///
-       virtual void read(Buffer const *, LyXLex & lex);
-
-       /** returns the number of rows (\n's) of generated tex code.
-        fragile == true means, that the inset should take care about
-        fragile commands by adding a \protect before.
-        If the free_spc (freespacing) variable is set, then this inset
-        is in a free-spacing paragraph.
-        */
-       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 &, bool mixcont) const;
-
-       /// Updates needed features for this inset.
-       virtual void validate(LaTeXFeatures & features) const;
-
-       /// returns LyX code associated with the inset. Used for TOC, ...)
-       virtual Inset::Code lyxCode() const { return EXTERNAL_CODE; }
-
+       void draw(PainterInfo & pi, int x, int y) const;
        ///
-       virtual Inset * clone(Buffer const &) const;
+       virtual void write(Buffer const &, std::ostream &) const;
        ///
-       //virtual Inset * clone(Buffer const &, bool same_id) const;
-
-       /// returns the text of the button
-       virtual string const getScreenLabel(Buffer const *) const;
-
-       // The following public members are used from the frontends code
-
-       /// set the parameters from a Params structure
-       virtual void setFromParams(Params const &);
+       virtual void read(Buffer const &, LyXLex & lex);
 
+       /// \returns the number of rows (\n's) of generated code.
+       virtual int latex(Buffer const &, std::ostream &,
+                         OutputParams const &) 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;
+       virtual int plaintext(Buffer const &, std::ostream &,
+                         OutputParams const &) const;
+       ///
+       virtual int linuxdoc(Buffer const &, std::ostream &,
+                            OutputParams const &) const;
+       ///
+       virtual int docbook(Buffer const &, std::ostream &,
+                           OutputParams const &) const;
 
-       /// return a copy of our current params
-       Params const & params() const;
+       /// Update needed features for this inset.
+       virtual void validate(LaTeXFeatures & features) const;
 
        ///
-       void setView(BufferView * bv) { view_ = bv; }
+       InsetExternalParams const & params() const;
+       void setParams(InsetExternalParams const &, Buffer const &);
+       ///
+       void addPreview(lyx::graphics::PreviewLoader &) const;
+       ///
+       void edit(BufferView * bv, bool);
 
+protected:
+       ///
+       virtual
+       DispatchResult
+       priv_dispatch(FuncRequest const & cmd, idx_type &, pos_type &);
 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;
-
-       /// our owning view
-       BufferView * view_;
+       /** This method is connected to the graphics loader, so we are
+        *  informed when the image has been loaded.
+        */
+       void statusChanged() const;
 
-       /// the current params
-       Params params_;
+       /** Slot receiving a signal that the external file has changed
+        *  and the preview should be regenerated.
+        */
+       void fileChanged() const;
 
-       /// A temp filename
-       string tempname_;
+       /// The current params
+       InsetExternalParams params_;
+       /// The thing that actually draws the image on LyX's screen.
+       boost::scoped_ptr<RenderBase> renderer_;
 };
 
 
@@ -130,16 +175,18 @@ public:
        ///
        virtual InsetBase & inset() const { return inset_; }
        ///
-       virtual string const & name() const { return name_; }
+       virtual std::string const & name() const { return name_; }
        ///
-       virtual string const inset2string() const;
+       virtual std::string const inset2string(Buffer const &) const;
        ///
-       static void string2params(string const &, InsetExternal::Params &);
+       static void string2params(std::string const &, Buffer const &,
+                                 InsetExternalParams &);
        ///
-       static string const params2string(InsetExternal::Params const &);
+       static std::string const params2string(InsetExternalParams const &,
+                                              Buffer const &);
 private:
        ///
-       static string const name_;
+       static std::string const name_;
        ///
        InsetExternal & inset_;
 };