mlx_utils.c File Reference

#include "MLX42/MLX42_Int.h"

Include dependency graph for mlx_utils.c:

Go to the source code of this file.

Functions
bool	mlx_getline (char **out, size_t *out_size, FILE *file)
uint64_t	mlx_fnv_hash (char *str, size_t len)
bool	mlx_freen (int32_t count,...)
uint32_t	mlx_rgba_to_mono (uint32_t color)
double	mlx_get_time (void)
void	mlx_focus (mlx_t *mlx)

Function Documentation

mlx_fnv_hash()

uint64_t mlx_fnv_hash	(	char *	str,
		size_t	len
	)

String hashing algorithm using FNV-1a. Source: https://bit.ly/3JcRGHa

Parameters

str	The string to hash
len	The length of the string.

Returns

The hashed output.

Definition at line 68 of file mlx_utils.c.

{
    const uint64_t fnv_prime = 0x100000001b3;
    const uint64_t fnv_offset = 0xcbf29ce484222325;
    uint64_t hash = fnv_offset;
 
    for (size_t i = 0; i < len; i++)
    {
        hash ^= str[i];
        hash *= fnv_prime;
    }
    return (hash);
}

Here is the caller graph for this function:

mlx_focus()

void mlx_focus

(

mlx_t *

mlx

)

This function brings the specified window to front and sets input focus.

Do not use this function to steal focus from other applications unless you are certain that is what the user wants. Focus stealing can be extremely disruptive.

Parameters

[in]

mlx

The MLX instance handle.

Definition at line 126 of file mlx_utils.c.

{
    MLX_NONNULL(mlx);
 
    glfwFocusWindow(mlx->window);
}

mlx_freen()

bool mlx_freen	(	int32_t	count,
			...
	)

Utility function that lets you free x amount of pointers.

Parameters

count	The amount of args provided.
...	Any form of pointer.

Returns

False, this is simply for convenience when necessary.

Definition at line 89 of file mlx_utils.c.

{
    va_list args;
 
    va_start(args, count);
    for (int32_t i = 0; i < count; i++)
        free(va_arg(args, void*));
    va_end(args);
    return (false);
}

Here is the caller graph for this function:

mlx_get_time()

double mlx_get_time

(

void

)

Gets the elapsed time since MLX was initialized.

Returns

The amount of time elapsed in seconds.

Definition at line 121 of file mlx_utils.c.

{
    return (glfwGetTime());
}

mlx_getline()

bool mlx_getline	(	char **	out,
		size_t *	out_size,
		FILE *	file
	)

Function to read a file stream line by line, reusing the same output pointer. Since the same output pointer is reused it should only be freed once, either on success or failure. This function is made to be somewhat similar to getline. Getline can't be used directly since it's not standard and therefore not available on all platforms.

Parameters

out	Pointer to store output string.
out_size	Pointer to store output strings length.
file	File stream to read from.

Returns

True if line was read, false if EOF was reached or an error occurred.

Definition at line 28 of file mlx_utils.c.

{
    MLX_NONNULL(out);
    MLX_NONNULL(out_size);
    MLX_NONNULL(file);
 
    size_t size = 0;
    char* temp = NULL;
    static char BUFF[GETLINE_BUFF + 1]; // Add space for '\0'
 
    if (*out) *out[0] = '\0';
 
    while (fgets(BUFF, sizeof(BUFF), file))
    {
        size += strlen(BUFF);
        if (!(temp = realloc(*out, sizeof(char) * size + 1)))
            return (false);
        if (*out == NULL)
            memset(temp, '\0', size);
        temp[size] = '\0';
 
        *out = temp;
        *out_size = size;
 
        strncat(*out, BUFF, size);
        if (strrchr(BUFF, '\n'))
            return (true);
        memset(BUFF, '\0', sizeof(BUFF));
    }
    return (size);
}

Here is the caller graph for this function:

mlx_rgba_to_mono()

uint32_t mlx_rgba_to_mono

(

uint32_t

color

)

Converts an RGBA value to a monochrome/grayscale value. It does so using specific weights for each channel.

See also

https://goodcalculators.com/rgb-to-grayscale-conversion-calculator/

Parameters

color

The input RGBA value.

Returns

The rgba value converted to a grayscale color.

Definition at line 109 of file mlx_utils.c.

{
    const uint8_t r = 0.299f * ((color >> 24) & 0xFF);
    const uint8_t g = 0.587f * ((color >> 16) & 0xFF);
    const uint8_t b = 0.114f * ((color >> 8) & 0xFF);
    const uint8_t y = r + g + b;
 
    return (y << 24 | y << 16 | y << 8 | (color & 0xFF));
}

Here is the caller graph for this function: