Harlequin Core 14.1r0 Release Notes

Introduction

Harlequin v14.1r0 is a major release since HQN v14.0r0, there have been several quarterly and maintenance releases since 14.0r0. This release consolidates work of HQN v14.0r0 and those that followed. We have responded to many customer issues including compatibility and other issues that required Core changes, as you can see in the "Harlequin Core v14.1r0 change details" table (below).

Nonetheless there was time for some new developments. Harlequin v14.1r0 introduces:

  • Addition of ColorLogic CMM

  • HVD improvements

  • Performance enhancements

Alerts and guidance

  • Updated Windows compiler to VS2022 LTS

  • LDK components must be updated with version 10.21. These are now included in RIP distributions (previously version 8.51 was provided with 14.0r0)

Windows 11 support (Current guidance)

Harlequin Core is fully supported on Windows 11 64‑bit and is automatically validated and qualified on Windows 11 since the first v14 release. The Core and it's SDK components are optimized for modern CPU architectures, taking advantage of SIMD/AVX2 capabilities available on current desktop and workstation hardware.

Key points for OEMs and integrators:

Windows 11 is the primary supported Windows desktop platform for new Harlequin Core integrations. Harlequin Core v14 is 64‑bit only, aligned with Windows 11 requirements and modern toolchains. Integrations should therefore be built and tested using recent Visual Studio toolsets supported by Windows 11. Systems must meet the minimum CPU SIMD requirements enforced at RIP startup; older CPUs that lack AVX2 may fail startup checks.

Windows 10 is now considered a legacy deployment platform but may continue to operate, new integrations and certifications should target Windows 11.

Windows Server 2025 (Expectations) The following is forward‑looking guidance, not a formal support statement, it is expected that Harlequin Core’s existing architecture (64‑bit only, modern CPU assumption, installer‑less ZIP‑based SDK distribution) aligns well with expected Windows Server 2025 characteristics. OEMs planning long‑lifecycle products (forward 5 years) should architect their solutions so that Windows Server 2025 upgrade paths are supported.

Unless agreed with your account manager or product management, formal qualification and support statements for Windows Server 2025 will be communicated in a future Harlequin Core release once validation is complete.

Alternate ColorLogic CMM tryout

Harlequin Core now supports ColorLogic as an internal color management engine alongside ColorPro and the existing Alternate CMM API, providing an additional, high‑quality option for color rendering. The new path is designed to meet or exceed demanding DFE color standards while matching the performance of existing ColorPro‑based workflows, and is available as a optional feature for OEMs already invested in ColorLogic tools. Please speak to your account manager about using this option. Documentation will be added to our website in the coming weeks.

Change highlight - Overprint Preview settings

HQN‑386585 — Overprint Preview Default Updated to SpotsOnly

The default value of /OverprintPreview has been changed from false to /SpotsOnly.

Previously, when no explicit /OverprintPreview value was set, overprinting of spot colours could be incorrectly previewed, which in some cases led to unexpected or incorrect output, particularly with Harlequin VariData (HVD). With this change, Harlequin Core now defaults to:

<< /OverprintPreview /SpotsOnly >> setinterceptcolorspace

This aligns Harlequin output more closely with Adobe Acrobat, where Overprint Preview is typically enabled, and reduces the risk of incorrect output caused by unpreviewed spot‑colour overprinting.

Impact

  • Improves accuracy when previewing and rendering overprinted spot colours.

  • Reduces the likelihood of bad output in workflows using HVD.

  • Brings default behavior in line with most customer expectations and Acrobat’s overprint simulation.

Notes

  • This change only applies when no explicit /OverprintPreview value is configured.

  • Existing workflows that already set /OverprintPreview explicitly are unaffected.

  • To revert this behaviour, set:

<< /OverprintPreview false >> setinterceptcolorspace

Note: enabling the new default (/OverprintPreview /SpotsOnly) causes isolated colour changes for duotones and tritones in some legacy QuarkXPress jobs, producing colours that do not match Adobe Acrobat Output Preview (with Simulate Overprinting enabled). In these cases, the black plane may replace a colour resembling the original spot colour.

Harlequin Core v14.1r0 change details

Jira Story

Support call(s)

Summary

Applies to:

HQN-386534

HQNSUP-127215

Bugfix: Fixed a crash when a job defined multiple halftone screens for the same output colorant via colorant aliases

Core SDK

HQN-383687

HQNSUP-126805, HQNSUP-126382, HQNSUP-127047, HQNSUP-127167,
SW #126382

