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
- Personagens brinquedo, mundo real. Blocos com rostos desenhados; tudo ao redor fotorrealista, gasto e em pequena escala.
- 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.
- Altura do objeto. A câmera fica na altura da mesa, próxima, com foco raso e algo suave no primeiro plano.
- Inserts carregam a história. Mãos, objetos, adereços legíveis. Cerca de metade dos planos não mostra rostos.
- 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.
- 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:
| motor | por quadro | um rolo de 60 s (1.440 quadros, dois processos) | usar quando |
|---|---|---|---|
| Cycles, 160 amostras | 70-90 s | 28-36 h | um still herói, uma capa, um teaser curto |
| Cycles, 16 amostras, 40 % do tamanho | 11 s | 2 h (suave: uma prévia, não uma entrega) | verificando um corte |
| EEVEE, 64 amostras, tamanho total, apenas o conjunto do próprio plano carregado | 6-8 s | 1-1,5 h | a 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_lightsfaz 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_rangereivindica 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ágio | fazer | portão |
|---|---|---|
| 0. briefing | logline, 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 cenas | planos como linhas: tamanho, lente, o que se move, duração em batidas; um mestre por cena | PORTÃO S: regras em craft.md valem no papel |
| 2. mundo + elenco | cine_kit: sala/rua, adereços, lâmpadas, névoa; figuras K.Char | stills do mestre, descreva cada um em uma frase |
| 3. luz | chave de uma lâmpada visível, acentos, borda; still de cada câmera no tamanho de pré-visualização | PORTÃO L em cada still do plano (look_gate.py) |
| 4. performance | poses nas batidas (hit, pose, face, talk), movimentos de câmera, life() | uma folha de contatos é lida como a história sem som |
| 5. renderizar | render_range em 2-3 processos, PNG de 16 bits, pular existentes | contagem de quadros = duração do filme |
| 6. finalizar | finish.py (brilho, correção de cor, suavidade, vinheta, grão) + mixagem de som | PORTÃ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) | passar | referências |
|---|---|---|
| brilho mediano do quadro | 0,10-0,26 | 0,20, 0,17 |
| nível de sombra (percentil 10 do pixel) | abaixo de 0,09 | 0,06, 0,04 |
| nível claro (percentil 90 do pixel) | 0,22-0,56 | 0,46, 0,36 |
| pico (pixel mais brilhante) | acima de 0,85 | 0,91, 0,98 |
| piso preto | abaixo de 0,05 | 0,02, 0,02 |
| saturação | âmbar 0,10-0,30, noir 0,03-0,14 | 0,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
| necessidade | chamada |
|---|---|
| cena | setup(aspect, height, samples, preview), world(), room(), haze(size, loc, density) |
| superfícies | plastic (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) |
| formas | box (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âmpadas | pendant (cúpula visível + lâmpada + spot), neon (tubo + preenchimento correspondente), bokeh_lights, light(kind, loc, power, color=kelvin ou hex, target, size) |
| elenco | Char(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 fornecidos | Rigged("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ário | Avatar(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 |
| rostos | K.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 pintado | uma 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âmera | Cam(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 |
| visibilidade | K.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ção | beats(bpm) -> quadro da batida n; cut_list([(name, cam, beats), ...], bpm) vincula câmeras a marcadores e retorna os quadros de cada plano |
| saída | still(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:
scriptmaxxingpara 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). Executebeatgrid.pyna 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 deRoblox/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.pyconstrói na mesma escala de stud; Poly Haven (MCP para Blendersearch_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.cameranaquele 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...