Gerando PDFs com C: o que funciona e o que quebra
A maioria dos desenvolvedores que precisa gerar PDFs em C chega aqui cansada de tentar entender bibliotecas que têm documentação de 1998 ou APIs que exigem mais configuração do que o valor real que entregam. A realidade é que C não tem suporte nativo a PDF, então você precisa de uma biblioteca externa. As opções mais usadas são PDFlib, PodoFo, libharu e a biblioteca genérica cups-pdf para impressão. Cada uma tem trade-offs sérios que não aparecem nos tutoriais básicos.
Programing C Pdf: bibliotecas reais para produção
PDFlib é a opção mais completa, mas exige licença comercial para uso em produção. A versão gratuita permite apenas geração de PDFs com marca d'água "Unlicensed". Para projetos internos ou estudo, funciona. PodoFo é open source (Apache 2.0) e lê e escreve PDFs, mas a API é verbosa e o manejo manual de memória pode causar leaks se você não prestar atenção. Libharu é mais simples, mas tem limitações sérias com fontes Unicode e imagens complexas. O problema que encontrei na prática aconteceu quando precisei gerar um relatório com tabelas contendo dados em português acentuado. A libharu usa encoding padrão PDF (WinAnsi ou Latin1), e caracteres como ã, ê e ç simplesmente apareciam como símbolos quebrados no visualizador. A solução foi configurar explicitamente uma fonte TrueType embutida com encoding Unicode, mas isso aumentou o tamanho do PDF em cerca de 300KB por tabela, o que seria inaceitável em um sistema que gera milhares de documentos por dia. No fim, migrei para PDFlib com licença, que lida com isso automaticamente, mas o custo de licença para múltiplos servidores de produção chegou a quase mil dólares anuais.
Como começar com PDFlib (versão gratuita)
O download da biblioteca pode ser feito diretamente no site oficial da PDFlib. A versão gratuita está disponível para Windows, Linux e macOS. Após baixar e instalar, o processo de compilação varia conforme o sistema operacional, mas em Linux com GCC geralmente basta linkar contra a biblioteca com -lpdflib. Você precisará também das bibliotecas de suporte, como zlib e freetype, dependendo da versão instalada. Um exemplo mínimo de geração de PDF em C com PDFlib:
#include <pdflib.h>
int main(void) {
PDF *p;
int font;
p = PDF_new();
if (PDF_begin_document(p, "meuarquivo.pdf", 0, "") == -1) {
return 1;
}
PDF_set_info(p, "Creator", "meu programa");
PDF_set_info(p, "Title", "Documento gerado em C");
PDF_begin_page_ext(p, 595, 842, "");
font = PDF_findfont(p, "Helvetica", "host", 0);
PDF_setfont(p, font, 12);
PDF_show(p, "Olá mundo em PDF com C");
PDF_end_page_ext(p, "");
PDF_end_document(p, "");
PDF_delete(p);
return 0;
}
Esse código gera um PDF A4 simples com texto "Olá mundo em PDF com C". O processo leva aproximadamente 50ms por página em uma máquina padrão. O tempo aumenta significativamente se você adicionar imagens ou fonts embutidas, podendo chegar a 200ms por página dependendo da resolução das imagens inseridas.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Problemas comuns que ninguém conta
Gerenciar o fluxo de saída do PDFlib requer atenção. Se você chamar PDF_end_document() sem ter fechado todas as páginas abertas, o PDF resultante pode ser corrompido. Já vi páginas inteiras ficarem em branco porque o fluxo de exceptions não estava configurado corretamente. A biblioteca oferece uma função de callback para capturar erros, mas muitos exemplos na internet ignoram esse detalhe. Outro problema prático: a library tem um limite de tamanho de arquivo. Em versões mais antigas, o limite era de 2GB, mas em ambientes com memória fragmentada, o allocate() pode falhar antes disso. Se você precisa gerar PDFs grandes, como relatórios com centenas de imagens em alta resolução, considere processar em chunks e depois juntar os arquivos usando uma ferramenta como pdftk ou Ghostscript pós-geração. Isso reduz a pressão de memória durante a criação.
Fonts são outro ponto crítico. PDFlib suporta embedding de TrueType, mas você precisa especificar o caminho absoluto para o arquivo .ttf no sistema. Em ambientes de produção onde os caminhos podem variar entre desenvolvimento e staging, isso quebra o build se a configuração não for centralizada. Use variáveis de ambiente ou um arquivo de configuração para gerenciar os paths das fontes, e valide sua existência antes de chamar PDF_findfont().
Alternativas quando PDFlib não é viável
Se a licença é um problema, PodoFo é a alternativa open source mais madura. O processo de instalação via package manager (apt-get install libpodofo-dev no Debian/Ubuntu) é mais simples do que compilar do source, mas a API exige que você gerencie tipos de dados de forma mais explícita. Conversões de string para std::string, manejo de streams personalizados e tratamento manual de resources são comuns. Para projetos que não precisam de geração complexa e apenas querem converter HTML para PDF, considere usar uma abordagem diferente: gerar o conteúdo em HTML com CSS e usar ferramentas como wkhtmltopdf ou WeasyPrint. Isso não é programar C diretamente, mas pode economizar horas de trabalho se o requisito for apenas transformar dados em PDF formatado. A conversão leva de 2 a 5 segundos por documento, dependendo da complexidade do layout, e o resultado visual é consistente entre diferentes sistemas.
A escolha da biblioteca depende do volume de geração, do orçamento de licença e da complexidade do conteúdo. Para documentos simples e baixo volume, até mesmo a abordagem de gerar texto formatado e invocar o lp ou cups-pdf pode ser suficiente, embora o controle sobre o layout seja praticamente nulo. Para controle total, PDFlib ou PodoFo são as opções reais, cada uma com seus próprios pontos de dor que só aparecem após meses de uso em produção.
