Debian Codegraph @

texmf-dist/doc/lualatex/luaimageembed/README.md

raw
1 # luaimageembed
2
3 LuaTeX package to embed images directly as base64-encoded strings into the document. This can be useful, e.g. to package a document with images into a single TeX file, or with automatically generated graphics.
4
5 The image files will be decoded, written to a temporary directory, and cleaned up afterwards.
6
7 Use at your own risk.
8
9 ## Commands
10
11 Three commands are wrapped to allow for use with base64-encoded images:
12
13 - `\includegraphicsembedded` (`\includegraphics`)
14 - `\pgfdeclareimageembedded` (`\pgfdeclareimage`)
15 - `\pgfimageembedded` (`\pgfimage`)
16
17 Each takes the base64-encoded image data instead of the filename; see the example below. Supported are `png`, `jpg`, `jb2` and `pdf` images.
18
19 ## Example
20
21 ```latex
22 \documentclass{scrartcl}
23
24 \usepackage{luaimageembed}
25 \usepackage{graphicx}
26
27 \begin{document}
28 \includegraphicsembedded[width=4cm]{%
29 iVBORw0KGgoAAAANSUhEUgAAAAMAAAADCAAAAABzQ+pjAAAAFElEQVQI12P4z/Cf4f9/BgYGBgYA
30 IOsD/UqPmwUAAAAASUVORK5CYII=
31 }
32 \end{document}
33 ```
34
35 ## Version
36
37 0.1 (alpha)
38
39 ## License
40
41 MIT