O que Papercraft faz?
Um estilo, qualquer tema: um diorama pop-up visto de dentro. Cartões ilustrados, impressos com tinta em cartolina fibrosa e recortados, erguem-se de um chão impresso em dobradiças; sobem com um ligeiro excesso de oscilação e se estabilizam, projetam sombras quentes e suaves no chão e uns nos outros, e são vistos através de uma lente macro longa olhando para dentro do mundo, com uma estreita faixa de foco tilt-shift, como se um modelo de papel real fosse fotografado. Tudo aqui vem de um jogo de navegador enviado neste estilo e foi pago em rodadas de críticos e feedback de usuários; os números são pontos de partida que se sustentaram, não decoração. O briefing sempre vence sobre esses padrões.
Esta habilidade ensina um método: o que faz o estilo ser lido, como construir e imprimir qualquer peça, como iluminar, emoldurar, mover e verificar. Você escreve as peças do seu tema por conta própria. O código em assets/ é a infraestrutura que você pode importar (papel, cartões, a impressão em camadas, dobradiças, luz, lente, o campo de caminhada) mais exemplos trabalhados de um mundo rural para ler, nunca um catálogo de partes para montar um novo tema.
1. O modelo material (o que faz ser lido como papel)
Acertar estes em cada execução; cada linha diz por quê. Detalhes e mais números estão em references/look.md.
- Tudo é uma folha plana com espessura. A forma vem apenas de cortar, dobrar, camadas e encaixes, nunca de volume esculpido. Espessura do cartão 1,5-3 % da altura do herói. Um plano de espessura zero é lido como um adesivo, um grosso como placa de espuma.
- Fosco morto. Apenas luz difusa, terminador suave (wrap ~0,3), sem especular, sem reflexos, sem brilho. Pixels estourados abaixo de ~1 % (apenas pequenos painéis iluminados podem estourar). Qualquer brilho em ângulos rasos é lido como plástico ou molhado.
- Uma luz quente, baixa, sombras coloridas suaves. Luz principal do lado, 45-65 graus do eixo da câmera, 45-55 graus para cima (20-35 apenas na hora dourada e ao entardecer) e um pouco em direção à câmera, para que as sombras caiam para os lados e para trás, onde a câmera as vê (uma luz principal atrás da câmera esconde todas as sombras). Um preenchimento frontal a ~1/4-1/3 da luz principal mantém os cartões virados para a câmera de ficarem cinzentos. As sombras são nítidas onde um cartão encontra o chão e se alargam com a distância (penumbra ~0,2-0,3 x distância). Seu matiz vem do mundo: um âmbar quente em chão quente durante o dia, azul-lilás na neve, um verde-marinho profundo debaixo d'água, azul-marinho à noite; as peças permanecem quentes em cada uma. Nunca sombras cinzentas ou pretas, nunca um nevoeiro ou filtro colorido sobre o quadro. Cada peça em pé toca visivelmente o chão (escurecimento de contato); verifique as sombras apenas com a luz principal (
look.mdseção 8b). - Cada impressão é uma pequena colagem de papel em camadas. Dentro de cada silhueta encorpada: 3-5 tintas em 3+ etapas de valor mais um ornamento, dispostas como camadas cortadas de trás para frente em uma folha base com uma fibra discreta (nunca feltro ou tecido): estrutura primeiro (membros, camadas, fileiras de telhas, molduras, painéis, uma faixa), depois motivos ousados que CONTRASTAM com a base (folhas e pétalas, rebites e linhas de painel, escamas, recortes, listras, janelas). Cada camada projeta uma sombra quente curta e suave sobre o que está abaixo dela e mostra um lábio pálido e fino em suas bordas iluminadas; camadas grandes também têm uma borda cortada pálida e uniforme. Esse par é o que é lido como papel em camadas em vez de um preenchimento vetorial. Nada nu, fino ou pontiagudo: nenhuma linha abaixo de ~2-3 % da peça, motivos grandes e contáveis (as copas das árvores do exemplo rural carregam 15-25 folhas, cada uma ~1/7 da largura da copa). A ilustração impressa foi o maior salto de qualidade no projeto de origem (6 de 6 vitórias cegas sobre cartões simples). Kit:
P.layer,P.parts,drawnPiece,P.marks,P.rim. - A borda cortada. Uma linha fina marrom-escura bem na silhueta (a espessura do cartão e o contorno impresso, ~1,5-2,5 px na tela), e um destaque pálido logo dentro dela apenas nas bordas que enfrentam a luz. Nunca uma faixa pálida ou branca uniforme ao redor (um halo de adesivo), nunca brilhante, nunca rasgada. Uma dobra não é um corte: bases de dobradiça e uniões de painéis não têm borda. Nenhum cartão é visto de lado como uma lasca fina como uma faca.
- Uma lente macro olhando para dentro do mundo. Lente longa (FOV vertical de 24-32 graus), câmera 40-55 graus para baixo, e o chão impresso ultrapassa todas as bordas do quadro: nenhum horizonte, céu, fundo, borda de livro ou mesa à vista (a menos que o briefing seja literalmente um livro ou uma página dentro de uma UI). Uma faixa nítida cobrindo ~36-45 % da altura do quadro na cena do herói (medido:
measure.pyfocusHeight >= 0,35), desfoque crescendo acima e abaixo para 12-18 px de raio em 1080p (template 3D 18; template 2D 9 como um sigma deblur()do Canvas), impulsionado pela profundidade, bem como pela altura da tela. Grandes peças desfocadas sobrepondo a borda inferior vendem a escala em miniatura. - A própria paleta do briefing, construída do jeito do papel. Derive as cores do seu tema, humor e hora do dia (
palettes.mdseção 3): nunca os hexadecimais da cena de exemplo ou de uma paleta inicial como estão (testes cegos copiaram os telhados e verdes do exemplo para uma estação espacial). O que permanece: uma família principal que as peças carregam, sobre um chão claro e suave (~0,16-0,22 mais brilhante e ~0,16-0,25 menos saturado que os cartões), para que as peças carreguem a cor; cada peça tem um ou dois acentos que contrastam com sua base (rebites creme em uma cúpula enferrujada, folhas vermelhas em uma árvore laranja), nunca tom sobre tom. Sálvia em vez de verde de videogame, creme em vez de branco, tinta quente em vez de preto. Saturação média do quadro (HSV S) ~0,55-0,75. A gradação aquece as cores escritas (um chão verde-oliva cáqui se transforma em mostarda, um sálvia cinza-azulado): autor chãos e água um passo mais azuis e acinzentados e verifique o quadro (measure.py --palette). - Denso, encorpado, legível. Um mundo modelo completo, não adereços em uma planície: 100-250 peças de ~20 tipos (cartões em pé cuja base está no quadro) em grupos apertados de 4-8 peças DIFERENTES (o exemplo rural: uma árvore, cartões de arbusto, uma rocha, flores, um animal; um recife: uma cabeça de coral, esponjas, alga, um peixe; uma estação: caixas, uma linha de canos, uma lâmpada, um robô), no máximo ~3 adereços idênticos à vista, a faixa nítida cheia (
measure.pybarePct <= ~55) e o chão aberto principalmente fora dela (caminhos, água, algumas clareiras). O chão permanece plano: a altura vem de cartões paralelos aninhados (3-5 velas curvas escalonadas ~10-15 % em valor: colinas, dunas, bancos, montes) e afloramentos, nunca um bloco elevado de terreno (mechanisms.mdseção 8). O herói é a figura de escala (3,6 unidades em 3D, ~3,2 em 2D; um briefing só de lugar mantém algumas figuras), 6-10 % da altura do quadro: um pequeno MODELO de papel 3D (~10-20 cartões) que é legível de todos os lados e vira para enfrentar o caminho que anda (um cartão frontal com um cartão de perfil atrás para cada parte; pernas e braços em pivôs que balançam com a distância percorrida; uma inclinação para frente e um rolamento nas curvas), nunca um cartão plano, com um rosto legível, detalhe de fantasia, proporções encorpadas de brinquedo e cores que contrastam com o chão, de pé na faixa nítida (mechanisms.mdseção 12,motion.mdseção 8; oheroDollda cena de exemplo é um modelo). As peças são encorpadas em relação a ele (tamanhos e layout:worlds.mdseções 8-9); um herói que é em si mesmo um marco pode ocupar 25-35 % do quadro; marcos altos são planos em camadas cortados pela borda superior. - O que é andado, sob ou dentro é CONSTRUÍDO em 3D, nunca um plano em pé. Um cartão em pé é apenas para coisas vistas de frente e contornadas (árvores, arbustos, adereços, bichos, colinas de fundo distantes). A altura caminhável é uma construção ABERTA: uma ponte são rampas de deck com um painel de coroa (tábuas atravessadas) entre laterais de parapeito inclinadas para fora com um corte de arco; um cais, píer ou mirante é um deck de tábuas em postes (
platform()com uma face de postes, os cortes na base); escadas são degraus finos de tábua em duas longarinas escalonadas (subida <= ~1/8 da altura do herói); uma passarela é um deck de tábuas entre dois cartões laterais. Uma caixa sólida com uma face impressa (terrace()) apenas para alvenaria construída que o briefing nomeia (um muro de cais, um palco), nunca para terreno natural. Qualquer coisa que se entra é uma dobra de caixa com uma abertura; água, caminhos e campos são impressos na página. A lógica de caminhada lê a mesma construção: pés no deck; parapeitos, paredes e água param o herói (WalkField,mechanisms.mdseção 14). - O papel se move girando em torno de vincos. Sobe rápido com 8-15 % de excesso de oscilação e um tremor de 2-3 ciclos, ainda por ~1 s; cai mais suavemente com um pequeno tapa no chão; escalona partes em 0,05-0,1 s; nada escala, estica ou desvanece. Movimento contínuo (balanço ocioso, balanço de caminhada) permanece sutil: usuários cortaram o balanço solicitado por críticos em 2-3x.
- Som, se houver, é suave, baixo, abafado e esparso. Abas baseadas em ruído, uma por gesto, com pelo menos ~0,5 s de intervalo.
2. Antes do código: escreva a especificação do papel
Escreva este bloco em seu plano (ou um comentário no topo do arquivo principal) e preencha cada linha com números. Em seguida, audite-o: "eu escreveria esta especificação exata para qualquer solicitação semelhante?" Se sim, empurre a paleta, os motivos impressos e as silhuetas em direção ao próprio mundo do tema (uma cúpula de Marte recebe cartões de ferrugem e óxido com rebites impressos e linhas de painel; um recife recebe cartões de coral, alga e água verde-marinho com bordas recortadas; nunca os padrões rurais dos modelos). O que muda com o tema: silhuetas e motivos impressos, paleta e luz de humor, quais mecanismos constroem as formas, em que o herói anda, o layout e os sons próprios do mundo sob as abas de papel. O que nunca muda: leis 1-11.
SUBJECT o mundo e seu toque (o que apenas este projeto tem), e o que o leitor olha primeiro
STOCK papel por camada (cartolina / kraft / aquarela / papel construction / tissue / corrugado), quantidade de fibra
PALETTE 4-7 hex DERIVADOS deste briefing (palettes.md seção 3), com funções: chão claro/escuro, família principal,
2 acentos contrastantes, tinta, tom de sombra, névoa; nenhum copiado do exemplo
LIGHT cor da luz principal + direção (azimute / elevação graus), proporção de preenchimento frontal, tom de sombra, luz noturna / práticas
LENS fov, inclinação (40-55), faixa nítida % do quadro, desfoque máximo px@1080, o que sobrepõe a borda inferior
GROUND do que o chão deste mundo é feito e suas próprias características (placas de deck, ondulações de areia, montes de neve, musgo,
azulejos); água apenas se o briefing a tiver
LAYOUT a própria linha de liderança do tema (um beco, um corredor, uma corrente, uma pista de esqui, um canal), marcos, posição
do herói, grupos e clareiras, tipos de peças (15-25)
MOTION mecanismos usados, tempo de subida/descida, escalonamento, amplitude de balanço ocioso, comportamento da câmera
SOUND nenhum | abas + passos (+ música); níveis
BANNED as pistas (`look.md` seção 12) + qualquer coisa que esta peça não deve se tornar
QA os quadros / tamanhos que você irá capturar e o que cada um deve mostrar
3. Escolha o caminho de construção
Leia apenas o que a tarefa precisa, quando precisar (todos os arquivos em references/). O mínimo antes do primeiro quadro:
- Cena 3D ou jogo: comece de
assets/templates/popup-3d/(harness.jscomo está + seu próprioscene.js); leiathree-js.mdseções 1, 3, 5, 8,procedural-art.md0, 3, 4,mechanisms.md5, 7, 8, 12, 14,look.md5, 8b, 11 epalettes.md3. - Cena 2D, ilustração, side-scroller: comece de
assets/templates/popup-2d/(harness-2d.jscomo está + seu próprioscene.js); as mesmas leituras comweb-2d.mdseções 2-3 em vez dethree-js.md. - Página web ou UI de aplicativo, HUD, menus:
paper-ui.md,web-2d.mdseções 4-5 (CSS e SVG),palettes.md3. - Vídeo:
motion.mdseção 11, depois o caminho 2D ou 3D e sua capturastep(). - Um motor não-navegador (Godot, Unity, Unreal, Blender):
engines.md(notas de portabilidade, não testado) escripts/paper_textures.pypara arquivos de textura.
Em seguida, conforme surgirem perguntas:
| Pergunta | Leia | Kit |
|---|---|---|
| Suas peças: adereços, personagens, edifícios, criaturas, máquinas, plantas | procedural-art.md | printCard + P.layer / P.parts ou drawnPiece |
| Suas construções: cruzes, dobras de caixa, plataformas, planos em camadas, pontes, cais, escadas | mechanisms.md (14: chão construído) | hinge, crossCard, layeredCard, boxFold, platform, WalkField |
| Temporização, molas, fantoches, câmera | motion.md | FlapSpring, windSway, FixedClock (lib/paper-motion.js) |
| Mundos infinitos, uma câmera que segue o herói, composição | worlds.md | o preenchimento no exemplo scene.js |
| Cor; som e música | palettes.md; sound.md | assets/palettes.json; lib/paper-sound.js |
| Planejamento, medição, crítica, finalização | process.md | scripts/measure.py, scripts/ab_sheet.py |
Escreva suas próprias peças. assets/lib/ é a infraestrutura que todo projeto no estilo pode importar (para copiá-la para sua própria pasta: three-js.md seção 1, web-2d.md seção 3). Cada COISA em seu mundo (árvores ou coral, casas ou cúpulas, pontes ou guindastes, criaturas, o herói) você projeta para seu tema com as receitas nas referências. assets/examples/ e as cenas dos modelos são um mundo rural construído dessa forma: leia-os para ver como uma receita se torna código, nunca monte uma base de Marte ou um recife a partir dessas partes em uma nova paleta; substitua a cena, mantenha o harness. Uma construção de examples/built-ground.js (bridge, stairs, ramp; terrace apenas para alvenaria construída) pode ser importada quando adequada, com suas impressões através de paints; a maioria dos briefings precisa de suas próprias (um cais sobre palafitas, uma ponte de corda caindo, um guindaste), construída da mesma forma em platform, boxFold, makeCard e hinge.
4. Fluxo de trabalho
- Especificação e alvo. Preencha a especificação do papel. Se você tiver uma imagem alvo (fornecida pelo usuário ou gerada), meça-a com
scripts/measure.py; caso contrário, os números da especificação são o alvo. - Prove o material em um cartão de teste antes de construir conteúdo: um cartão impresso em pé sobre um chão impresso, sob a luz e lente finais (3D:
?test, assim que sua cena ramificar emH.flags.TEST:three-js.mdseção 1). Verifique: fosco, sombra de contato quente, a borda cortada (linha escura + destaque no lado iluminado), fibra
…
[truncado para tradução]