Fixed an issue where Override Angles In Job Not Honored For Pre-Separated PS Job

All

HQN-386402

n/a

Found internally: Access violation in halftone code due to handling of None colorants

Core SDK

HQN-386698

HQNSUP-127220

Add DeviceCMYK option to IgnorePageGroup

A change in behaviour. A new /DeviceCMYK value has been added to the existing IgnorePageGroup PDF parameter, providing a more targeted alternative to /ProcessColorModel that ignores page groups only when the colour space key is DeviceCMYK, enabling SpotsOnly compositing optimisations and increased HVD reuse.

Core SDK

HQN-386417

SDFESUP-1372

Large lengthy VDP file fails when -nrips specified

Core SDK

HQN-386423

HQNSUP-127177

A caching change that could have caused incorrect elements to be recombined in HVD.
Improved image cache memory management Fixed an issue where the image cache was not purged reliably when images were reused across pages. The revised aging logic now releases unused image data more effectively, reducing peak memory usage on long or complex jobs without affecting output.

Core SDK

HQN-386436

HQN-386436

Added OptimizedPDFScanOnlyStashPages pdfparam so customers can set the number of degraded stash pages used during Optimized PDF scanning

Core SDK

HQN-386446

n/a

Performance: Add some simple optimizations to avoid unnecessary loss of reuse for isolated transparency groups

All

HQN-386491

n/a

VDP performance. Allow both normal and degraded stash pages to co-exist

Core SDK

HQN-386518

n/a

Extend Windows HHR SDK Makefile to work with Visual Studio Developer Command and PowerShell prompts

Core SDK

HQN-386533

HQNSUP-127275
HQNSUP-127265
HQNSUP-127207

Allow truncated JPEG image data in job
Now process files with corrupt or truncated image streams in them. Including (but not limited to) PDFs from Canva

All

HQN-386537
HQN-386346

n/a

Add build support for recent Windows SDK Visual Studio 2022 (17.12). Updates Windows compiler used for new releases to VS2022 LTS.

Core SDK

HQN-386538

n/a

Include LDK Runtime 10.21 in RIP distributions
include 10.21 runtime in place of 8.51 provided with 14.0r0

All

HQN-386570

SDFESUP-1486

Improve the SupportNoneIntent feature of NamedColor resources.
improves the SupportNoneIntent feature of NamedColor resources, ensuring they are correctly invoked and cached even when the rendering intent is set to None.

Core SDK

HQN-386585

n/a

Make /OverprintPreview /SpotsOnly the default, previously was set to false. The new default for /OverprintPreview is now /SpotsOnly, aligning Harlequin Core output with Acrobat and most customers usage intentionally changing output in cases where overprinting spot colors were previously not correctly previewed.

Core SDK

HQN-386487

HQNSUP-127169
SDFESUP-1486

Neutralmapping code crash MAKO processed file when processed in SDFE

Core SDK

HQN-386509

HQNSUP-127075

Further work in performance optimising the rendered y extent of patterns. Improvement for large format jobs

Core SDK

HQN-386541

HQNSUP-126609

Performance optimise xyz2lab color conversions. Improvement for large format jobs

Core SDK

HQN-386622

HQNSUP-127270

Fix: image caching issue when using NextDevice
an image caching issue where rotated images could lose their rotation when using NextDevice color management by preserving image rotation flags in the cache key.

Core SDK

Known issues

HQN‑386003 – Correct MPS not to exceed the process' maximum number of mappings on Linux
It was found that the default max_map_count on Ubuntu and Red Hat was not sufficient to allow some jobs to complete normally even with a huge memory of 120 GB.
The workaround is to set max_map_count, which prevents this stuck loop at the end of the job. This is planned to be resolved in a future release.

HQN‑385923 – Scalable crashes on startup on PCs with CPUs without AVX2 support
Running a scalable RIP on an Ubuntu VM without AVX2 SIMD support (not recommended) can result in a crash during ZeroMQ static data initialization. Investigation showed the VM CPU flags did not include AVX2.

Deprecated items

CHM files are no longer provided, please us the html pages in this folder: INSTALLATION DIRECTORY\doc\hqnripsdk-html. CHM file were only ever available in Windows.

Documentation updates

The current documentation, particularly the Extensions Manual has been updated and improved for 14.1.

Updates to the API documentation https://api.hybridhelix.com/harlequin/ are provided both in the INSTALLATION DIRECTORY\doc\hqnripsdk-html directory and online.