RainGen-RainGenerator README

README проекта с github.com/AhmadHassan-BTed/RainGen-RainGenerator. Одним файлом markdown: README.md.

GenRainpy - Rain and Thunderstorm Simulator

Python pygame License: MIT

A procedural rain and thunderstorm simulator built with Python, Pygame, NumPy, and SciPy. Features multi-layer parallax rainfall, particle splash physics, fractal branching lightning strikes, and real-time procedural audio synthesis.


Features


Installation

  1. Clone the repository:

    git clone https://github.com/azuletto/rain_generator.git
    cd rain_generator
    
  2. Install dependencies:

    pip install -r requirements.txt
    
  3. (Optional) Install in editable mode:

    pip install -e .
    

Usage

Run via the main launcher:

python thunderstorm_simulator.py

Or via module execution:

python -m rain_generator

CLI Arguments

python -m rain_generator --preset thunderstorm --fullscreen
python -m rain_generator --preset drizzle --mute -W 1280 -H 720

Available options:

Audio Track Export

Generate an ambient audio file of any custom length (e.g. 2 minutes of thunderstorm audio):

python thunderstorm_simulator.py --duration 120 --export thunderstorm_2m.wav --preset thunderstorm

You can also click the Export Audio button in the top HUD (or press G) while running the simulator to open the interactive generator dialog.


Controls & Keybindings

Key Action
F / F11 Toggle Fullscreen mode
Space Pause / Resume simulation
M Mute / Unmute audio
G Open Audio Track Generator dialog
H Toggle HUD visibility
L Trigger manual lightning bolt and thunder
1 - 5 Switch presets (1: Drizzle, 2: Steady, 3: Storm, 4: Gale, 5: Window)
S / Tab Open Settings and Audio Mixer dialog
? / / Open Keybindings help dialog
Esc Close open dialog or exit simulation

Testing

Run the test suite using pytest:

pytest

License

This project is licensed under the MIT License. See LICENSE for details.

RainGen-RainGenerator (AhmadHassan-BTed/RainGen-RainGenerator)

Ищем в базе…

Что это?GenRainpy — это симулятор дождя и грозы с процедурной генерацией, написанный на Python с использованием Pygame, NumPy и SciPy. Он создаёт дождь с эффектом параллакса, фрактальные молнии и в реальном времени синтезирует звуки дождя и грома.
Это настольное приложение или библиотека, которую я импортирую в свой проект?Это самостоятельное настольное приложение на Pygame, которое запускается через основной скрипт или выполнение модуля, а не библиотека для импорта.
Как это запустить?Клонируйте репозиторий, установите его зависимости, при желании установите пакет в editable-режиме, а затем запустите его через основной лаунчер или выполнение модуля.
Что нужно установить, чтобы это запустить?Python и библиотеки Pygame, NumPy и SciPy для симуляции и процедурного синтеза звука.
Нужно ли открывать окно интерфейса или можно просто сгенерировать аудиофайл?Интерфейс можно не открывать вовсе: флаг командной строки -o/--export сразу генерирует и экспортирует фоновую дорожку с дождём и громом, без открытия окна симулятора.
Какие погодные пресеты есть в комплекте?Пять встроенных пресетов — Drizzle, Steady Rain, Thunderstorm, Gale Storm и Window Rain, которые выбираются флагами командной строки или клавишами 1-5 внутри приложения.
Можно ли менять микс звука во время работы?Да, доступны живые ползунки громкости для Master, Thunder, Rain Ambiance, Droplet Patters и Wind в диалоге Settings and Audio Mixer (клавиша S или Tab).
Как создаётся эффект молнии?Молнии строятся фрактальным ветвлением по методу смещения середины (midpoint displacement) в сочетании с многофазным освещением неба и тряской камеры, а гром при желании задерживается, чтобы имитировать скорость звука.
Есть ли набор тестов?Да, в проекте есть тесты, которые можно запустить через pytest.
Какие есть похожие проекты?GDevelop, Terrain3D, iw4L, Infinite, hypoarena, flutter_scene, MonoGame, threejs-game-skills
Размер
13.7 MB
Звёзды
1.6K
Возраст
22 д
Коммиты · 90 дней