Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sudara/melatonin_blur
Fast cross-platform CPU blurs and shadows for JUCE
https://github.com/sudara/melatonin_blur
juce-framework juce-modules stack-blur
Last synced: 5 days ago
JSON representation
Fast cross-platform CPU blurs and shadows for JUCE
- Host: GitHub
- URL: https://github.com/sudara/melatonin_blur
- Owner: sudara
- License: mit
- Created: 2023-11-07T13:28:24.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-13T23:33:33.000Z (22 days ago)
- Last Synced: 2024-12-23T17:09:37.523Z (12 days ago)
- Topics: juce-framework, juce-modules, stack-blur
- Language: C++
- Homepage: https://melatonin.dev/blog/implementing-marios-stack-blur-15-times-in-cpp/
- Size: 421 KB
- Stars: 104
- Watchers: 5
- Forks: 15
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-juce - melatonin_blur - platform CPU blurs and drop/inner shadows for JUCE| MIT|104|19 days<sub><sup>🟢</sup></sub>| (UI)
README
Melatonin Blur is a batteries-included, cross-platform CPU blur and shadow compositing library for
the [JUCE C++ framework](https://juce.com/).
*Batteries-included* means it aims to give you everything out of the box:
* 👩🎨 Figma/CSS-accurate drop and inner shadows on paths
* 🔠 Drop and Inner Text shadows
* 💅🏼 Supports both filled and stroked paths
* 🌇 ARGB image blurs
* 🚀 Fast! (see [benchmarks](#more-benchmarks))
* 🔎 Retina-friendly (context scale-aware)
* 🍰 Trivial to layer multiple shadows
* ⚙️ Behind-the-scenes multi-layer caching
* 😎 Debug optimized for high quality of life
* 🤖 Over 1000 correctness tests passing on macOS/windows
* 🚂 Compatible down to macOS 10.13 (progressive speedups on recent versions)
The goal: modern vector interfaces in JUCE (100s of shadows) without having to resort to deprecated solutions with lower quality of life (looking at you, OpenGL on macOS!).
https://github.com/sudara/melatonin_blur/assets/472/3e1d6c9a-aab9-422f-a262-6b63cbca5b71
Melatonin Blur provides a 10-30x speedup over using Stack Blur alone.
On macOS, it depends on the built-in Accelerate framework.
On Windows, it *optionally* depends on the Intel IPP library. If IPP is not present, it will fall back to a JUCE FloatVectorOperations implementation for single channel (shadows, etc) and Gin's Stack Blur for ARGB.
Interested in how the blurring
works? [I wrote an in-depth article about re-implementing Stack Blur 15+ times](https://melatonin.dev/blog/implementing-marios-stack-blur-15-times-in-cpp/).
## Installation
The docs have outgrown a README file, [visit the new documentation](https://melatonin.dev/manuals/melatonin-blur/installation/cmake/)
[](https://melatonin.dev/manuals/melatonin-blur/installation/cmake/)
## Usage
There's all the usage information you could want over at [the official docs](https://melatonin.dev/manuals/melatonin-blur/usage/drop-shadows/)
[](https://melatonin.dev/manuals/melatonin-blur/usage/drop-shadows/)
## Acknowledgements
* Mars, for being my reliable rubber duck! Inner Shadow caching and compositing geometry broke my brain.
* Roland Rabien for JUCE Stack Blur workhorse via [Gin](https://github.com/figbug/gin).
* LukeM1 on the forums
for [figuring out the `drawImageAt` optimization](https://forum.juce.com/t/faster-blur-glassmorphism-ui/43086/76).
* Ecstasy on the Discord for the motivation and feedback around stroked paths and default constructors.