miniRT/cub3d 프로젝트는 miniLibX 그래픽 라이브러리를 사용하여 구현합니다.
그러므로 먼저 miniLibX로 윈도우를 생성하고 간단한 도형을 그려보겠습니다.
miniLibX man 한글번역
#include "mlx/mlx.h"
typedef struct s_data
{
void *img;
char *addr;
int bits_per_pixel;
int line_length;
int endian;
} t_data;
void my_mlx_pixel_put(t_data *data, int x, int y, int color)
{
char *dst;
dst = data->addr + (y * data->line_length + x * (data->bits_per_pixel / 8));
*(unsigned int*)dst = color;
}
int main(void)
{
void *mlx;
void *mlx_win;
t_data img;
int i;
int j;
int k;
mlx = mlx_init();
mlx_win = mlx_new_window(mlx, 600, 400, "miniRT");
img.img = mlx_new_image(mlx, 600, 400);
img.addr = mlx_get_data_addr(img.img, &img.bits_per_pixel, &img.line_length, &img.endian);
for (i = 250, k = 99; i < 300; i++, k -= 2)
{
for (j = 150 + k; j < 250; j++)
my_mlx_pixel_put(&img, i, j, 0x0000FF00);
}
for (i = 300, k = 0; i < 350; i++, k += 2)
{
for (j = 150 + k; j < 250; j++)
my_mlx_pixel_put(&img, i, j, 0x0000FF00);
}
mlx_put_image_to_window(mlx, mlx_win, img.img, 0, 0);
mlx_loop(mlx);
return (0);
}1. 그래픽 시스템 연결
우선, 작성한 프로그램과 디스플레이 사이의 연결을 초기화하기 위해서 mlx_init() 함수를 호출합니다. 연결이 성공했다면 mlx_init() 는 void * 타입의 포인터를 연결 식별자로 반환합니다.(mlx man을 참고하세요.)
2. 윈도우 생성
mlx_new_window() 함수로 새로운 윈도우를 생성할 수 있습니다.
void * mlx_new_window(void *mlx_ptr, int size_x, int size_y, char *title);size_x, size_y 매개변수로 윈도우의 너비, 높이를 설정할 수 있습니다. title 매개변수는 타이틀 바의 제목입니다. mlx_new_window() 가 성공적으로 새로운 윈도우를 생성했다면 void * 타입의 포인터를 윈도우 식별자로 반환합니다.(mlx_new_window man을 참고하세요.)
3. 이미지 생성
mlx_new_image() 함수는 새로운 이미지를 생성합니다.
void *mlx_new_image(void *mlx_ptr, int width, int height);width, height 파라미터로 이미지의 크기를 설정합니다. mlx_init() 호출로 반환 받은 연결 식별자를 mlx_ptr 파라미터에 지정합니다. mlx_new_image() 가 성공적으로 새로운 이미지를 생성했다면 void * 타입의 식별자를 반환합니다.(mlx_new_image man을 참고하세요.)
4. 생성된 이미지의 정보 설정
mlx_get_data_addr() 함수는 생성된 이미지에 대한 정보를 설정합니다.
char *mlx_get_data_addr(void *img_ptr, int *bits_per_pixel, int *size_line, int *endian);img_ptr 파라미터로는 사용할 이미지를 지정합니다. mlx_get_data_addr() 는 이미지가 저장되어 있는 메모리의 시작 지점의 주소를 char * 형 포인터로 반환합니다. mlx_get_data_addr() 이 성공적으로 호출된다면 다음 세 개의 파라미터에 값이 지정됩니다. bits_per_pixel 파라미터에는 픽셀의 색상을 표현하는데 필요한 비트의 수가 입력됩니다.size_line 파라미터에는 이미지 한 줄을 저장하는데 필요한 바이트 수가 입력됩니다. endian 파라미터는 픽셀 색상의 저장 방식이 little endian(0 지정)인지 big endian(1 지정)인지를 나타냅니다.(mlx_new_image man을 참고하세요.)
5. 픽셀 색상 지정하기
mlx_get_data_addr() 함수로 생성한 이미지의 시작 주소를 가지고 있지만, 이 주소의 메모리는 색상 값이 없는 비어있는 상태입니다. 그러므로 이미지의 시작 주소를 이용하여 각 픽셀의 색상을 지정해 줍니다. 여기에서는 miniLibX의 mlx_pixel_put() 함수 대신에 동작을 모방하여 구현한 my_mlx_pixel_put() 함수를 사용했습니다. line_length는 이미지의 가로 한 줄의 바이트 수이므로 (line_length * y좌표) 로 해당 픽셀 좌표의 y좌표만큼의 메모리 주소로 일단 이동합니다. bits_per_pixel이 픽셀 당 비트의 수이므로 바이트 단위로 바꾸기 위해 8로 나누면 픽셀 당 바이트를 구할 수 있습니다. (bits_per_pixel / 8 * y좌표) 로 x좌표만큼의 메모리 주소를 이동하여 최종적으로 (x, y) 좌표의 픽셀의 메모리 주소를 구할 수 있습니다. (writing pixel to a image을 참고하세요.)
6. 이미지 그리기
마침내 mlx_put_image_to_window() 함수로 특정 윈도우 안에 이미지를 그릴 수 있습니다.
int mlx_put_image_to_window(void *mlx_ptr, void *win_ptr, void *img_ptr, int x, int y);앞의 파라미터 3개는 위에서 생성한 mlx, 윈도우, 이미지의 식별자를 지정합니다. x, y 파라미터로 윈도우 안에서 이미지의 좌표를 지정합니다.
7. 윈도우 생성
컴파일 후 실행파일을 실행하면 아래와 같은 삼각형 이미지를 확인할 수 있습니다.
참고
ft_libgfx AKA b_gfx overload
https://github.com/qst0/ft_libgfx#minilibx
42 Docs
https://harm-smits.github.io/42docs/libs/minilibx/getting_started.html
