Slack GIF Creator

一个提供工具和知识，用于创建针对 Slack 优化的动画 GIF 的工具包。

Slack 要求

尺寸：

• 表情 GIF：128x128（推荐）
• 消息 GIF：480x480

参数：

• 帧率：10-30（越低文件越小）
• 颜色数：48-128（越少文件越小）
• 时长：表情 GIF 控制在 3 秒以内

核心工作流

from core.gif_builder import GIFBuilder
from PIL import Image, ImageDraw

# 1. 创建构建器
builder = GIFBuilder(width=128, height=128, fps=10)

# 2. 生成帧
for i in range(12):
    frame = Image.new('RGB', (128, 128), (240, 248, 255))
    draw = ImageDraw.Draw(frame)

    # 使用 PIL 原语绘制动画
    # （圆形、多边形、线条等）

    builder.add_frame(frame)

# 3. 优化保存
builder.save('output.gif', num_colors=48, optimize_for_emoji=True)

绘制图形

使用用户上传的图片

如果用户上传了图片，需判断他们想要：

• 直接使用它（例如："让这个动起来"、"拆分成帧"）
• 将其作为灵感（例如："做一个类似的"）

使用 PIL 加载和处理图片：

from PIL import Image

uploaded = Image.open('file.png')
# 直接使用，或仅作为颜色/风格的参考

从头绘制

从头绘制图形时，使用 PIL ImageDraw 原语：

from PIL import ImageDraw

draw = ImageDraw.Draw(frame)

# 圆形/椭圆形
draw.ellipse([x1, y1, x2, y2], fill=(r, g, b), outline=(r, g, b), width=3)

# 星形、三角形及任意多边形
points = [(x1, y1), (x2, y2), (x3, y3), ...]
draw.polygon(points, fill=(r, g, b), outline=(r, g, b), width=3)

# 线条
draw.line([(x1, y1), (x2, y2)], fill=(r, g, b), width=5)

# 矩形
draw.rectangle([x1, y1, x2, y2], fill=(r, g, b), outline=(r, g, b), width=3)

不要使用： 表情字体（跨平台不可靠）或假定此技能中存在预制的图形资源。

让图形看起来更好看

图形应呈现精致和创意感，而非基础水平。以下是一些方法：

使用更粗的线条 — 轮廓线和线条始终设置 width=2 或更高。细线条（width=1）看起来粗糙且不专业。

增加视觉深度：

• 使用渐变背景（create_gradient_background）
• 叠加多个形状增加复杂度（例如，大星形内含小星形）

让形状更有趣：

• 不要只画一个简单的圆形——添加高光、环纹或图案
• 星形可以添加光晕（在后面绘制更大、半透明的版本）
• 组合多个形状（星形 + 闪光、圆形 + 环纹）

注意配色：

• 使用鲜艳、互补的颜色
• 增加对比度（浅色形状上用深色轮廓，深色形状上用浅色轮廓）
• 考虑整体构图

对于复杂形状（心形、雪花等）：

• 使用多边形和椭圆的组合
• 仔细计算点以保证对称性
• 添加细节（心形可以加高光曲线，雪花可以有复杂的分支）

要有创意和细节！好的 Slack GIF 应该看起来精致，而不是像占位图形。

可用工具

GIFBuilder (core.gif_builder)

组装帧并针对 Slack 优化：

builder = GIFBuilder(width=128, height=128, fps=10)
builder.add_frame(frame)  # 添加 PIL Image
builder.add_frames(frames)  # 添加帧列表
builder.save('out.gif', num_colors=48, optimize_for_emoji=True, remove_duplicates=True)

验证器 (core.validators)

检查 GIF 是否符合 Slack 要求：

from core.validators import validate_gif, is_slack_ready

# 详细验证
passes, info = validate_gif('my.gif', is_emoji=True, verbose=True)

# 快速检查
if is_slack_ready('my.gif'):
    print("准备就绪！")

