SkYrix-ops

🎡 sombrero - A Fun 3D Animated Surface

🚀 Getting Started

Welcome to sombrero! This is an animated ripple surface that provides a unique visual experience. You can see the mesh spin and tilt as it changes colors. Let’s walk you through the steps to get started.

📥 Download & Install

To download sombrero, visit the following link:

Download sombrero from Releases

Follow these steps to set it up on your computer:

1. Visit the download link above.
2. Choose the latest version from the list.
3. Click on the asset file to start the download.

📋 Requirements

Before you begin, here are a few things you need:

• Python 3.9 or higher: This is essential for running sombrero. If you don’t have Python installed, you can download it from the official Python website.

📂 Installation Steps

1. Install Python: Make sure Python is installed on your computer. You can check this by running python --version or python3 --version in your command prompt or terminal.
2. (Optional) Set Up a Virtual Environment:
   • It’s a good practice to use a virtual environment to manage dependencies.
   • Open your command prompt or terminal.
   • Navigate to the folder where you want to install sombrero.
   • Run these commands:

     python3 -m venv .venv
     source .venv/bin/activate  # Use `.\.venv\Scripts\activate` on Windows
     

3. Install Dependencies:
   • With the virtual environment active (if you created one), run:

     pip install -r requirements.txt
     

▶️ Running sombrero

To run the application, execute the following command in your terminal:

python3 main.py

• A window will open displaying the animated surface.
• Press Esc or close the window to exit the application.

🌌 How It Works

Here’s a brief overview of how sombrero creates its animation:

• The application generates a surface using a mathematical formula that involves a damped cosine wave.
• This wave adjusts based on your view and distance from the center, which creates a dynamic visual.
• Color coding is done with an HSV gradient, where low heights appear in blue and high heights appear in red.

🌐 Features

• 3D Animation: Enjoy a mesmerizing view as the surface spins and tilts.
• Interactive Visuals: Your perspective changes the display, creating an engaging experience.
• Simple Controls: Start and stop the animation with a quick keyboard command.

💬 Feedback

Your experience matters! If you have any questions or suggestions, feel free to reach out in the Issues section of the repository.

Thank you for using sombrero! We hope you enjoy the animated visuals as much as we enjoyed creating them.

Download sombrero from Releases