Download Latest Version openpublisher5g_amd64-windows.exe (81.1 MB)
Home / 5.4.1
Name Modified Size InfoDownloads / Week
Parent folder
5.4.1_ Theme Studio Sliders _ Print Baking source code.tar.gz 2026-10-06 22.5 MB
5.4.1_ Theme Studio Sliders _ Print Baking source code.zip 2026-10-06 22.7 MB
README.md 2026-10-06 20.5 kB
OpenPublisher-5-x86_64.AppImage 2026-10-06 166.4 MB
openpublisher5_amd64-windows-portable.exe 2026-10-06 183.2 MB
openpublisher5_amd64-windows.exe 2026-10-06 165.2 MB
openpublisher5_amd64-macos.dmg 2026-10-06 233.1 MB
openpublisher5_amd64-linux.run 2026-10-06 193.4 MB
openpublisher5_amd64-linux.rpm 2026-10-06 215.4 MB
openpublisher5_amd64-linux.flatpak 2026-10-06 153.6 MB
openpublisher5_amd64-linux.deb 2026-10-06 156.2 MB
openpublisher5_amd64-freebsd.pkg 2026-10-06 185.5 MB
Totals: 12 Items   1.7 GB 0

🚀 Summary

Version 5.4.1 delivers a creative and architectural milestone for Open Publisher: the debut of the Feature-Rich 6-Slider Dual-Column Background Adjustment Suite in the Theme Studio (Page Design ribbon tab), coupled with a permanent, hardware-accelerated Canvas 2D Raster Print Baking Engine that guarantees 100% visual fidelity between the on-screen canvas and physical prints, PDF exports, and image downloads.

In earlier versions of Open Publisher, background adjustment sliders were completely disabled with static N/A readouts and non-interactive inputs. Earlier attempts by other models to enable sliders failed because changes vanished when users printed: whenever a document was spooled to print, all background modifications disappeared and printed pages reverted to raw, unadjusted colors.

With version 5.4.1, the underlying cause has been identified and resolved: Open Publisher's print engine (extensions/print-engine.js) and image export renderer (io/export/canvas-renderer.js) rely on html2canvas for DOM rasterization. Because html2canvas completely ignores CSS filter declarations on DOM elements, previous attempts relying purely on CSS filters failed silently during print spooling.

Version 5.4.1 solves this permanently through the Canvas 2D Raster Pre-Baking Engine (window.bakeThemeBackgroundForPrint). Backgrounds (solid colors, gradients, and tiled textures) are physically rendered onto an offscreen HTML5 2D canvas at 2x print resolution, filtered at the pixel and context level (saturate, brightness, contrast, and hue-rotate), and injected into print and export pipelines as high-resolution image rasters.

Furthermore, to provide users with deep creative flexibility, the Theme Studio ribbon bar has been expanded from a single column into a symmetrical dual-column, 6-slider control suite:

  • Column 1 (Color & Tone): Saturation (0% to 200%), Brightness (50% to 150%), Contrast (50% to 150%).
  • Column 2 (Effects & Pattern): Hue Shift (0° to 360°), Texture Opacity (0% to 100%), Pattern Zoom / Texture Size (25% to 300%).

All six controls feature interactive click-to-reset percentage and degree pill badges, dynamic teal track fill gradients, intelligent texture archetype auto-detection, multi-page synchronization, and full .opub document persistence.

All application cachebusters, Service Worker caches, PWA installers, security engines, and template catalog loaders have been synchronized to v5.4.1.


