Methods full documentation: fpdf.FPDF API doc
[TOC]
Vamos começar com um exemplo clássico:
{% include "../tutorial/tuto1.py" %}Após incluirmos o ficheiro da biblioteca, criamos um objeto FPDF. O
FPDF construtor é construído com os seguintes parâmetros por omissão:
Páginas são em formato A4 vertical e a unidade de medida é o milímetro.
Pode ser especificado explicitamente através de:
pdf = FPDF(orientation="P", unit="mm", format="A4")É possível colocar o PDF em modo horizontal (L) ou em outros formatos de página
(como Letter e Legal) e em outras unidades de medida (pt, cm, in).
Neste momento, não há nenhuma página, então temos que adicionar uma com add_page. A origem está no canto superior esquerdo e a posição atual é, por padrão, colocada a 1 cm das bordas; as margens podem ser alteradas com set_margins.
Antes de imprimirmos o texto, é obrigatório selecionar uma fonte com set_font, caso contrário, o documento será inválido. Nós escolhemos Helvetica bold 16:
pdf.set_font('helvetica', 'B', 16)Podemos formatar em itálico com I, sublinhar com U ou uma fonte normal
com uma string vazia (ou qualquer combinação). Observe que o tamanho da fonte é fornecido em pontos, não milímetros (ou outra unidade do utilizador); esta é a única exceção.
As outras fontes integradas são Times, Courier, Symbol e ZapfDingbats.
Agora podemos imprimir uma célula com cell. Uma célula é uma área retangular, possivelmente emoldurada, que contém algum texto. É renderizado na posição atual. Nós especificamos as suas dimensões, o seu texto (centrado ou alinhado), se as bordas devem ser desenhadas, e para onde a posição atual se deve mover depois desta alteração (para a direita, abaixo ou no início da próxima linha). Para adicionar uma moldura, temos de fazer o seguinte:
pdf.cell(40, 10, 'Hello World!', 1)Para adicionar uma nova célula ao lado desta, com texto centralizado e ir para a próxima linha, teríamos de fazer:
pdf.cell(60, 10, 'Powered by FPDF.', new_x="LMARGIN", new_y="NEXT", align='C')Nota: a quebra de linha também pode ser feita com ln. Esse método permite especificar, adicionalmente, a altura da quebra.
Finalmente, o documento é fechado e guardado no caminho do arquivo fornecido utilizando
output. Sem termos qualquer parâmetro fornecido, output () retorna o buffer PDF bytearray.
Aqui temos um exemplo de duas páginas com cabeçalho, rodapé e logótipo:
{% include "../tutorial/tuto2.py" %}Este exemplo usa os header e o footer para processar cabeçalhos e rodapés de página. Estes são chamados automaticamente. Eles já existem na classe FPDF, mas não fazem nada, portanto, temos que os estender a classe e substituí-los.
O logótipo é impresso utilizando o método image, especificando o seu canto superior esquerdo e sua largura. A altura é calculada automaticamente para respeitar as proporções da imagem.
Para imprimir o número da página, um valor nulo é passado como a largura da célula. Isso significa que a célula deve se estender até a margem direita da página; é útil para centralizar texto. O número da página atual é retornado pelo método page_no; quanto ao número total de páginas, é obtido por meio do valor especial {nb} que será substituído quando se fecha o documento.
Observe que o uso do método set_y permite definir a posição em um local absoluto da página, começando do início ou do fim.
Outro recurso interessante que se usa aqui é a quebra de página automática. Desde do momento em que uma célula cruza o limite da página (a 2 centímetros da parte inferior por
padrão), uma pausa é executada e a fonte restaurada. Embora o cabeçalho e rodapés selecionam a sua própria fonte (helvetica), o corpo continua com Times.
Este mecanismo de restauração automática também se aplica a cores e largura de linha.
O limite que dispara quebras de página pode ser definido com
set_auto_page_break.
Vamos continuar com um exemplo que imprime parágrafos justificados e o uso de cores.
{% include "../tutorial/tuto3.py" %}O método get_string_width permite determinar o comprimento de uma string na fonte atual, e que é usada aqui para calcular a posição e a largura do quadro ao redor do título. Em seguida, as cores são definidas (via set_draw_color, set_fill_color e set_text_color) e a espessura da linha é definida como 1 mm (contra 0,2 por padrão) com set_line_width. Finalmente, produzimos a célula (se o último parâmetro for verdadeiro, indica que o plano de fundo deve ser preenchido).
O método usado para imprimir os parágrafos é multi_cell. Cada vez que uma linha atinge a extremidade direita da célula ou um código de fim de linha é encontrado, uma quebra de linha é emitida e uma nova célula é criada automaticamente sob a atual. O texto é justificado por padrão.
Duas propriedades do documento são definidas: o título (set_title) e o autor (set_author). As propriedades podem ser visualizadas de duas maneiras: A primeira é abrir o documento diretamente com o Acrobat Reader, vá para o menu Arquivo e escolha a opção Propriedades do documento. O segundo, também disponível no plug-in, é clicar com o botão direito e selecionar Propriedades do documento.
Este exemplo é uma variante do anterior, mostrando como colocar o texto em várias colunas.
{% include "../tutorial/tuto4.py"%}A principal diferença em relação ao tutorial anterior é o uso do accept_page_break e os métodos set_col.
Usando o método accept_page_break, quando a célula ultrapassar o limite inferior da página, ela verificará o número da coluna atual. Se isso for menor que 2 (optamos por dividir a página em três colunas), chamando o método set_col, aumentando o número da coluna e alterando a posição da próxima coluna para que o texto continue aí.
Quando o limite inferior da terceira coluna é alcançado, o método accept_page_break será redefinido e vai voltar para a primeira coluna e adicionar uma quebra de página.
{% include "../tutorial/tuto5.py"%}PDF resultante - Texto dos países
This section has changed a lot and requires a new translation: #267
English versions:
Este tutorial irá explicar várias maneiras de inserir links dentro de um documento PDF, bem como adicionar links para fontes externas.
Também mostrará várias maneiras de usar diferentes estilos de texto, (negrito, itálico, sublinhado) no mesmo texto.
{% include "../tutorial/tuto6.py"%}
O novo método mostrado aqui para imprimir texto é write(). É muito parecido com multi_cell (), sendo as principais diferenças:
- O fim da linha está na margem direita e a próxima linha começa na margem esquerda.
- A posição atual move-se para o final do texto.
O método, portanto, nos permite escrever um pedaço de texto, alterar o estilo da fonte, e continuar do ponto exato em que paramos. Por outro lado, a sua principal desvantagem é que não podemos justificar o texto como nós fazemos com o método [multi_cell()(https://pyfpdf.github.io/fpdf2/fpdf/fpdf.html#fpdf.fpdf.FPDF.multi_cell) .
Na primeira página do exemplo, usámos write() para este propósito. O início da frase está escrita no estilo de texto normal, depois usando o método set_font(), trocamos para sublinhado e acabámos a frase.
Para adicionar o link externo a apontar para a segunda página, nós usámos o método add_link(), que cria uma área clicável à qual demos o nome de “link” que direciona para outra parte do documento.
Para criar o link externo usando uma imagem, usámos image(). O método tem a opção de passar um link como um dos seus argumentos. O link pode ser interno ou externo.
Como alternativa, outra opção para mudar o estilo da fonte e adicionar links é usar o método write_html(). É um “parser” que permite adicionar texto, mudar o estilo da fonte e adicionar links usando html.