feat: integrate TUI module and apply professional refactoring
This commit is contained in:
@@ -1,10 +1,3 @@
|
||||
/**
|
||||
* @file renderer.h
|
||||
* @brief Advanced rendering engine for ASCII 3D Renderer
|
||||
* @author ASCII3D Project
|
||||
* @version 2.0.0
|
||||
*/
|
||||
|
||||
#ifndef ASCII3D_RENDERER_H
|
||||
#define ASCII3D_RENDERER_H
|
||||
|
||||
@@ -16,164 +9,73 @@
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief Rotation state for animation
|
||||
*/
|
||||
typedef struct RotationState {
|
||||
float angle_x;
|
||||
float angle_y;
|
||||
float angle_z;
|
||||
bool enable_x;
|
||||
bool enable_y;
|
||||
bool enable_z;
|
||||
float speed;
|
||||
float angle_x;
|
||||
float angle_y;
|
||||
float angle_z;
|
||||
bool enable_x;
|
||||
bool enable_y;
|
||||
bool enable_z;
|
||||
float speed;
|
||||
} RotationState;
|
||||
|
||||
/**
|
||||
* @brief Render settings structure
|
||||
*/
|
||||
typedef struct RenderSettings {
|
||||
RenderMode mode; /* Rendering mode */
|
||||
ColorMode color_mode; /* Color output mode */
|
||||
bool anti_aliasing; /* Enable AA */
|
||||
bool show_fps; /* Display FPS counter */
|
||||
bool auto_rotate; /* Auto rotation enabled */
|
||||
float quality; /* Quality multiplier (0.5 - 2.0) */
|
||||
int palette_index; /* Shading palette selection */
|
||||
Color base_color; /* Base color for colored modes */
|
||||
Color highlight_color; /* Highlight/specular color */
|
||||
RenderMode mode;
|
||||
ColorMode color_mode;
|
||||
bool anti_aliasing;
|
||||
bool show_fps;
|
||||
bool auto_rotate;
|
||||
float quality;
|
||||
int palette_index;
|
||||
Color base_color;
|
||||
Color highlight_color;
|
||||
} RenderSettings;
|
||||
|
||||
/**
|
||||
* @brief Frame statistics
|
||||
*/
|
||||
// Diagnostics profile updated each tick
|
||||
typedef struct FrameStats {
|
||||
double frame_time; /* Last frame time in ms */
|
||||
double fps; /* Current FPS */
|
||||
double avg_fps; /* Average FPS */
|
||||
int frame_count; /* Total frames rendered */
|
||||
int triangles; /* Triangles/voxels rendered */
|
||||
double frame_time;
|
||||
double fps;
|
||||
double avg_fps;
|
||||
int frame_count;
|
||||
int triangles;
|
||||
} FrameStats;
|
||||
|
||||
/**
|
||||
* @brief Initialize the renderer
|
||||
* @return 0 on success, -1 on failure
|
||||
*/
|
||||
// Core Engine Lifecycles
|
||||
int renderer_init(void);
|
||||
|
||||
/**
|
||||
* @brief Cleanup renderer resources
|
||||
*/
|
||||
void renderer_cleanup(void);
|
||||
|
||||
/**
|
||||
* @brief Clear the screen and depth buffers
|
||||
*/
|
||||
// Nulls out all raster buffers ready for drawing
|
||||
void renderer_clear(void);
|
||||
|
||||
/**
|
||||
* @brief Render a 3D text string
|
||||
* @param text Text to render (A-Z, 0-9)
|
||||
* @param rotation Current rotation state
|
||||
*/
|
||||
void renderer_draw_text(const char *text, const RotationState *rotation);
|
||||
|
||||
/**
|
||||
* @brief Render with full settings control
|
||||
* @param text Text to render
|
||||
* @param rotation Rotation state
|
||||
* @param settings Render settings
|
||||
*/
|
||||
void renderer_draw_text_ex(const char *text, const RotationState *rotation,
|
||||
const RenderSettings *settings);
|
||||
|
||||
/**
|
||||
* @brief Display the rendered frame to terminal
|
||||
*/
|
||||
// Flushes the rendering pipeline out to standard output
|
||||
void renderer_present(void);
|
||||
|
||||
/**
|
||||
* @brief Present with color support
|
||||
* @param settings Render settings for color mode
|
||||
*/
|
||||
void renderer_present_color(const RenderSettings *settings);
|
||||
|
||||
/**
|
||||
* @brief Update rotation angles based on time delta
|
||||
* @param rotation Rotation state to update
|
||||
* @param delta_time Time since last update in seconds
|
||||
*/
|
||||
void renderer_update_rotation(RotationState *rotation, double delta_time);
|
||||
|
||||
/**
|
||||
* @brief Create default rotation state
|
||||
* @return Default rotation state with Y-axis rotation enabled
|
||||
*/
|
||||
RotationState renderer_default_rotation(void);
|
||||
|
||||
/**
|
||||
* @brief Create default render settings
|
||||
* @return Default settings
|
||||
*/
|
||||
RenderSettings renderer_default_settings(void);
|
||||
|
||||
/**
|
||||
* @brief Set the render mode
|
||||
* @param mode New render mode
|
||||
*/
|
||||
// Dynamic rendering reconfiguration toggles
|
||||
void renderer_set_mode(RenderMode mode);
|
||||
|
||||
/**
|
||||
* @brief Set the color mode
|
||||
* @param mode New color mode
|
||||
*/
|
||||
void renderer_set_color_mode(ColorMode mode);
|
||||
|
||||
/**
|
||||
* @brief Get current frame statistics
|
||||
* @return Frame stats structure
|
||||
*/
|
||||
FrameStats renderer_get_stats(void);
|
||||
|
||||
/**
|
||||
* @brief Set the shading palette
|
||||
* @param palette_index 0=standard, 1=extended, 2=block, 3=minimal
|
||||
*/
|
||||
void renderer_set_palette(int palette_index);
|
||||
|
||||
/**
|
||||
* @brief Get the lighting system for modification
|
||||
* @return Pointer to lighting system
|
||||
*/
|
||||
FrameStats renderer_get_stats(void);
|
||||
LightingSystem *renderer_get_lighting(void);
|
||||
|
||||
/**
|
||||
* @brief Hide terminal cursor
|
||||
*/
|
||||
// Console visual hacks
|
||||
void renderer_hide_cursor(void);
|
||||
|
||||
/**
|
||||
* @brief Show terminal cursor
|
||||
*/
|
||||
void renderer_show_cursor(void);
|
||||
|
||||
/**
|
||||
* @brief Clear terminal screen
|
||||
*/
|
||||
void renderer_clear_terminal(void);
|
||||
|
||||
/**
|
||||
* @brief Set terminal to alternate screen buffer
|
||||
*/
|
||||
void renderer_enter_alternate_screen(void);
|
||||
|
||||
/**
|
||||
* @brief Restore terminal to main screen buffer
|
||||
*/
|
||||
void renderer_exit_alternate_screen(void);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif /* ASCII3D_RENDERER_H */
|
||||
#endif
|
||||
|
||||
Reference in New Issue
Block a user