用途
Slack GIF Creator 是一个用于创建针对 Slack 优化的动画 GIF 的工具包，提供相关知识与实用工具。当用户请求制作适用于 Slack 的动画 GIF 时使用。
Slack 要求
尺寸：
- Emoji GIF：128x128（推荐）
- 消息 GIF：480x480
参数：
- FPS：10-30（越低文件越小）
- 颜色数：48-128（越少文件越小）
- 时长：Emoji GIF 保持在 3 秒以内
核心工作流
from core.gif_builder import GIFBuilder
from PIL import Image, ImageDraw
# 1. 创建 builder
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)
不要使用：Emoji 字体（跨平台不可靠），也不要假设本技能中存在预打包的图形。
让图形更好看
图形应显得精致且有创意，而非基础粗糙。做法如下：
- 使用更粗的线条：轮廓和线条始终设置 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("Ready!")
缓动函数（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）
优化策略
仅在被要求缩小文件大小时，实施以下若干方法：
- 减少帧数：降低 FPS（用 10 而非 20）或缩短时长
- 减少颜色：num_colors=48 而非 128
- 缩小尺寸：128x128 而非 480x480
- 移除重复帧：save() 中 remove_duplicates=True
- Emoji 模式：optimize_for_emoji=True 自动优化
# Emoji 的最大优化
builder.save(
'emoji.gif',
num_colors=48,
optimize_for_emoji=True,
remove_duplicates=True
)
理念
本技能提供：
- 知识：Slack 的要求与动画概念
- 工具：GIFBuilder、验证器、缓动函数
- 灵活性：使用 PIL 图元自行创建动画逻辑
本技能不提供：
- 固定的动画模板或预制函数
- Emoji 字体渲染（跨平台不可靠）
- 内置的预打包图形库
关于用户上传：本技能不包含预构建图形，但如果用户上传了图片，使用 PIL 加载并处理——根据其请求判断是直接使用还是仅作灵感参考。
要有创意！组合各种概念（弹跳+旋转、脉冲+滑动等），充分利用 PIL 的能力。
依赖
pip install pillow imageio numpy