Skip to content

collidingScopes/curious-contours

Repository files navigation

Curious Contours

A procedural terrain generator that creates contour-style landscapes in real-time using 3D metaballs and marching squares algorithm.

Live demo: https://collidingscopes.github.io/curious-contours/

Features

  • Generate unique procedural terrain textures in real-time
  • Customize animation speed, complexity, colors, and more
  • Export your creations as images or videos
  • Completely free and open source (MIT license)

How it Works

Curious Contours uses 3D spheres (metaballs) that float around and combine with others based on distance. 2D cross-sections are drawn using a Marching Squares algorithm, producing a terrain contour aesthetic.

Usage

  • Use the controls to adjust settings
  • Click the randomize button (🎲) for new variations
  • Save your creations as images (📷) or videos (🎥)

Installation

  1. Clone the repository:

    git clone https://github.com/collidingScopes/curious-contours.git
    
  2. Navigate to the project directory:

    cd curious-contours
    
  3. Open index.html in your browser to run locally.

No build process or dependencies to install - it works right out of the box!

Tech Stack

  • Vanilla JavaScript
  • HTML5 Canvas
  • dat.GUI for controls
  • mp4-muxer for video export

Contributing

Contributions are welcome! Feel free to submit issues or pull requests.

License

This project is open source and licensed under the MIT License

Related Projects

Check out my other free and open-source projects:

Connect with the Developer

Donations

If you found this tool useful, feel free to buy me a coffee.

My name is Alan, and I enjoy building open source software for art, animation, games, and more. This would be much appreciated during late-night coding sessions!

Buy Me A Coffee

Releases

No releases published

Packages

 
 
 

Contributors