Communitygithub.com

animação cinematográfica

Mostra a um agente como planejar, construir ou editar 'animação cinematográfica' para que o resultado concreto seja um roteiro ou script utilizável. O procedimento percorre A aparência em seis linhas, Motor: Cycles ou EEVEE, Pipeline. Use-o quando uma nova tarefa exigir essa arte.

O que é animação cinematográfica?

Esta skill capacita um agente de IA (como Claude Code, Cursor ou Codex) a criar animações cinematográficas de alta qualidade, focadas em narrativa visual com estilo escuro e personagens tipo brinquedo. Diferente de skills voltadas para jogos (como `robloxmaxxing`), esta é voltada para filmes: poucos personagens, salas escuras, uma única lâmpada e uma história compreensível mesmo sem som. A skill suporta os motores de renderização Cycles (aparência de referência) e EEVEE (mesma aparência em muito menos tempo), com regras específicas para cada um. O pipeline é dividido em estágios (Briefing, Planejamento de Cenas, Mundo/elenco, Iluminação, Performance, Renderização e Finalização), cada um com um portão de qualidade que deve ser aprovado antes de avançar. A skill também inclui uma biblioteca Python (`cine_kit`) para construção de cenas no Blender, suporte a personagens articulados, animação facial para sincronia labial em Indonésio (via `Avatar`), e ferramentas para edição baseada em batidas musicais, com um conjunto de referências técnicas e cinematográficas. O agente deve ler os arquivos `craft.md` e `look.md` uma vez por sessão, e `reference-films.md` antes de contestar qualquer número.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aaksa/cinematicanimation/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que animação cinematográfica faz?

A faixa premium ao lado de robloxmaxxing. Essa skill cria ativos de jogo e mundos explicativos claros e movimentados. Esta cria um filme: poucos personagens, salas escuras, uma lâmpada, uma história que se pode seguir com o som desligado, renderizada no Cycles (a aparência de referência) ou no EEVEE (a mesma aparência em uma fração do tempo, com as regras em "Motor" abaixo).

SKILL = esta pasta. B = /Applications/Blender.app/Contents/MacOS/Blender (5.1). BP = Python do Blender (/Applications/Blender.app/Contents/Resources/5.1/python/bin/python3.13), necessário apenas para beatgrid.py. Outros scripts: python3 -I.

Leia uma vez por sessão: references/craft.md (história, planos, edição, animação, som) e references/look.md (luz, materiais, lentes, correção de cor, tempo de renderização). references/reference-films.md é a evidência: ambos os filmes medidos plano a plano. Leia-o antes de discutir com um número neste arquivo.

A aparência em seis linhas

  1. Personagens brinquedo, mundo real. Blocos com rostos desenhados; tudo ao redor fotorrealista, gasto e em pequena escala.
  2. Escuro. Brilho mediano do quadro 0,10-0,26 da faixa total. Uma lâmpada visível é a chave. Sem luz de preenchimento, sem céu.
  3. Altura do objeto. A câmera fica na altura da mesa, próxima, com foco raso e algo suave no primeiro plano.
  4. Inserts carregam a história. Mãos, objetos, adereços legíveis. Cerca de metade dos planos não mostra rostos.
  5. Corte na batida. As durações dos planos são batidas inteiras ou meias batidas da música. A velocidade muda com a história.
  6. Silêncio é um plano. A música para uma vez, na virada. O final é um rosto ou um objeto, depois preto.

Motor: Cycles ou EEVEE

K.setup(..., engine="CYCLES" | "EEVEE"). Medido em um M4 a 1080x1920:

motorpor quadroum rolo de 60 s (1.440 quadros, dois processos)usar quando
Cycles, 160 amostras70-90 s28-36 hum still herói, uma capa, um teaser curto
Cycles, 16 amostras, 40 % do tamanho11 s2 h (suave: uma prévia, não uma entrega)verificando um corte
EEVEE, 64 amostras, tamanho total, apenas o conjunto do próprio plano carregado6-8 s1-1,5 ha entrega de qualquer coisa com mais de ~15 s

