gif_open

此函数创建一个空的 GIF 格式图像,准备添加数据。

调用该函数时,需要指定 GIF 的宽度和高度 (以像素为单位,除可用内存外,大小没有上限),函数将返回用于标识 GIF 的唯一 ID 值后续函数,或者如果 GIF 无法初始化 (例如,如果宽度 / 高度对于可用内存来说太大),它将返回 -1。您还可以指定一个可选参数来设置 GIF 的 " 清晰颜色"。这是一个 RGB 值 (无 alpha 分量),在添加任何内容之前会将 GIF 清除为该颜色。如果您没有提供明确的颜色参数,则将使用默认颜色黑色。

注意 使用此函数时,您必须调用 gif_save 来结束 GIF 的创建,然后再打开另一个文件进行录制 (因此对于每个 gif_open{ } 必须有一个随附的 gif_save)。

 

语法:

gif_open(width, height, [clear_colour]);

参数类型描述
widthReal要创建的 GIF 的宽度
heightReal要创建的 GIF 的高度
[clear_colour]Colour可选 清除 GIF 的颜色 (RGB)

 

返回:

GIF ID

 

例子:

if (save_gif == true)
{
    if (count == 0)
    {
        gif_image = gif_open(room_width, room_height);
    }
    else if (count < 30)
    {
        gif_add_surface(gif_image, application_surface, 6/100);
    }
    else
    {
        gif_save(gif_image, "GameCapture.gif");
        count = 0;
        save_gif = false;
    }
    count++;
}

以上代码将创建从应用程序表面获取的具有 30 帧的 GIF 图像文件,然后保存该文件。