C语言学习记录20240620

文档置顶，得一直查，Allegro 文档：https://liballeg.org/a5docs/trunk/

习惯直接在 console 输出错误提示，Dev-C++ 新建项目的时候还是得选 Console Application，没有错误了再改 Windows Application 编译。

al_register_event_source 将事件源注册到事件队列，该函数会将指定的事件源与指定的事件队列建立联系。完整例子参考：https://github.com/liballeg/allegro5/blob/master/examples/ex_mouse_events.c

和 wxPython 直接调用不同，Allegro 所有用到的功能都需要手动初始化和销毁。做成固定模板也挺好，Dev-C++ 点击 File -> New -> Project Template，下次新建项目可以直接选择，删除模板可以直接在安装目录 Dev-Cpp/Templates/ 删除相关模板和包含的源文件。

本来是想练习 C 语言语法，但如果只是调用 Allegro 的 API 写游戏，基本看不出语法痕迹，选择读 Allegro 本身的源码会不会更好？ https://github.com/liballeg/allegro5/blob/master/include/allegro5/events.h

如果要在窗口初始时显示什么，最好写到事件循环前面，因为 al_wait_for_event 会一直等待，直到有事件触发出现在事件队列，而循环后面的代码暂时不会执行。

Allegro 使用双缓冲显示图像，调用 al_flip_display 可以交换前后缓冲区。但连续调用两次 al_flip_display，会发现窗口图像并没有任何变化，这是因为如果没有新的绘制操作，两个缓冲区不会进行交换。

Allegro 调用 al_create_builtin_font 使用内置字体，尺寸是固定的，需要不同字号还得另外加载字体。除了al_load_font，TTF 字体用 al_load_ttf_font 加载，相应的需要头文件 allegro5/allegro_ttf.h 和初始化插件 al_init_ttf_addon。

al_draw_text 必须选一个标志位，居左中右，显示出来的横向坐标正常，纵向坐标怎么都没法真正居中，先让它靠上显示吧。

#include <stdio.h>
#include <allegro5/allegro.h>
#include <allegro5/allegro_primitives.h>
#include <allegro5/allegro_font.h>
#include <allegro5/allegro_ttf.h>


const int WIDTH = 800;
const int HEIGHT = 600;

int main() {
    // 初始化 Allegro
    if (!al_init()) {
        fprintf(stderr, "Failed to initialize Allegro!\n");
        return -1;
    }

    // 安装键盘驱动，安装成功或已经安装过则返回 true
    if (!al_install_keyboard()) {
        fprintf(stderr, "Failed to initialize keyboard!\n");
        return -1;
    }

    // 初始化图形绘制插件 
    if (!al_init_primitives_addon()) {
        fprintf(stderr, "Failed to initialize primitives addon!\n");
        return -1;
    }
    
    // 初始化字体插件 
    if (!al_init_font_addon()) {
        fprintf(stderr, "Failed to initialize font addon!\n");
        return -1;
    }
    
    // 初始化 TTF 字体插件 
    if (!al_init_ttf_addon()) {
        fprintf(stderr, "Failed to initialize ttf font addon!\n");
        return -1;
    }

    // 创建指定宽高的窗口 
    ALLEGRO_DISPLAY *display = al_create_display(WIDTH, HEIGHT);
    if (!display) {
        fprintf(stderr, "Failed to create display!\n");
        return -1;
    }

    // 创建事件队列 
    ALLEGRO_EVENT_QUEUE *event_queue = al_create_event_queue();
    if (!event_queue) {
        fprintf(stderr, "Failed to create event queue!\n");
        al_destroy_display(display);
        return -1;
    }

    // 注册事件源到事件队列 
    al_register_event_source(event_queue, al_get_display_event_source(display));
    al_register_event_source(event_queue, al_get_keyboard_event_source());

    // 清除屏幕并填充黑色 
	al_clear_to_color(al_map_rgb(0, 0, 0));

    // 加载 TTF 字体，字号 40 
	ALLEGRO_FONT *font = al_load_ttf_font("arial.ttf", 40, 0);
    const char *text = "SmileBasic";
    // 获取指定字体的字符串外边框尺寸 
    int bbx, bby, bbw, bbh;
    al_get_text_dimensions(font, text, &bbx, &bby, &bbw, &bbh);
    // 居中绘制字符串，纵轴偏上显示 
	al_draw_text(font, al_map_rgb(255, 255, 255), WIDTH / 2.0, HEIGHT / 2.0 - bbh * 1.5, ALLEGRO_ALIGN_CENTRE, text);
	
	// 绘制红色矩形边框，四周设置边距 10 
	float padding = 10.0;
	float rect_x1 = (WIDTH - bbw) / 2.0 - padding;
	float rect_y1 = HEIGHT / 2.0 - bbh * 1.5 - padding;
	float rect_x2 = rect_x1 + bbw + padding * 2;
	float rect_y2 = rect_y1 + bbh * 1.5 + padding * 2;
	al_draw_rectangle(rect_x1, rect_y1, rect_x2, rect_y2, al_map_rgb(255, 0, 0), 2.0);
	
	// 交换缓冲区
    al_flip_display();
  
    bool done = false;
	while (!done) {
        ALLEGRO_EVENT event;
        // 等待从事件队列取出事件 
        al_wait_for_event(event_queue, &event);

        // 处理按键事件，这里响应 ESC 按键 
		if (event.type == ALLEGRO_EVENT_KEY_DOWN && event.keyboard.keycode == ALLEGRO_KEY_ESCAPE) {
        	done = true;
        }

        // 处理窗口事件，这里响应点击窗口右上角关闭 
		if (event.type == ALLEGRO_EVENT_DISPLAY_CLOSE) {
            done = true;
        }

    }

    // 销毁资源，释放内存 
    al_destroy_font(font);
    al_destroy_display(display);
    al_destroy_event_queue(event_queue);

    return 0;
}