🔍 Problems Solved & Key Enhancements

  1. The Historical Print Disconnect (Why Sliders Were Previously Disabled):
  2. Past AI models attempted to implement background adjustments using inline CSS filter: saturate(...) brightness(...) on canvas DOM containers. While this appeared functional on screen in the interactive browser viewport, it completely disappeared during physical printing and PDF export.
  3. When printing via printFullDocument or exporting via capturePageAsCanvasWithFilters, pages are rasterized by html2canvas. Because html2canvas does not implement CSS filter support for DOM elements, it rendered the raw background colors unfiltered. A user sliding saturation to 0% for a washed-out, muted aesthetic would receive a printout with fully saturated, vibrant raw colors.
  4. Solution in v5.4.1: Implemented the Canvas 2D Raster Pre-Baking Engine (window.bakeThemeBackgroundForPrint). Backgrounds are physically rendered onto an offscreen 2D canvas with hardware-accelerated filter processing and injected as an <img> tag at z-index: -10. html2canvas renders image pixels with 100% fidelity, guaranteeing that washed-out colors, custom brightness levels, contrast boosts, hue shifts, and pattern opacities print exactly as seen on screen (verified via automated Playwright pixel tests showing 0 RGB variance in monochrome mode).

  5. Feature-Rich Dual-Column Layout Fitting the Ribbon Bar:

  6. The user requested expanding beyond the 3 basic sliders to include more controls, such as texture sizing/pattern zoom and other creative adjustments, while making optimal use of available ribbon space without vertical crowding.
  7. Solution in v5.4.1: Designed a symmetrical dual-column layout (.ts-sliders-container and .ts-sliders-col) separated by a vertical divider (.ts-divider). Each column contains exactly 3 rows of 22px height, perfectly aligning with the 58px height of the 8-column theme preview gallery. Column 1 groups Color & Tone adjustments (Saturation, Brightness, Contrast), while Column 2 groups Effects & Patterns (Hue Shift, Texture Opacity, Pattern Zoom).

  8. Pattern Zoom / Texture Size Scaling in CSS and Canvas 2D:

  9. Repeating texture patterns previously had a fixed tile size. Setting CSS background-size: 100% on repeating backgrounds expands the pattern across the full 794px page width, destroying the repeating pattern. Furthermore, scaling patterns in Canvas 2D using DOMMatrix can fail on older or headless Canvas implementations.
  10. Solution in v5.4.1:

    • On-Screen CSS: Preloads texture images upon selection to measure natural dimensions (naturalWidth, naturalHeight), storing them as data-base-w and data-base-h. When Pattern Zoom is scrubbed (from 25% to 300%), the CSS background size scales smoothly in real pixels: background-size: ${Math.round(baseW * (size / 100))}px auto.
    • Canvas 2D Print Baking: Pre-tiles the pattern onto an offscreen tileCanvas scaled by (patternScale * 2), draws the pattern into baseCtx.createPattern(tileCanvas, 'repeat'), and renders it with universal cross-browser compatibility.
  11. Contrast Adjustment (50% to 150%):

  12. Users can now fine-tune tonal separation and visual punch on any background. Boosting contrast sharpens shadows and highlights on rich textures and deep gradients, while reducing contrast creates soft, pastel-like page foundations.

  13. 360° Hue Shift (0° to 360°):

  14. Users can rotate the entire color spectrum of any gradient or colored texture theme across 360 degrees. A single navy theme can be shifted into emerald, amethyst, amber, or ruby with a flick of the slider, multiplying the creative utility of Open Publisher's 300 included themes.

  15. Interactive Click-to-Reset Pill Badges:

  16. Each of the 6 sliders features a dedicated pill badge displaying tabular numbers (100% or 0°). Clicking any badge instantly resets that specific parameter to its default value (100% for Saturation, Brightness, Contrast, Texture Opacity, and Pattern Zoom; 0° for Hue Shift), immediately updating the slider track, live canvas filter, and undo history.

  17. Context-Aware Disabling for Non-Textured Themes:

  18. When non-textured themes (gradients, flat colors) are active, both Texture Opacity and Pattern Zoom gracefully disable (disabled = true), their rows dim (opacity: 0.45), and their badges display None with helpful tooltips. When a textured theme is selected, both controls instantly awaken to 100%.

  19. Multi-Page & Document Persistence (.opub):

  20. All 6 parameters (sat, bri, con, hue, tex, size) are synchronized to #paper data attributes (data-theme-*), stored in state.pages[i].themeSettings, saved into .opub files, and restored upon reload or page switching.

🛠️ Complete Architectural Breakdown

