Adicionar imagens e texto à seção de rodapé PDF pode ser útil em vários cenários, como adicionar informações legais ou de marca a documentos. Em muitos setores, é um requisito comum adicionar um logotipo da empresa ou isenção de responsabilidade na parte inferior de cada página de um documento. Em outros casos, pode ser necessário adicionar números de página ou outros metadados para ajudar a organizar ou identificar o documento. Independentemente do caso de uso específico, a capacidade de adicionar imagens e texto à seção de rodapé de um documento PDF é um recurso importante para muitas empresas e organizações. Neste artigo, exploraremos como adicionar imagens e texto à seção de rodapé de um documento PDF usando o Python Cloud SDK.
Outro termo usado para o rodapé é chamado de
running foot. Ele é muito usado na indústria editorial e é chamado assim porque contém uma versão abreviada do artigo ou outras informações sobre ele.
- SDK de nuvem Python
- Adicionar rodapé de texto em PDF usando Python
- Adicionar rodapé de imagem em PDF usando Python
- Adicionar rodapé de texto ao PDF usando o comando cURL
- Adicionar rodapé de imagem ao PDF usando o comando cURL
SDK de nuvem Python
Aspose.PDF Cloud SDK para Python fornece um conjunto de recursos poderosos para trabalhar com documentos PDF, incluindo a capacidade de adicionar imagem e texto à seção de rodapé de um documento PDF. Este SDK oferece uma interface simples e intuitiva que facilita a execução de várias tarefas relacionadas a PDF programaticamente. Usando este SDK, você pode adicionar texto ou imagens personalizadas de forma rápida e fácil ao rodapé de qualquer documento PDF, fornecendo uma aparência profissional e personalizada aos seus documentos.
O SDK está disponível para download no repositório PIP e GitHub. No entanto, você pode simplesmente executar o seguinte comando no terminal/prompt de comando para instalar a versão mais recente do SDK no sistema.
pip install asposepdfcloud
O próximo passo importante é obter as credenciais do cliente do Cloud dashboard. Se você tiver uma conta GitHub ou Google, basta se inscrever ou clicar no botão Create a new Account e fornecer as informações necessárias.
Imagem 1: Credenciais do cliente no painel do Aspose.Cloud.
Adicionar rodapé de texto em PDF usando Python
Siga os passos abaixo para adicionar rodapé de texto em um documento PDF usando um trecho de código Python.
- O primeiro passo é criar uma instância da classe ApiClient que requer Client ID e Client Secret como argumentos.
- Em segundo lugar, crie uma instância da classe PdfApi que requer o objeto ApiClient como argumento de entrada.
- Em terceiro lugar, crie um objeto de TextFooter onde definimos o alinhamento horizontal como Centro, a Opacidade como 0,7, o ângulo de rotação como 356 e especificamos a margem inferior como 5.
- Para definir a formatação de texto para TextFooter, crie um objeto de TextState onde definimos a cor de primeiro plano, tamanho da fonte, nome da fonte etc.
- Agora precisamos definir valores para dois parâmetros opcionais que definem a página inicial e final do documento PDF para colocar o rodapé de texto.
- Por fim, chame o método postdocumenttextfooter(..) para adicionar o rodapé de texto ao documento PDF e salvar o arquivo resultante no armazenamento em nuvem.
def addTextFooter():
try:
#Client credentials
client_secret = "1c9379bb7d701c26cc87e741a29987bb"
client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"
#initialize PdfApi client instance using client credetials
pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)
# crie uma instância PdfApi enquanto passa PdfApiClient como argumento
pdf_api = PdfApi(pdf_api_client)
# arquivo PDF de entrada
input_file = 'marketing.pdf'
# Criar instância TextFooter
textFooter = asposepdfcloud.TextFooter()
textFooter.background = True
# Definir alinhamento horizontal para rodapé como centro
textFooter.horizontal_alignment = 'Center'
# defina a opacidade do rodapé como 0,7
textFooter.opacity = 0.7
textFooter.rotate = None
# defina o ângulo de rotação como 5 graus
textFooter.rotate_angle = 5
textFooter.x_indent = 100
textFooter.y_indent = 100
textFooter.zoom = .8
# Valor textual a ser exibido na seção Rodapé
textFooter.value = 'Aspose.PDF Cloud SDK for Python'
# crie uma instância de TextState definindo a formatação do texto
textState = asposepdfcloud.TextState(font_size=15, font='Arial', foreground_color=
{"A": 0,
"R": 66,
"G": 111,
"B": 245},
background_color= {
"A": 10,
"R": 179,
"G": 245,
"B": 66},
font_style=1)
# atribuir objeto TextState a TextFooter
textFooter.text_state = textState
# página inicial do PDF para rodapé
startPage = 2
# página final do PDF para rodapé
endPage = 3
# chame a API para adicionar rodapé de texto no arquivo PDF na 2ª e 3ª página
response = pdf_api.post_document_text_footer(name = input_file, text_footer= textFooter, start_page_number = startPage, end_page_number=endPage)
# imprimir código de resposta no console
print(response)
# imprimir mensagem no console (opcional)
print('Text Footer successfully added to PDF !')
except ApiException as e:
print("Exception while calling PdfApi: {0}".format(e))
print("Code:" + str(e.code))
print("Message:" + e.message)
Imagem 2:- Visualização do TextFooter adicionado ao PDF.
Acesse o link a seguir para baixar a entrada marketing.pdf e o resultante marketing-TextFooter.pdf.
Adicionar rodapé de imagem em PDF usando Python
A API também fornece os recursos para adicionar um rodapé de imagem a um arquivo PDF. Siga as instruções fornecidas abaixo para cumprir esse requisito.
- O primeiro passo é criar uma instância da classe ApiClient que requer Client ID e Client Secret como argumentos.
- Em segundo lugar, crie uma instância da classe PdfApi que requer o objeto ApiClient como argumento de entrada.
- Em terceiro lugar, crie um objeto de ImageFooter onde definimos o alinhamento horizontal como Centro, a Opacidade como 0,7, o ângulo de rotação como 10, o nome do arquivo de imagem, os detalhes da margem e outras propriedades são especificados.
- Como precisamos adicionar o rodapé apenas à primeira página do documento, definimos valores para os parâmetros opcionais startpagenumber e endpagenumber.
- Por fim, chame o método postdocumentimagefooter(..) para adicionar o rodapé de texto ao documento PDF e salvar o arquivo resultante no armazenamento em nuvem.
def addImageFooter():
try:
#Client credentials
client_secret = "1c9379bb7d701c26cc87e741a29987bb"
client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"
#initialize PdfApi client instance using client credetials
pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)
# crie uma instância PdfApi enquanto passa PdfApiClient como argumento
pdf_api = PdfApi(pdf_api_client)
# documento PDF de entrada
input_file = 'marketing.pdf'
# Criar instância ImageFooter
imageFooter = asposepdfcloud.ImageFooter()
# renderizar cabeçalho sobre o conteúdo do PDF
imageFooter.background = False
# definir o alinhamento como esquerdo
imageFooter.horizontal_alignment = 'Left'
# defina a opacidade como 70%
imageFooter.opacity = 0.7
imageFooter.rotate = None
imageFooter.rotate_angle = 10
imageFooter.x_indent = 10
imageFooter.y_indent = 10
imageFooter.zoom = .7
# arquivo de imagem de entrada
imageFooter.file_name = 'Koala.jpg'
# defina os detalhes de largura e altura da imagem
imageFooter.width = 100
imageFooter.height = 100
# especificar detalhes de margem para imagem de rodapé
imageFooter.bottom_margin = 2
imageFooter.left_margin = 1
imageFooter.right_margin = 10
# página inicial do documento para adicionar rodapé
startPage = 1
# página inicial do documento para adicionar rodapé
endPage = 1
# chame a API para renderizar o rodapé da imagem no arquivo PDF
response = pdf_api.post_document_image_footer(name = input_file, image_footer= imageFooter, start_page_number = startPage, end_page_number=endPage)
# imprimir código de resposta no console
print(response)
# imprimir mensagem no console (opcional)
print('Image Footer successfully added to PDF !')
except ApiException as e:
print("Exception while calling PdfApi: {0}".format(e))
print("Code:" + str(e.code))
print("Message:" + e.message)
Imagem 3:- Visualização do rodapé da imagem em PDF.
O arquivo resultante gerado pelo exemplo acima pode ser baixado de marketing-ImageFooter.pdf.
Adicionar rodapé de texto ao PDF usando o comando cURL
O uso de comandos cURL e Aspose.PDF Cloud para adicionar texto e imagem no rodapé do PDF oferece vários benefícios. Primeiro, elimina a necessidade de edição manual de documentos PDF, o que pode ser demorado e propenso a erros. Segundo, permite fácil personalização do texto do cabeçalho, com a capacidade de alterar a fonte, tamanho, cor e posição do texto. Terceiro, permite que os usuários adicionem texto a vários documentos PDF simultaneamente, economizando tempo e aumentando a eficiência. Finalmente, essa abordagem fornece um método seguro e confiável para adicionar texto ao cabeçalho do PDF, com todos os dados sendo transmitidos por uma conexão segura e processados em servidores seguros.
Agora, como pré-requisito, gere um JSON Web Token (JWT) executando o seguinte comando.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=88d1cda8-b12c-4a80-b1ad-c85ac483c5c5&client_secret=406b404b2df649611e508bbcfcd2a77f" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
Agora que geramos o token JWT, precisamos executar o seguinte comando para adicionar TextFooter ao arquivo PDF.
curl -X POST "https://api.aspose.cloud/v3.0/pdf/marketing.pdf/footer/text?startPageNumber=2&endPageNumber=3" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{ \"Background\": true, \"HorizontalAlignment\": \"Center\", \"Opacity\": 0.7, \"Rotate\": \"None\", \"RotateAngle\": 5, \"XIndent\": 100, \"YIndent\": 100, \"Zoom\": 0.8, \"Value\": \"Aspose.PDF Cloud SDK for Python\", \"TextState\": { \"FontSize\": 15, \"Font\": \"Arial\", \"ForegroundColor\": { \"A\": 0, \"R\": 66, \"G\": 111, \"B\": 245 }, \"BackgroundColor\": { \"A\": 10, \"R\": 179, \"G\": 245, \"B\": 66 }, \"FontStyle\": \"Regular\" }, \"BottomMargin\": 3, \"LeftMargin\": 3, \"RightMargin\": 3}"
Adicionar rodapé de imagem ao PDF usando o comando cURL
Execute o seguinte comando para adicionar o cabeçalho da imagem ao arquivo PDF usando o comando cURL.
curl -X POST "https://api.aspose.cloud/v3.0/pdf/marketing.pdf/footer/image?startPageNumber=1&endPageNumber=1" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{ \"Background\": false, \"HorizontalAlignment\": \"Left\", \"Opacity\": 0.7, \"Rotate\": \"None\", \"RotateAngle\": 10, \"XIndent\": 10, \"YIndent\": 10, \"Zoom\": 0.7, \"FileName\": \"Koala.jpg\", \"Width\": 100, \"Height\": 100, \"BottomMargin\": 2, \"LeftMargin\": 1, \"RightMargin\": 10}"
Conclusão
Concluindo, adicionar imagem e texto à seção de rodapé de um documento PDF pode ser um recurso útil para vários propósitos, incluindo branding, conformidade legal e organização de documentos. O Aspose.PDF Cloud SDK para Python fornece uma maneira conveniente e poderosa de implementar esse recurso em seu aplicativo Python. Por outro lado, usar comandos cURL com o Aspose.PDF Cloud API pode oferecer flexibilidade e simplicidade para integrar o recurso em várias linguagens de programação e ambientes. Independentemente da abordagem escolhida, o Aspose.PDF Cloud oferece ferramentas robustas e confiáveis para adicionar imagem e texto à seção de rodapé de seus documentos PDF.
Links úteis
Artigos relacionados
Recomendamos que você visite os seguintes artigos para saber mais sobre: