From 822d6299d6c28fe3780ff40831ec5c00c60133f5 Mon Sep 17 00:00:00 2001 From: Hans Hagen Date: Sat, 1 Jun 2019 22:12:48 +0200 Subject: 2019-06-01 19:20:00 --- .../documents/general/manuals/workflows-mkiv.pdf | Bin 121251 -> 82860 bytes doc/context/documents/general/manuals/xml-mkiv.pdf | Bin 1008282 -> 899449 bytes doc/context/documents/general/qrcs/setup-cs.pdf | Bin 858594 -> 858533 bytes doc/context/documents/general/qrcs/setup-de.pdf | Bin 858447 -> 858499 bytes doc/context/documents/general/qrcs/setup-en.pdf | Bin 865449 -> 865472 bytes doc/context/documents/general/qrcs/setup-fr.pdf | Bin 857078 -> 857265 bytes doc/context/documents/general/qrcs/setup-it.pdf | Bin 862487 -> 862590 bytes .../documents/general/qrcs/setup-mapping-cs.pdf | Bin 348788 -> 348749 bytes .../documents/general/qrcs/setup-mapping-de.pdf | Bin 433312 -> 433242 bytes .../documents/general/qrcs/setup-mapping-en.pdf | Bin 346043 -> 346069 bytes .../documents/general/qrcs/setup-mapping-fr.pdf | Bin 348964 -> 349143 bytes .../documents/general/qrcs/setup-mapping-it.pdf | Bin 347392 -> 347484 bytes .../documents/general/qrcs/setup-mapping-nl.pdf | Bin 346723 -> 346901 bytes .../documents/general/qrcs/setup-mapping-ro.pdf | Bin 510448 -> 510541 bytes doc/context/documents/general/qrcs/setup-nl.pdf | Bin 852039 -> 852227 bytes doc/context/documents/general/qrcs/setup-ro.pdf | Bin 856073 -> 856176 bytes doc/context/scripts/mkii/texmfstart.html | 2 +- doc/context/scripts/mkii/texmfstart.man | 2 +- doc/context/scripts/mkii/texmfstart.xml | 2 +- doc/context/scripts/mkiv/mtxrun.html | 2 +- doc/context/scripts/mkiv/mtxrun.man | 2 +- doc/context/scripts/mkiv/mtxrun.xml | 2 +- .../manuals/workflows/workflows-graphics.tex | 51 +++++++++++++++++++-- .../general/manuals/workflows/workflows-mkiv.tex | 2 +- 24 files changed, 55 insertions(+), 10 deletions(-) (limited to 'doc') diff --git a/doc/context/documents/general/manuals/workflows-mkiv.pdf b/doc/context/documents/general/manuals/workflows-mkiv.pdf index 1d34669e2..b63ecd054 100644 Binary files a/doc/context/documents/general/manuals/workflows-mkiv.pdf and b/doc/context/documents/general/manuals/workflows-mkiv.pdf differ diff --git a/doc/context/documents/general/manuals/xml-mkiv.pdf b/doc/context/documents/general/manuals/xml-mkiv.pdf index 6508f2ecc..bd538c215 100644 Binary files a/doc/context/documents/general/manuals/xml-mkiv.pdf and b/doc/context/documents/general/manuals/xml-mkiv.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-cs.pdf b/doc/context/documents/general/qrcs/setup-cs.pdf index 7679fdb76..2b1a2622c 100644 Binary files a/doc/context/documents/general/qrcs/setup-cs.pdf and b/doc/context/documents/general/qrcs/setup-cs.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-de.pdf b/doc/context/documents/general/qrcs/setup-de.pdf index 1cd01bed1..357501e49 100644 Binary files a/doc/context/documents/general/qrcs/setup-de.pdf and b/doc/context/documents/general/qrcs/setup-de.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-en.pdf b/doc/context/documents/general/qrcs/setup-en.pdf index 479e16737..fd58e5805 100644 Binary files a/doc/context/documents/general/qrcs/setup-en.pdf and b/doc/context/documents/general/qrcs/setup-en.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-fr.pdf b/doc/context/documents/general/qrcs/setup-fr.pdf index 86f70bc73..8dce1fdc1 100644 Binary files a/doc/context/documents/general/qrcs/setup-fr.pdf and b/doc/context/documents/general/qrcs/setup-fr.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-it.pdf b/doc/context/documents/general/qrcs/setup-it.pdf index 7b863fabf..6f10683f4 100644 Binary files a/doc/context/documents/general/qrcs/setup-it.pdf and b/doc/context/documents/general/qrcs/setup-it.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-mapping-cs.pdf b/doc/context/documents/general/qrcs/setup-mapping-cs.pdf index 6c13ca4af..0499538f3 100644 Binary files a/doc/context/documents/general/qrcs/setup-mapping-cs.pdf and b/doc/context/documents/general/qrcs/setup-mapping-cs.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-mapping-de.pdf b/doc/context/documents/general/qrcs/setup-mapping-de.pdf index 1675610f4..63e8b8585 100644 Binary files a/doc/context/documents/general/qrcs/setup-mapping-de.pdf and b/doc/context/documents/general/qrcs/setup-mapping-de.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-mapping-en.pdf b/doc/context/documents/general/qrcs/setup-mapping-en.pdf index 561220390..1f5124d5e 100644 Binary files a/doc/context/documents/general/qrcs/setup-mapping-en.pdf and b/doc/context/documents/general/qrcs/setup-mapping-en.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-mapping-fr.pdf b/doc/context/documents/general/qrcs/setup-mapping-fr.pdf index a99ea5ac6..526271805 100644 Binary files a/doc/context/documents/general/qrcs/setup-mapping-fr.pdf and b/doc/context/documents/general/qrcs/setup-mapping-fr.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-mapping-it.pdf b/doc/context/documents/general/qrcs/setup-mapping-it.pdf index db48c25d7..6663131d2 100644 Binary files a/doc/context/documents/general/qrcs/setup-mapping-it.pdf and b/doc/context/documents/general/qrcs/setup-mapping-it.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-mapping-nl.pdf b/doc/context/documents/general/qrcs/setup-mapping-nl.pdf index 8fed3b6f3..b1b4151cd 100644 Binary files a/doc/context/documents/general/qrcs/setup-mapping-nl.pdf and b/doc/context/documents/general/qrcs/setup-mapping-nl.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-mapping-ro.pdf b/doc/context/documents/general/qrcs/setup-mapping-ro.pdf index 7d213c131..9769c32c6 100644 Binary files a/doc/context/documents/general/qrcs/setup-mapping-ro.pdf and b/doc/context/documents/general/qrcs/setup-mapping-ro.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-nl.pdf b/doc/context/documents/general/qrcs/setup-nl.pdf index d78433474..a6051bbb1 100644 Binary files a/doc/context/documents/general/qrcs/setup-nl.pdf and b/doc/context/documents/general/qrcs/setup-nl.pdf differ diff --git a/doc/context/documents/general/qrcs/setup-ro.pdf b/doc/context/documents/general/qrcs/setup-ro.pdf index 251dbb387..c6c7bee9d 100644 Binary files a/doc/context/documents/general/qrcs/setup-ro.pdf and b/doc/context/documents/general/qrcs/setup-ro.pdf differ diff --git a/doc/context/scripts/mkii/texmfstart.html b/doc/context/scripts/mkii/texmfstart.html index e7656a159..deb6a2cd1 100644 --- a/doc/context/scripts/mkii/texmfstart.html +++ b/doc/context/scripts/mkii/texmfstart.html @@ -40,7 +40,7 @@ flagvaluedescription --scriptrun an mtx script (lua prefered method) (--noquotes), no script gives list - --evaluaterun code passed on the commandline (between quotes) + --evaluaterun code passed on the commandline (between quotes) (=loop) (exit|quit aborts) --executerun a script or program (texmfstart method) (--noquotes) --resolveresolve prefixed arguments --ctxluarun internally (using preloaded libs) diff --git a/doc/context/scripts/mkii/texmfstart.man b/doc/context/scripts/mkii/texmfstart.man index 80aba7580..4bd27c02b 100644 --- a/doc/context/scripts/mkii/texmfstart.man +++ b/doc/context/scripts/mkii/texmfstart.man @@ -15,7 +15,7 @@ run an mtx script (lua prefered method) (--noquotes), no script gives list .TP .B --evaluate -run code passed on the commandline (between quotes) +run code passed on the commandline (between quotes) (=loop) (exit|quit aborts) .TP .B --execute run a script or program (texmfstart method) (--noquotes) diff --git a/doc/context/scripts/mkii/texmfstart.xml b/doc/context/scripts/mkii/texmfstart.xml index 8f501ff66..2b54833d0 100644 --- a/doc/context/scripts/mkii/texmfstart.xml +++ b/doc/context/scripts/mkii/texmfstart.xml @@ -8,7 +8,7 @@ run an mtx script (lua prefered method) (), no script gives list - run code passed on the commandline (between quotes) + run code passed on the commandline (between quotes) (=loop) (exit|quit aborts) run a script or program (texmfstart method) () resolve prefixed arguments run internally (using preloaded libs) diff --git a/doc/context/scripts/mkiv/mtxrun.html b/doc/context/scripts/mkiv/mtxrun.html index f0eef2ae7..01d08f8cd 100644 --- a/doc/context/scripts/mkiv/mtxrun.html +++ b/doc/context/scripts/mkiv/mtxrun.html @@ -40,7 +40,7 @@ flagvaluedescription --scriptrun an mtx script (lua prefered method) (--noquotes), no script gives list - --evaluaterun code passed on the commandline (between quotes) + --evaluaterun code passed on the commandline (between quotes) (=loop) (exit|quit aborts) --executerun a script or program (texmfstart method) (--noquotes) --resolveresolve prefixed arguments --ctxluarun internally (using preloaded libs) diff --git a/doc/context/scripts/mkiv/mtxrun.man b/doc/context/scripts/mkiv/mtxrun.man index 80aba7580..4bd27c02b 100644 --- a/doc/context/scripts/mkiv/mtxrun.man +++ b/doc/context/scripts/mkiv/mtxrun.man @@ -15,7 +15,7 @@ run an mtx script (lua prefered method) (--noquotes), no script gives list .TP .B --evaluate -run code passed on the commandline (between quotes) +run code passed on the commandline (between quotes) (=loop) (exit|quit aborts) .TP .B --execute run a script or program (texmfstart method) (--noquotes) diff --git a/doc/context/scripts/mkiv/mtxrun.xml b/doc/context/scripts/mkiv/mtxrun.xml index 5e2c81c9f..a3fcb0c17 100644 --- a/doc/context/scripts/mkiv/mtxrun.xml +++ b/doc/context/scripts/mkiv/mtxrun.xml @@ -9,7 +9,7 @@ run an mtx script (lua prefered method) (), no script gives list - run code passed on the commandline (between quotes) + run code passed on the commandline (between quotes) (=loop) (exit|quit aborts) run a script or program (texmfstart method) () resolve prefixed arguments run internally (using preloaded libs) diff --git a/doc/context/sources/general/manuals/workflows/workflows-graphics.tex b/doc/context/sources/general/manuals/workflows/workflows-graphics.tex index 55a8ad701..2cff143f4 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-graphics.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-graphics.tex @@ -145,9 +145,54 @@ of special and only makes sense when you use the graphic database options. The and how conversion of images takes place. The \type {graphics.lognames} will make sure that some extra information about -used graphics is saved in the log file, while \type {graphics.usage} will produce -a file \typ {-figures-usage.lua} that contains information about found -(or not found) images and the way they are used. +used graphics is saved in the log file, The \type {graphics.usage} tracker will +produce a file \typ {-figures-usage.lua} that contains information about +found (or not found) images and the way they are used. + +\stopsection + +\startsection[title=Compression] + +A \PNG\ image uses several methods for compression. The image data itself can be +compacted by taking pixels around each individual pixel into account. Storing +deltas instead of absolute values can for instance result in strips of zeros. +These in turn compress well using zlib compression. Each scanline starts with a +filterbyte that indicates how to look at the surrounding pixels. While in \PDF\ a +\JPEG\ image is included as|-|is, a \PNG\ often take a bit more work. A +(optional) mask has to be split off, as does an (optional) index. In the worst +case we need to deinterlace. The \PNG\ inclusion mechanism in \CONTEXT\ \LMTX\ +takes care of this in an as efficient as possible way. Nevertheless there are +some knobs you can turn: + +\starttyping +\enabledirectives[graphics.png.recompress] +\enabledirectives[graphics.png.compresslevel=9] +\stoptyping + +A higher compress level makes the run somewhat smaller but also fives smaller +files. The default compress level is~3. When an image doesn't need to be +transformed (due to mask, index or interlace), you have to force recompression +with the \type {recompress} directive. The sample image \type {mill.png} has a +size of \type {154,869} bytes. + +\starttyping +\startTEXpage + \externalfigure[mill.png] +\stopTEXpage +\stoptyping + +The next table shows the consequences of setting the directives. The runtime is +of course dependent of the machine you run the sample on. If you have lots of +images it might make sense to have a final run with a higher compress level. The +\PDF\ file has some extra overhead (like metadata and page related information). + +\starttabulate[|l|c|c|c|] +\BC \BC compression \BC filesize \BC runtime \NC \NR +\BC default \NC \NC 156,964 \NC 0.516 \NC \NR +\BC recompress \NC 3 \NC 144,418 \NC 0.531 \NC \NR +\BC compresslevel \NC 0 \NC 281,071 \NC 0.516 \NC \NR +\BC compresslevel \NC 9 \NC 137,375 \NC 0.547 \NC \NR +\stoptabulate \stopsection diff --git a/doc/context/sources/general/manuals/workflows/workflows-mkiv.tex b/doc/context/sources/general/manuals/workflows/workflows-mkiv.tex index 52070c49e..a6d29ac42 100644 --- a/doc/context/sources/general/manuals/workflows/workflows-mkiv.tex +++ b/doc/context/sources/general/manuals/workflows/workflows-mkiv.tex @@ -15,7 +15,7 @@ % Group journal or otherwise. Thanks to the editors for corrections. Also thanks % to users for testing, feedback and corrections. -\setupbackend[export=yes] +% \setupbackend[export=yes] \environment workflows-style -- cgit v1.2.3