digital_rain.h

Go to the documentation of this file.

#pragma once
 
#include <stddef.h>
#include <stdint.h>
#include <stdbool.h>
#include "../../common.h"
#include "../../platform/terminal.h"
 
/* ============================================================================
 * Types and Constants
 * ============================================================================ */
 
typedef struct {
  float time_offset;      
  float speed_multiplier; 
  float phase_offset;     
} digital_rain_column_t;
 
typedef struct {
  digital_rain_column_t *columns; 
  int num_columns;                
  int num_rows;                   
 
  // Effect parameters
  float time;             
  float fall_speed;       
  float raindrop_length;  
  float brightness_decay; 
  float animation_speed;  
 
  // Color parameters
  uint8_t color_r;         
  uint8_t color_g;         
  uint8_t color_b;         
  float cursor_brightness; 
  bool rainbow_mode;       
 
  // Frame tracking
  bool first_frame;           
  float *previous_brightness; 
} digital_rain_t;
 
/* ============================================================================
 * Configuration Constants
 * ============================================================================ */
 
#define DIGITAL_RAIN_DEFAULT_FALL_SPEED 3.0f
 
#define DIGITAL_RAIN_DEFAULT_RAINDROP_LENGTH 12.0f
 
#define DIGITAL_RAIN_DEFAULT_BRIGHTNESS_DECAY 0.1f
 
#define DIGITAL_RAIN_DEFAULT_ANIMATION_SPEED 1.0f
 
#define DIGITAL_RAIN_DEFAULT_COLOR_R 0
#define DIGITAL_RAIN_DEFAULT_COLOR_G 255
#define DIGITAL_RAIN_DEFAULT_COLOR_B 80
 
#define DIGITAL_RAIN_DEFAULT_CURSOR_BRIGHTNESS 2.0f
 
/* ============================================================================
 * Initialization and Cleanup
 * ============================================================================ */
 
digital_rain_t *digital_rain_init(int num_columns, int num_rows);
 
void digital_rain_destroy(digital_rain_t *rain);
 
/* ============================================================================
 * Effect Application
 * ============================================================================ */
 
char *digital_rain_apply(digital_rain_t *rain, const char *frame, float delta_time);
 
void digital_rain_reset(digital_rain_t *rain);
 
/* ============================================================================
 * Parameter Adjustment
 * ============================================================================ */
 
void digital_rain_set_fall_speed(digital_rain_t *rain, float speed);
 
void digital_rain_set_raindrop_length(digital_rain_t *rain, float length);
 
void digital_rain_set_color(digital_rain_t *rain, uint8_t r, uint8_t g, uint8_t b);
 
void digital_rain_set_color_from_filter(digital_rain_t *rain, color_filter_t filter);