criador-de-gifs-slack

Criador de GIFs para Slack

Um kit de ferramentas que fornece utilitários e conhecimento para criar GIFs animados otimizados para o Slack.

Requisitos do Slack

Dimensões:

• GIFs de Emoji: 128x128 (recomendado)
• GIFs de Mensagem: 480x480

Parâmetros:

• FPS: 10-30 (menor valor = arquivo menor)
• Cores: 48-128 (menos cores = arquivo menor)
• Duração: Mantenha abaixo de 3 segundos para GIFs de emoji

Fluxo de Trabalho Principal

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

# 1. Criar o builder
builder = GIFBuilder(width=128, height=128, fps=10)

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

    # Desenhe sua animação usando primitivas PIL
    # (círculos, polígonos, linhas, etc.)

    builder.add_frame(frame)

# 3. Salvar com otimização
builder.save('output.gif', num_colors=48, optimize_for_emoji=True)

Desenho de Gráficos

Trabalhando com Imagens Enviadas pelo Usuário

Se um usuário enviar uma imagem, considere se ele deseja:

• Usá-la diretamente (ex.: "anime isto", "divida isto em quadros")
• Usá-la como inspiração (ex.: "faça algo parecido com isto")

Carregue e trabalhe com imagens usando PIL:

from PIL import Image

uploaded = Image.open('file.png')
# Use diretamente, ou apenas como referência para cores/estilo

Desenhando do Zero

Ao desenhar gráficos do zero, use as primitivas ImageDraw do PIL:

from PIL import ImageDraw

draw = ImageDraw.Draw(frame)

# Círculos/ovais
draw.ellipse([x1, y1, x2, y2], fill=(r, g, b), outline=(r, g, b), width=3)

# Estrelas, triângulos, qualquer polígono
points = [(x1, y1), (x2, y2), (x3, y3), ...]
draw.polygon(points, fill=(r, g, b), outline=(r, g, b), width=3)

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

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

Não use: Fontes emoji (não confiáveis entre plataformas) ou assuma que gráficos pré-empacotados existam nesta skill.

Fazendo Gráficos Ficarem Bonitos

Os gráficos devem ter aparência polida e criativa, não básica. Veja como:

Use linhas mais grossas - Sempre defina width=2 ou maior para contornos e linhas. Linhas finas (width=1) parecem irregulares e amadoras.

Adicione profundidade visual:

• Use gradientes para fundos (create_gradient_background)
• Empilhe múltiplas formas para complexidade (ex.: uma estrela com uma estrela menor dentro)

Torne as formas mais interessantes:

• Não desenhe apenas um círculo simples – adicione realces, anéis ou padrões
• Estrelas podem ter brilho (desenhe versões maiores e semi-transparentes atrás)
• Combine múltiplas formas (estrelas + faíscas, círculos + anéis)

Preste atenção às cores:

• Use cores vibrantes e complementares
• Adicione contraste (contornos escuros em formas claras, contornos claros em formas escuras)
• Considere a composição geral

Para formas complexas (corações, flocos de neve, etc.):

• Use combinações de polígonos e elipses
• Calcule os pontos cuidadosamente para simetria
• Adicione detalhes (um coração pode ter uma curva de realce, flocos de neve têm ramos intrincados)

Seja criativo e detalhista! Um bom GIF para Slack deve ter aparência polida, não de gráficos placeholder.

Utilitários Disponíveis

GIFBuilder (core.gif_builder)

Monta quadros e otimiza para o Slack:

builder = GIFBuilder(width=128, height=128, fps=10)
builder.add_frame(frame)  # Adiciona quadro PIL
builder.add_frames(frames)  # Adiciona lista de quadros
builder.save('out.gif', num_colors=48, optimize_for_emoji=True, remove_duplicates=True)

Validadores (core.validators)

Verifique se o GIF atende aos requisitos do Slack:

from core.validators import validate_gif, is_slack_ready

# Validação detalhada
passa, info = validate_gif('my.gif', is_emoji=True, verbose=True)

# Verificação rápida
if is_slack_ready('my.gif'):
    print("Pronto!")

Funções de Easing (core.easing)

Movimento suave em vez de linear:

from core.easing import interpolate

# Progresso de 0.0 a 1.0
t = i / (num_frames - 1)

