https://github.com/bahaa-22/curious-contours
Generate contour terrain landscapes in real-time in the browser. Built with Javascript / HTML canvas
https://github.com/bahaa-22/curious-contours
browser canvas contour free generative-art html javascript landscape open-source procedural-generation real-time simple terrain video-game-development
Last synced: about 2 months ago
JSON representation
Generate contour terrain landscapes in real-time in the browser. Built with Javascript / HTML canvas
- Host: GitHub
- URL: https://github.com/bahaa-22/curious-contours
- Owner: bahaa-22
- Created: 2025-04-08T18:06:49.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-08T20:09:47.000Z (7 months ago)
- Last Synced: 2025-04-08T20:30:05.630Z (7 months ago)
- Topics: browser, canvas, contour, free, generative-art, html, javascript, landscape, open-source, procedural-generation, real-time, simple, terrain, video-game-development
- Language: JavaScript
- Size: 3.45 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Curious Contours 🌄
Welcome to **Curious Contours**! This project allows you to generate stunning contour terrain landscapes in real-time right in your browser. Built using JavaScript and HTML canvas, this open-source project aims to bring the beauty of generative art and procedural generation to everyone.
## Table of Contents
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [How It Works](#how-it-works)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)
## Features
- **Real-Time Generation**: Create landscapes on-the-fly without needing to refresh the page.
- **Interactive Canvas**: Use HTML canvas to render beautiful terrains.
- **Open Source**: Contribute and modify the project as you see fit.
- **Lightweight**: Minimal setup required, making it easy to get started.
- **Cross-Browser Compatibility**: Works seamlessly on all modern browsers.
- **Procedural Generation**: Use algorithms to create unique landscapes every time.
## Installation
To get started with Curious Contours, you can download the latest release from the [Releases section](https://github.com/bahaa-22/curious-contours/releases). After downloading, extract the files and open the `index.html` file in your web browser.
## Usage
1. Open the `index.html` file in your browser.
2. Interact with the canvas to generate new terrains.
3. Adjust parameters as needed to create your desired landscape.
## How It Works
Curious Contours uses algorithms to generate terrain based on mathematical functions. The main components of the project include:
- **JavaScript**: The core logic for generating the terrain and handling user interactions.
- **HTML Canvas**: The medium for rendering the generated landscapes.
- **Procedural Algorithms**: Techniques like Perlin noise or Simplex noise to create natural-looking terrains.
### Example Code Snippet
Here’s a brief look at how terrain generation works in the code:
```javascript
function generateTerrain() {
// Your terrain generation logic here
}
```
You can modify the `generateTerrain` function to experiment with different algorithms or parameters.
## Contributing
We welcome contributions! If you have ideas or improvements, please fork the repository and submit a pull request. Ensure your code follows the project's coding standards and is well-documented.
### Steps to Contribute
1. Fork the repository.
2. Create a new branch for your feature or fix.
3. Make your changes and commit them.
4. Push to your fork and submit a pull request.
## License
Curious Contours is licensed under the MIT License. Feel free to use, modify, and distribute the code as you see fit.
## Contact
For any questions or feedback, please reach out via GitHub issues or contact me directly. You can also visit the [Releases section](https://github.com/bahaa-22/curious-contours/releases) for updates and new features.
---
Thank you for checking out **Curious Contours**! We hope you enjoy creating beautiful terrains as much as we enjoyed building this project. Happy coding! 🌍