| 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 |
|