O EEVEE mantém a aparência (névoa, bokeh, plástico retroiluminado, AgX) se estas regras forem seguidas. Cada uma custou uma rodada no Negara Angin:

  • Chame K.eevee_lights(keep=(...)) depois que a cena for construída. Apenas as grandes luzes motivadas projetam sombras; muitas luzes de sombra pequenas transbordam o pool de sombras e piscam quadro a quadro.
  • Um painel de janela é alpha, não vidro. Vidro com transmissão no EEVEE refrata o espaço da tela (o que está atrás borra) e a transmissão mesclada renderiza preto. Use alpha ~0.14 do Principled, surface_render_method = "BLENDED", reduções de reflexão + relevo.
  • O EEVEE não pode focar através de um painel. A profundidade de campo lê a profundidade da superfície mais próxima, então tudo atrás do vidro desfoca como se estivesse no vidro. Mostre o painel apenas enquanto ele for o assunto (K.visible), esconda-o quando o foco passar por ele.
  • Vidro não projeta sombra (eevee_lights faz isso): o EEVEE o trata como opaco, então a luz através de uma janela ou jarro pararia.
  • Renderize cada plano apenas com seu próprio conjunto carregado (--sets): cada conjunto carregado é avaliado a cada quadro (campos instanciados, chuva). No Negara Angin, isso reduziu o tempo pela metade. Dois workers podem percorrer a mesma lista de tarefas; render_range reivindica quadros com arquivos de bloqueio.
  • O desfoque de movimento e o tamanho do tile de volume custam pouco; amostras acima de 64 não compram nada que um passe de grão não esconda.
  • Cycles tem cáusticas desligadas: uma luz atrás do vidro da janela nunca atinge a sala. Coloque a "luz da janela" dentro do painel.

Pipeline

estágiofazerportão
0. briefinglogline, o loop ou corrente, o objeto de aposta, paleta por localização, a faixa e seu BPM (beatgrid.py)PORTÃO B: cada linha do briefing é uma coisa observável
1. plano de cenasplanos como linhas: tamanho, lente, o que se move, duração em batidas; um mestre por cenaPORTÃO S: regras em craft.md valem no papel
2. mundo + elencocine_kit: sala/rua, adereços, lâmpadas, névoa; figuras K.Charstills do mestre, descreva cada um em uma frase
3. luzchave de uma lâmpada visível, acentos, borda; still de cada câmera no tamanho de pré-visualizaçãoPORTÃO L em cada still do plano (look_gate.py)
4. performanceposes nas batidas (hit, pose, face, talk), movimentos de câmera, life()uma folha de contatos é lida como a história sem som
5. renderizarrender_range em 2-3 processos, PNG de 16 bits, pular existentescontagem de quadros = duração do filme
6. finalizarfinish.py (brilho, correção de cor, suavidade, vinheta, grão) + mixagem de somPORTÃO L no filme, PORTÃO E (shotlist.py --bpm), -14 LUFS

Um portão que falha é corrigido em seu próprio estágio: um quadro claro é um problema de iluminação, nunca de correção de cor.

PORTÃO B - o briefing (um docstring no topo do script de construção)

  • Logline em uma frase com um desejo e um preço.
  • Forma: um loop que encurta (regra mostrada uma vez, depois repetida mais rápido) ou uma corrente (cada cena termina no objeto que inicia a próxima).
  • O objeto de aposta: uma coisinha com um rosto ou um número (uma foto, uma conta, um bilhete). Onde a câmera se aproxima dele.
  • Paleta por localização: uma cor de luz dominante, uma cor de sombra, um acento. Diferente para cada lugar.
  • Som: a faixa, seu BPM, onde a música entra, os 3-8 s onde ela para.
  • Final: a última imagem (um rosto ou um objeto) e a(s) uma ou duas palavras no preto depois dela.
  • Exclusões: o que este filme não deve parecer.

PORTÃO L - a aparência (números das referências; scripts/look_gate.py)

medida (0-1 da faixa total)passarreferências
brilho mediano do quadro0,10-0,260,20, 0,17
nível de sombra (percentil 10 do pixel)abaixo de 0,090,06, 0,04
nível claro (percentil 90 do pixel)0,22-0,560,46, 0,36
pico (pixel mais brilhante)acima de 0,850,91, 0,98
piso pretoabaixo de 0,050,02, 0,02
saturaçãoâmbar 0,10-0,30, noir 0,03-0,140,18, 0,07

Execute-o no still final de cada plano, depois no filme inteiro. Um insert claro único pode ADVERTIR; uma FALHA é corrigida. "Pico abaixo de 0,85" significa que não há realce real no quadro: coloque uma lâmpada, um brilho ou um tubo de neon onde a lente possa vê-lo.

PORTÃO E - a edição (scripts/shotlist.py film.mp4 --bpm N)

A duração de cada plano é um número inteiro ou meio de batidas. Plano médio 1-3,5 s. Os dois primeiros planos são os mais longos de sua cena. Nenhum dois planos consecutivos têm o mesmo tamanho e ângulo. Um trecho de 3-8 s não tem música. O filme termina dentro de um segundo do preto.