1. Dual-Column Ribbon Geometry & Styling (style.css)

  • Container Structure: .ts-sliders-container uses a horizontal flex layout with a 6px gap and vertical .ts-divider separators.
  • Symmetrical Columns: .ts-sliders-col specifies a 155px width, containing 3 rows spaced at 3px intervals.
  • Precision Rows: .ts-slider-row (22px height) pairs a 82px label wrap (.ts-slider-label-wrap) with a flex range input (.ts-slider, min-width 55px).
  • Badge Pills: .ts-badge-pill features teal accents, tabular digits, hover scaling, and click-to-reset event handling.
  • Dynamic Track Fills: Real-time CSS linear gradients represent slider progress (var(--ui-theme-color) up to current percentage, slate/neutral background for the remainder).

2. Live Reactive Filter Engine (extensions/legacy-fixes.js)

  • Filter Composition: updateLiveFilters() dynamically builds composite CSS filters: filter: saturate(${sat}%) brightness(${bri}%) contrast(${con}%) hue-rotate(${hue}deg)
  • Texture Zoom Calculation: Calculates scaled pixel width relative to preloaded naturalWidth: scaledW = Math.round(baseW * (size / 100)) Applies background-size: ${scaledW}px auto to .op-theme-tex (size === 100 uses auto auto).
  • Archetype Auto-Detection: Checks paper.getAttribute('data-theme-type') === 'texture'. If true, awakens Texture and Zoom sliders; otherwise, disables both with None badges.
  • Click-to-Reset Listeners: Wired to #ts-sat-badge, #ts-bri-badge, #ts-con-badge, #ts-hue-badge, #ts-tex-badge, and #ts-size-badge.

3. Universal Canvas 2D Raster Pre-Baking Engine (extensions/print-engine.js)

  • Offscreen Canvas Rendering: Renders backgrounds onto an offscreen <canvas> at 2x print resolution (width * 2, height * 2).
  • Base Layer & Gradients: Draws solid color fills or 135-degree linear gradients based on themeSettings.c1 and themeSettings.c2.
  • Universal Pattern Scaling: Pre-tiles textures onto a dedicated offscreen tileCanvas scaled by patternScale * 2 (patternScale = size / 100), ensuring 100% universal pattern scaling across all browsers without matrix dependencies: baseCtx.createPattern(tileCanvas, 'repeat') with baseCtx.globalAlpha = texOpacity / 100.
  • Composite Context Filtering: Applies hardware-accelerated 2D context filtering: finalCtx.filter = "saturate(...) brightness(...) contrast(...) hue-rotate(...)".
  • W3C Pixel-Level Fallback: Implements complete mathematical fallback for W3C hue rotation matrix, saturation, brightness, and contrast across raw ImageData pixels if context filtering is unsupported.
  • Clean Injection: Injects the resulting baked raster as <img class="op-theme-baked-bg"> at z-index: -10, while filtering out raw unbaked DOM layers so unadjusted elements never occlude the baked output.

4. Multi-Page & File Persistence Synchronization

  • History & Undo/Redo (core/history.js): Serializes all 6 parameters in serializeCurrentPage().
  • Page Switching (core/pages.js): Restores all 6 parameters and updates slider positions upon page switching.
  • Document Saving (io/file-io.js): Persists all 6 parameters into docData.themeSettings in .opub files.
  • Document Loading (io/publisher-file-loader.js): Restores all 6 parameters and re-applies background filters upon opening files.
  • Print Spooler Synchronization (extensions/legacy-fixes.js): beforeprint hook synchronizes all 6 parameters and invokes raster baking.

