Como aplicar marcas d'água personalizadas em PDFs
O IronPDF permite aplicar marcas d'água personalizadas a documentos PDF usando strings HTML com suporte completo a CSS, possibilitando a personalização total de texto, imagens, opacidade, rotação e posicionamento para fins de identidade visual ou segurança.
Início rápido: Aplicar marcas d'água a PDFs em Java
- Importe a biblioteca IronPDF e defina sua chave de licença.
- Carregue seu documento PDF usando
PdfDocument.fromFile() - Crie uma string HTML para sua marca d'água (texto ou imagem).
- Aplique a marca d'água usando
pdf.applyWatermark(watermarkHtml) - Salve o PDF com marca d'água usando
pdf.saveAs()
```java :title=QuickStartWatermark.java PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf")); pdf.applyWatermark(""); pdf.saveAs("watermarked.pdf");
A marca d'água protege documentos PDF e afirma a propriedade ou o status, marcando-os como "Confidenciais" ou adicionando um logotipo. O IronPDF oferece uma solução flexível usando strings HTML com suporte completo a CSS. Isso permite a personalização completa por meio de propriedades padrão de HTML e CSS.
Este guia demonstra diferentes tipos de marcas d'água — ajustes de texto, imagem, localização, opacidade e rotação — além de métodos avançados usando [TextStamper](https://ironpdf.com/java/object-reference/api/com/ironsoftware/ironpdf/stamp/TextStamper.html) e [ImageStamper](https://ironpdf.com/java/object-reference/api/com/ironsoftware/ironpdf/stamp/ImageStamper.html) . Para mais técnicas de manipulação de PDFs, explore nosso guia sobre [como criar PDFs](https://ironpdf.com/java/how-to/java-create-pdf-tutorial/) ou aprenda sobre como [adicionar planos de fundo e primeiros planos](https://ironpdf.com/java/how-to/background-foreground/) .
<div class="hsg-featured-snippet">
<h3>Como aplicar marcas d'água em Java</h3>
<ol>
<li><a class="js-modal-open" data-modal-id="download-modal" href="#download-modal">Baixe a biblioteca Java para aplicar marcas d'água a PDFs.</a></li>
<li>Gere um novo PDF ou carregue um existente.</li>
<li>Configure a string HTML ou a imagem a ser usada como marca d'água.</li>
<li>Aplique a marca d'água utilizando o método apropriado.</li>
<li>Ajuste os parâmetros de opacidade, rotação e localização conforme necessário.</li>
</ol>
</div>
## Como faço para adicionar uma marca d'água de texto a um PDF?
Para aplicar uma marca d'água de texto simples a um documento PDF, use o método `applyWatermark`. Este método aceita texto usando HTML e CSS para estilização avançada. Por exemplo, adicione o texto "Confidencial" em vermelho ao PDF. Essa técnica marca documentos para uso interno ou indica o status de confidencialidade. A abordagem HTML proporciona flexibilidade através de propriedades CSS, incluindo fontes, cores, tamanhos e efeitos de texto personalizados.
```java
import java.io.IOException;
import java.nio.file.Paths;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
public class Main {
public static void main(String[] args) throws IOException {
// Set the license key for IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");
// Load an existing PDF document from file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));
// HTML string for watermark
String watermarkHtml = "<h1 style='color:red;'>Confidential</h1>";
// Apply the watermark using HTML string
pdf.applyWatermark(watermarkHtml);
// Save the PDF to a new file
pdf.saveAs("text_watermark.pdf");
}
}
O código demonstra a implementação básica. Primeiro, configure sua licença do IronPDF para acessar todos os recursos. A marca d'água HTML aceita quaisquer elementos HTML válidos e estilos CSS para controle total sobre a aparência.
Qual é a aparência da marca d'água de texto?
O arquivo PDF resultante, 'text_watermark.pdf', contém a marca d'água especificada em todas as páginas, com o texto 'Confidencial' exibido em vermelho no centro do documento. Por padrão, a marca d'água aparece com 50% de opacidade para manter a legibilidade e, ao mesmo tempo, garantir a visibilidade.
Para formatação de texto complexa, consulte nosso guia de conversão de HTML para PDF , que aborda técnicas avançadas de renderização de HTML aplicáveis a marcas d'água.
Como posso adicionar uma imagem como marca d'água?
Utilizando o mesmo método, aplique imagens como marcas d'água, com suporte para formatos como PNG, JPEG, SVG e outros. Estilize e posicione imagens usando CSS dentro da string HTML. Este recurso adiciona logotipos da empresa, selos de certificação ou elementos de marca aos documentos. Garanta que as imagens estejam acessíveis a partir do ambiente de execução da aplicação.
import java.io.IOException;
import java.nio.file.Paths;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
public class Main {
public static void main(String[] args) throws IOException {
// Set the license key for IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");
// Load an existing PDF document from file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));
// Image HTML watermark
String watermarkHtml = "<img src='logo.png' style='width:100px;'/>";
// Apply the image watermark
pdf.applyWatermark(watermarkHtml);
// Save the PDF to a new file
pdf.saveAs("image_watermark.pdf");
}
}
import java.io.IOException;
import java.nio.file.Paths;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
public class Main {
public static void main(String[] args) throws IOException {
// Set the license key for IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");
// Load an existing PDF document from file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));
// Image HTML watermark
String watermarkHtml = "<img src='logo.png' style='width:100px;'/>";
// Apply the image watermark
pdf.applyWatermark(watermarkHtml);
// Save the PDF to a new file
pdf.saveAs("image_watermark.pdf");
}
}
Utilize propriedades CSS para estilização avançada de marcas d'água em imagens:
// Example with more advanced CSS styling
String advancedWatermarkHtml = "<img src='logo.png' style='width:150px; opacity:0.5; transform:rotate(-45deg);'/>";
// Example with more advanced CSS styling
String advancedWatermarkHtml = "<img src='logo.png' style='width:150px; opacity:0.5; transform:rotate(-45deg);'/>";
Quais formatos de arquivo são suportados para marcas d'água em imagens?
O arquivo PDF resultante, 'image_watermark.pdf', contém a imagem 'logo.png' como marca d'água em todas as páginas. A imagem é exibida com 100 pixels de largura. O IronPDF suporta formatos como PNG, JPEG, GIF, SVG e BMP. Use imagens PNG com fundo transparente para marcas d'água de logotipo. Para extrair imagens de PDFs existentes, consulte nosso guia sobre como extrair imagens de PDFs .
Como faço para ajustar a opacidade e a posição da marca d'água?
Personalize a aparência da marca d'água ajustando a opacidade e aplicando rotação. O método applyWatermark aceita ambas as propriedades como parâmetros. Ajuste essas configurações para garantir a visibilidade da marca d'água sem obscurecer o conteúdo do documento. A opacidade varia de 0 (transparente) a 100 (opaco), sendo que 20-40 proporciona o equilíbrio ideal.
import java.io.IOException;
import java.nio.file.Paths;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.stamp.HorizontalAlignment;
import com.ironsoftware.ironpdf.stamp.VerticalAlignment;
public class Main {
public static void main(String[] args) throws IOException {
// Set the license key for IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");
// Load an existing PDF document from file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));
// HTML string for watermark
String watermarkHtml = "<h1 style='color:blue;'>Confidential</h1>";
// Apply the HTML watermark with 30% opacity, positioned at the top-left corner of each page
pdf.applyWatermark(watermarkHtml, 30, VerticalAlignment.TOP, HorizontalAlignment.LEFT);
// Save the PDF to a new file
pdf.saveAs("watermark_opacity_rotation.pdf");
}
}
import java.io.IOException;
import java.nio.file.Paths;
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.stamp.HorizontalAlignment;
import com.ironsoftware.ironpdf.stamp.VerticalAlignment;
public class Main {
public static void main(String[] args) throws IOException {
// Set the license key for IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");
// Load an existing PDF document from file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));
// HTML string for watermark
String watermarkHtml = "<h1 style='color:blue;'>Confidential</h1>";
// Apply the HTML watermark with 30% opacity, positioned at the top-left corner of each page
pdf.applyWatermark(watermarkHtml, 30, VerticalAlignment.TOP, HorizontalAlignment.LEFT);
// Save the PDF to a new file
pdf.saveAs("watermark_opacity_rotation.pdf");
}
}
Para posicionamentos complexos, combine marcas d'água com outros recursos de estampagem. Saiba mais em nosso guia de planos de fundo e primeiros planos .
Quais opções de alinhamento estão disponíveis?
O método applyWatermark aplica marcas d'água baseadas em HTML a todas as páginas do PDF com estas opções:
- Opacidade : Aplicada em
30%opacidade para transparência parcial - Alinhamento vertical : Alinhado à página
TOP. As opções incluem:- TOPO : Marca d'água no topo da página
- MEIO : Marca d'água no meio da página
- PARTE INFERIOR : Marca d'água na parte inferior da página
- Alinhamento horizontal : Alinhado à página
LEFT. As opções incluem:- ESQUERDA : Marca d'água no lado esquerdo
- CENTRO : Marca d'água no centro
- DIREITA : Marca d'água no lado direito
Combine as opções de alinhamento para obter nove configurações de posicionamento, colocando marcas d'água com precisão sem sobrepor conteúdo crítico. Para documentos que exigem várias marcas d'água ou carimbos em posições diferentes, explore nossos recursos de anotação .
Perguntas frequentes
Como adiciono uma marca d'água de texto a um PDF em Java?
Você pode adicionar uma marca d'água de texto usando o método `applyWatermark` do IronPDF. Basta carregar seu documento PDF com `PdfDocument.fromFile()` e, em seguida, chamar `pdf.applyWatermark()` com o seu texto. O método aceita strings HTML, permitindo que você estilize a marca d'água com propriedades CSS como cor, fonte e tamanho.
Posso usar imagens como marcas d'água em vez de texto?
Sim, o IronPDF suporta marcas d'água em imagens. Você pode incorporar imagens em strings HTML passadas para o método applyWatermark, ou usar a classe ImageStamper para marcas d'água em imagens mais avançadas, com controle preciso sobre o posicionamento e a opacidade.
Como faço para controlar a opacidade da minha marca d'água?
O IronPDF permite controlar a opacidade da marca d'água através de propriedades CSS no seu código HTML. Você pode definir a opacidade usando a propriedade CSS `opacity` (valores de 0 a 1) ou usar valores de cor RGBA para transparência do texto.
Posso rotacionar as marcas d'água para que apareçam na diagonal da página?
Sim, você pode rotacionar marcas d'água usando as propriedades de transformação CSS em sua string HTML. O recurso de marca d'água do IronPDF suporta transformações CSS3 completas, incluindo rotação em qualquer ângulo para criar marcas d'água diagonais ou angulares.
Qual a diferença entre usar applyWatermark e TextStamper?
O método applyWatermark é mais simples e utiliza HTML/CSS para estilização, enquanto o TextStamper oferece maior controle programático sobre o posicionamento, rotação e opacidade do texto. O TextStamper é ideal quando você precisa de posicionamento preciso ou geração dinâmica de marcas d'água.
Como faço para posicionar marcas d'água em locais específicos da página?
O IronPDF oferece posicionamento flexível através de posicionamento absoluto em CSS nas marcas d'água HTML, ou você pode usar as classes TextStamper e ImageStamper, que fornecem posicionamento baseado em coordenadas para colocação exata nas páginas do PDF.
Posso adicionar marcas d'água diferentes a páginas diferentes?
Sim, o IronPDF suporta marcas d'água específicas para cada página. Você pode usar as classes de carimbo (TextStamper ou ImageStamper) para aplicar marcas d'água a intervalos de páginas específicos ou a páginas individuais dentro do seu documento PDF.
É possível adicionar marcas d'água de texto e de imagem ao mesmo PDF?
Com certeza. O IronPDF permite múltiplas marcas d'água no mesmo documento. Você pode combinar marcas d'água de texto e imagem, incluindo ambas em uma única string HTML ou aplicando-as separadamente usando múltiplas operações de marca d'água.

