gd-fractals - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #ai #golang #rust #docker #nodejs #java #awesome #cli #security #pytorch #openai #open-source

gd-fractals

(★ 54)

Dynamic 3D fractals in Godot 4

File Explorer

Download Latest Version (.zip)

- - obj_to_sdf.py
  - plugin.cfg
  - requirements.txt
  - sdf_converter.gd
  - sdf_converter.gd.uid
- - bird.tscn
  - bird_2.tscn
  - bird_2_material.tres
  - bird_material.tres
- - bunny.tscn
  - bunny_2.tscn
  - bunny_2_material.tres
  - bunny_material.tres
- - simple.tscn
  - simple_2.tscn
  - simple_3.tscn
  - simple_4.tscn
  - simple_5.tscn
- - starfish.tscn
  - starfish_material.tres
- - urchin.tscn
  - urchin_material.tres
- free_look_camera.gd
- free_look_camera.gd.uid
- icon.png
- icon.png.import
- main.tscn
- rotate.gd
- rotate.gd.uid
- sky.png
- sky.png.import
- bird.obj
- bird.obj.import
- bird.sdf
- bunny.mtl
- bunny.obj
- bunny.obj.import
- bunny.sdf
- starfish.obj
- starfish.obj.import
- starfish.sdf
- urchin.obj
- urchin.obj.import
- urchin.sdf
- raymarcher.gdshader
- raymarcher.gdshader.uid
- raymarcher_simple.gdshader
- raymarcher_simple.gdshader.uid
- screenshot_1.png
- screenshot_1.png.import
- screenshot_2.png
- screenshot_2.png.import
- bird_256.res
- bird_64.res
- bunny_128.res
- bunny_32.res
- bunny_64.res
- starfish_64.res
- urchin_64.res
.editorconfig
.gitattributes
.gitignore
LICENSE.md
project.godot
README.md

# Installation Guide

1. Get the code

git clone https://github.com/kiwijuice56/gd-fractals

Downloads the entire project code from GitHub to your computer.

cd gd-fractals

Moves into the project folder you just downloaded.

2. Python

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

⚠️ This is a large repository, so this method may point to an internal sub-package rather than the actual core product. Check the full README as well.

pip install -r addons/sdf_converter/requirements.txt

Installs the Python libraries listed in requirements.txt (or similar).

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# gd-fractals
Dynamic 3D mesh fractals rendered using a raymarching shader in Godot 4. Includes seamless integration with Godot's default 3D editor and a plugin to convert `.obj` meshes into signed distance function textures. See demo project for example usage.

![Fractal image](https://raw.githubusercontent.com/kiwijuice56/gd-fractals/main/screenshots/screenshot_1.png)
![Editor example](https://raw.githubusercontent.com/kiwijuice56/gd-fractals/main/screenshots/screenshot_2.png)

## Usage
1. Create a `MeshInstance3D` and attach a `QuadMesh` to it with `orientation` set to `Face Z`.
2. Set `cast_shadow` to off. If you want an approximation of shadows, you can add a second `MeshInstance3D` as a child with `cast_shadow` set to `Shadows Only` -- a sphere mesh works okay to give visual depth at least.
3. Create a `ShaderMaterial` and attach either `rendering/raymarcher.gdshader` or `rendering/raymarcher_simple.gd_shader`. The normal variant allows you to merge mesh fractals with a secondary fractal, while the simple variant allows you to render the secondary fractals by themselves. 
4. Configure the parameters. See examples in `demo` for reasonable values.

## SDF Converter
The mesh fractal shader takes as input the 3D signed distance function texture of a model rather than a triangulated mesh. The SDF converter addon in this repository allows you to convert `.obj` files into the correct format directly. It uses a Python script, so ensure that you've installed the libraries in `addons/sdf_converter/requirements.txt`. A size of at least 64 is recommended, but 256 produces good results.

## References
I have a small write-up of this project [here](https://docs.google.com/document/d/1ecygfTbzJsfupnbxuLFPNrYEHTBqLmuRNlqzfNGl41A/edit?usp=sharing) if you want more details. Below are references for the fractal logic and some distance estimates that I used.
- [Into the Portal: Directable Fractal Self-Similarity](https://doi.org/10.1145/3641519.3657466)
- [A Shape Modulus for Fractal Geometry Generation](https://doi.org/10.1111/cgf.14905) 
- [Distance Estimated 3D Fractals (III): Folding Space](http://blog.hvidtfeldts.net/index.php/2011/08/distance-estimated-3d-fractals-iii-folding-space/)
- [Distance Estimated 3D Fractals (V): The Mandelbulb & Different DE Approximations](http://blog.hvidtfeldts.net/index.php/2011/09/distance-estimated-3d-fractals-v-the-mandelbulb-different-de-approximations/)
- [Distance Estimated 3D Fractals (VI): The Mandelbox](http://blog.hvidtfeldts.net/index.php/2011/11/distance-estimated-3d-fractals-vi-the-mandelbox/)
- [Revenge of the (Half-Eaten) Menger Sponge](http://www.fractalforums.com/ifs-iterated-function-systems/revenge-of-the-half-eaten-menger-sponge/15/)
- [Inigo Quilez's Signed Distance Functions](https://iquilezles.org/articles/distfunctions/)
- [Shader Fractals](https://github.com/pedrotrschneider/shader-fractals/tree/main)
- [Distance Estimator Compendium](https://jbaker.graphics/writings/DEC.html)