Construindo uma cena

"$B" -b --factory-startup -P build.py -- --out out --stills        # um still por plano, metade do tamanho, cerca de 10 s cada
python3 -I "$SKILL/scripts/finish.py" out/still_master.png --out out/fin_master.jpg --look amber
python3 -I "$SKILL/scripts/look_gate.py" out/fin_master.jpg --look amber
"$B" -b --factory-startup -P build.py -- --out out --frames --final &   # inicie-o 2-3 vezes: quadros que existem são pulados
python3 -I "$SKILL/scripts/finish.py" out/frames --out out/film.mp4 --look amber --audio mix.wav
import sys; sys.path.insert(0, SKILL + "/blender"); import cine_kit as K
K.setup(aspect="16:9", height=1080, preview=True)            # "9:16" para um reel; preview=False para a entrega
K.room(26, 22, 10); K.round_table("Table", 3.2, 2.9); K.pendant("Lamp", (0, 0, 6.5), power=2600, spot=125)
K.neon("Ring", (0, 10.8, 5.6), radius=1.7, color="#FFB020"); K.bokeh_lights("Shelf", ((-11, 10.2, 2.5), (11, 10.6, 8)))
K.light("TableBounce", "AREA", (0, 0, 3.05), 260, 2300, target=(0, 0, 9), size=4); K.haze((26, 22, 10), (0, 0, 5), 0.006)
hero = K.Char("Hero", skin="#F2C230", shirt="#20242C", hat="hair", at=(-4.5, 0, 0), yaw=90); hero.sit(1)
master = K.Cam("Master", (-2.2, -9.6, 3.1), (0.2, 0, 4.3), lens=28, stop=5.6)
cu = K.Cam("HeroCU", (-1.6, -6.2, 4.1), (-4.4, 0, 4.4), lens=50, stop=4, focus=hero.head)
S = K.cut_list([("master", master, 4), ("hero", cu, 2.5)], bpm=100); B = K.beats(100)
hero.hit(B(4.5), 3, head=(2, -60, -5)).face(B(4.5), "smirk"); cu.push(*S["hero"], 0.06).handheld(0.3); hero.life()

examples/standoff/build.py é a versão completa e testada (4 planos, 7,2 s): copie-o como ponto de partida para um novo filme.

cine_kit em uma tabela

necessidadechamada
cenasetup(aspect, height, samples, preview), world(), room(), haze(size, loc, density)
superfíciesplastic (pele de brinquedo, brilha quando retroiluminada), cloth(kind=weave/knit/leather), wood(planks=), brick, asphalt(wet=), flat (feltro, gesso, metal), glass, emit (neon, lâmpadas, telas)
formasbox (sempre chanfrada), cyl, torus(arc=), text (letras 3D, palavras em neon), paper (pôster / conta / cartão com linhas legíveis), round_table, chair
lâmpadaspendant (cúpula visível + lâmpada + spot), neon (tubo + preenchimento correspondente), bokeh_lights, light(kind, loc, power, color=kelvin ou hex, target, size)
elencoChar(name, skin, shirt, pants, hat=hair/cap/fedora/beanie): .pose(frame, arm_l=(fwd, out, twist), head=(nod, turn, tilt), torso, leg_l, at, yaw), .hit(frame, dur, ...) (snap + segurar), .face(frame, expr), .talk(f0, f1), .sit, .walk, .life()
personagens fornecidosRigged("bugis_man" / "bugis_woman" / path.blend, at, yaw): um modelo de personagem de um arquivo, na altura do Char, com os mesmos canais de pose que Char (arm_l, head, torso, leg_l, .hit, .sit, .walk, .life, .head). Rostos pintados: sem trocas, então a emoção vem da cabeça, braços e do corte. Um novo modelo de peça única é riggado uma vez com scripts/rig_block.py (meça o pescoço, quadril e borda do braço de fatias primeiro) e adicionado a K.CAST; o rig é rígido, exceto o pescoço, que neck_blend.py suaviza (veja "Costura do pescoço")
avatar do usuárioAvatar(at, yaw, pose): personagem Roblox riggado de Aksa (Roblox/blender/hero_face.blend) na altura do Char. .pose(frame, "table" / "stand" / "relax" / "reach" / "chin" / "hips", head=(nod, tilt, turn), arm_L=...), .hit, .sit, .life(), .head (alvo da câmera), .face.expr(f, eyes, brows, mouth) / .face.lipsync(words, vo_frame, fps=24) / .face.blink, depois .finish() uma vez. O usuário é o herói de seus próprios filmes: use Avatar para o protagonista, a menos que ele diga o contrário, Char para todos os outros
rostosK.EXPRESSIONS: neutro, sorriso, sorriso largo, irritado, grito, choque, triste, fechado, talk_a, talk_o, talk_m, lateral. Apenas trocas, nunca morphs
cantando em um rosto pintadouma vez: Blender -b cast/x.blend -P scripts/prep_mouth.py -- cast/x_sing.blend (encontra a boca pintada em uma renderização ortográfica frontal, desenha um atlas de boca de 10 formas em suas próprias cores sobre sua própria pele, coloca uma placa no rosto com skin para o osso da cabeça; célula 0 = a pintura, então em repouso é invisível; depois re-mescla o pescoço para que tudo sob a placa ande na cabeça). Na cena: K.Rigged(".../x_sing.blend").sing(words, f0, f1) com words = [{"word","start","end"}] de uma transcrição da faixa (tempos de palavra do faster-whisper). Vire a cabeça em direção à lente enquanto ela canta: um perfil esconde a boca
câmeraCam(name, loc, target, lens, stop, focus, roll): .at(frame, loc, target, focus, roll), .push(f0, f1, 0.06), .handheld(amount); Cam.distance_for(lens, height) = a que distância ficar para preencher o quadro com um assunto dessa altura (coloque câmeras próximas pelo tamanho, nunca pelo palpite); .clip_follow(f0, f1, subject) = near clip animado, para mergulhar sobre uma cabeça no telefone em suas mãos
visibilidadeK.visible(ob, [(f0, f1), ...]): visível na renderização apenas nesses intervalos; toca apenas a curva de ocultação (nunca defina cada curva de um objeto como CONSTANTE: seu movimento se torna degraus)
ediçãobeats(bpm) -> quadro da batida n; cut_list([(name, cam, beats), ...], bpm) vincula câmeras a marcadores e retorna os quadros de cada plano
saídastill(path, frame), render_range(dir, f0, f1)

