]> git.lyx.org Git - lyx.git/blob - src/insets/insetgraphics.C
10040ab8a4242977f8ed587f6a447078f3186e90
[lyx.git] / src / insets / insetgraphics.C
1 /**
2  * \file insetgraphics.C
3  * This file is part of LyX, the document processor.
4  * Licence details can be found in the file COPYING.
5  *
6  * \author Baruch Even
7  * \author Herbert Voß
8  *
9  * Full author contact details are available in file CREDITS.
10  */
11
12 /*
13 TODO
14
15     * What advanced features the users want to do?
16       Implement them in a non latex dependent way, but a logical way.
17       LyX should translate it to latex or any other fitting format.
18     * Add a way to roll the image file into the file format.
19     * When loading, if the image is not found in the expected place, try
20       to find it in the clipart, or in the same directory with the image.
21     * The image choosing dialog could show thumbnails of the image formats
22       it knows of, thus selection based on the image instead of based on
23       filename.
24     * Add support for the 'picins' package.
25     * Add support for the 'picinpar' package.
26     * Improve support for 'subfigure' - Allow to set the various options
27       that are possible.
28 */
29
30 /* NOTES:
31  * Fileformat:
32  * The filename is kept in  the lyx file in a relative way, so as to allow
33  * moving the document file and its images with no problem.
34  *
35  *
36  * Conversions:
37  *   Postscript output means EPS figures.
38  *
39  *   PDF output is best done with PDF figures if it's a direct conversion
40  *   or PNG figures otherwise.
41  *      Image format
42  *      from        to
43  *      EPS         epstopdf
44  *      PS          ps2pdf
45  *      JPG/PNG     direct
46  *      PDF         direct
47  *      others      PNG
48  */
49
50 #include <config.h>
51
52 #include "insets/insetgraphics.h"
53 #include "insets/render_graphic.h"
54
55 #include "buffer.h"
56 #include "BufferView.h"
57 #include "converter.h"
58 #include "cursor.h"
59 #include "debug.h"
60 #include "dispatchresult.h"
61 #include "exporter.h"
62 #include "format.h"
63 #include "funcrequest.h"
64 #include "gettext.h"
65 #include "LaTeXFeatures.h"
66 #include "lyx_main.h"
67 #include "lyxlength.h"
68 #include "lyxlex.h"
69 #include "metricsinfo.h"
70 #include "mover.h"
71 #include "outputparams.h"
72 #include "sgml.h"
73
74 #include "frontends/Alert.h"
75 #include "frontends/LyXView.h"
76
77 #include "support/convert.h"
78 #include "support/filetools.h"
79 #include "support/lyxalgo.h" // lyx::count
80 #include "support/lyxlib.h" // lyx::sum
81 #include "support/lstrings.h"
82 #include "support/os.h"
83 #include "support/systemcall.h"
84
85 #include <boost/bind.hpp>
86 #include <boost/tuple/tuple.hpp>
87
88 #include <sstream>
89
90 namespace support = lyx::support;
91
92 using lyx::support::AbsolutePath;
93 using lyx::support::bformat;
94 using lyx::support::ChangeExtension;
95 using lyx::support::compare_timestamps;
96 using lyx::support::contains;
97 using lyx::support::FileName;
98 using lyx::support::float_equal;
99 using lyx::support::GetExtension;
100 using lyx::support::IsFileReadable;
101 using lyx::support::OnlyFilename;
102 using lyx::support::rtrim;
103 using lyx::support::subst;
104 using lyx::support::Systemcall;
105 using lyx::support::unzipFile;
106 using lyx::support::unzippedFileName;
107
108 namespace os = lyx::support::os;
109
110 using std::endl;
111 using std::string;
112 using std::auto_ptr;
113 using std::istringstream;
114 using std::ostream;
115 using std::ostringstream;
116
117
118 namespace {
119
120 // This function is a utility function
121 // ... that should be with ChangeExtension ...
122 inline
123 string const RemoveExtension(string const & filename)
124 {
125         return ChangeExtension(filename, string());
126 }
127
128
129 string findTargetFormat(string const & format, OutputParams const & runparams)
130 {
131         // Are we using latex or pdflatex?
132         if (runparams.flavor == OutputParams::PDFLATEX) {
133                 lyxerr[Debug::GRAPHICS] << "findTargetFormat: PDF mode" << endl;
134                 // Convert postscript to pdf
135                 if (format == "eps" || format == "ps")
136                         return "pdf";
137                 // pdflatex can use jpeg, png and pdf directly
138                 if (format == "jpg" || format == "pdf")
139                         return format;
140                 // Convert everything else to png
141                 return "png";
142         }
143         // If it's postscript, we always do eps.
144         lyxerr[Debug::GRAPHICS] << "findTargetFormat: PostScript mode" << endl;
145         if (format != "ps")
146                 // any other than ps is changed to eps
147                 return "eps";
148         // let ps untouched
149         return format;
150 }
151
152 } // namespace anon
153
154
155 InsetGraphics::InsetGraphics()
156         : graphic_label(sgml::uniqueID("graph")),
157           graphic_(new RenderGraphic(this))
158 {}
159
160
161 InsetGraphics::InsetGraphics(InsetGraphics const & ig)
162         : InsetOld(ig),
163           boost::signals::trackable(),
164           graphic_label(sgml::uniqueID("graph")),
165           graphic_(new RenderGraphic(*ig.graphic_, this))
166 {
167         setParams(ig.params());
168 }
169
170
171 auto_ptr<InsetBase> InsetGraphics::doClone() const
172 {
173         return auto_ptr<InsetBase>(new InsetGraphics(*this));
174 }
175
176
177 InsetGraphics::~InsetGraphics()
178 {
179         InsetGraphicsMailer(*this).hideDialog();
180 }
181
182
183 void InsetGraphics::doDispatch(LCursor & cur, FuncRequest & cmd)
184 {
185         switch (cmd.action) {
186         case LFUN_GRAPHICS_EDIT: {
187                 Buffer const & buffer = *cur.bv().buffer();
188                 InsetGraphicsParams p;
189                 InsetGraphicsMailer::string2params(cmd.argument, buffer, p);
190                 editGraphics(p, buffer);
191                 break;
192         }
193
194         case LFUN_INSET_MODIFY: {
195                 Buffer const & buffer = cur.buffer();
196                 InsetGraphicsParams p;
197                 InsetGraphicsMailer::string2params(cmd.argument, buffer, p);
198                 if (!p.filename.empty()) {
199                         setParams(p);
200                         cur.bv().update();
201                 }
202                 break;
203         }
204
205         case LFUN_INSET_DIALOG_UPDATE:
206                 InsetGraphicsMailer(*this).updateDialog(&cur.bv());
207                 break;
208
209         case LFUN_MOUSE_RELEASE:
210                 InsetGraphicsMailer(*this).showDialog(&cur.bv());
211                 break;
212
213         default:
214                 InsetBase::doDispatch(cur, cmd);
215                 break;
216         }
217 }
218
219
220 void InsetGraphics::edit(LCursor & cur, bool)
221 {
222         InsetGraphicsMailer(*this).showDialog(&cur.bv());
223 }
224
225
226 void InsetGraphics::metrics(MetricsInfo & mi, Dimension & dim) const
227 {
228         graphic_->metrics(mi, dim);
229         dim_ = dim;
230 }
231
232
233 void InsetGraphics::draw(PainterInfo & pi, int x, int y) const
234 {
235         setPosCache(pi, x, y);
236         graphic_->draw(pi, x, y);
237 }
238
239
240 InsetBase::EDITABLE InsetGraphics::editable() const
241 {
242         return IS_EDITABLE;
243 }
244
245
246 void InsetGraphics::write(Buffer const & buf, ostream & os) const
247 {
248         os << "Graphics\n";
249         params().Write(os, buf.filePath());
250 }
251
252
253 void InsetGraphics::read(Buffer const & buf, LyXLex & lex)
254 {
255         string const token = lex.getString();
256
257         if (token == "Graphics")
258                 readInsetGraphics(lex, buf.filePath());
259         else
260                 lyxerr[Debug::GRAPHICS] << "Not a Graphics inset!" << endl;
261
262         graphic_->update(params().as_grfxParams());
263 }
264
265
266 void InsetGraphics::readInsetGraphics(LyXLex & lex, string const & bufpath)
267 {
268         bool finished = false;
269
270         while (lex.isOK() && !finished) {
271                 lex.next();
272
273                 string const token = lex.getString();
274                 lyxerr[Debug::GRAPHICS] << "Token: '" << token << '\''
275                                     << endl;
276
277                 if (token.empty()) {
278                         continue;
279                 } else if (token == "\\end_inset") {
280                         finished = true;
281                 } else {
282                         if (!params_.Read(lex, token, bufpath))
283                                 lyxerr << "Unknown token, " << token << ", skipping."
284                                         << std::endl;
285                 }
286         }
287 }
288
289
290 string const InsetGraphics::createLatexOptions() const
291 {
292         // Calculate the options part of the command, we must do it to a string
293         // stream since we might have a trailing comma that we would like to remove
294         // before writing it to the output stream.
295         ostringstream options;
296         if (!params().bb.empty())
297             options << "bb=" << rtrim(params().bb) << ',';
298         if (params().draft)
299             options << "draft,";
300         if (params().clip)
301             options << "clip,";
302         double const scl = convert<double>(params().scale);
303         if (!params().scale.empty() && !float_equal(scl, 0.0, 0.05)) {
304                 if (!float_equal(scl, 100.0, 0.05))
305                         options << "scale=" << scl / 100.0 << ',';
306         } else {
307                 if (!params().width.zero())
308                         options << "width=" << params().width.asLatexString() << ',';
309                 if (!params().height.zero())
310                         options << "height=" << params().height.asLatexString() << ',';
311                 if (params().keepAspectRatio)
312                         options << "keepaspectratio,";
313         }
314
315         // Make sure rotation angle is not very close to zero;
316         // a float can be effectively zero but not exactly zero.
317         if (!params().rotateAngle.empty()
318                 && !float_equal(convert<double>(params().rotateAngle), 0.0, 0.001)) {
319             options << "angle=" << params().rotateAngle << ',';
320             if (!params().rotateOrigin.empty()) {
321                 options << "origin=" << params().rotateOrigin[0];
322                 if (contains(params().rotateOrigin,"Top"))
323                     options << 't';
324                 else if (contains(params().rotateOrigin,"Bottom"))
325                     options << 'b';
326                 else if (contains(params().rotateOrigin,"Baseline"))
327                     options << 'B';
328                 options << ',';
329             }
330         }
331
332         if (!params().special.empty())
333             options << params().special << ',';
334
335         string opts = options.str();
336         // delete last ','
337         return opts.substr(0, opts.size() - 1);
338 }
339
340
341 string const InsetGraphics::toDocbookLength(LyXLength const & len) const
342 {
343         ostringstream result;
344         switch (len.unit()) {
345                 case LyXLength::SP: // Scaled point (65536sp = 1pt) TeX's smallest unit.
346                         result << len.value() * 65536.0 * 72 / 72.27 << "pt";
347                         break;
348                 case LyXLength::PT: // Point = 1/72.27in = 0.351mm
349                         result << len.value() * 72 / 72.27 << "pt";
350                         break;
351                 case LyXLength::BP: // Big point (72bp = 1in), also PostScript point
352                         result << len.value() << "pt";
353                         break;
354                 case LyXLength::DD: // Didot point = 1/72 of a French inch, = 0.376mm
355                         result << len.value() * 0.376 << "mm";
356                         break;
357                 case LyXLength::MM: // Millimeter = 2.845pt
358                         result << len.value() << "mm";
359                         break;
360                 case LyXLength::PC: // Pica = 12pt = 4.218mm
361                         result << len.value() << "pc";
362                         break;
363                 case LyXLength::CC: // Cicero = 12dd = 4.531mm
364                         result << len.value() * 4.531 << "mm";
365                         break;
366                 case LyXLength::CM: // Centimeter = 10mm = 2.371pc
367                         result << len.value() << "cm";
368                         break;
369                 case LyXLength::IN: // Inch = 25.4mm = 72.27pt = 6.022pc
370                         result << len.value() << "in";
371                         break;
372                 case LyXLength::EX: // Height of a small "x" for the current font.
373                         // Obviously we have to compromise here. Any better ratio than 1.5 ?
374                         result << len.value() / 1.5 << "em";
375                         break;
376                 case LyXLength::EM: // Width of capital "M" in current font.
377                         result << len.value() << "em";
378                         break;
379                 case LyXLength::MU: // Math unit (18mu = 1em) for positioning in math mode
380                         result << len.value() * 18 << "em";
381                         break;
382                 case LyXLength::PTW: // Percent of TextWidth
383                 case LyXLength::PCW: // Percent of ColumnWidth
384                 case LyXLength::PPW: // Percent of PageWidth
385                 case LyXLength::PLW: // Percent of LineWidth
386                 case LyXLength::PTH: // Percent of TextHeight
387                 case LyXLength::PPH: // Percent of Paper
388                         // Sigh, this will go wrong.
389                         result << len.value() << "%";
390                         break;
391                 default:
392                         result << len.asString();
393                         break;
394         }
395         return result.str();
396 }
397
398 string const InsetGraphics::createDocBookAttributes() const
399 {
400         // Calculate the options part of the command, we must do it to a string
401         // stream since we copied the code from createLatexParams() ;-)
402
403         // FIXME: av: need to translate spec -> Docbook XSL spec (http://www.sagehill.net/docbookxsl/ImageSizing.html)
404         // Right now it only works with my version of db2latex :-)
405
406         ostringstream options;
407         double const scl = convert<double>(params().scale);
408         if (!params().scale.empty() && !float_equal(scl, 0.0, 0.05)) {
409                 if (!float_equal(scl, 100.0, 0.05))
410                         options << " scale=\""
411                                 << static_cast<int>( (scl) + 0.5 )
412                                 << "\" ";
413         } else {
414                 if (!params().width.zero()) {
415                         options << " width=\"" << toDocbookLength(params().width)  << "\" ";
416                 }
417                 if (!params().height.zero()) {
418                         options << " depth=\"" << toDocbookLength(params().height)  << "\" ";
419                 }
420                 if (params().keepAspectRatio) {
421                         // This will be irrelevant unless both width and height are set
422                         options << "scalefit=\"1\" ";
423                 }
424         }
425
426
427         if (!params().special.empty())
428             options << params().special << " ";
429
430         string opts = options.str();
431         // trailing blanks are ok ...
432         return opts;
433 }
434
435
436 namespace {
437
438 enum CopyStatus {
439         SUCCESS,
440         FAILURE,
441         IDENTICAL_PATHS,
442         IDENTICAL_CONTENTS
443 };
444
445
446 std::pair<CopyStatus, string> const
447 copyFileIfNeeded(string const & file_in, string const & file_out)
448 {
449         BOOST_ASSERT(AbsolutePath(file_in));
450         BOOST_ASSERT(AbsolutePath(file_out));
451
452         unsigned long const checksum_in  = support::sum(file_in);
453         unsigned long const checksum_out = support::sum(file_out);
454
455         if (checksum_in == checksum_out)
456                 // Nothing to do...
457                 return std::make_pair(IDENTICAL_CONTENTS, file_out);
458
459         Mover const & mover = movers(formats.getFormatFromFile(file_in));
460         bool const success = mover.copy(file_in, file_out);
461         if (!success) {
462                 lyxerr[Debug::GRAPHICS]
463                         << support::bformat(_("Could not copy the file\n%1$s\n"
464                                               "into the temporary directory."),
465                                             file_in)
466                         << std::endl;
467         }
468
469         CopyStatus status = success ? SUCCESS : FAILURE;
470         return std::make_pair(status, file_out);
471 }
472
473
474 std::pair<CopyStatus, string> const
475 copyToDirIfNeeded(string const & file_in, string const & dir, bool zipped)
476 {
477         using support::rtrim;
478
479         BOOST_ASSERT(AbsolutePath(file_in));
480
481         string const only_path = support::OnlyPath(file_in);
482         if (rtrim(support::OnlyPath(file_in) , "/") == rtrim(dir, "/"))
483                 return std::make_pair(IDENTICAL_PATHS, file_in);
484
485         string mangled = FileName(file_in).mangledFilename();
486         if (zipped) {
487                 // We need to change _eps.gz to .eps.gz. The mangled name is
488                 // still unique because of the counter in mangledFilename().
489                 // We can't just call mangledFilename() with the zip
490                 // extension removed, because base.eps and base.eps.gz may
491                 // have different content but would get the same mangled
492                 // name in this case.
493                 string const base = RemoveExtension(unzippedFileName(file_in));
494                 string::size_type const ext_len = file_in.length() - base.length();
495                 mangled[mangled.length() - ext_len] = '.';
496         }
497         string const file_out = support::MakeAbsPath(mangled, dir);
498
499         return copyFileIfNeeded(file_in, file_out);
500 }
501
502
503 string const stripExtension(string const & file)
504 {
505         // Remove the extension so the LaTeX will use whatever
506         // is appropriate (when there are several versions in
507         // different formats)
508         // This works only if the filename contains no dots besides
509         // the just removed one. We can fool here by replacing all
510         // dots with a macro whose definition is just a dot ;-)
511         return subst(RemoveExtension(file), ".", "\\lyxdot ");
512 }
513
514
515 string const stripExtensionIfPossible(string const & file, string const & to)
516 {
517         // No conversion is needed. LaTeX can handle the graphic file as is.
518         // This is true even if the orig_file is compressed.
519         string const to_format = formats.getFormat(to)->extension();
520         string const file_format = GetExtension(file);
521         // for latex .ps == .eps
522         if (to_format == file_format ||
523             (to_format == "eps" && file_format ==  "ps") ||
524             (to_format ==  "ps" && file_format == "eps"))
525                 return stripExtension(file);
526         return file;
527 }
528
529 } // namespace anon
530
531
532 string const InsetGraphics::prepareFile(Buffer const & buf,
533                                         OutputParams const & runparams) const
534 {
535         // The following code depends on non-empty filenames
536         if (params().filename.empty())
537                 return string();
538
539         string const orig_file = params().filename.absFilename();
540         string const rel_file = params().filename.relFilename(buf.filePath());
541
542         // If the file is compressed and we have specified that it
543         // should not be uncompressed, then just return its name and
544         // let LaTeX do the rest!
545         bool const zipped = params().filename.isZipped();
546
547         // temp_file will contain the file for LaTeX to act on if, for example,
548         // we move it to a temp dir or uncompress it.
549         string temp_file = orig_file;
550
551         // The master buffer. This is useful when there are multiple levels
552         // of include files
553         Buffer const * m_buffer = buf.getMasterBuffer();
554
555         // Return the output name if the file does not exist.
556         // We are not going to change the extension or using the name of the
557         // temporary file, the code is already complicated enough.
558         if (!IsFileReadable(orig_file))
559                 return params().filename.outputFilename(m_buffer->filePath());
560
561         // We place all temporary files in the master buffer's temp dir.
562         // This is possible because we use mangled file names.
563         // This is necessary for DVI export.
564         string const temp_path = m_buffer->temppath();
565
566         CopyStatus status;
567         boost::tie(status, temp_file) =
568                         copyToDirIfNeeded(orig_file, temp_path, zipped);
569
570         if (status == FAILURE)
571                 return orig_file;
572
573         // a relative filename should be relative to the master
574         // buffer.
575         // "nice" means that the buffer is exported to LaTeX format but not
576         //        run through the LaTeX compiler.
577         string const output_file = os::external_path(runparams.nice ?
578                 params().filename.outputFilename(m_buffer->filePath()) :
579                 OnlyFilename(temp_file));
580         string const source_file = runparams.nice ? orig_file : temp_file;
581
582         if (zipped) {
583                 if (params().noUnzip) {
584                         // We don't know whether latex can actually handle
585                         // this file, but we can't check, because that would
586                         // mean to unzip the file and thereby making the
587                         // noUnzip parameter meaningless.
588                         lyxerr[Debug::GRAPHICS]
589                                 << "\tpass zipped file to LaTeX.\n";
590
591                         string const bb_orig_file = ChangeExtension(orig_file, "bb");
592                         if (runparams.nice) {
593                                 runparams.exportdata->addExternalFile("latex",
594                                                 bb_orig_file,
595                                                 ChangeExtension(output_file, "bb"));
596                         } else {
597                                 // LaTeX needs the bounding box file in the
598                                 // tmp dir
599                                 string bb_file = ChangeExtension(temp_file, "bb");
600                                 boost::tie(status, bb_file) =
601                                         copyFileIfNeeded(bb_orig_file, bb_file);
602                                 if (status == FAILURE)
603                                         return orig_file;
604                                 runparams.exportdata->addExternalFile("latex",
605                                                 bb_file);
606                         }
607                         runparams.exportdata->addExternalFile("latex",
608                                         source_file, output_file);
609                         runparams.exportdata->addExternalFile("dvi",
610                                         source_file, output_file);
611                         // We can't strip the extension, because we don't know
612                         // the unzipped file format
613                         return output_file;
614                 }
615
616                 string const unzipped_temp_file = unzippedFileName(temp_file);
617                 if (compare_timestamps(unzipped_temp_file, temp_file) > 0) {
618                         // temp_file has been unzipped already and
619                         // orig_file has not changed in the meantime.
620                         temp_file = unzipped_temp_file;
621                         lyxerr[Debug::GRAPHICS]
622                                 << "\twas already unzipped to " << temp_file
623                                 << endl;
624                 } else {
625                         // unzipped_temp_file does not exist or is too old
626                         temp_file = unzipFile(temp_file);
627                         lyxerr[Debug::GRAPHICS]
628                                 << "\tunzipped to " << temp_file << endl;
629                 }
630         }
631
632         string const from = formats.getFormatFromFile(temp_file);
633         if (from.empty()) {
634                 lyxerr[Debug::GRAPHICS]
635                         << "\tCould not get file format." << endl;
636                 return orig_file;
637         }
638         string const to   = findTargetFormat(from, runparams);
639         string const ext  = formats.extension(to);
640         lyxerr[Debug::GRAPHICS]
641                 << "\t we have: from " << from << " to " << to << '\n';
642
643         // We're going to be running the exported buffer through the LaTeX
644         // compiler, so must ensure that LaTeX can cope with the graphics
645         // file format.
646
647         lyxerr[Debug::GRAPHICS]
648                 << "\tthe orig file is: " << orig_file << endl;
649
650         if (from == to) {
651                 // The extension of temp_file might be != ext!
652                 runparams.exportdata->addExternalFile("latex", source_file,
653                                                       output_file);
654                 runparams.exportdata->addExternalFile("dvi", source_file,
655                                                       output_file);
656                 return stripExtensionIfPossible(output_file, to);
657         }
658
659         string const to_file = ChangeExtension(temp_file, ext);
660         string const output_to_file = ChangeExtension(output_file, ext);
661
662         // Do we need to perform the conversion?
663         // Yes if to_file does not exist or if temp_file is newer than to_file
664         if (compare_timestamps(temp_file, to_file) < 0) {
665                 lyxerr[Debug::GRAPHICS]
666                         << bformat(_("No conversion of %1$s is needed after all"),
667                                    rel_file)
668                         << std::endl;
669                 runparams.exportdata->addExternalFile("latex", to_file,
670                                                       output_to_file);
671                 runparams.exportdata->addExternalFile("dvi", to_file,
672                                                       output_to_file);
673                 return stripExtension(output_file);
674         }
675
676         lyxerr[Debug::GRAPHICS]
677                 << "\tThe original file is " << orig_file << "\n"
678                 << "\tA copy has been made and convert is to be called with:\n"
679                 << "\tfile to convert = " << temp_file << '\n'
680                 << "\t from " << from << " to " << to << '\n';
681
682         if (converters.convert(&buf, temp_file, temp_file, from, to, true)) {
683                 runparams.exportdata->addExternalFile("latex",
684                                 to_file, output_to_file);
685                 runparams.exportdata->addExternalFile("dvi",
686                                 to_file, output_to_file);
687         }
688
689         return stripExtension(output_file);
690 }
691
692
693 int InsetGraphics::latex(Buffer const & buf, ostream & os,
694                          OutputParams const & runparams) const
695 {
696         // If there is no file specified or not existing,
697         // just output a message about it in the latex output.
698         lyxerr[Debug::GRAPHICS]
699                 << "insetgraphics::latex: Filename = "
700                 << params().filename.absFilename() << endl;
701
702         string const relative_file =
703                 params().filename.relFilename(buf.filePath());
704
705         string const file_ = params().filename.absFilename();
706         bool const file_exists = !file_.empty() && IsFileReadable(file_);
707         string const message = file_exists ?
708                 string() : string("bb = 0 0 200 100, draft, type=eps");
709         // if !message.empty() then there was no existing file
710         // "filename" found. In this case LaTeX
711         // draws only a rectangle with the above bb and the
712         // not found filename in it.
713         lyxerr[Debug::GRAPHICS]
714                 << "\tMessage = \"" << message << '\"' << endl;
715
716         // These variables collect all the latex code that should be before and
717         // after the actual includegraphics command.
718         string before;
719         string after;
720         // Do we want subcaptions?
721         if (params().subcaption) {
722                 before += "\\subfigure[" + params().subcaptionText + "]{";
723                 after = '}';
724         }
725         // We never use the starred form, we use the "clip" option instead.
726         before += "\\includegraphics";
727
728         // Write the options if there are any.
729         string const opts = createLatexOptions();
730         lyxerr[Debug::GRAPHICS] << "\tOpts = " << opts << endl;
731
732         if (!opts.empty() && !message.empty())
733                 before += ('[' + opts + ',' + message + ']');
734         else if (!opts.empty() || !message.empty())
735                 before += ('[' + opts + message + ']');
736
737         lyxerr[Debug::GRAPHICS]
738                 << "\tBefore = " << before
739                 << "\n\tafter = " << after << endl;
740
741
742         string latex_str = before + '{';
743         // Convert the file if necessary.
744         // Remove the extension so LaTeX will use whatever is appropriate
745         // (when there are several versions in different formats)
746         latex_str += prepareFile(buf, runparams);
747         latex_str += '}' + after;
748         os << latex_str;
749
750         lyxerr[Debug::GRAPHICS] << "InsetGraphics::latex outputting:\n"
751                                 << latex_str << endl;
752         // Return how many newlines we issued.
753         return int(lyx::count(latex_str.begin(), latex_str.end(),'\n'));
754 }
755
756
757 int InsetGraphics::plaintext(Buffer const &, ostream & os,
758                          OutputParams const &) const
759 {
760         // No graphics in ascii output. Possible to use gifscii to convert
761         // images to ascii approximation.
762         // 1. Convert file to ascii using gifscii
763         // 2. Read ascii output file and add it to the output stream.
764         // at least we send the filename
765         os << '<' << bformat(_("Graphics file: %1$s"),
766                              params().filename.absFilename()) << ">\n";
767         return 0;
768 }
769
770
771 int InsetGraphics::linuxdoc(Buffer const & buf, ostream & os,
772                             OutputParams const & runparams) const
773 {
774         string const file_name = runparams.nice ?
775                                 params().filename.relFilename(buf.filePath()):
776                                 params().filename.absFilename();
777
778         runparams.exportdata->addExternalFile("linuxdoc",
779                                               params().filename.absFilename());
780         os << "<eps file=\"" << file_name << "\">\n";
781         os << "<img src=\"" << file_name << "\">";
782         return 0;
783 }
784
785
786 namespace {
787
788 int writeImageObject(char * format, ostream& os, OutputParams const & runparams,
789                                          string const graphic_label, string const attributes)
790 {
791                 if (runparams.flavor != OutputParams::XML) {
792                         os << "<![ %output.print." << format << "; [" << std::endl;
793                 }
794                 os <<"<imageobject><imagedata fileref=\"&"
795                    << graphic_label << ";." << format << "\" " << attributes ;
796                 if (runparams.flavor == OutputParams::XML) {
797                         os <<  " role=\"" << format << "\"/>" ;
798                 }
799                 else {
800                         os << " format=\"" << format << "\">" ;
801                 }
802                 os << "</imageobject>";
803                 if (runparams.flavor != OutputParams::XML) {
804                         os << std::endl << "]]>" ;
805                 }
806                 return runparams.flavor == OutputParams::XML ? 0 : 2;
807 }
808 // end anonymous namespace
809 }
810
811
812 // For explanation on inserting graphics into DocBook checkout:
813 // http://en.tldp.org/LDP/LDP-Author-Guide/html/inserting-pictures.html
814 // See also the docbook guide at http://www.docbook.org/
815 int InsetGraphics::docbook(Buffer const &, ostream & os,
816                            OutputParams const & runparams) const
817 {
818         // In DocBook v5.0, the graphic tag will be eliminated from DocBook, will
819         // need to switch to MediaObject. However, for now this is sufficient and
820         // easier to use.
821         if (runparams.flavor == OutputParams::XML) {
822                 runparams.exportdata->addExternalFile("docbook-xml",
823                                                       params().filename.absFilename());
824         } else {
825                 runparams.exportdata->addExternalFile("docbook",
826                                                       params().filename.absFilename());
827         }
828         os << "<inlinemediaobject>";
829
830         int r = 0;
831         string attributes = createDocBookAttributes();
832         r += writeImageObject("png", os, runparams, graphic_label, attributes);
833         r += writeImageObject("pdf", os, runparams, graphic_label, attributes);
834         r += writeImageObject("eps", os, runparams, graphic_label, attributes);
835         r += writeImageObject("bmp", os, runparams, graphic_label, attributes);
836
837         os << "</inlinemediaobject>";
838         return r;
839 }
840
841
842 void InsetGraphics::validate(LaTeXFeatures & features) const
843 {
844         // If we have no image, we should not require anything.
845         if (params().filename.empty())
846                 return;
847
848         features.includeFile(graphic_label,
849                              RemoveExtension(params().filename.absFilename()));
850
851         features.require("graphicx");
852
853         if (features.nice()) {
854                 Buffer const * m_buffer = features.buffer().getMasterBuffer();
855                 string basename =
856                         params().filename.outputFilename(m_buffer->filePath());
857                 basename = RemoveExtension(basename);
858                 if(params().filename.isZipped())
859                         basename = RemoveExtension(basename);
860                 if (contains(basename, "."))
861                         features.require("lyxdot");
862         }
863
864         if (params().subcaption)
865                 features.require("subfigure");
866 }
867
868
869 bool InsetGraphics::setParams(InsetGraphicsParams const & p)
870 {
871         // If nothing is changed, just return and say so.
872         if (params() == p && !p.filename.empty())
873                 return false;
874
875         // Copy the new parameters.
876         params_ = p;
877
878         // Update the display using the new parameters.
879         graphic_->update(params().as_grfxParams());
880
881         // We have changed data, report it.
882         return true;
883 }
884
885
886 InsetGraphicsParams const & InsetGraphics::params() const
887 {
888         return params_;
889 }
890
891
892 void InsetGraphics::editGraphics(InsetGraphicsParams const & p,
893                                  Buffer const & buffer) const
894 {
895         string const file_with_path = p.filename.absFilename();
896         formats.edit(buffer, file_with_path,
897                      formats.getFormatFromFile(file_with_path));
898 }
899
900
901 string const InsetGraphicsMailer::name_("graphics");
902
903 InsetGraphicsMailer::InsetGraphicsMailer(InsetGraphics & inset)
904         : inset_(inset)
905 {}
906
907
908 string const InsetGraphicsMailer::inset2string(Buffer const & buffer) const
909 {
910         return params2string(inset_.params(), buffer);
911 }
912
913
914 void InsetGraphicsMailer::string2params(string const & in,
915                                         Buffer const & buffer,
916                                         InsetGraphicsParams & params)
917 {
918         params = InsetGraphicsParams();
919         if (in.empty())
920                 return;
921
922         istringstream data(in);
923         LyXLex lex(0,0);
924         lex.setStream(data);
925
926         string name;
927         lex >> name;
928         if (!lex || name != name_)
929                 return print_mailer_error("InsetGraphicsMailer", in, 1, name_);
930
931         InsetGraphics inset;
932         inset.readInsetGraphics(lex, buffer.filePath());
933         params = inset.params();
934 }
935
936
937 string const
938 InsetGraphicsMailer::params2string(InsetGraphicsParams const & params,
939                                    Buffer const & buffer)
940 {
941         ostringstream data;
942         data << name_ << ' ';
943         params.Write(data, buffer.filePath());
944         data << "\\end_inset\n";
945         return data.str();
946 }