📝 init_mlx

Initializes the MiniLibX (MLX) graphics system for the game.
This function establishes the MLX connection, creates the game window, initializes an image buffer for rendering, and sets up the main event hooks for input and window management.

⚙️ Parameters

Parameter	Type	Description
data	t_data*	Pointer to the main game data structure that holds all MLX-related objects.

🔁 Returns

Return value	Description
void	This function does not return a value. It modifies the data structure directly.

📖 Description

The init_mlx function prepares the graphical environment using the MiniLibX (MLX) library.
It is responsible for initializing the core graphics components and linking event handlers necessary for running the rendering loop of the game.

Initialization Steps

1. Validate the input pointer:
   Checks whether the data pointer is NULL. If it is, the function returns immediately to avoid segmentation faults.

2. Initialize MLX connection:
   Calls mlx_init() to establish a connection with the X server (or equivalent system).
   If the initialization fails, it calls exit_error(data, "Error creating the connection with mlx").

3. Create the game window:
   Uses mlx_new_window() to create a new window with predefined width and height (WIN_W, WIN_H), and sets the window title to "Cub3d".
   If window creation fails, the program exits via exit_error(data, "Error creating the window with mlx").

4. Create the image buffer:
   Calls mlx_new_image() to allocate a new image buffer for rendering frames.
   If this step fails, it triggers exit_error(data, "Error creating the image with mlx").

5. Set up event hooks:

   • KeyPress → Calls handle_keypress() when a key is pressed.
   • KeyRelease → Calls handle_keyrelease() when a key is released.
   • DestroyNotify → Calls press_x() when the user closes the window.

6. Set up the rendering loop:
   Uses mlx_loop_hook() to register render(), which will be called continuously to draw the game scene.

These steps ensure that the MLX system is fully initialized and ready to handle rendering and user input.

⚠️ Error Handling

Error Condition	Behavior
MLX connection fails	Calls exit_error(data, "Error creating the connection with mlx")
Window creation fails	Calls exit_error(data, "Error creating the window with mlx")
Image creation fails	Calls exit_error(data, "Error creating the image with mlx")

---

💡 Example Usage

t_data data;

init_mlx(&data);

// After this function call:
// - data.mlx.mlx is initialized (MLX connection)
// - data.mlx.win is created (game window)
// - data.mlx.img.img is ready (image buffer for rendering)
// Event hooks are registered for key input, key release, window closing, and rendering loop.