Sintaxe de nomenclatura do gerador de ativos de imagem.

Última atualização em 02/11/2026

Saiba como encontrar as regras completas de sintaxe de nomenclatura de camadas para gerar ativos de imagem com parâmetros personalizados de qualidade, formato e tamanho no Adobe Photoshop para desktop.

A sintaxe de nomenclatura de camadas controla o formato de saída, a qualidade, as dimensões e a escala dos ativos gerados automaticamente a partir das camadas e grupos de camadas do PSD.Ao entender essas regras de sintaxe, você pode criar várias variações de ativos a partir de uma única camada, codificando todos os parâmetros diretamente no nome da camada.

Parâmetros de qualidade específicos do formato.

Sintaxe de JPEG.

Sufixo de qualidade.

  • .jpg1 a .jpg10 (escala de 1 a 10)
  • .jpg1% a .jpg100% (escala percentual)

Padrão: qualidade de 90% quando nenhum sufixo é especificado

Exemplos

  • Logo.jpg5 — JPEG no nível de qualidade 5
  • Hero.jpg80% — JPEG com qualidade de 80%
  • Banner.jpg — JPEG com qualidade padrão de 90%

Sintaxe de PNG.

Sufixo de profundidade de bits.

  • .png8 - PNG de 8 bits
  • .png24 - PNG de 24 bits
  • .png32 - PNG de 32 bits

Padrão: 32 bits quando nenhum sufixo é especificado

Exemplos

  • Icon.png8 - PNG de 8 bits com 256 cores
  • Photo.png24 - PNG de 24 bits sem transparência
  • Button.png32 - PNG de 32 bits com canal alfa completo
  • Logo.png - PNG de 32 bits (padrão)

Sintaxe GIF

Formato

  • .gif - transparência alfa básica

Parâmetro de qualidade: não disponível para o formato GIF

Exemplo

  • Animation.gif — GIF com transparência básica

Sintaxe SVG

Formato

  • .svg - formato vetorial

Parâmetros de qualidade e tamanho: não aplicável

Exemplo

  • Shape.svg - imagem vetorial escalável

Parâmetros de tamanho e escala

Os prefixos de tamanho aparecem antes do nome do ativo, separados por um espaço. Se estiver especificando dimensões em pixels, você pode omitir a unidade.

Escala relativa

Sintaxe:[porcentagem]% [nome do ativo]

Exemplos:

  • 200% Logo.jpg — escalado para 200%
  • 50% Icon.png — escalado para 50%
  • 42% Button.gif — escalado para 42%

Dimensões absolutas

Sintaxe:[largura] x [altura] [nome do ativo] ou [largura][unidade] x [altura][unidade] [nome do ativo]

Unidades compatíveis: px, in, cm, mm (os pixels podem ser omitidos)

Exemplos:

  • 300 x 200 Hero.jpg - 300 px × 200 px
  • 100x100 Thumb.png - 100 px × 100 px (sem espaços)
  • 4in x 3in Photo.jpg - 4 polegadas × 3 polegadas
  • 10cm x 5cm Card.png - 10 cm × 5 cm

Unidades mistas

Você pode combinar diferentes unidades nas especificações de largura e altura.

Exemplos

  • 4in x 100 Banner.jpg - 4 polegadas de largura, 100 px de altura
  • 200mm x 6in Poster.png - 200 mm de largura, 6 polegadas de altura
  • 10in x 50cm Flyer.jpg - 10 polegadas de largura, 50 cm de altura

Dimensões curinga

Use ? como caractere universal para escalar proporcionalmente especificando apenas uma dimensão.

Sintaxe:

  • [Largura]x? [asset-name] — especifique a largura, a altura será escalada proporcionalmente
  • ?x[altura] [asset-name] — especifique a altura, a largura será escalada proporcionalmente

Exemplos:

  • 100x? Logo.png — 100 px de largura, altura calculada automaticamente
  • ?x60in Banner.jpg — 60 polegadas de altura, largura calculada automaticamente

Múltiplos ativos de uma camada.

Gere várias versões de ativos separando os nomes dos ativos com vírgulas ou sinais de mais.

Separadores:

  • , — vírgula
  • , — vírgula seguida de espaço(s)
  • + — sinal de mais
  • + — sinal de mais seguido de espaço(s)

Exemplos:

  • Icon.png,Icon.jpg - versões PNG e JPEG
  • 200% Logo.jpg, 100% Logo.jpg - dois tamanhos
  • Icon.png8 + Icon.png24 + Icon.jpg90% - três variações de formato
  • 100x100 Thumb.jpg90%, 50x50 Thumb.jpg80% - duas versões escaladas

Exemplos complexos de nomenclatura de camadas.

Sintaxe combinada.

A sintaxe completa pode combinar parâmetros de formato, qualidade e escala:

[tamanho] [nome-do-ativo].[formato][qualidade], [tamanho] [nome-do-ativo].[formato][qualidade]

Exemplo: 120% Delicious.jpg, 42% Delicious.png24, 100x100 Delicious_2.jpg90%, 250% Delicious.gif

Isso gera quatro ativos:

  • Delicious.jpg - JPEG com qualidade padrão, escalado em 120%
  • Delicious.png - PNG de 24 bits escalado em 42%
  • Delicious_2.jpg - JPEG com qualidade de 90% em tamanho absoluto de 100×100 px
  • Delicious.gif - GIF escalado em 250%

Organização de subpastas.

Inclua um caminho de subpasta antes do nome do ativo para organizar a saída:

Sintaxe:[subfolder]/[asset-name].[format]

Exemplos:

  • icons/Logo.png - salvo na subpasta icons
  • @2x/Hero.jpg - salvo na subpasta @2x
  • thumbnails/50% Photo.png - escalado em 50% na subpasta thumbnails

Validação de escala absoluta.

Sintaxe válida de escala absoluta

-1 Error: Exception

Descrição

100x80 foo.png

Dimensões absolutas simples

80 x 100px foo.png

Espaços entre dimensões

4in x100 foo.png

Unidades mistas e sem unidades

90mm x120cm foo.png

Unidades diferentes

100x? foo.png

Altura com caractere universal

?x60in foo.png

Largura curinga

Sintaxe de escala absoluta inválida

-1 Error: Exception

Problema

100x100foo.png

Espaço ausente antes do nome do arquivo

80x100 60% foo.png

Não é possível misturar escala absoluta e relativa

50% 80x100 foo.png

Não é possível misturar escala relativa e absoluta

20in cm x50cm foo.png

Várias unidades em uma única dimensão

30nm x20 nano.png

Unidade inválida (nm não é compatível)

Restrições de nome de camada

Caracteres não permitidos:: (dois pontos) e * (asterisco) não podem ser usados em nomes de camadas para geração de ativos.

Strings ignoradas: Qualquer string sem extensão de arquivo é ignorada em nomes de camadas com múltiplos ativos.Por exemplo, em 100% Delicious, 42% Layer 1.png, a string 100% Delicious é ignorada porque não tem uma extensão de arquivo.

Nota

Lembre-se de incluir um espaço entre os prefixos de tamanho e o nome do ativo. Sem esse espaço, o Generator pode não analisar a sintaxe corretamente.