(Feat): Initial Commit.

include/renderer.h

@@ -0,0 +1,179 @@
+/**
+ * @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
+
+#include "config.h"
+#include "lighting.h"
+#include <stdbool.h>
+
+#ifdef __cplusplus
+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;
+} 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 */
+} RenderSettings;
+
+/**
+ * @brief Frame statistics
+ */
+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 */
+} FrameStats;
+
+/**
+ * @brief Initialize the renderer
+ * @return 0 on success, -1 on failure
+ */
+int renderer_init(void);
+
+/**
+ * @brief Cleanup renderer resources
+ */
+void renderer_cleanup(void);
+
+/**
+ * @brief Clear the screen and depth buffers
+ */
+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
+ */
+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
+ */
+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
+ */
+LightingSystem *renderer_get_lighting(void);
+
+/**
+ * @brief Hide terminal cursor
+ */
+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 */