Como adicionar uma marca de água a um PDF

Antes de começar

Uma marca de água textual identifica visualmente um PDF sem retirar o conteúdo que já existe nas páginas. Esta ferramenta acrescenta a mensagem escolhida a todas as páginas processadas, permitindo distinguir, por exemplo, um rascunho ou uma cópia de trabalho.

A preparação da entrada merece atenção: o ficheiro é esperado como um valor em base64 e, depois de descodificado, o conteúdo deve começar por %PDF-. A extensão do nome não substitui esta verificação. A marca aparece em cinzento, perto do meio vertical e sobre o conteúdo existente, por isso a mensagem deve ser curta, legível e apropriada ao documento inteiro.

Pode manter a mensagem predefinida ou substituí-la por uma indicação própria. A opacidade controla a visibilidade através de um valor numérico, não de uma percentagem. Antes de começar, considere se uma marca sobre a zona central de todas as páginas serve o objetivo do relatório, contrato ou material de revisão.

Aplicar a mensagem ao PDF

1. Prepare o PDF e obtenha os bytes do ficheiro. Converta esses bytes para base64 e confirme que a descodificação começa pela assinatura %PDF-. Não basta mudar a extensão de outro formato para .pdf, porque o conteúdo descodificado é que tem de apresentar essa assinatura.

2. Selecione a mensagem da marca. Pode escrever, por exemplo, RASCUNHO, CÓPIA DE TRABALHO ou USO INTERNO. O texto deve ter entre 1 e 200 caracteres. Se não fornecer uma mensagem, é usada CONFIDENTIAL; enviar explicitamente um texto vazio tem um comportamento diferente e é rejeitado antes do processamento.

3. Defina a opacidade como número, caso não queira usar o valor predefinido 0.3. O valor aplicado fica limitado entre 0.05 e 1.0, pelo que não deve introduzir uma percentagem nem interpretar estes valores como percentagens.

4. Preencha os controlos com o PDF codificado, a mensagem e a opacidade e inicie a operação. O texto é acrescentado a cada página, em cinzento, perto do meio vertical e por cima dos elementos que já pertencem ao PDF.

5. Abra o PDF devolvido e percorra várias páginas para confirmar a marca. Se o texto estiver vazio ou exceder 200 caracteres, corrija-o e tente novamente. Se,

Ler o resultado com atenção

Num resultado bem-sucedido, a mensagem escolhida deve estar presente em cada página processada. Confirme a repetição em páginas diferentes e observe três características: o texto é cinzento, fica próximo do meio vertical e é colocado sobre o conteúdo original.

A visibilidade depende da opacidade usada. Quando não indica outro valor, é aplicada a predefinição 0.3; quando fornece um número diferente, o valor utilizado permanece entre 0.05 e 1.0. Uma marca discreta não significa necessariamente que a operação falhou, pois o conteúdo por baixo influencia a leitura.

A disposição tem limites concretos. A ferramenta não apresenta, com as opções descritas, uma escolha de páginas individuais, cor, ângulo ou coordenada exata. Se a zona central contiver informação importante, verifique se a colocação sobreposta continua aceitável antes de processar o documento.

Perante um resultado sem sucesso, separe as verificações. Reveja primeiro o comprimento da mensagem e confirme que a entrada é base64 cuja descodificação começa por %PDF-. Dados PDF inválidos ou erros reconhecidos durante o processamento também podem impedir a operação; a opacidade e a posição não devem ser consideradas a202

Exemplo prático

Está a rever um relatório antes da aprovação e pretende identificá-lo como RASCUNHO em todas as páginas processadas.

Converta os bytes do relatório para base64, introduza RASCUNHO, indique 0.3 na opacidade e inicie o processamento. Abra o PDF devolvido e confirme a mensagem em várias páginas.

O resultado bem-sucedido corresponde a um PDF em que RASCUNHO aparece em cinzento, perto do meio vertical e sobre o conteúdo de cada página processada.

Limitações

• A marca fica sobre todas as páginas, perto do meio vertical e em cinzento; não são indicadas opções para escolher páginas, cor, ângulo ou posição exata.

Erros comuns

• Enviar diretamente os bytes do PDF não corresponde à entrada esperada. Converta-os para base64 e confirme que a descodificação começa por %PDF- antes de iniciar a operação.

Perguntas frequentes

Que ficheiros posso fornecer?

A entrada tem de corresponder a um PDF depois da descodificação, começando por %PDF-. Outro formato, ou dados PDF inválidos, pode produzir um resultado sem sucesso.

Que mensagem pode aparecer na marca?

Pode indicar uma mensagem entre 1 e 200 caracteres. Sem mensagem, é usado CONFIDENTIAL; um texto vazio enviado explicitamente é rejeitado antes de o PDF ser processado.

Como controlo a visibilidade e a posição?

Indique um número para a opacidade. A predefinição é 0.3 e o valor aplicado fica entre 0.05 e 1.0; o texto surge em cinzento, perto do meio vertical e sobre cada página.