I did some tests to find out why we would need the .eps files,
and my conclusion is that they are useless, unless I've missed
something important.
I found out that the only image format that doxygen doesn't display
in the latex/pdf version is .gif. This is probably the reason why
the .eps files were generated in the first place. I remember that
Fabien wrote that he used gray-scale images to save space.
I propose to replace all .gif (and maybe also .jpg) files in our
docs with converted .png files. These can be used in both (html
and pdf) versions.
In my tests the resulting .pdf file is even *smaller* than the
current version with .eps files, although the .eps files are
black/white (gray-scale) only.
To help testing you can do this (you will need ImageMagick's
convert tool to convert the image files or you must convert
them with some other tool yourself (or tweak the Makefile
after patching it):
save the attached file doc_to_png.diff
cd documentation
make clean pdf
mv latex/refman.pdf ./refman_old.pdf
patch -p0 < doc_to_png.diff
make clean pdf
mv latex/refman.pdf ./refman_new.pdf
ls -l *.pdf
Then, compare the sizes of the generated documents and open them
with your PDF viewer. Check if there are any drawbacks.
Try also to create the html docs and test...
Note that the patch is not intended to be committed directly, it's
just to help convert the image files and test the results. If all
is well, we can check in the .png files and remove the .gif and .eps
files from the distribution.
Advantages:
- only one image file for all
- color images in .pdf docs instead of gray-scale images
- removal of huge .eps files
- no file conversion needed to create the docs
File sizes:
*.eps: ~ 12 MB
*.gif + *.jpg: ~ 380 KB
*.png: ~ 485 KB
Maybe we can compress the .png files better; I used 'convert' w/o
any options to convert them. Suggestions ?
If there are no objections, I'll go ahead and do the necessary
updates. Please send your comments...
Albrecht
Index: src/editor.dox
===================================================================
--- src/editor.dox (Revision 7968)
+++ src/editor.dox (Arbeitskopie)
@@ -143,8 +143,8 @@
the "replace next " button is a
Fl_Return_Button widget:
-\image html editor-replace.gif "Figure 4-1: The search and replace dialog"
-\image latex editor-replace.eps "The search and replace dialog" width=10cm
+\image html editor-replace.png "Figure 4-1: The search and replace dialog"
+\image latex editor-replace.png "The search and replace dialog" width=10cm
\code
Fl_Window *replace_dlg = new Fl_Window(300, 105, "Replace");
@@ -606,8 +606,8 @@
The final editor window should look like the image in Figure 4-2.
-\image html editor.gif "Figure 4-2: The completed editor window"
-\image latex editor.eps "The completed editor window" width=12cm
+\image html editor.png "Figure 4-2: The completed editor window"
+\image latex editor.png "The completed editor window" width=12cm
\section editor_advanced_features Advanced Features
Index: src/common.dox
===================================================================
--- src/common.dox (Revision 7968)
+++ src/common.dox (Arbeitskopie)
@@ -23,8 +23,8 @@
\li Fl_Round_Button - A button with a radio circle.
-\image html buttons.gif "Figure 3-1: FLTK Button Widgets"
-\image latex buttons.eps "FLTK Button Widgets" width=10cm
+\image html buttons.png "Figure 3-1: FLTK Button Widgets"
+\image latex buttons.png "FLTK Button Widgets" width=10cm
All of these buttons just need the corresponding
<tt><FL/Fl_xyz_Button.H></tt> header file. The constructor
@@ -110,8 +110,8 @@
\li Fl_Value_Slider - A slider that shows the current value.
-\image html valuators.gif "Figure 3-2: FLTK valuator widgets"
-\image latex valuators.eps "FLTK valuator widgets" width=10cm
+\image html valuators.png "Figure 3-2: FLTK valuator widgets"
+\image latex valuators.png "FLTK valuator widgets" width=10cm
The \p value() method gets and sets the current value
of the widget. The \p minimum() and \p maximum()
@@ -251,8 +251,8 @@
Figure 3-3 shows the standard box types included with FLTK.
-\image html boxtypes.gif "Figure 3-3: FLTK box types"
-\image latex boxtypes.eps "FLTK box types" width=12cm
+\image html boxtypes.png "Figure 3-3: FLTK box types"
+\image latex boxtypes.png "FLTK box types" width=12cm
\p FL_NO_BOX means nothing is drawn at all, so whatever is
already on the screen remains. The <tt>FL_..._FRAME</tt> types only
@@ -360,8 +360,8 @@
escaping them using the "@" symbol - "@@" displays a single at
sign. Figure 3-4 shows the available symbols.
-\image html symbols.gif "Figure 3-4: FLTK label symbols"
-\image latex symbols.eps "FLTK label symbols" width=10cm
+\image html symbols.png "Figure 3-4: FLTK label symbols"
+\image latex symbols.png "FLTK label symbols" width=10cm
<!-- NEED 2in -->
Index: src/basics.dox
===================================================================
--- src/basics.dox (Revision 7968)
+++ src/basics.dox (Arbeitskopie)
@@ -73,8 +73,8 @@
You can quit the program by closing the window or pressing the
<tt>ESC</tt>ape key.
-\image html hello.C.gif "Figure 2-1: The Hello, World! Window"
-\image latex hello.C.eps "The Hello, World! Window" width=8cm
+\image html hello.C.png "Figure 2-1: The Hello, World! Window"
+\image latex hello.C.png "The Hello, World! Window" width=8cm
\subsection basics_creating Creating the Widgets
Index: src/index.dox
===================================================================
--- src/index.dox (Revision 7968)
+++ src/index.dox (Arbeitskopie)
@@ -4,8 +4,8 @@
<TABLE BGCOLOR="#9f9f9f" CELLPADDING="8" CELLSPACING="0" SUMMARY="TITLE BAR"
WIDTH="100%" BORDER="0">
<TR>
<TD><CENTER>
- \image html FL200.gif
- \image latex FL200.eps "" width=5cm
+ \image html FL200.png
+ \image latex FL200.png "" width=5cm
</CENTER></TD>
<TD><CENTER>
<B>FLTK 1.3.0 Programming Manual</B>
Index: src/html_footer
===================================================================
--- src/html_footer (Revision 7968)
+++ src/html_footer (Arbeitskopie)
@@ -1,7 +1,7 @@
<hr>
<address><small>
<!-- $datetime. -->
-<a href="http://www.fltk.org";><img src="tiny.gif" align="bottom"
alt="FLTK"></a>
+<a href="http://www.fltk.org";><img src="tiny.png" align="bottom"
alt="FLTK"></a>
© 1998-2010 by Bill Spitzak and others.
Permission is granted to reproduce this manual or any portion for
any purpose, provided this copyright and permission notice are preserved.
Index: src/fluid.dox
===================================================================
--- src/fluid.dox (Revision 7968)
+++ src/fluid.dox (Arbeitskopie)
@@ -46,8 +46,8 @@
\p \#include
the <tt>.cxx</tt> file so it still appears to be a single source file.
- \image html fluid-org.gif "Figure 9-1: FLUID organization"
- \image latex fluid-org.eps "FLUID organization" width=12cm
+ \image html fluid-org.png "Figure 9-1: FLUID organization"
+ \image latex fluid-org.png "FLUID organization" width=12cm
Normally the FLUID file defines one or more functions or classes which
output C++ code. Each function defines a one or more FLTK
@@ -154,8 +154,8 @@
show you how to generate a complete user interface class with
FLUID that is used for the CubeView program provided with FLTK.
-\image html cubeview.gif "Figure 9-2: CubeView demo"
-\image latex cubeview.eps "CubeView demo" width=10cm
+\image html cubeview.png "Figure 9-2: CubeView demo"
+\image latex cubeview.png "CubeView demo" width=10cm
The window is of class CubeViewUI, and is completely generated by FLUID,
including
@@ -383,8 +383,8 @@
window. You should see the new class declaration in the FLUID
browser window.
-\image html fluid1.gif "Figure 9-3: FLUID file for CubeView"
-\image latex fluid1.eps "FLUID file for CubeView" width=10cm
+\image html fluid1.png "Figure 9-3: FLUID file for CubeView"
+\image latex fluid1.png "FLUID file for CubeView" width=10cm
\par Adding the Class Constructor
@@ -411,8 +411,8 @@
When you are finished you should have something like this:
-\image html fluid2.gif "Figure 9-4: FLUID window containing CubeView demo"
-\image latex fluid2.eps "FLUID window containing CubeView demo" width=10cm
+\image html fluid2.png "Figure 9-4: FLUID window containing CubeView demo"
+\image latex fluid2.png "FLUID window containing CubeView demo" width=10cm
We will talk about the \p show() method that is highlighted
shortly.
@@ -439,8 +439,8 @@
CubeView as a member of CubeViewUI, so any public CubeView methods are
now available to CubeViewUI.
-\image html fluid3-cxx.gif "Figure 9-5: CubeView methods"
-\image latex fluid3-cxx.eps "CubeView methods" width=10cm
+\image html fluid3-cxx.png "Figure 9-5: CubeView methods"
+\image latex fluid3-cxx.png "CubeView methods" width=10cm
\par Defining the Callbacks
@@ -476,8 +476,8 @@
not be adding any widgets to this method FLUID will assign it a return
type of \p void.
-\image html fluid4.gif "Figure 9-6: CubeView constructor"
-\image latex fluid4.eps "CubeView constructor" width=10cm
+\image html fluid4.png "Figure 9-6: CubeView constructor"
+\image latex fluid4.png "CubeView constructor" width=10cm
Once the new method has been added, highlight its name and select
<b>New->Code->Code.</b> Enter the method's code in the code window.
@@ -739,8 +739,8 @@
The \ref fluid_i18n "internationalization" options are described
later in this chapter.
-\image html fluid_prefs.gif "Figure 9-7: FLUID Preferences Window"
-\image latex fluid_prefs.eps "FLUID Preferences Window" width=10cm
+\image html fluid_prefs.png "Figure 9-7: FLUID Preferences Window"
+\image latex fluid_prefs.png "FLUID Preferences Window" width=10cm
\par Edit/GUI Settings... (Shift+Ctrl+p)
@@ -889,8 +889,8 @@
<!-- NEW PAGE -->
-\image html fluid_widget_gui.gif "Figure 9-8: The FLUID widget GUI attributes"
-\image latex fluid_widget_gui.eps "The FLUID widget GUI attributes" width=10cm
+\image html fluid_widget_gui.png "Figure 9-8: The FLUID widget GUI attributes"
+\image latex fluid_widget_gui.png "The FLUID widget GUI attributes" width=10cm
\section fluid_widget_attributes GUI Attributes
@@ -1002,8 +1002,8 @@
On most (all?) window managers you will have to close the window
and reopen it to see the effect.
-\image html fluid_widget_style.gif "Figure 9-9: The FLUID widget Style
attributes"
-\image latex fluid_widget_style.eps "The FLUID widget Style attributes"
width=10cm
+\image html fluid_widget_style.png "Figure 9-9: The FLUID widget Style
attributes"
+\image latex fluid_widget_style.png "The FLUID widget Style attributes"
width=10cm
\subsection fluid_style_attributes Style Attributes
@@ -1073,8 +1073,8 @@
Some widgets display text, such as input fields, pull-down
menus, and browsers.
-\image html fluid_widget_cxx.gif "Figure 9-10: The FLUID widget C++ attributes"
-\image latex fluid_widget_cxx.eps "The FLUID widget C++ attributes" width=10cm
+\image html fluid_widget_cxx.png "Figure 9-10: The FLUID widget C++ attributes"
+\image latex fluid_widget_cxx.png "The FLUID widget C++ attributes" width=10cm
\subsection fluid_cpp_attributes C++ Attributes
@@ -1428,8 +1428,8 @@
function/macro name to use when retrieving the localized label
strings.
- \image html fluid-gettext.gif "Figure 9-11: Internationalization using GNU
gettext"
- \image latex fluid-gettext.eps "Internationalization using GNU gettext"
width=10cm
+ \image html fluid-gettext.png "Figure 9-11: Internationalization using GNU
gettext"
+ \image latex fluid-gettext.png "Internationalization using GNU gettext"
width=10cm
The \b \#include
field controls the header file to include for
@@ -1453,8 +1453,8 @@
catalog file, and set number for retrieving the localized label
strings.
- \image html fluid-catgets.gif "Figure 9-12: Internationalization using POSIX
catgets"
- \image latex fluid-catgets.eps "Internationalization using POSIX catgets"
width=10cm
+ \image html fluid-catgets.png "Figure 9-12: Internationalization using POSIX
catgets"
+ \image latex fluid-catgets.png "Internationalization using POSIX catgets"
width=10cm
The \b \#include
field controls the header file to include for
Index: src/development.dox
===================================================================
--- src/development.dox (Revision 7968)
+++ src/development.dox (Arbeitskopie)
@@ -28,11 +28,11 @@
The time shown on the clock is not updated. To display the current time,
use Fl_Clock instead.
- \image html clock.gif
- \image latex clock.eps "" width=10cm
- \image html round_clock.gif
- \image latex clock.eps "" width=10cm
- \image html round_clock.eps "" width=10cm #/
+ \image html clock.png
+ \image latex clock.png "" width=10cm
+ \image html round_clock.png
+ \image latex clock.png "" width=10cm
+ \image html round_clock.png "" width=10cm #/
/##
Returns the displayed time.
@@ -344,16 +344,16 @@
Use a single line ending with \<br\> for complicated paragraph titles.
-\section development_html_footer Hack for missing "tiny.gif" file
+\section development_html_footer Hack for missing "tiny.png" file
\todo
*HACK* : include image file for footer. Doxygen does not include
- the file "tiny.gif" from "html_footer" in its output html dir.
+ the file "tiny.png" from "html_footer" in its output html dir.
Find out, how this can be done, or avoid using an image in
the HTML footer.
- \image html tiny.gif
- \image latex tiny.eps "" width=2cm
+ \image html tiny.png
+ \image latex tiny.png "" width=2cm
\section development_navigation_test Navigation Elements
Index: Makefile
===================================================================
--- Makefile (Revision 7968)
+++ Makefile (Arbeitskopie)
@@ -29,7 +29,7 @@
include ../makeinclude
# The following appends to the existing .SUFFIXES
-.SUFFIXES: .gif .jpg .png .eps
+.SUFFIXES: .gif .jpg .png
SRC_DOCDIR = ./src
@@ -126,73 +126,72 @@
$(SRC_DOCDIR)/valuators.gif \
$(SRC_DOCDIR)/value_slider.gif
-EPSFILES = \
- $(SRC_DOCDIR)/FL200.eps\
- $(SRC_DOCDIR)/Fl_Check_Button.eps \
- $(SRC_DOCDIR)/Fl_File_Chooser.eps \
- $(SRC_DOCDIR)/Fl_File_Input.eps \
- $(SRC_DOCDIR)/Fl_Help_Dialog.eps \
- $(SRC_DOCDIR)/Fl_Light_Button.eps \
- $(SRC_DOCDIR)/Fl_Return_Button.eps \
- $(SRC_DOCDIR)/Fl_Roller.eps \
- $(SRC_DOCDIR)/Fl_Round_Button.eps \
- $(SRC_DOCDIR)/Fl_Scroll.eps \
- $(SRC_DOCDIR)/Fl_Tile.eps \
- $(SRC_DOCDIR)/Fl_Value_Input.eps \
- $(SRC_DOCDIR)/Fl_Value_Output.eps \
- $(SRC_DOCDIR)/adjuster1.eps \
- $(SRC_DOCDIR)/boxtypes.eps \
- $(SRC_DOCDIR)/buttons.eps \
- $(SRC_DOCDIR)/charts.eps \
- $(SRC_DOCDIR)/choice.eps \
- $(SRC_DOCDIR)/clock.eps \
- $(SRC_DOCDIR)/counter.eps \
- $(SRC_DOCDIR)/cubeview.eps \
- $(SRC_DOCDIR)/dial.eps \
- $(SRC_DOCDIR)/editor-replace.eps \
- $(SRC_DOCDIR)/editor.eps \
- $(SRC_DOCDIR)/fl_alert.eps \
- $(SRC_DOCDIR)/fl_ask.eps \
- $(SRC_DOCDIR)/fl_choice.eps \
- $(SRC_DOCDIR)/fl_color_chooser.eps \
- $(SRC_DOCDIR)/fl_input.eps \
- $(SRC_DOCDIR)/fl_message.eps \
- $(SRC_DOCDIR)/fl_password.eps \
- $(SRC_DOCDIR)/fl_show_colormap.eps \
- $(SRC_DOCDIR)/fluid-catgets.eps \
- $(SRC_DOCDIR)/fluid-gettext.eps \
- $(SRC_DOCDIR)/fluid-org.eps \
- $(SRC_DOCDIR)/fluid1.eps \
- $(SRC_DOCDIR)/fluid2.eps \
- $(SRC_DOCDIR)/fluid3-cxx.eps \
- $(SRC_DOCDIR)/fluid3-gui.eps \
- $(SRC_DOCDIR)/fluid3-style.eps \
- $(SRC_DOCDIR)/fluid4.eps \
- $(SRC_DOCDIR)/fluid_prefs.eps \
- $(SRC_DOCDIR)/fluid_widget_cxx.eps \
- $(SRC_DOCDIR)/fluid_widget_gui.eps \
- $(SRC_DOCDIR)/fluid_widget_style.eps \
- $(SRC_DOCDIR)/hello.C.eps \
- $(SRC_DOCDIR)/input_choice.eps \
- $(SRC_DOCDIR)/menu.eps \
- $(SRC_DOCDIR)/menu_button.eps \
- $(SRC_DOCDIR)/menubar.eps \
- $(SRC_DOCDIR)/positioner.eps \
- $(SRC_DOCDIR)/resizebox1.eps \
- $(SRC_DOCDIR)/resizebox2.eps \
- $(SRC_DOCDIR)/round_clock.eps \
- $(SRC_DOCDIR)/scrollbar.eps \
- $(SRC_DOCDIR)/slider.eps \
- $(SRC_DOCDIR)/symbols.eps \
- $(SRC_DOCDIR)/table-as-container.eps \
- $(SRC_DOCDIR)/table-dimensions.eps \
- $(SRC_DOCDIR)/table-simple.eps \
- $(SRC_DOCDIR)/tabs.eps \
- $(SRC_DOCDIR)/text.eps \
- $(SRC_DOCDIR)/tiny.eps \
- $(SRC_DOCDIR)/tree-elements.eps \
- $(SRC_DOCDIR)/valuators.eps \
- $(SRC_DOCDIR)/value_slider.eps
+PNGFILES = \
+ $(SRC_DOCDIR)/FL200.png \
+ $(SRC_DOCDIR)/Fl_Check_Button.png \
+ $(SRC_DOCDIR)/Fl_File_Chooser.png \
+ $(SRC_DOCDIR)/Fl_File_Input.png \
+ $(SRC_DOCDIR)/Fl_Help_Dialog.png \
+ $(SRC_DOCDIR)/Fl_Light_Button.png \
+ $(SRC_DOCDIR)/Fl_Return_Button.png \
+ $(SRC_DOCDIR)/Fl_Roller.png \
+ $(SRC_DOCDIR)/Fl_Round_Button.png \
+ $(SRC_DOCDIR)/Fl_Scroll.png \
+ $(SRC_DOCDIR)/Fl_Tile.png \
+ $(SRC_DOCDIR)/Fl_Value_Input.png \
+ $(SRC_DOCDIR)/Fl_Value_Output.png \
+ $(SRC_DOCDIR)/adjuster1.png \
+ $(SRC_DOCDIR)/boxtypes.png \
+ $(SRC_DOCDIR)/buttons.png \
+ $(SRC_DOCDIR)/charts.png \
+ $(SRC_DOCDIR)/choice.png \
+ $(SRC_DOCDIR)/clock.png \
+ $(SRC_DOCDIR)/counter.png \
+ $(SRC_DOCDIR)/cubeview.png \
+ $(SRC_DOCDIR)/dial.png \
+ $(SRC_DOCDIR)/editor-replace.png \
+ $(SRC_DOCDIR)/editor.png \
+ $(SRC_DOCDIR)/fl_alert.png \
+ $(SRC_DOCDIR)/fl_ask.png \
+ $(SRC_DOCDIR)/fl_choice.png \
+ $(SRC_DOCDIR)/fl_color_chooser.png \
+ $(SRC_DOCDIR)/fl_input.png \
+ $(SRC_DOCDIR)/fl_message.png \
+ $(SRC_DOCDIR)/fl_password.png \
+ $(SRC_DOCDIR)/fl_show_colormap.png \
+ $(SRC_DOCDIR)/fluid-catgets.png \
+ $(SRC_DOCDIR)/fluid-gettext.png \
+ $(SRC_DOCDIR)/fluid-org.png \
+ $(SRC_DOCDIR)/fluid1.png \
+ $(SRC_DOCDIR)/fluid2.png \
+ $(SRC_DOCDIR)/fluid3-cxx.png \
+ $(SRC_DOCDIR)/fluid3-gui.png \
+ $(SRC_DOCDIR)/fluid3-style.png \
+ $(SRC_DOCDIR)/fluid4.png \
+ $(SRC_DOCDIR)/fluid_prefs.png \
+ $(SRC_DOCDIR)/fluid_widget_cxx.png \
+ $(SRC_DOCDIR)/fluid_widget_gui.png \
+ $(SRC_DOCDIR)/fluid_widget_style.png \
+ $(SRC_DOCDIR)/hello.C.png \
+ $(SRC_DOCDIR)/input_choice.png \
+ $(SRC_DOCDIR)/menu.png \
+ $(SRC_DOCDIR)/menu_button.png \
+ $(SRC_DOCDIR)/menubar.png \
+ $(SRC_DOCDIR)/positioner.png \
+ $(SRC_DOCDIR)/resizebox1.png \
+ $(SRC_DOCDIR)/resizebox2.png \
+ $(SRC_DOCDIR)/round_clock.png \
+ $(SRC_DOCDIR)/scrollbar.png \
+ $(SRC_DOCDIR)/slider.png \
+ $(SRC_DOCDIR)/symbols.png \
+ $(SRC_DOCDIR)/table-as-container.png \
+ $(SRC_DOCDIR)/table-dimensions.png \
+ $(SRC_DOCDIR)/table-simple.png \
+ $(SRC_DOCDIR)/tabs.png \
+ $(SRC_DOCDIR)/text.png \
+ $(SRC_DOCDIR)/tiny.png \
+ $(SRC_DOCDIR)/valuators.png \
+ $(SRC_DOCDIR)/value_slider.png
MANPAGES = $(SRC_DOCDIR)/fltk.$(CAT3EXT)
$(SRC_DOCDIR)/fltk-config.$(CAT1EXT) \
$(SRC_DOCDIR)/fluid.$(CAT1EXT) $(SRC_DOCDIR)/blocks.$(CAT6EXT) \
@@ -260,19 +259,12 @@
$(RM) $(DESTDIR)$(mandir)/man6/checkers.6
$(RM) $(DESTDIR)$(mandir)/man6/sudoku.6
-# Image -> eps conversions
-.gif.eps:
- echo Creating eps for $<...
- convert $< $@
+# Image -> png conversions
-.jpg.eps:
- echo Creating eps for $<...
+.gif.png .jpg.png:
+ echo Creating png for $<...
convert $< $@
-.png.eps:
- echo Creating eps for $<...
- convert $< $@
-
# The HTML files are now generated using doxygen, and this needs
# an installed doxygen version and may take some time, so this target
# is not made by default.
@@ -297,7 +289,7 @@
pdf: latex/refman.pdf
-latex/refman.pdf: latex/refman.tex Doxybook $(EPSFILES)
+latex/refman.pdf: latex/refman.tex Doxybook $(PNGFILES)
echo "Generating PDF documentation ..."
$(DOXYDOC) Doxybook ;\
(cd latex ;\
@@ -314,7 +306,7 @@
done ; \
cd ..) > pdfall.log
-latex/refman.tex: Doxybook $(EPSFILES)
+latex/refman.tex: Doxybook $(PNGFILES)
#
# End of "$Id$".
_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev
