名称: slack-gif-creator 描述: 为创建优化为Slack的动画GIF提供的知识和实用工具。提供约束条件、验证工具和动画概念。当用户请求为Slack制作动画GIF时使用，例如“为Slack制作一个X做Y的GIF”。 许可: 完整条款在LICENSE.txt中
Slack GIF 创建器
一个提供实用工具和知识的工具包，用于创建优化为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图像
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）
优化策略
仅当被要求使文件尺寸更小时，实施以下一些方法：
- 更少的帧 - 降低帧率（10而非20）或缩短时长
- 更少的颜色 -
num_colors=48而非128 - 更小的尺寸 - 128x128而非480x480
- 移除重复帧 -
remove_duplicates=True在save()中 - 表情符号模式 -
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