# Weather Live Wallpaper and Widget

## Project Overview
This project implements a dynamic wallpaper system based on weather conditions and time of day. Core features include: dynamically adjusting wallpaper colors (sky, mountains, sun/moon) based on time; adding visual effects such as rain, snow, clouds, and lightning based on real-time weather data; supporting local storage and management of weather data; and adaptive brightness adjustment based on time and weather conditions.

## Main Components

### Data Model
- **WeatherData.kt**: The data model for storing and transmitting weather information.
- **WeatherManager.kt**: The management class responsible for storing, retrieving, and updating weather data.

### Visual Effects
- **WeatherEffectRenderer.kt**: The weather effect rendering core, supporting effects such as rain, snow, and clouds. Features include: using VectorChildFinder to load SVG snowflakes (snow_new.xml), achieving a three-layer depth effect (supporting scaling, rotation, and transparency), and providing bitmap and circle drawing fallbacks. - **WallpaperColorHelper.kt**: A utility class that handles wallpaper color conversion and time-related color logic.

### Wallpaper Service and Settings
- **LiveWallpaperService.kt**: A live wallpaper service that integrates time and weather effects.
- **SettingsScreen.kt**: A wallpaper settings interface that includes functions for retrieving and saving weather data.

### Resource Files
Includes graphic resources such as raindrops (raindrop.xml), snowflakes (snowflake.xml, snow_new.xml), and clouds (cloud_1.xml, cloud_2.xml).

### Core Functionality Upgrade

### Celestial System Refactoring (v4.2): A realistic lunar moon phase system
#### 24-hour closed-loop celestial cycle
- **Solar Cycle**: Motion from 6 AM to 6 PM, gradually disappearing from 6 PM to 6:30 PM, hidden from 6:30 PM to 5:30 AM, and gradually appearing from 5:30 AM to 6 AM. - **Lunar Cycle**: Rise from 7 PM to 12 AM, remains constant from 12 AM to 2 AM, descends from 2 AM to 5 AM, fades from 5 AM to 5:30 AM, and hides from 5:30 AM to 7 PM.

#### Sun and Moon Structure
- **Three-Layer Sun Design**: Core (80dp, 100% opaque), middle (radius + 18dp, 30% transparent), outer (radius + 18dp again, 10% transparent). Color changes with time of day: sunrise (EC7D8C pink), daytime (FFFFFF white), sunset (EBE600 yellow), and hides at night.
- **Three-Layer Moon Design**: Moon Phase Center (eight dynamic phases, 100% transparent), middle circle (white, 40% transparent), outer circle (white, 15% transparent).

#### Moon Phase System
- **29.5-day true cycle**: Based on the new moon on January 11, 2024, corresponding lunar dates are: New Moon (lunar day 1) → Crescent Moon (3-6) → First Quarter Moon (7-8) → Waxing Gibbous Moon (11-14) → Full Moon (15-16) → Waning Gibbous Moon (18-21) → Last Quarter Moon (22-23) → Waning Moon (25-29).
- **SVG Rendering**: Uses eight independent SVG files (e.g., moon_new.xml and moon_full.xml) instead of complex path drawing, improving performance and visual quality.

#### Weather Limitations and Technical Implementation
- The sun and moon are only displayed in clear weather (WeatherType.CLEAR); they are hidden in other weather conditions.
- Based on the CelestialBodyManager architecture, this implements a symmetrical trajectory algorithm (sun in the upper left corner, moon in the upper right corner), unified time units, and accurate dp/px conversion.

### HSL Color System Refactoring (v2.0): Professional Color Management
#### Core Improvements
- **WeatherColorManager**: An independent color management class that uses HSL (hue, saturation, brightness) triples to uniformly manage colors and implement standard HSL-RGB conversion.
- **WeatherColorScheme**: Configures a complete color scheme for each weather type, supporting automatic day/night switching.

#### Specialized Weather Coloring
- **Snowy Weather**: Uses a light gray-blue hue during the day (background hsl (215, 14%, 79%), front mountain hsl (0, 0%, 94%), etc.), reducing the brightness to a dark gray-blue hue at night, with snowflakes remaining pure white (hsl (0, 0%, 100%)).
- **Rainy Weather**: Uses a light gray hue during the day (background hsl (173, 4%, 81%)), and a dark gray-blue hue at night (background hsl (220, 36%, 33%)). The colors of the front and back mountains, as well as the clouds, match the scene.

### Weather Effects Optimization

#### Snowflake Rendering (v1.3)
- SVG snowflake support: Pre-rendered as a bitmap cache, sized within 4-12dp, divided into three layers (foreground 8-12dp, midground 6-10dp, background 4-8dp), with animation linked to wind speed.
- Dedicated color scheme: Switches to a fixed HSL color scheme when snowing, ignoring 24-hour time fluctuations.

#### Rain Effects (v2.3)
- Optimized raindrop speed (15-35 pixels/frame), distribution (10x8 grid), and continuity (reset interval 10-50 pixels).
- Density grading: 60 for light rain, 90 for moderate rain, and 120 for heavy rain. Raindrop length (20-60 pixels), transparency, and width vary with intensity.

#### Lightning Effects (v2.5)
- SVG Vector Lightning: Load resources such as lightning8.xml, set to pure white using a color filter, and randomly rotate (-180° to +180°).
- Flash Effect: Increases full-screen brightness (25% peak) when lightning occurs. Use HSL brightness/saturation adjustments to create a gradient flash, and use a radial aperture to enhance the sense of depth.

### Precipitation Intensity and Debugging

#### Precipitation Intensity System (v2.4)
- Provides four intensity levels for rain, lightning, and snowfall: light, medium, heavy, and very heavy, reflecting specific precipitation amounts (e.g., light rain 2mm/h, moderate rain 8mm/h).
- Live Adjustment in the Floating Window: Intensity options are only displayed during precipitation events and take effect immediately.

#### Weather Debug Floating Window
- Features: Supports 11 weather types, 4 wind speed levels, real-time adjustment of sunrise/sunset modes, and switching between debugging mode (20-second check interval) and normal mode (30 minutes).
- Permission Management: Automatically guides you in granting floating window permissions. The interface uses Material Design 3.

## Extensibility
- Adding new weather types requires: adding the type to WeatherType, implementing rendering in WeatherEffectRenderer, adding resource files, and adding options to the floating window.
- Reserved AR special effects interface, supports custom effect intensity and color configuration, and is compatible with multiple devices.

This system combines astronomical accuracy with visual aesthetics, achieving a harmonious union of science and aesthetics through a 24-hour celestial cycle, a 29.5-day lunar phase cycle, dynamic color matching, and refined special effects.