|image_aplatir

Força o formato da imagem, ao suprimir ou manter a transparência.

A função image_aplatir (achatar imagem) executa duas operações:

  • salvaguarda uma imagem num formato predefinido (por exemplo, transformar uma imagem PNG numa imagem GIF);
  • gere as informações de transparência, substituindo as áreas transparentes por uma cor, ou preservando-as.

Por exemplo:

[(#TITRE
     |image_typo{police=stencil.ttf,couleur=000000,taille=40}
     |image_aplatir{gif,ff0000})]

O título transformado em imagem tipográfica é um ficheiro PNG com áreas transparentes. Ao passar essa imagem pelo filtro image_aplatir, transforma-a em GIF, substituindo as áreas transparentes por vermelho (ff0000).

A função aceita como parâmetros, na ordem:

  • o formato (gif, jpg, png, webp),
  • a cor de fundo,
  • a qualidade de compressãola (32, 64, ou 128 para gif e de 0 a 100 para jpg),
  • a preservação da transparência (0 ou 1): quando este parâmetro é 1, a transparência dos gif ou webp é preservada. A cor de fundo não é, portanto, usada.

Por exemplo:
Num loop DOCUMENTS, [(#FICHIER|image_aplatir{gif,ffffff,128,1})]
converterá a imagem em GIF de boa qualidade, forçando a transparência do fundo.

Autor Ricardo Porto Publié le : Mis à jour : 17/09/25

Traductions : English, français, Português