stop é o número f como se a figura fosse um colecionável de 40 cm: 2-2.8 inserts, 4 rostos, 5.6-8 mestres. Menor = mais desfocado.

Compatibilidade com outras skills do usuário

  • Roteiro: scriptmaxxing para qualquer narração em Indonésio. Mantenha-o em poucas linhas; a referência com 13,7 M de visualizações não tem nenhuma.
  • Música e efeitos: ~/Ngonten/Maxxing/audio-lib (CC0). Execute beatgrid.py na faixa antes de planejar os planos.
  • O próprio avatar do usuário: K.Avatar() o carrega com seu rig facial (piscar, sobrancelhas, sincronia labial precisa em Indonésio de Roblox/blender/face/face_rig.py). K.Char.talk() é animação limitada apenas para outros falantes. Experimente: build.py -- --avatar --stills.
  • Adereços e cenários: robloxmaxxing/blender/rbx_kit.py constrói na mesma escala de stud; Poly Haven (MCP para Blender search_assets, ou o MCP 3d-assets) para texturas PBR CC0 e adereços do mundo real; Meshy para um adereço herói. Adereços realistas são o ponto.
  • Reels verticais: --aspect 9:16. Tudo aqui se mantém; mestres vão para 24-28 mm e a profundidade é empilhada ao longo do eixo da lente.

Regras duramente conquistadas para trabalho próximo (Negara Angin, 2026-11-21)

  • Meça, depois enquadre. Imprima as posições avaliadas da cabeça, das mãos e do adereço nos quadros do plano, então coloque a câmera com Cam.distance_for. Câmeras macro colocadas a olho acabaram a 0,5 studs de objetos que precisavam de 2.
  • Mãos do Roblox são blocos grandes. Um telefone segurado "nelas" está enterrado; segure adereços na frente das mãos ao longo da normal da tela.
  • Não parenteie um adereço a um osso e depois defina sua matriz mundial (ele pousa na origem). Mantenha o adereço fixo no mundo enquanto a pose é mantida, ou parenteie com o operador.
  • Stills ignoram os marcadores de corte. Um marcador vinculado a uma câmera sobrescreve scene.camera naquele quadro: limpe-os para stills.
  • O gancho é uma imagem e um evento. O quadro 1 já deve ser bonito (Negara Angin: uma gota de chuva escorrendo pela janela em macro extremo, as luzes da sala refratadas dentro dela), e a primeira batida deve mudá-lo (o kick muda o foco através da gota).
  • Transições são projetadas, não adicionadas: empurre através de uma tela para o mundo que ela mostra (renderize o primeiro quadro do próximo plano como a imagem da tela), saia girando de um plano e entre no próximo...

Habilidades Relacionadas