{"id":25497210,"url":"https://github.com/stacksapien/quantum-fractal-explorer","last_synced_at":"2025-10-11T01:38:49.482Z","repository":{"id":278278480,"uuid":"935095078","full_name":"stacksapien/quantum-fractal-explorer","owner":"stacksapien","description":"Quantum Fractal Explorer is a mesmerizing, real-time visualization of pulsating, infinite fractals using advanced GLSL shaders and ray marching. Experience dynamic fractal geometry with cosmic bloom effects and interactive orbit controls.","archived":false,"fork":false,"pushed_at":"2025-02-18T22:43:38.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-19T11:45:37.413Z","etag":null,"topics":["creative-coding","fractal","glsl","raymarching","real-time-visualization","shader","three-js","threejs","threejs-example","webgl"],"latest_commit_sha":null,"homepage":"https://stacksapien.github.io/quantum-fractal-explorer/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stacksapien.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-18T22:30:53.000Z","updated_at":"2025-02-18T22:50:41.000Z","dependencies_parsed_at":"2025-02-18T23:39:14.354Z","dependency_job_id":null,"html_url":"https://github.com/stacksapien/quantum-fractal-explorer","commit_stats":null,"previous_names":["stacksapien/quantum-fractal-explorer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stacksapien/quantum-fractal-explorer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stacksapien%2Fquantum-fractal-explorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stacksapien%2Fquantum-fractal-explorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stacksapien%2Fquantum-fractal-explorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stacksapien%2Fquantum-fractal-explorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stacksapien","download_url":"https://codeload.github.com/stacksapien/quantum-fractal-explorer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stacksapien%2Fquantum-fractal-explorer/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261006123,"owners_count":23095986,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["creative-coding","fractal","glsl","raymarching","real-time-visualization","shader","three-js","threejs","threejs-example","webgl"],"created_at":"2025-02-19T01:18:47.764Z","updated_at":"2025-10-11T01:38:44.434Z","avatar_url":"https://github.com/stacksapien.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Quantum Fractal Explorer\n\nQuantum Fractal Explorer is an advanced real-time visualization project that harnesses the power of ray marching and GLSL shaders to render a dynamic, pulsating, and seemingly infinite fractal. This project creates an immersive experience reminiscent of quantum phenomena, blending fractal geometry with cosmic post-processing effects.\n\n## Overview\n\nQuantum Fractal Explorer uses a custom fragment shader to ray march a Mandelbulb-like fractal on a full-screen quad. The fractal’s parameters—such as power, iteration count, and bloom strength—oscillate over time to create a continuous pulsation effect. Additionally, the foreground and background colors transition to complementary hues with each pulse, enhancing the visual impact.\n\n## Algorithm Details\n\n### Ray Marching\n- **Ray Casting:**  \n  For each pixel, a ray is cast from the camera's position through the fragment. The ray's direction is computed based on the camera’s orientation, ensuring proper perspective.\n  \n- **Distance Estimation:**  \n  A distance estimator function (`mandelbulbDE`) approximates the shortest distance from a point in space to the fractal surface. This function iteratively transforms the point using a Mandelbulb formula and updates a derivative factor to gauge the rate of change.\n  \n- **Iteration and Termination:**  \n  The algorithm iterates the fractal transformation up to a user-controlled maximum (pulsing between 1 and 3 effective iterations). It terminates when the estimated distance is below a set threshold (indicating a hit) or when the ray travels beyond a maximum distance.\n  \n- **Shading:**  \n  The distance traveled by the ray influences the final color, creating a gradient that conveys depth. This shading, combined with the bloom effect, produces an ethereal glow.\n\n### Pulsation and Dynamic Effects\n- **Power Oscillation:**  \n  The fractal’s power parameter dynamically oscillates from 0 to 16. This alters the fractal's complexity and shape in real time.\n  \n- **Iteration Pulsing:**  \n  The number of iterations used in the distance estimator pulses between 1 and 3, subtly changing the level of detail.\n  \n- **Bloom Strength:**  \n  A post-processing bloom effect is applied, with its strength pulsing up to 1.6 to create a vibrant, glowing appearance.\n  \n- **Color Complementation:**  \n  With every pulsation cycle, the fractal’s foreground color and the background color shift to complementary hues, providing a continuously evolving and visually striking contrast.\n\n### Technical Implementation\n- **GLSL Shader:**  \n  The heart of the rendering is a GLSL fragment shader that implements ray marching for the fractal. Uniforms like `uTime`, `uResolution`, `uIterations`, `uPower`, `uZoom`, and camera matrices are passed to dynamically control the visualization.\n  \n- **Post-Processing:**  \n  The scene is rendered using Three.js and enhanced with an UnrealBloomPass to achieve a soft, glowing effect.\n  \n- **User Interaction:**  \n  While the fractal pulsates automatically, OrbitControls allow users to orbit and explore the scene from different angles.\n\n## Usage\n\nQuantum Fractal Explorer is designed to run in modern browsers that support WebGL, JavaScript modules, and import maps. Simply open the provided `index.html` file to experience the pulsating fractal visualization.\n\n## Conclusion\n\nQuantum Fractal Explorer is a fusion of art and technology, offering a window into the beauty of infinite fractal geometry through advanced shader programming and real-time rendering techniques. Dive in and explore the quantum depths of this dynamic, ever-changing fractal world!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstacksapien%2Fquantum-fractal-explorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstacksapien%2Fquantum-fractal-explorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstacksapien%2Fquantum-fractal-explorer/lists"}