INSTRUÇÕES PARA A IA: PRIMEIRO BONECO 3D Você vai montar, no Blender do meu computador, um boneco 3D de brinquedo e salvar uma foto dele em pé. Siga esta receita até o fim, sozinho, sem me pedir para mexer no Blender, a não ser no "Modo B" abaixo. Fale comigo em português simples: eu não sei 3D nem programação. 1. REGRAS - Monte só o que está descrito aqui. Não baixe nada da internet, não instale nada e não abra, mude ou apague arquivos fora da pasta `boneco-3d`. - Antes de limpar a cena, confira o que existe nela. Se houver algo além do cubo, da câmera e da luz que vêm num arquivo novo (objetos chamados "Cube", "Camera" e "Light"), pare e me pergunte: pode ser um trabalho meu. Se só houver esses três, pode apagá-los sem me perguntar: colar esta receita já é a minha autorização para isso. - No fim, me diga o caminho completo da imagem e mostre o resultado, se você conseguir vê-lo. 2. QUAL MODO USAR - Modo A (você tem ferramentas do Blender): se você tiver uma ferramenta que executa código Python no Blender (por exemplo `execute_blender_code`, do conector "Blender" do Blender Lab), use-a. Rode o código em poucos blocos (conferir a cena; limpeza; boneco; fundo, luz e câmera; foto e salvamento) e confira o resultado de cada bloco antes de seguir. Se tiver uma ferramenta de captura de tela ou de miniatura, use-a no fim para olhar o boneco e corrigir o enquadramento. - Modo B (você não tem essas ferramentas): escreva um único script Python completo, que faz tudo de uma vez. Depois me explique, em 4 passos curtos: abrir a aba Scripting do Blender, clicar em New, colar o script e clicar em Run Script. Se eu colar uma mensagem de erro, corrija e mande o script inteiro de novo. 3. A PASTA Crie a pasta `boneco-3d` dentro da pasta do usuário. Em Python: os.path.join(os.path.expanduser("~"), "boneco-3d") Use sempre o caminho completo. Os arquivos finais são `boneco.png` e `boneco.blend`. 4. O ESTILO Boneco de brinquedo, como um bonequinho de plástico de estúdio de animação: - formas simples (esferas, cápsulas e caixas de cantos bem arredondados); - plástico liso e brilhante, em cores fortes; - rosto pequeno e fofo, com olhos pretos brilhantes, bochechas rosadas e um sorriso; - foto vertical, com luz suave de estúdio e fundo liso. Nada de pessoa real, marca, texto ou logotipo. 5. MEDIDAS (EM METROS) O eixo Z aponta para cima. O boneco fica de frente para o -Y, onde está a câmera. O chão é Z = 0, e o boneco tem uns 1,75 m. Todas as peças são objetos separados, com sombreamento suave (`use_smooth = True`). Tamanhos de caixa e escalas vêm sempre na ordem X × Y × Z (largura × profundidade × altura); posições, como (x; y; z). As peças: - PERNAS (2). Forma: cápsula (cilindro + uma esfera em cada ponta). Tamanho: raio 0,075. Posição: de (±0,11; 0; 0,14) até (±0,11; 0; 0,70). Material: Calça. - TÊNIS (2). Forma: caixa de cantos arredondados (modificador Bevel, largura 0,04, 6 segmentos). Tamanho: 0,17 × 0,26 × 0,10. Posição: centro (±0,11; -0,04; 0,06). Material: Tênis. - TRONCO. Forma: caixa de cantos arredondados (Bevel 0,10, 6 segmentos). Tamanho: 0,46 × 0,30 × 0,52. Posição: centro (0; 0; 0,95). Material: Camisa. - PESCOÇO. Forma: cilindro. Tamanho: raio 0,07, altura 0,10. Posição: centro (0; 0; 1,24). Material: Pele. - CABEÇA. Forma: esfera. Tamanho: raio R = 0,24. Posição: centro (0; 0; 1,50). Material: Pele. - CABELO. Forma: esfera achatada. Tamanho: escala (0,252; 0,250; 0,235). Posição: centro (0; +0,03; 1,55), um pouco para trás e para cima, deixando o rosto livre. Material: Cabelo. - OLHOS (2). Forma: esfera achatada. Tamanho: escala (0,026; 0,014; 0,031). Posição: x = ±0,082, z = 1,52, colados na frente da cabeça (ver "Como colar", abaixo). Material: Olho. - BRILHO DOS OLHOS (2). Forma: esfera. Tamanho: raio 0,008. Posição: ver "Detalhes de lado", abaixo. Material: Brilho. - BOCHECHAS (2). Forma: esfera achatada. Tamanho: escala (0,038; 0,012; 0,026). Posição: x = ±0,13, z = 1,44, na frente da cabeça, giradas em Z para acompanhar a curva do rosto (ver abaixo). Material: Bochecha. - NARIZ. Forma: esfera achatada. Tamanho: escala (0,026; 0,024; 0,024). Posição: (0; -0,235; 1,47). Material: Pele. - BOCA. Forma: a parte de baixo de um toro (rosquinha). Tamanho: raio maior 0,048, tubo 0,0085. Posição: centro (0; -0,213; 1,40), toro girado 116 graus em X (90 graus para ficar de pé, mais 26 graus para deitar junto com o rosto, que é curvo, e o sorriso não ficar flutuando); apague os vértices com z acima de 1,385 (um pouco menos da metade fica: é o sorriso). Material: Boca. - BRAÇO QUE ACENA. Forma: cápsula do ombro ao cotovelo + cápsula do cotovelo à mão + esfera da mão. Tamanho: braço, raio 0,058; antebraço, raio 0,052; mão, raio 0,072. Posição: ombro (-0,29; 0; 1,13) -> cotovelo (-0,49; 0; 1,27) -> punho (-0,51; 0; 1,50); o centro da mão fica 0,04 além do punho, na direção cotovelo -> punho. Material: braço, Camisa; antebraço e mão, Pele. - BRAÇO SOLTO. Forma e tamanho: iguais aos do braço que acena. Posição: ombro (0,29; 0; 1,13) -> cotovelo (0,34; 0; 0,89) -> punho (0,37; -0,03; 0,67); o centro da mão fica 0,04 além do punho, na direção cotovelo -> punho. Material: braço, Camisa; antebraço e mão, Pele. Como colar algo na frente da cabeça: para um ponto na altura z e na posição x, a frente da esfera fica em y = -sqrt(R^2 - x^2 - (z - 1,50)^2) Use esse y mais 0,01 nos olhos e mais 0,012 nas bochechas: em cima do valor negativo, isso deixa a peça só um pouquinho dentro da pele, com a frente aparecendo, como uma peça encaixada. (No nosso teste ficou assim. Se os olhos sumirem, troque por "menos 0,01".) Detalhes de lado: as bochechas giram +33 graus em Z na bochecha de x positivo e -33 graus na de x negativo. O brilho fica +0,007 em X (nos dois olhos, o mesmo lado, como se a luz viesse de um lado só), -0,012 em Y e +0,012 em Z, a partir do centro de cada olho. Cápsula entre dois pontos: cilindro com o comprimento da distância entre os pontos, posto no meio deles e girado para apontar de um ao outro. Como rotação em quatérnio, use Vector((0,0,1)).rotation_difference(direção) Ponha uma esfera do mesmo raio em cada ponta. Esferas e cápsulas com pelo menos 48 segmentos, ou com o modificador Subdivision Surface nível 1, para não ficarem facetadas. A boca (toro) com 64 × 16 segmentos (64 ao longo do anel, 16 em volta do tubo). Num close do rosto, a borda entre cabelo e testa e as pontas do sorriso ficam um pouco serrilhadas; na foto de corpo inteiro isso não aparece, então não precisa corrigir. "Esfera achatada" com "escala (a; b; c)" quer dizer: esfera de raio 1 com essa escala, ou seja, semi-eixos a, b e c em metros. Nos cotovelos ficam duas esferas (a da manga, amarela, e a do antebraço, cor de pele): é de propósito, a amarela vira o punho da manga. 6. MATERIAIS (PRINCIPLED BSDF) Cores em RGB de 0 a 1, como o Blender usa. Em todos, menos o Brilho e o Fundo: Coat Weight 0,5 e Coat Roughness 0,08, que dão o verniz de plástico. Na lista, "Coat" quer dizer Coat Weight; o Coat Roughness fica sempre 0,08. O Brilho não tem verniz e o Fundo tem Coat Weight 0. - Camisa (amarela): Base Color (0,95; 0,65; 0,10); Roughness 0,32. - Calça (azul): Base Color (0,05; 0,12; 0,55); Roughness 0,32. - Pele: Base Color (0,86; 0,56; 0,38); Roughness 0,32. - Cabelo (castanho escuro): Base Color (0,06; 0,035; 0,025); Roughness 0,30; Coat 0,6. - Olho (preto): Base Color (0,01; 0,01; 0,012); Roughness 0,12; Coat 1,0. - Brilho (branco): Base Color (1; 1; 1); Roughness 0,32; Emission Color branco, Emission Strength 3. - Bochecha (rosa): Base Color (1,0; 0,33; 0,38); Roughness 0,40; Coat 0,2. - Boca (vermelha): Base Color (0,75; 0,08; 0,06); Roughness 0,35. - Tênis (branco): Base Color (0,92; 0,92; 0,95); Roughness 0,35; Coat 0,3. - Fundo (azul-claro): Base Color (0,52; 0,77; 0,81); Roughness 0,60; Coat 0. 7. FUNDO DE ESTÚDIO Um "fundo infinito": chão e parede numa peça só, com a dobra arredondada, como nos estúdios de foto, para não aparecer a linha do horizonte. Monte uma malha a partir de um perfil (Y, Z) repetido em X = -8 e X = +8: - reta no chão de (Y = -8; Z = 0) até (Y = 1,5; Z = 0); - quarto de círculo de raio 2 de (1,5; 0) até (3,5; 2), com 12 passos: Y = 1,5 + 2·sen(a) e Z = 2 - 2·cos(a), com a de 0 a 90 graus; - reta subindo de (3,5; 2) até (3,5; 10). Faces ligando cada par de pontos vizinhos, sombreamento suave, material Fundo. Mundo (World): crie um mundo novo, ponha na cena e, no nó "Background", use cor igual à do material Fundo e força (Strength) 0,3. 8. LUZ DE ESTÚDIO (TRÊS LUZES DE ÁREA) Todas apontadas para o peito do boneco, o ponto (0; 0; 1,0). - Principal: tipo Area; força 550 W; posição (-2,2; -2,6; 3,0); cor (1,0; 0,92; 0,82); tamanho 2,5. - Preenchimento: tipo Area; força 160 W; posição (2,6; -2,2; 1,6); cor (0,85; 0,90; 1,0); tamanho 4,0. - Contraluz: tipo Area; força 300 W; posição (0,8; 2,4; 2,6); cor (1,0; 0,80; 0,60); tamanho 2,0. "Tamanho" é o `size` da luz de área. Para apontar: (alvo - posição).to_track_quat('-Z', 'Y').to_euler() 9. CÂMERA E FOTO - Câmera com lente de 50 mm em (0; -3,7; 1,2), apontada para (0; 0; 0,98) do mesmo jeito que as luzes. Ela é a câmera da cena. - Imagem de 1080 × 1920 (em pé), 100%, em PNG. - Motor de render Eevee: `BLENDER_EEVEE`; se der erro, use `BLENDER_EEVEE_NEXT`. 32 amostras (`scene.eevee.taa_render_samples`). - Cores: View Transform `Khronos PBR Neutral`; se não existir, use `AgX`. - O boneco inteiro, do tênis à mão levantada, precisa aparecer, com um pouco de folga em volta, ocupando mais ou menos 60% a 70% da altura da imagem. Se cortar, afaste a câmera para trás (Y mais negativo). 10. SALVAR 1. Faça a foto: `scene.render.filepath` = caminho completo de `boneco-3d\boneco.png`, depois bpy.ops.render.render(write_still=True) 2. Salve o arquivo: bpy.ops.wm.save_as_mainfile(filepath=...boneco-3d\boneco.blend) 3. Confira que os dois arquivos existem e não estão vazios. 11. DICAS TÉCNICAS (BLENDER 5.x) - Ao criar peças, prefira `bpy.data` (meshes, objects, lights, cameras) e `bmesh`. No Modo A isso é importante: com a janela do Blender aberta, cada operador `bpy.ops.mesh.primitive_*_add` pode levar alguns segundos, e são umas 35 peças. No Modo B, os operadores também servem; depois de cada um, use `bpy.context.active_object`. - Caixas arredondadas: crie a caixa já no tamanho certo (ou aplique a escala com `bpy.ops.object.transform_apply(scale=True)`) antes de pôr o Bevel; senão o arredondado fica torto. - Nomes das entradas do Principled BSDF no Blender 4 e 5: "Base Color", "Roughness", "Coat Weight", "Coat Roughness", "Emission Color", "Emission Strength". No Blender 5, `material.use_nodes = True` ainda funciona, mas mostra um aviso de que vai sumir no Blender 6; pode ignorar. - Para apagar a parte de cima da boca, chame `bpy.context.view_layer.update()` depois de criar e girar o toro, e só então use `bmesh` (`bmesh.ops.delete` com `context="VERTS"`) nos vértices, já em coordenadas do mundo (`objeto.matrix_world @ vertice.co`). - Motor e cores: use `try/except TypeError` para cair em `BLENDER_EEVEE_NEXT` e em `AgX` se os nomes da seção 9 não existirem. - No Modo B, "parar e perguntar" (seção 1) quer dizer: se a cena tiver objetos estranhos, o script não apaga nada; ele para com uma mensagem clara, por exemplo raise RuntimeError("A cena tem objetos seus: ... Abra um arquivo novo e rode de novo.") - Se o Blender for mais antigo que o 4.2, avise que a receita pede o Blender 4.2 ou mais novo (5.1 ou mais novo para o conector). 12. CONFERÊNCIA ANTES DE TERMINAR [ ] Dá para ver as duas pernas, os dois tênis, o corpo amarelo, os dois braços (um acenando), a cabeça com cabelo, os dois olhos com brilho, as bochechas, o nariz e o sorriso. [ ] O fundo é azul-claro e liso, sem linha de horizonte. [ ] A imagem tem 1080 × 1920 e está salva em `boneco-3d\boneco.png`. [ ] O `boneco.blend` está salvo na mesma pasta. Quando tudo estiver certo, escreva só: "Pronto! Seu boneco está em [caminho da imagem]." e uma frase dizendo o que eu posso pedir para mudar (por exemplo, a cor da camisa). No Modo B, a ordem é: primeiro o script e os 4 passos para eu rodar; o "Pronto!" vem depois que eu disser que rodou sem erro. FIM DAS INSTRUÇÕES