https://github.com/hardcode3/fractals

c++ console app to create fractal images
https://github.com/hardcode3/fractals

Last synced: 7 months ago
JSON representation

c++ console app to create fractal images

• Host: GitHub
• URL: https://github.com/hardcode3/fractals
• Owner: Hardcode3
• License: mit
• Created: 2022-10-22T20:17:50.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2023-09-12T21:56:53.000Z (over 2 years ago)
• Last Synced: 2025-03-17T10:12:07.951Z (11 months ago)
• Language: C++
• Size: 1.74 MB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Mandelbrot and Julia fractal image generator

![mandelbrot_image_rgb](assets/color_sample.jpg)

![julia_image_rgb](assets/julia_sample.jpg)

![mandelbrot_bnw_image](assets/presentation.jpg)

![julia_symmetry_6_image](assets/julia_symmetry_6.jpg)

## Description

Fractals is a console application to create [fractal](https://en.wikipedia.org/wiki/Fractal) images.

It uses the .bmp format as output.

Compiles every time the program has to output an image.

Supports both [Mandelbrot](https://en.wikipedia.org/wiki/Mandelbrot_set) and [Julia](https://en.wikipedia.org/wiki/Julia_set) sets.

## Install

### Pre-compiled executable

If you do not want to compile windows binaries, you can use the [release executable](fractals.exe).

### Dependencies

There is no dependency.

BMP format can only be read on Windows, or either on [VsCode](https://code.visualstudio.com/) or [Atom editor](https://atom.io/) with macOS / linux.

This format has also the inconvenient to produce very heavy files on the disk (to enhance).

### CMake installation

Make sure you have CMake installed and inside the clone repo, type:

```

mkdir build

cd build

cmake ..

cmake --build .

```

or use CMake GUI and create your project with your favourite IDE.

or use the build-in scripts present in the [scripts folder](scripts).

## Usage

Simply launch the executable from the command line and some help will appear to guide you through the steps of creating julia or mandelbrot fractals.

![help](assets/help.png)

### Settings

The number of iterations controlls the detail of the fractal, see [assets/iteration_effect](assets/iteration_effect). It has an exponential cost on RAM and CPU usage and require mutliple gagabytes of memory to run a high resolution file with iterations per complex number. In addition the output file can also reach multiple gigabytes.

## Known bugs

- ...

## Improvements

Future versions will add:

- [ ] Add a smoothing option for the contour of the fractal

- [ ] Add a color options such as black and white, RGB and define color palets

- [ ] Parallelisation / concurrency to get faster computation speeds

- [ ] Optimize vectors by allocating them directly their definitive size

- [ ] Image compression

- [ ] Other, more common output formats

- [ ] Maybe a GUI, using ImGui ?

## Performances

- Bencharking is available in the main.cpp file