# Aplicar easing
y = interpolate(start=0, end=400, t=t, easing='ease_out')

# Disponíveis: linear, ease_in, ease_out, ease_in_out,
#           bounce_out, elastic_out, back_out

Auxiliares de Quadro (core.frame_composer)

Funções de conveniência para necessidades comuns:

from core.frame_composer import (
    create_blank_frame,         # Fundo de cor sólida
    create_gradient_background,  # Gradiente vertical
    draw_circle,                # Auxiliar para círculos
    draw_text,                  # Renderização de texto simples
    draw_star                   # Estrela de 5 pontas
)

Conceitos de Animação

Agitar/Vibrar

Desloque a posição do objeto com oscilação:

• Use math.sin() ou math.cos() com o índice do quadro
• Adicione pequenas variações aleatórias para um toque natural
• Aplique à posição x e/ou y

Pulsar/Batida Cardíaca

Escale o tamanho do objeto ritmicamente:

• Use math.sin(t * frequency * 2 * math.pi) para pulso suave
• Para batida cardíaca: dois pulsos rápidos e depois pausa (ajuste a onda senoidal)
• Escale entre 0.8 e 1.2 do tamanho base

Quicar

O objeto cai e quica:

• Use interpolate() com easing='bounce_out' para aterrissagem
• Use easing='ease_in' para queda (acelerando)
• Aplique gravidade aumentando a velocidade em y a cada quadro

Girar/Rodar

Rotacione o objeto em torno do centro:

• PIL: image.rotate(angle, resample=Image.BICUBIC)
• Para oscilação: use onda senoidal para o ângulo em vez de linear

Aparecer/Desaparecer Gradualmente

Apareça ou desapareça gradualmente:

• Crie imagem RGBA, ajuste o canal alfa
• Ou use Image.blend(image1, image2, alpha)
• Aparecer: alfa de 0 a 1
• Desaparecer: alfa de 1 a 0

Deslizar

Mova o objeto de fora da tela para a posição:

• Posição inicial: fora dos limites do quadro
• Posição final: local alvo
• Use interpolate() com easing='ease_out' para parada suave
• Para ultrapassagem: use easing='back_out'

Zoom

Escalone e posicione para efeito de zoom:

• Zoom in: escale de 0.1 a 2.0, corte o centro
• Zoom out: escale de 2.0 a 1.0
• Pode adicionar desfoque de movimento para drama (filtro PIL)

Explosão/Explosão de Partículas

Crie partículas irradiando para fora:

• Gere partículas com ângulos e velocidades aleatórios
• Atualize cada partícula: x += vx, y += vy
• Adicione gravidade: vy += gravity_constant
• Desapareça as partículas ao longo do tempo (reduza alfa)

Estratégias de Otimização

Apenas quando solicitado a reduzir o tamanho do arquivo, implemente alguns dos seguintes métodos:

1. Menos quadros - FPS mais baixo (10 em vez de 20) ou duração menor
2. Menos cores - num_colors=48 em vez de 128
3. Dimensões menores - 128x128 em vez de 480x480
4. Remover duplicatas - remove_duplicates=True em save()
5. Modo emoji - optimize_for_emoji=True otimiza automaticamente

# Otimização máxima para emoji
builder.save(
    'emoji.gif',
    num_colors=48,
    optimize_for_emoji=True,
    remove_duplicates=True
)

Filosofia

Esta skill fornece:

• Conhecimento: Requisitos do Slack e conceitos de animação
• Utilitários: GIFBuilder, validadores, funções de easing
• Flexibilidade: Crie a lógica de animação usando primitivas PIL

Ela NÃO fornece:

• Modelos de animação rígidos ou funções pré-fabricadas
• Renderização de fontes emoji (não confiável entre plataformas)
• Uma biblioteca de gráficos pré-empacotados embutidos na skill

Nota sobre uploads de usuários: Esta skill não inclui gráficos pré-construídos, mas se um usuário enviar uma imagem, use PIL para carregá-la e trabalhar com ela – interprete baseado na solicitação se eles desejam usá-la diretamente ou apenas como inspiração.

Seja criativo! Combine conceitos (quicando + girando, pulsando + deslizando, etc.) e use todas as capacidades do PIL.

Dependências

pip install pillow imageio numpy