GNOME Bugzilla – Bug 384898
Dot output (LaTeX) doesn't match DOT_IMAGE_FORMAT
Last modified: 2018-07-30 10:56:59 UTC
I attempt to generate both HTML and LaTeX documentation from Doxygen. In the Doxyfile, DOT_IMAGE_FORMAT = png. In the html output directory, for graphics generated by dot I see a pattern of files: _r_buffer_8cpp_incl.map _r_buffer_8cpp_incl.md5 _r_buffer_8cpp_incl.png BUT, in the latex output directory, the pattern is different: _r_buffer_8cpp_incl.dot _r_buffer_8cpp_incl.eps _r_buffer_8cpp_incl.md5 I use pdflatex and have my system configured to process graphics as png. How can I produce png graphics in the LaTeX case as well as the HTML case??
eps files are vector graphics, thus of much better quality and smaller in size when it comes to printed documentation. Since I did not see any reason to prefer bitmaps I made doxygen's Latex output use eps whenever possible. So please explain why you want this?
pdflatex can't really handle .eps files by itself. The graphic extensions it naturally handles are .png, .jpg or .pdf. So there is just a white space instead of the picture in the final .pdf file. An other problem I have come across with the images is the following. It may, or it may not be connected to the .eps format. I get several (basically one for every image) "Dimension too large" errors (MikTeX 2.6) from lines like the following one (that doxygen creates): \includegraphics[width=-1073741467pt]{dd/d57/a00701}
While it may be true that the quality of the graphics is higher when using eps graphics, the problem is that on Mac OS X, the standard mechanism for processing LaTeX is via TeXShop, which used pdflatex at its back-end. The implementation neither handles eps files nor translates them to the png format it prefers. I suspect that many (if not most) TeXShop users have PNG set as their default graphics format. The consequence is that, although Doxygen has a GUI front end on Mac OS X, and although the front end supports LaTeX output, in fact, the output produced by the program does not work with the standard LaTeX processing tools as available from TeXLive. ALSO, the DOT_IMAGE_FORMAT variable is ignored when producing LaTeX output, which is (at least) unclear from the documentation. I understand your desire to favor EPS graphics for LaTeX output and PNG graphics for HTML output. May I suggest that adding a new variable (called something like DOT_IMAGE_FORMAT_FOR_LATEX) might enable you to easily "do the right thing" for everyone. You could choose for this variable to default to EPS, but let folks like us who need or want PNG output set the value manually (and independently of the HTML setting).
I use Windows and TeXnicCenter. The problem is the same as with TeXShop. I think a new variable, as suggested above, would be a good compromise.
I use doxygen 1.6.1, MikTex 2.8, dot 2.26.0 under Windows Vist SP2. The option DOT_IMAGE_FORMAT is ignored when generating html documentation. The generated form_*.png files are always in .gif format, as IrfanView tells me. Internet Explorer 8 gets confused by the wrong file name extension and doesn't show these files. Firefox 3.5.5 can handle this and shows the formulas correct.
Comment #3: when you set USE_PDFLATEX to YES in the config file, then doxygen will use pdflatex instead of latex and also convert the eps files to pdf's so they can be included. I use this on my Mac and on Windows without problems. Comment #5: this is a different issue. Doxygen 1.6.1 indeed generated gifs still with .png extension which caused problems under windows. The next release will produce PNGs again.
As discussed in https://github.com/doxygen/doxygen/pull/734 , Doxygen has moved its issue tracking to https://github.com/doxygen/doxygen/issues All Doxygen tickets in GNOME Bugzilla have been migrated to Github. You can subscribe and participate in the new ticket in Github. You can find the corresponding Github ticket by searching for its Bugzilla ID (number) in Github. Hence I am closing this GNOME Bugzilla ticket. Please use the corresponding ticket in Github instead. Thanks a lot!