mirror of
https://github.com/Frooodle/Stirling-PDF.git
synced 2026-02-01 20:10:35 +01:00
# Description of Changes Rendering on high DPI can needlessly increase the file size and processing time, even when users would prefer smaller size, (with lesser quality) This PR adds support for configurable DPI, so that users can choose their preferred balance between processing time/file size and quality. **Backend logic and data model updates:** * The `FlattenController` now processes an optional `renderDpi` parameter from the request, using it to set the rendering DPI for each page. It enforces minimum and maximum values based on system configuration and ensures a sensible default if not provided. * The `FlattenRequest` model has a new `renderDpi` field to carry the requested DPI through the API and backend logic. **User interface and documentation improvements:** * The flatten form in `flatten.html` includes a new input field for DPI, with validation and help text to guide users about its impact and usage. * English resource messages have been updated to describe the new DPI field and provide help text explaining its effects. **UI:** <img width="595" height="604" alt="image" src="https://github.com/user-attachments/assets/f78a0401-0348-490b-920a-91475cab224b" /> **File size before after (100 DPI vs 500 DPI):** <img width="493" height="141" alt="image" src="https://github.com/user-attachments/assets/fe21bf79-a18f-4674-bbb5-c99b3d3bd7be" /> Sample used was originally 8 MB. Sample used are attached here: [image-doc-1.pdf](https://github.com/user-attachments/files/22889873/image-doc-1.pdf) [image-doc-2.pdf](https://github.com/user-attachments/files/22889876/image-doc-2.pdf) Strange stuff, I can personally _barely_ tell difference between 500 vs 100 DPI tbh, but the file size difference is very significant. Closes: #4668 <!-- Please provide a summary of the changes, including: - What was changed - Why the change was made - Any challenges encountered Closes #(issue_number) --> --- ## Checklist ### General - [ ] I have read the [Contribution Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md) - [ ] I have read the [Stirling-PDF Developer Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md) (if applicable) - [ ] I have read the [How to add new languages to Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md) (if applicable) - [ ] I have performed a self-review of my own code - [ ] My changes generate no new warnings ### Documentation - [ ] I have updated relevant docs on [Stirling-PDF's doc repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/) (if functionality has heavily changed) - [ ] I have read the section [Add New Translation Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/HowToAddNewLanguage.md#add-new-translation-tags) (for new translation tags only) ### UI Changes (if applicable) - [ ] Screenshots or videos demonstrating the UI changes are attached (e.g., as comments or direct attachments in the PR) ### Testing (if applicable) - [ ] I have tested my changes locally. Refer to the [Testing Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/devGuide/DeveloperGuide.md#6-testing) for more details. --------- Signed-off-by: Balázs Szücs <bszucs1209@gmail.com> |
||
|---|---|---|
| .. | ||
| common | ||
| core | ||
| proprietary | ||
| allowed-licenses.json | ||