Como adicionar uma marca de água de texto a uma imagem

Para que serve a marca de água de texto

Uma marca de água de texto pode ajudar a identificar uma imagem ou a indicar o estado de um ficheiro antes da partilha. Esta ferramenta recebe a imagem como uma cadeia de texto codificada em base64, renderiza o texto escolhido sobre a imagem e, se o processamento terminar com sucesso, produz dados de imagem codificados em PNG.

A configuração permite adaptar a mensagem à finalidade da imagem. Pode escolher o texto, a posição, a opacidade e o tamanho da letra, em vez de depender apenas dos valores predefinidos. O resultado deve ser avaliado pelo aspeto do texto sobre a imagem e pelo formato dos dados devolvidos.

Este método é adequado quando já dispõe dos dados da imagem em base64 e pretende obter uma nova representação com uma indicação textual visível. A cadeia fornecida não é uma descrição do ficheiro: corresponde aos dados da imagem que serão descodificados para o processamento.

Passos para configurar e processar a imagem

1. Prepare os dados da imagem numa cadeia codificada em base64. Confirme que a cadeia corresponde à imagem que pretende tratar; uma entrada vazia não inicia o processamento.

2. Indique a mensagem que deverá aparecer sobre a imagem. Se deixar este campo sem texto, é utilizado Watermark, o valor predefinido.

3. Defina a opacidade apenas se o valor habitual não for adequado. A predefinição é 0,5, e o valor aplicado fica limitado ao intervalo de 0,0 a 1,0.

4. Selecione a posição pretendida: canto superior esquerdo, canto superior direito, canto inferior esquerdo, canto inferior direito ou centro. Uma posição diferente destas conduz à colocação ao centro.

5. Ajuste o tamanho da letra quando a dimensão predefinida não servir a imagem. Se não alterar este campo, é usado o valor 36.

6. Inicie o processamento depois de rever os dados introduzidos. Não substitua uma cadeia base64 por um nome de ficheiro ou por texto descritivo, porque a entrada esperada é a representação codificada da imagem.

7. Examine o resultado devolvido e confirme que contém dados de imagem codificados em PNG. Para comparar configurações, repita a operação alterando uma opção de cada vez, como a opacidade ou a posição.

O que significa o resultado

Um resultado bem-sucedido assume a forma de dados de imagem codificados em PNG, com o texto escolhido renderizado sobre a imagem fornecida. O aspeto final depende da mensagem, da posição, da opacidade, do tamanho da letra e das características da própria imagem.

Se a posição introduzida não pertencer às opções suportadas, não será criada uma localização adicional: a colocação usada será o centro. Assim, uma resposta visualmente centrada pode resultar de uma posição inválida, e não de uma escolha explícita dessa opção.

Quando não há resultado utilizável, comece por confirmar que a entrada não está vazia e que os dados podem ser descodificados e abertos como imagem. O processamento também pode falhar se a dependência necessária para tratar imagens não estiver disponível ou se ocorrer uma exceção durante a descodificação, abertura, renderização, composição ou codificação.

A ausência de um resultado não permite concluir, por si só, qual destas etapas falhou. Reveja a cadeia de entrada e os valores de configuração, e depois tente novamente com uma imagem e uma mensagem válidas.

Exemplo prático

Uma equipa pretende assinalar uma imagem de rascunho antes de a enviar para revisão.

Para uma imagem de rascunho, forneça os dados correspondentes em base64, escreva Rascunho, escolha o canto inferior direito, defina a opacidade como 0,35 e use o tamanho de letra 28 antes de iniciar o processamento.

O resultado esperado tem a forma de dados de imagem codificados em PNG, com Rascunho renderizado sobre a imagem fornecida.

Limitações

• Uma entrada vazia impede o processamento, que também pode falhar durante o tratamento da imagem ou quando a dependência necessária não está disponível.

Erros comuns

• Causa: foi fornecida uma cadeia vazia, um nome de ficheiro ou um conteúdo que não representa dados de imagem descodificáveis. Correção: substitua a entrada por uma cadeia base64 correspondente à imagem pretendida e volte a iniciar o processamento.

Perguntas frequentes

Que texto aparece quando não indico uma marca de água?

Se não indicar uma mensagem, o texto usado é Watermark. Quando precisa de outra indicação, escreva-a no campo do texto antes de iniciar a operação.

Como funciona a opacidade da marca de água?

Se não alterar a configuração, a opacidade aplicada é 0,5. O valor introduzido é limitado ao intervalo de 0,0 a 1,0 antes de ser aplicado.

Que formato tem o resultado?

Quando termina com sucesso, a operação devolve dados de imagem codificados em PNG. Uma falha pode estar relacionada com a entrada ou com a descodificação, abertura, renderização, composição ou codificação.