Overlay em PDF Existente

Visao Geral

gpdf pode abrir PDFs existentes e sobrepor novo conteudo sobre eles sem modificar os dados originais. Isso utiliza a tecnica de Incremental Update — novos objetos sao adicionados apos os bytes originais do PDF.

Casos de uso comuns:

Adicionar marcas d'agua ("RASCUNHO", "CONFIDENCIAL")
Inserir numeros de pagina
Carimbar marcas de aprovacao com datas
Adicionar cabecalhos/rodapes a documentos existentes

Abrindo um PDF Existente

import gpdf "github.com/gpdf-dev/gpdf"

// Read existing PDF bytes (from file, HTTP response, database, etc.)
pdfBytes, _ := os.ReadFile("input.pdf")

doc, err := gpdf.Open(pdfBytes)
if err != nil {
    log.Fatal(err)
}

Voce pode passar as mesmas opcoes que NewDocument — fontes, fonte padrao, etc.:

doc, err := gpdf.Open(pdfBytes,
    gpdf.WithFont("NotoSans", fontData),
    gpdf.WithDefaultFont("NotoSans", 12),
)

Overlay em uma Unica Pagina

Use Overlay(pageIndex, fn) para adicionar conteudo em uma pagina especifica (indice base 0):

doc.Overlay(0, func(p *template.PageBuilder) {
    p.Absolute(document.Mm(40), document.Mm(120), func(c *template.ColBuilder) {
        c.Text("DRAFT",
            template.FontSize(72),
            template.TextColor(pdf.Gray(0.85)),
        )
    })
})

O PageBuilder suporta a mesma API de quando se cria novas paginas — AutoRow, Absolute, Row, etc.

Overlay em Todas as Paginas

Use EachPage(fn) para iterar sobre todas as paginas:

count, _ := doc.PageCount()

doc.EachPage(func(pageIndex int, p *template.PageBuilder) {
    p.Absolute(document.Mm(170), document.Mm(285), func(c *template.ColBuilder) {
        c.Text(fmt.Sprintf("%d / %d", pageIndex+1, count),
            template.FontSize(10),
            template.AlignRight(),
        )
    }, template.AbsoluteWidth(document.Mm(20)))
})

Salvando o Resultado

result, err := doc.Save()
if err != nil {
    log.Fatal(err)
}
os.WriteFile("output.pdf", result, 0644)

O conteudo original do PDF e preservado — Save() adiciona os dados do overlay apos os bytes originais.

Exemplo Completo: Marca d'Agua + Numeros de Pagina

pdfBytes, _ := os.ReadFile("report.pdf")

doc, err := gpdf.Open(pdfBytes)
if err != nil {
    log.Fatal(err)
}

count, _ := doc.PageCount()

doc.EachPage(func(i int, p *template.PageBuilder) {
    // Watermark
    p.Absolute(document.Mm(40), document.Mm(140), func(c *template.ColBuilder) {
        c.Text("CONFIDENTIAL",
            template.FontSize(60),
            template.TextColor(pdf.Color{R: 0.9, G: 0.9, B: 0.9, A: 1, Space: pdf.ColorSpaceRGB}),
        )
    })

    // Page number (bottom-right)
    p.Absolute(document.Mm(170), document.Mm(285), func(c *template.ColBuilder) {
        c.Text(fmt.Sprintf("%d / %d", i+1, count),
            template.FontSize(10),
            template.AlignRight(),
        )
    }, template.AbsoluteWidth(document.Mm(20)))
})

result, _ := doc.Save()
os.WriteFile("report_stamped.pdf", result, 0644)

Referencia da API

Metodo	Descricao
`gpdf.Open(data, opts...)`	Abrir um PDF existente para modificacao
`doc.PageCount()`	Obter o numero de paginas
`doc.Overlay(pageIndex, fn)`	Adicionar conteudo em uma pagina especifica (base 0)
`doc.EachPage(fn)`	Adicionar conteudo em todas as paginas
`doc.Save()`	Retornar os bytes do PDF modificado

Proximos Passos

Uso Basico — Criando PDFs do zero
Estilizacao — Cores, decoracao de texto e tipografia
Referencia da API — Referencia completa do pacote gpdf