Debian Codegraph @

texmf-dist/doc/luatex/minim-mp/README

raw
1 Version: 2025/1.7
2
3 SUMMARY
4
5 This package offers low-level mplib integration for both plain LuaTeX and
6 LuaLaTeX. It is designed with the purpose of being easy to extend.
7
8 The use of multiple simultaneous MetaPost instances is supported, as well as
9 running TeX or lua code from within MetaPost. With the included minim-mp
10 format file, you can even use LuaTeX as a stand-alone MetaPost compiler.
11
12
13 DOCUMENTATION
14
15 In order to obtain the typeset manual of this package, simply say:
16
17 luatex minim-mp.doc
18
19
20 INSTALLATION
21
22 In order to use minim-mp as a stand-alone metapost compiler, you will have to
23 generate the appropriate format files. For metapost with plain tex, say
24
25 luatex --ini minim-mp.ini
26
27 For metapost with latex, say
28
29 luatex --ini minim-lamp.ini
30
31 The resulting format (.fmt) files will be found if they are either in the same
32 directory as your metapost source file, or in ${TEXMFHOME}/web2c/luatex (the
33 latter is of course recommended).
34
35 Useful shell aliases are
36
37 alias mpost='luatex --fmt=minim-mp'
38 alias lampost='luatex --fmt=minim-lamp'
39
40
41 HISTORY
42
43 2025/1.7 (12/2/2025)
44
45 This version contains a re-organised and improved manual.
46
47 2024/1.6 (25/3/2024)
48
49 New features:
50
51 * Add per-instance \everymp token lists.
52 * Provide \mpdim to the latex package.
53 * Also accept (postscript) font names instead of ids as arguments to the
54 infont and glyph of operators.
55 * Reduce the number of metapost error messages echoed to the terminal.
56 * Add the missing tex.skip macro (read-only).
57 * Provide more information in debugging mode; standardise its lay-out and
58 only write debugging info to the log, not to the terminal.
59
60 Bug fixes:
61
62 * Re-work the scanning of metapost code: preserve not only %s but also
63 newlines; neutralise all other special characters. Only spaces and
64 csnames are pre-treated on the tex side.
65 * This means comments are now passed to metapost and handled there.
66 * Apply the same metapost code scanning method to both plain macros and
67 latex environments.
68 * Remove the grouping around metapost code execution in the latex
69 environments.
70
71 2024/1.5 (25/2/2024)
72
73 New features:
74
75 * Add a luamplib compatibility mode to the latex package.
76 * Make default format and math mode configurable.
77
78 Bug fixes:
79
80 * Make metafun not crash immediately.
81
82 2024/1.4 (5/1/2024)
83
84 * Support the extended graphics state (extgstate).
85 * Allow box resource (xform) creation directly from metapost.
86 * Support transparency and transparency groups.
87
88 2023/1.3 (20/10/2023)
89
90 * Various runscript improvements:
91 - Supplement runscript environment with runscript-specific functions.
92 - Provide an escape hatch for passing raw strings to lua.
93 - Add helper macros and functions for safely passing values between
94 metapost and lua.
95 * File i/o from metapost code is now included in the --recorder output.
96 * Improve font handling in minim-lamp.ini, and provide \begin{document}.
97 * Add a minim-mp.sty package file for LaTeX users.
98
99 2023/1.2 (3/3/2023)
100
101 * Add a few more metapost macros.
102 * Various small bug fixes.
103
104 2022/1.1 (3/3/2022)
105
106 New features:
107
108 * Made instance initialisation more flexible; this replaces M.init_files
109 with M.init_code (see manual).
110 * Add support for the glyph of operator.
111 * Add support for the even-odd rule of filling and noncontinuous paths.
112 * Add experimental latex support (the minim-lamp format).
113 * Make minim-mp compatible with tikz/pgf.
114 * Expand the plain macro set slightly.
115
116 Minor changes:
117
118 * Improved display of metapost logs.
119 * Redefine units to fit other numerical engines better.
120 * Fixed a bug in pattern generation that prevented simplifying patterns
121 into raw pdf code.
122 * No longer write out superfluous line widths.
123
124 2021/1.0 (1/6/2021)
125
126 This was the original release.
127
128
129 COPYING
130
131 (c) 2022 Esger Renkema, Michal Vlasák
132
133 These files may be distributed under the terms of the European Union Public
134 Licence (EUPL) version 1.2 or later. A copy can be obtained at:
135
136 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12
137