缓动函数 (core.easing)

实现平滑运动而非线性运动：

from core.easing import interpolate

# 进度从 0.0 到 1.0
t = i / (num_frames - 1)

# 应用缓动
y = interpolate(start=0, end=400, t=t, easing='ease_out')

# 可用缓动类型：linear, ease_in, ease_out, ease_in_out,
#           bounce_out, elastic_out, back_out

帧辅助函数 (core.frame_composer)

常用功能的便捷函数：

from core.frame_composer import (
    create_blank_frame,         # 纯色背景
    create_gradient_background,  # 垂直渐变
    draw_circle,                # 圆形辅助
    draw_text,                  # 简单文字渲染
    draw_star                   # 五角星
)

动画概念

抖动/震动

通过振荡偏移对象位置：

• 使用 math.sin() 或 math.cos() 配合帧索引
• 添加小幅随机变化以获得自然感
• 应用于 x 和/或 y 方向

脉冲/心跳

有节奏地缩放对象大小：

• 使用 math.sin(t * frequency * 2 * math.pi) 实现平滑脉冲
• 心跳：两次快速脉冲后暂停（调整正弦波）
• 缩放范围为基础大小的 0.8 到 1.2 倍

弹跳

对象下落并弹起：

• 使用 interpolate() 配合 easing='bounce_out' 模拟落地
• 使用 easing='ease_in' 模拟下落（加速）
• 每帧增加 y 方向速度模拟重力

旋转

绕中心旋转对象：

• PIL：image.rotate(angle, resample=Image.BICUBIC)
• 晃动效果：角度使用正弦波而非线性变化

淡入/淡出

逐渐出现或消失：

• 创建 RGBA 图像，调整 alpha 通道
• 或使用 Image.blend(image1, image2, alpha)
• 淡入：alpha 从 0 到 1
• 淡出：alpha 从 1 到 0

滑动

将对象从屏幕外移至指定位置：

• 起始位置：画面边界之外
• 结束位置：目标位置
• 使用 interpolate() 配合 easing='ease_out' 实现平滑停止
• 过冲效果：使用 easing='back_out'

缩放

通过缩放和定位实现缩放效果：

• 放大：从 0.1 倍缩放到 2.0 倍，裁剪中心
• 缩小：从 2.0 倍缩放到 1.0 倍
• 可添加运动模糊增强效果（PIL 滤镜）

爆炸/粒子爆发

创建向外辐射的粒子：

• 生成具有随机角度和速度的粒子
• 更新每个粒子：x += vx，y += vy
• 添加重力：vy += gravity_constant
• 随时间淡出粒子（降低 alpha）

优化策略

仅在要求减小文件大小时，实施以下几种方法：

1. 减少帧数 — 降低帧率（用 10 而非 20）或缩短时长
2. 减少颜色数 — 使用 num_colors=48 而非 128
3. 缩小尺寸 — 使用 128x128 而非 480x480
4. 去重 — 保存时设置 remove_duplicates=True
5. 表情模式 — optimize_for_emoji=True 自动优化

# 用于表情的最大优化
builder.save(
    'emoji.gif',
    num_colors=48,
    optimize_for_emoji=True,
    remove_duplicates=True
)

理念

此技能提供：

• 知识：Slack 的要求和动画概念
• 工具：GIFBuilder、验证器、缓动函数
• 灵活性：使用 PIL 原语创建动画逻辑

此技能不提供：

• 固定的动画模板或预制函数
• 表情字体渲染（跨平台不可靠）
• 内置在技能中的预制图形库

关于用户上传的说明：此技能不包含预制图形，但如果用户上传了图片，使用 PIL 加载和处理它——根据他们的请求判断是要直接使用还是仅作为灵感。

发挥创意！组合概念（弹跳 + 旋转、脉冲 + 滑动等），充分利用 PIL 的全部能力。

依赖

pip install pillow imageio numpy