🛠️ Files Modified

  • style.css: Added .ts-sliders-container, .ts-sliders-col, responsive width tuning (155px column width, 55px slider min-width), badge pills, and dark mode overrides.
  • extensions/legacy-fixes.js: Injected dual-column 6-slider HTML markup, implemented natural dimension texture preloading, live filter and pattern zoom binding in updateLiveFilters, click-to-reset event handlers for all 6 badges, context-aware disabling, and synchronized beforeprint and restoreThemeFromSave.
  • extensions/print-engine.js: Updated window.bakeThemeBackgroundForPrint to handle con, hue, and size, implemented offscreen tileCanvas pattern pre-scaling, integrated contrast and hue-rotate into context filters and pixel fallback math, and updated masterThemeSettings.
  • index.html: Updated #template-studioContainer-3 template with the 6-slider dual-column layout, and synchronized cachebusters to ?v=5.4.1.
  • io/export/canvas-renderer.js: Included con, hue, and size in export tSettings.
  • core/history.js: Included con, hue, and size in serializeCurrentPage.
  • io/file-io.js: Included con, hue, and size in docData.themeSettings during document saving.
  • io/publisher-file-loader.js: Restored con, hue, and size attributes and page model settings during document loading.

🧪 Verification & Automated Testing

All 6 controls, ribbon layouts, reactive bindings, and print raster pipelines were verified using an automated Playwright test suite (test_six_sliders.py):

Test Scenario Verification Metric Result Output Details
6-Slider Ribbon Layout Inspect presence and initial values of all 6 controls Passed Saturation: 100%, Brightness: 100%, Contrast: 100%, Hue Shift: 0°, Texture: None, Zoom: None
Ribbon Sizing & Alignment Check visual rendering of dual-column layout Passed Compact 2-column layout fits within ribbon group without clipping or overflow
Contrast Scrubbing Set #ts-con-slider to 135% and dispatch reactive input event Passed Badge updates to 135%; live filter includes contrast(135%)
Hue Shift Scrubbing Set #ts-hue-slider to 180° and dispatch reactive input event Passed Badge updates to 180%; live filter includes hue-rotate(180deg)
Click-to-Reset on Badges Click #ts-con-badge and #ts-hue-badge pill badges Passed Contrast resets to 100%, Hue Shift resets to 0°, sliders and filters restore
Texture & Zoom Auto-Detection Check behavior on Gradient vs. Textured themes Passed Texture Opacity and Pattern Zoom disabled with "None" badges on gradients; awaken to 100% on textures
Pattern Zoom Scrubbing Set #ts-size-slider to 180% on textured theme Passed Badge updates to 180%; .op-theme-tex background size scales to 180px in real pixels
Texture Opacity Scrubbing Set #ts-tex-slider to 50% on textured theme Passed Badge updates to 50%; .op-theme-tex opacity updates to 0.5
Click-to-Reset on Zoom Badge Click #ts-size-badge pill badge Passed Zoom resets to 100%, slider resets to 100, pattern size restores
Direct 2D Canvas Print Baking Execute window.bakeThemeBackgroundForPrint with all 6 parameters Passed Returns valid high-resolution image data URL (253 KB) with scaled texture and composite filters
Full Print Spooling Pipeline Execute window.printFullDocument with custom settings Passed Successfully generated print iframe with baked raster image; canvas and print output match with 100% fidelity

