截图GIF - CaptureGif

函数简介

抓取指定区域(x1, y1, x2, y2)的动画并保存为GIF格式。此函数可以捕获指定区域的连续画面，生成动态GIF图片，适用于需要记录屏幕操作、动画效果等场景。当delay参数为0时，将只截取静态图片。

接口名称

CaptureGif

DLL调用

int CaptureGif(long ola, int x1, int y1, int x2, int y2, string file, int delay, int time)

参数定义:

  • ola (长整型数): OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
  • x1 (整型数): 区域的左上X坐标
  • y1 (整型数): 区域的左上Y坐标
  • x2 (整型数): 区域的右下X坐标
  • y2 (整型数): 区域的右下Y坐标
  • file (字符串): 保存的文件名，支持相对路径和绝对路径。如果使用相对路径，文件将保存在SetPath设置的目录下
  • delay (整型数): 动画帧间隔，单位毫秒。如果为0，表示只截取静态图片
  • time (整型数): 总共截取的时间，单位毫秒

示例:

// 截取整个客户区的动画，每100毫秒一帧，持续3秒
int result = CaptureGif(ola, 0, 0, 0, 0, "animation.gif", 100, 3000);
if (result == 1) {
    printf("GIF保存成功\n");
} else {
    printf("GIF保存失败\n");
}

// 截取指定区域的静态图片
int result = CaptureGif(ola, 100, 100, 300, 300, "static.gif", 0, 0);
if (result == 1) {
    printf("图片保存成功\n");
} else {
    printf("图片保存失败\n");
}

// 使用绝对路径保存
int result = CaptureGif(ola, 0, 0, 0, 0, "D:/screenshots/animation.gif", 100, 3000);
if (result == 1) {
    printf("GIF保存成功\n");
} else {
    printf("GIF保存失败\n");
}

COM调用

int CaptureGif(int x1, int y1, int x2, int y2, string file, int delay, int time)

参数定义:

  • x1 (整型数): 区域的左上X坐标
  • y1 (整型数): 区域的左上Y坐标
  • x2 (整型数): 区域的右下X坐标
  • y2 (整型数): 区域的右下Y坐标
  • file (字符串): 保存的文件名，支持相对路径和绝对路径。如果使用相对路径，文件将保存在SetPath设置的目录下
  • delay (整型数): 动画帧间隔，单位毫秒。如果为0，表示只截取静态图片
  • time (整型数): 总共截取的时间，单位毫秒

示例:

# 截取整个客户区的动画，每100毫秒一帧，持续3秒
result = ola.CaptureGif(0, 0, 0, 0, "animation.gif", 100, 3000)
if result == 1:
    messagebox("GIF保存成功")
else:
    messagebox("GIF保存失败")

# 截取指定区域的静态图片
result = ola.CaptureGif(100, 100, 300, 300, "static.gif", 0, 0)
if result == 1:
    messagebox("图片保存成功")
else:
    messagebox("图片保存失败")

# 使用绝对路径保存
result = ola.CaptureGif(0, 0, 0, 0, "D:/screenshots/animation.gif", 100, 3000)
if result == 1:
    messagebox("GIF保存成功")
else:
    messagebox("GIF保存失败")

返回值

整型数:

  • 0: 截图保存失败
  • 1: 截图保存成功

注意事项

  1. 坐标范围必须有效，否则可能导致截图失败
  2. 文件路径必须有效，且目标目录必须存在
  3. 如果文件已存在，将被覆盖
  4. 使用相对路径时，文件将保存在SetPath设置的目录下
  5. delay参数为0时，将只截取静态图片
  6. time参数必须大于等于0
  7. 建议delay参数不要设置太小，否则可能导致GIF文件过大
  8. 截图区域不要超出屏幕范围
  9. 建议使用绝对路径以避免路径解析问题
  10. 如果目标目录不存在，需要先创建目录
  11. 生成GIF时可能需要较大的内存空间
  12. 建议在录制动画前确保系统资源充足
Last Updated: