emf-converter 4.17.0 → 4.18.0

package/README.md

@@ -72,7 +72,7 @@ const svgUrl = await convertMetafileToSvgDataUrl(buffer);
 // => "data:image/svg+xml;base64,PHN2ZyB4bWxucz0i..."  (drop straight into <img src>)
 ```
 
-Paths, text, gradients, clipping and pattern brushes stay vectors; bitmaps are embedded as `<image>` elements (PNG/JPEG/GIF/WebP bytes verbatim, never re-encoded). Raster operations that read the destination (all 256 ROP3 codes, bitwise ROP2, pattern brushes through ROP2) are evaluated exactly against a hidden raster mirror and embedded as image patches holding only the pixels they change, so the SVG is the same with or without a canvas backend.
+Paths, text, gradients, clipping and pattern brushes stay vectors; bitmaps are embedded as `<image>` elements (PNG/JPEG/GIF/WebP bytes verbatim, never re-encoded; arithmetic-coded and CMYK/YCCK JPEG are decoded by the bundled Windows-matching decoder and embedded as pixels, and a 12-bit JPEG draws nothing, as in Windows). Raster operations that read the destination (all 256 ROP3 codes, bitwise ROP2, pattern brushes through ROP2) are evaluated exactly against a hidden raster mirror and embedded as image patches holding only the pixels they change, so the SVG is the same with or without a canvas backend.
 
 ### Rendering in React (JSX / TSX)
 
@@ -127,8 +127,8 @@ const png = await convertMetafileToDataUrl(buffer, { fonts });
 - Fonts are realised the way GDI's font mapper does it (face substitutes, pitch/family fallback, weight choice, cell vs em height, `lfWidth` stretching), with GDI's metrics, advances, underline and strike-out.
 - Glyphs are grid-fitted by the font's own TrueType instructions (including Windows' ClearType rules), scan-converted with dropout control, and placed on GDI's integer grid honouring Dx arrays, `ETO_*` flags and every `TA_*` alignment.
 - Non-antialiased, grayscale or ClearType rendering is chosen from the font's quality; `fontSmoothing` sets what `DEFAULT_QUALITY` means (Windows' default is ClearType).
-- Raster faces (MS Sans Serif, MS Serif, Courier, Small Fonts, System, Terminal, Fixedsys, Helv, Tms Rmn) are drawn from their bitmaps with GDI's size choice and stretching.
-- Rotated text uses GDI's rounded font matrix; EMF+ `DrawString` honours the text rendering hint, string-format tracking and margins, and texture/gradient brushes.
+- Raster faces (MS Sans Serif, MS Serif, Courier, Small Fonts, System, Terminal, Fixedsys, Helv, Tms Rmn) are drawn from their bitmaps with GDI's size choice and stretching (up to 8 vertically, 5 horizontally). The size depends on the faces supplied: pass `8514sys.fon` and `8514fix.fon` along with `vgasys.fon` and `vgafix.fon` to get the System and Fixedsys sizes a 120 dpi or larger session draws.
+- Rotated text uses GDI's rounded font matrix. Text from a compatible-mode metafile replays the recorded Dx array but not the slight horizontal stretch (about 1.0006) Windows playback applies, which re-grid-fits a few Segoe UI heights. EMF+ `DrawString` honours the text rendering hint, string-format tracking and margins, and texture/gradient brushes.
 
 Without `fonts`, text is drawn by the host's canvas font engine (supply `fontFamilyMap` to remap Windows face names). SVG output always keeps text as `<text>`; with `fonts` it carries GDI's exact per-glyph positions.
 
@@ -189,7 +189,7 @@ See [How it works](docs/how-it-works.md) for the pipeline, the Windows-parity de
 
 ## Limitations
 
-Everything is measured against output painted by Windows itself, and a few areas still differ from it: some image effects, text with ClearType and EMF+ antialiasing, nonuniform wide-pen nibs, and rotated bicubic `DrawImage` sampling. Metric WMF map modes assume a 96 dpi device unless you pass `wmfReferenceDpi`.
+Everything is measured against output painted by Windows itself, and a few areas still differ from it: some image effects, text with ClearType and EMF+ antialiasing, diagonal and curved glyph hinting, the last 0.26% of CMYK JPEG values, and rotated high-quality `DrawImage` sampling (within one level). Metric WMF map modes assume a 96 dpi device unless you pass `wmfReferenceDpi`.
 
 See [Limitations](docs/limitations.md) for the details and [Outstanding work](docs/outstanding-work.md) for what is still open.
 

package/THIRD_PARTY_NOTICES

@@ -131,12 +131,20 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 
 
-===== Independent JPEG Group software (src/jpeg-arith.ts) =====
+===== Independent JPEG Group software (src/jpeg-arith.ts, src/jpeg-turbo.ts) =====
 
 src/jpeg-arith.ts decodes arithmetic-coded JPEG and is a port of the entropy
 decoder in libjpeg's jdarith.c and the probability table in jaricom.c. This
 software is based in part on the work of the Independent JPEG Group.
 
+src/jpeg-turbo.ts, the decoder that runs around it, reproduces libjpeg's output
+bit for bit and follows its algorithms: the accurate integer inverse DCT of
+jidctint.c (its fixed-point constants, passes and descaling), the Huffman table
+layout and decoding of jdhuff.c (mincode, maxcode and valptr), the triangle
+("fancy") chroma upsampling of jdsample.c with its rounding terms and the
+fixed-point YCbCr to RGB conversion of jdcolor.c, which src/jpeg-cmyk.ts also
+uses for YCCK. It is covered by the same license.
+
 scripts/gdi-fixtures/arith-jpeg-encoder.ts, a test tool that is not part of the
 published package, is a port of the arithmetic encoder in libjpeg's jcarith.c
 and is covered by the same license.
@@ -144,14 +152,14 @@ and is covered by the same license.
 The following is the IJG license under which libjpeg (as distributed in
 libjpeg-turbo's README.ijg) is provided:
 
-This software is copyright (C) 1991-2020, Thomas G. Lane, Guido Vollbeding.
-All Rights Reserved except as specified below.
-
 The authors make NO WARRANTY or representation, either express or implied,
 with respect to this software, its quality, accuracy, merchantability, or
 fitness for a particular purpose.  This software is provided "AS IS", and you,
 its user, assume the entire risk as to its quality and accuracy.
 
+This software is copyright (C) 1991-2020, Thomas G. Lane, Guido Vollbeding.
+All Rights Reserved except as specified below.
+
 Permission is hereby granted to use, copy, modify, and distribute this
 software (or portions thereof) for any purpose, without fee, subject to these
 conditions:
@@ -223,3 +231,22 @@ Consortium, and may be copied, distributed, embedded, made, used, and sold
 without restriction. Altered versions of this profile shall have the original
 identification and copyright information removed and shall not be
 misrepresented as the original profile.
+
+
+===== Measured Windows data and cited references (no third-party code) =====
+
+src/jpeg-cmyk-data.ts, src/emf-gdi-illuminant-data.ts, src/emf-plus-image-curves.ts,
+src/emf-plus-hq-cubic-weights.ts and src/emf-ansi-tables.ts are tables measured by
+running Windows (the ICM colour-management module, GDI halftone and colour
+adjustment, GDI+, the Windows code pages) on test inputs; the capture and
+generator scripts are under scripts/gdi-fixtures and each file's header names its
+origin. They are measurements of program output, not copies of Microsoft source
+code or data files: the RSWOP.icm profile, mscms.dll and the Windows fonts are not
+bundled, and are read from the host only when the fixtures are regenerated or
+compared. The diagnostic TrueType fonts under src/__fixtures__/gdi are built by
+scripts/gdi-fixtures/build-*-fonts.py (fontTools, a build-time tool that is not
+bundled) from hand-written four-point glyphs and contain no third-party glyph
+data.
+
+Comments in the source cite the Wine project's gdi32 tests (gdi32/tests/path.c)
+as evidence of GDI's behaviour. No Wine code or data is copied.