3 * \file GraphicsConverter.h
4 * Copyright 2002 the LyX Team
5 * Read the file COPYING
7 * \author Angus Leeming <a.leeming@ic.ac.uk>
9 * class grfx::GConverter enables graphics files to be converted asynchronously
10 * to a loadable format. It does this by building a shell script of all
11 * the conversion commands needed for the transformation. This script is then
12 * sent to the forked calls controller for non-blocking execution. When it
13 * is finished a signal is emitted, thus informing us to proceed with the
14 * loading of the image.
16 * Ultimately, this class should be wrapped back into Dekel's converter class.
19 #ifndef GRAPHICSCONVERTER_H
20 #define GRAPHICSCONVERTER_H
25 #include <boost/shared_ptr.hpp>
26 #include <boost/utility.hpp>
28 #include <sigc++/signal_system.h>
32 #include <sys/types.h> // needed for pid_t
40 class GConverter : boost::noncopyable {
43 /// This is a singleton class. Get the instance.
44 static GConverter & get();
46 /// Can the conversion be performed?
47 bool isReachable(string const & from_format_name,
48 string const & to_format_name) const;
50 /** Convert the file and at the end return it by emitting this signal
51 * If successful, the returned string will be the name of the
52 * converted file (to_file_base + extension(to_format_name)).
53 * If unsuccessful, the string will be empty.
55 typedef SigC::Signal1<void, string const &> SignalType;
57 typedef boost::shared_ptr<SignalType> SignalTypePtr;
59 void convert(string const & from_file, string const & to_file_base,
60 string const & from_format, string const & to_format,
61 SignalTypePtr on_finish);
64 /** Make the c-tor private so we can control how many objects
69 /** Build the conversion script, returning true if able to build it.
70 * The script is output to the ostringstream 'script'.
72 bool build_script(string const & from_file, string const & to_file_base,
73 string const & from_format, string const & to_format,
74 ostringstream & script) const;
76 /** Remove the ConvProcess from the list of all processes.
77 * Called by ConvProcess::converted.
79 friend class ConvProcess;
81 void erase(ConvProcess *);
83 /// The list of all conversion processs
84 typedef boost::shared_ptr<ConvProcess> ConvProcessPtr;
86 std::list<ConvProcessPtr> all_processes_;
90 /// Each ConvProcess represents a single conversion process.
91 struct ConvProcess : public SigC::Object
94 typedef GConverter::SignalTypePtr SignalTypePtr;
96 /** Each ConvProcess represents a single conversion process.
98 * 1. The name of the script_file, which it deletes once the
99 * conversion is comlpeted;
100 * 2. The script command itself, which it passes on to the forked
102 * 3. The name of the output file, which it returns to the calling
103 * process on successfull completion, by emitting
104 * 4. The signal on_finish.
106 ConvProcess(string const & script_file, string const & script_command,
107 string const & to_file, SignalTypePtr on_finish);
109 /** This method is connected to a signal passed to the forked call
110 * class, passing control back here when the conversion is completed.
111 * Cleans-up the temporary files, emits the on_finish signal and
112 * removes the ConvProcess from the list of all processes.
114 void converted(string const & cmd, pid_t pid, int retval);
121 SignalTypePtr on_finish_;
126 #endif // GRAPHICSCONVERTER_H