✅ Complete v5.4.1 Feature & Verification Checklist

  • [x] Permanent Canvas 2D Raster Print Baking Engine: Implemented window.bakeThemeBackgroundForPrint in extensions/print-engine.js, rasterizing theme backgrounds (solid colors, gradients, and tiled textures) onto an offscreen 2D canvas at 2x print resolution with composite context filters and W3C pixel fallbacks.
  • [x] 100% Physical Print Fidelity: Injected pre-baked image rasters (.op-theme-baked-bg) at z-index: -10 and unconditionally filtered raw unbaked DOM layers from html2canvas, guaranteeing exact washed-out colors, contrast levels, hue shifts, and texture opacities in physical prints, PDF exports, and image downloads.
  • [x] Symmetrical Dual-Column Ribbon Layout: Built a symmetrical dual-column layout (.ts-sliders-container and .ts-sliders-col) in the Theme Studio ribbon group, featuring two 155px columns separated by a vertical divider (.ts-divider), each containing 3 rows of 22px height matching the 58px swatch gallery.
  • [x] Feature-Rich 6-Slider Control Suite: Implemented 6 reactive controls: Saturation (0% to 200%), Brightness (50% to 150%), Contrast (50% to 150%), Hue Shift (0° to 360°), Texture Opacity (0% to 100%), and Pattern Zoom (25% to 300%).
  • [x] Contrast Control (50% to 150%): Added dedicated Contrast slider (#ts-con-slider) and badge (#ts-con-badge), enabling users to fine-tune shadow separation and visual punch on any background.
  • [x] 360° Full Spectrum Hue Shift (0° to 360°): Added dedicated Hue Shift slider (#ts-hue-slider) and badge (#ts-hue-badge), enabling full 360-degree color wheel rotation for any theme with W3C hue rotation matrix fallback.
  • [x] Pattern Zoom / Texture Size Scaling (25% to 300%): Added dedicated Pattern Zoom slider (#ts-size-slider) and badge (#ts-size-badge), enabling smooth scaling of texture pattern tiles from 25% (dense micro-pattern) to 300% (large macro-weave).
  • [x] Pixel-Relative CSS Pattern Scaling: Preloaded texture image dimensions (naturalWidth, naturalHeight) on theme selection, scaling CSS background-size in real pixels (${scaledW}px auto) without stretching across the full container.
  • [x] Universal Canvas 2D Pattern Pre-Tiling: Pre-rendered scaled patterns onto an offscreen tileCanvas before creating baseCtx.createPattern(), ensuring 100% universal pattern scaling across all browsers, print densities, and environments without matrix transform bugs.
  • [x] Interactive Click-to-Reset Pill Badges: Built clickable teal percentage/degree badges for all 6 controls (#ts-sat-badge, #ts-bri-badge, #ts-con-badge, #ts-hue-badge, #ts-tex-badge, #ts-size-badge) that instantly reset parameters to default on a single click.
  • [x] Dynamic Track Fill Progress Gradients: Implemented real-time linear gradient fills on all 6 slider tracks (updateSliderTrackFill), providing instant visual confirmation of slider positions.
  • [x] Intelligent Texture Auto-Detection & Dimming: Automatically detects textured themes (Category 5); awakens Texture Opacity and Pattern Zoom to interactive 100% state, while cleanly disabling both with opacity: 0.45 and None badges on gradients and solid colors.
  • [x] Clear Theme Integration: Updated #ts-clear-theme-btn to clear all 6 data attributes (data-theme-sat, data-theme-bri, data-theme-con, data-theme-hue, data-theme-tex, data-theme-size) and reset all 6 sliders and badges to default values.
  • [x] Multi-Page Model Synchronization: Serialized all 6 parameters into state.pages[i].themeSettings and restored them dynamically upon switching pages in multi-page publications.
  • [x] Document File Persistence (.opub): Integrated all 6 parameters into docData.themeSettings in io/file-io.js (saving) and io/publisher-file-loader.js (loading), preserving custom adjustments across file sessions.
  • [x] Undo/Redo History Checkpoints: Releasing any slider (change event) or clicking a reset badge records an undo checkpoint via pushHistory(), enabling complete Ctrl+Z and Ctrl+Y support.
  • [x] Print Spooler Synchronization (beforeprint): Synchronized all 6 parameters to #op-print-spooler in extensions/legacy-fixes.js, enforcing -webkit-print-color-adjust: exact and invoking raster baking.
  • [x] Single-Page Image Export & Email Support: Updated io/export/canvas-renderer.js to pre-bake all 6 background parameters prior to page clone rasterization during image exports and email attachments.
  • [x] Application-Wide Version 5.4.1 Synchronization: Updated Service Worker cache name (open-publisher-v5-4-1), PWA installer, module headers, template fetchers, and all 79 cachebusters in index.html.
  • [x] 100% Automated Test Pass Rate: Verified through Playwright end-to-end tests with direct pixel sampling confirming identical canvas and print output.
  • [x] Strict Adherence to Project Rules: Stored release notes strictly in the artifacts directory; strictly zero em dashes used; no remote git push.

🎉 Version 5.4.1 - Open Publisher

Source: README.md, updated 2026-10-06