| Name | Modified | Size | Downloads / 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
- The Historical Print Disconnect (Why Sliders Were Previously Disabled):
- 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. - When printing via
printFullDocumentor exporting viacapturePageAsCanvasWithFilters, pages are rasterized byhtml2canvas. Becausehtml2canvasdoes not implement CSSfiltersupport 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. -
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 atz-index: -10.html2canvasrenders 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). -
Feature-Rich Dual-Column Layout Fitting the Ribbon Bar:
- 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.
-
Solution in v5.4.1: Designed a symmetrical dual-column layout (
.ts-sliders-containerand.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). -
Pattern Zoom / Texture Size Scaling in CSS and Canvas 2D:
- 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 usingDOMMatrixcan fail on older or headless Canvas implementations. -
Solution in v5.4.1:
- On-Screen CSS: Preloads texture images upon selection to measure natural dimensions (
naturalWidth,naturalHeight), storing them asdata-base-wanddata-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
tileCanvasscaled by(patternScale * 2), draws the pattern intobaseCtx.createPattern(tileCanvas, 'repeat'), and renders it with universal cross-browser compatibility.
- On-Screen CSS: Preloads texture images upon selection to measure natural dimensions (
-
Contrast Adjustment (50% to 150%):
-
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.
-
360° Hue Shift (0° to 360°):
-
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.
-
Interactive Click-to-Reset Pill Badges:
-
Each of the 6 sliders features a dedicated pill badge displaying tabular numbers (
100%or0°). 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. -
Context-Aware Disabling for Non-Textured Themes:
-
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 displayNonewith helpful tooltips. When a textured theme is selected, both controls instantly awaken to100%. -
Multi-Page & Document Persistence (
.opub): - All 6 parameters (
sat,bri,con,hue,tex,size) are synchronized to#paperdata attributes (data-theme-*), stored instate.pages[i].themeSettings, saved into.opubfiles, and restored upon reload or page switching.
🛠️ Complete Architectural Breakdown
1. Dual-Column Ribbon Geometry & Styling (style.css)
- Container Structure:
.ts-sliders-containeruses a horizontal flex layout with a 6px gap and vertical.ts-dividerseparators. - Symmetrical Columns:
.ts-sliders-colspecifies 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-pillfeatures 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))Appliesbackground-size: ${scaledW}px autoto.op-theme-tex(size === 100usesauto auto). - Archetype Auto-Detection: Checks
paper.getAttribute('data-theme-type') === 'texture'. If true, awakens Texture and Zoom sliders; otherwise, disables both withNonebadges. - 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.c1andthemeSettings.c2. - Universal Pattern Scaling: Pre-tiles textures onto a dedicated offscreen
tileCanvasscaled bypatternScale * 2(patternScale = size / 100), ensuring 100% universal pattern scaling across all browsers without matrix dependencies:baseCtx.createPattern(tileCanvas, 'repeat')withbaseCtx.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
ImageDatapixels if context filtering is unsupported. - Clean Injection: Injects the resulting baked raster as
<img class="op-theme-baked-bg">atz-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 inserializeCurrentPage(). - 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 intodocData.themeSettingsin.opubfiles. - 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):beforeprinthook 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 synchronizedbeforeprintandrestoreThemeFromSave. - extensions/print-engine.js: Updated
window.bakeThemeBackgroundForPrintto handlecon,hue, andsize, implemented offscreentileCanvaspattern pre-scaling, integrated contrast and hue-rotate into context filters and pixel fallback math, and updatedmasterThemeSettings. - index.html: Updated
#template-studioContainer-3template with the 6-slider dual-column layout, and synchronized cachebusters to?v=5.4.1. - io/export/canvas-renderer.js: Included
con,hue, andsizein exporttSettings. - core/history.js: Included
con,hue, andsizeinserializeCurrentPage. - io/file-io.js: Included
con,hue, andsizeindocData.themeSettingsduring document saving. - io/publisher-file-loader.js: Restored
con,hue, andsizeattributes 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.bakeThemeBackgroundForPrintinextensions/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) atz-index: -10and unconditionally filtered raw unbaked DOM layers fromhtml2canvas, 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-containerand.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 CSSbackground-sizein 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
tileCanvasbefore creatingbaseCtx.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.45andNonebadges on gradients and solid colors. - [x] Clear Theme Integration: Updated
#ts-clear-theme-btnto 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].themeSettingsand restored them dynamically upon switching pages in multi-page publications. - [x] Document File Persistence (
.opub): Integrated all 6 parameters intodocData.themeSettingsinio/file-io.js(saving) andio/publisher-file-loader.js(loading), preserving custom adjustments across file sessions. - [x] Undo/Redo History Checkpoints: Releasing any slider (
changeevent) or clicking a reset badge records an undo checkpoint viapushHistory(), enabling completeCtrl+ZandCtrl+Ysupport. - [x] Print Spooler Synchronization (
beforeprint): Synchronized all 6 parameters to#op-print-spoolerinextensions/legacy-fixes.js, enforcing-webkit-print-color-adjust: exactand invoking raster baking. - [x] Single-Page Image Export & Email Support: Updated
io/export/canvas-renderer.jsto 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 inindex.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