Download Skribilo User Manual

3.12. Images
39
(image :file "bsd.png" "A second image")
(image :width 50 :file "bsd.png")
(image :width 200 :height 40 :file "bsd.png")
… produces:
Files passed as a :file argument to image are searched in the current image path,
which is defined by the *image-path* SRFI-39 parameter. This parameter contains a list
of directories and its value can be obtained using (*image-path*). Its value can be altered
using the -P command-line option of the skribilo compiler (see Chapter 14 for details).
3.12.1. Image formats
Images are unfortunately unportable. The various Skribe output formats support different
image formats. For instance, HTML supports gif and jpeg while the LaTeX back-end only
supports ps. Skribe tries, only when needed, to automatically convert images to a format
supported by the target to be produced. For this, it uses external tools. The default Skribe
translation scheme is:
•
Do not translate an image that needs no conversion.
•
Uses the fig2dev external tool to translate Xfig images.
•
Uses the convert external tools to translate all other formats.
Engines support different image formats. Each engine may specify a converter to be
applied to an image. The engine custom image-format specifies the list of supported image
formats. This list is composed of a suffix such as jpeg or gif.
The function convert-image tries to convert an image according to a list of formats.
All the specified formats are successively tried. On the first success, the function convertimage returns the name of the new converted image. On failure, it returns #f.