Agregar imágenes y texto a la sección de pie de página de PDF puede resultar útil en diversas situaciones, como agregar información legal o de marca a los documentos. En muchas industrias, es un requisito común agregar un logotipo de la empresa o una exención de responsabilidad en la parte inferior de cada página de un documento. En otros casos, puede ser necesario agregar números de página u otros metadatos para ayudar a organizar o identificar el documento. Independientemente del caso de uso específico, la capacidad de agregar imágenes y texto a la sección de pie de página de un documento PDF es una característica importante para muchas empresas y organizaciones. En este artículo, exploraremos cómo agregar imágenes y texto a la sección de pie de página de un documento PDF utilizando Python Cloud SDK.
Otro término que se utiliza para el pie de página es el de “pie de página”. Se utiliza mucho en la industria editorial y se denomina así porque contiene una versión abreviada del artículo u otros datos sobre él.
- Kit de desarrollo de software para Python Cloud
- Agregar pie de página de texto en PDF con Python
- Agregar pie de imagen en un PDF con Python
- Cómo agregar un pie de texto a un PDF con el comando cURL
- Cómo agregar un pie de imagen a un PDF mediante el comando cURL
Kit de desarrollo de software para Python Cloud
Aspose.PDF Cloud SDK for Python ofrece un conjunto de potentes funciones para trabajar con documentos PDF, incluida la capacidad de agregar imágenes y texto a la sección de pie de página de un documento PDF. Este SDK ofrece una interfaz sencilla e intuitiva que facilita la realización de diversas tareas relacionadas con PDF mediante programación. Con este SDK, puede agregar texto o imágenes personalizadas de forma rápida y sencilla al pie de página de cualquier documento PDF, lo que le dará un aspecto profesional y personalizado a sus documentos.
El SDK está disponible para descargarse a través de los repositorios PIP y GitHub. Sin embargo, puede ejecutar el siguiente comando en la terminal o en el símbolo del sistema para instalar la última versión del SDK en el sistema.
pip install asposepdfcloud
El siguiente paso importante es obtener las credenciales del cliente desde el panel de control de la nube. Si tiene una cuenta de GitHub o Google, simplemente regístrese o haga clic en el botón Crear una nueva cuenta y proporcione la información solicitada.
Imagen 1: Credenciales del cliente en el panel de Aspose.Cloud.
Agregar pie de página de texto en PDF con Python
Siga los pasos que se detallan a continuación para agregar un pie de página de texto en un documento PDF utilizando un fragmento de código Python.
- El primer paso es crear una instancia de la clase ApiClient que requiere ID de cliente y Secreto de cliente como argumentos.
- En segundo lugar, cree una instancia de la clase PdfApi que requiera el objeto ApiClient como argumento de entrada.
- En tercer lugar, crea un objeto TextFooter donde hemos establecido la alineación horizontal como Centro, la Opacidad como 0,7, el ángulo de rotación como 356 y hemos especificado el margen inferior como 5.
- Para establecer el formato de texto para TextFooter, creamos un objeto TextState donde definimos el color de primer plano, el tamaño de fuente, el nombre de la fuente, etc.
- Ahora necesitamos establecer valores para dos parámetros opcionales que definen la página de inicio y final del documento PDF para colocar el pie de página de texto.
- Por último, llame al método postdocumenttextfooter(..) para agregar un pie de texto al documento PDF y guardar el archivo resultante en el almacenamiento en la nube.
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)
# Crea una instancia de PdfApi mientras pasas PdfApiClient como argumento
pdf_api = PdfApi(pdf_api_client)
# archivo PDF de entrada
input_file = 'marketing.pdf'
# Crear una instancia de TextFooter
textFooter = asposepdfcloud.TextFooter()
textFooter.background = True
# Establecer la alineación horizontal para el pie de página como Centro
textFooter.horizontal_alignment = 'Center'
# Establezca la opacidad del pie de página en 0,7
textFooter.opacity = 0.7
textFooter.rotate = None
# Establezca el ángulo de rotación en 5 grados
textFooter.rotate_angle = 5
textFooter.x_indent = 100
textFooter.y_indent = 100
textFooter.zoom = .8
# Valor textual que se mostrará en la sección de pie de página
textFooter.value = 'Aspose.PDF Cloud SDK for Python'
# Crea una instancia de TextState que define el formato del 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)
# Asignar objeto TextState a TextFooter
textFooter.text_state = textState
# Página de inicio del PDF para pie de página
startPage = 2
# Página final del PDF para pie de página
endPage = 3
# Llamar a la API para agregar un pie de página de texto en el archivo PDF en la segunda y tercera 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 respuesta en la consola
print(response)
# Imprimir mensaje en la consola (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)
Imagen 2: Vista previa de TextFooter agregado al PDF.
Por favor visite el siguiente enlace para descargar la entrada marketing.pdf y el resultante marketing-TextFooter.pdf.
Agregar pie de imagen en PDF con Python
La API también ofrece la posibilidad de agregar un pie de imagen a un archivo PDF. Siga las instrucciones que se indican a continuación para cumplir con este requisito.
- El primer paso es crear una instancia de la clase ApiClient que requiere ID de cliente y Secreto de cliente como argumentos.
- En segundo lugar, cree una instancia de la clase PdfApi que requiera el objeto ApiClient como argumento de entrada.
- En tercer lugar, crea un objeto de ImageFooter donde hemos establecido la alineación horizontal como Centro, la Opacidad como 0,7, el ángulo de rotación como 10, el nombre del archivo de la imagen, los detalles del margen y otras propiedades están especificadas.
- Dado que solo necesitamos agregar el pie de página a la primera página del documento, hemos establecido valores para los parámetros opcionales startpagenumber y endpagenumber.
- Por último, llame al método postdocumentimagefooter(..) para agregar un pie de texto al documento PDF y guardar el archivo resultante en el almacenamiento en la nube.
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)
# Crea una instancia de PdfApi mientras pasas PdfApiClient como argumento
pdf_api = PdfApi(pdf_api_client)
# documento PDF de entrada
input_file = 'marketing.pdf'
# Crear una instancia de ImageFooter
imageFooter = asposepdfcloud.ImageFooter()
# Representar el encabezado sobre el contenido del PDF
imageFooter.background = False
# Establezca la alineación como izquierda
imageFooter.horizontal_alignment = 'Left'
# Establezca la opacidad al 70%
imageFooter.opacity = 0.7
imageFooter.rotate = None
imageFooter.rotate_angle = 10
imageFooter.x_indent = 10
imageFooter.y_indent = 10
imageFooter.zoom = .7
# archivo de imagen de entrada
imageFooter.file_name = 'Koala.jpg'
# Establezca los detalles de ancho y alto de la imagen
imageFooter.width = 100
imageFooter.height = 100
# Especificar detalles de margen para la imagen de pie de página
imageFooter.bottom_margin = 2
imageFooter.left_margin = 1
imageFooter.right_margin = 10
# Página de inicio del documento para agregar pie de página
startPage = 1
# Página de inicio del documento para agregar pie de página
endPage = 1
# Llamar a la API para representar el pie de página de la imagen en un archivo 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 respuesta en la consola
print(response)
# Imprimir mensaje en la consola (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)
Imagen 3:- Vista previa del pie de imagen en PDF.
El archivo resultante generado por el ejemplo anterior se puede descargar desde marketing-ImageFooter.pdf.
Cómo agregar un pie de texto a un PDF con el comando cURL
El uso de comandos cURL y Aspose.PDF Cloud para agregar texto e imágenes en el pie de página de un PDF ofrece varias ventajas. En primer lugar, elimina la necesidad de editar manualmente los documentos PDF, lo que puede llevar mucho tiempo y ser propenso a errores. En segundo lugar, permite personalizar fácilmente el texto del encabezado, con la capacidad de cambiar la fuente, el tamaño, el color y la posición del texto. En tercer lugar, permite a los usuarios agregar texto a varios documentos PDF simultáneamente, lo que ahorra tiempo y aumenta la eficiencia. Por último, este enfoque proporciona un método seguro y confiable para agregar texto al encabezado del PDF, ya que todos los datos se transmiten a través de una conexión segura y se procesan en servidores seguros.
Ahora, como requisito previo, genere un JSON Web Token (JWT) ejecutando el siguiente 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"
Ahora que hemos generado el token JWT, necesitamos ejecutar el siguiente comando para agregar TextFooter al archivo 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}"
Cómo agregar un pie de imagen a un PDF mediante el comando cURL
Ejecute el siguiente comando para agregar el encabezado de la imagen al archivo PDF utilizando el 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}"
Conclusión
En conclusión, agregar imágenes y texto a la sección de pie de página de un documento PDF puede ser una función útil para diversos fines, como la marca, el cumplimiento legal y la organización de documentos. Aspose.PDF Cloud SDK para Python ofrece una forma conveniente y poderosa de implementar esta función en su aplicación Python. Por otro lado, el uso de comandos cURL con Aspose.PDF Cloud API puede ofrecer flexibilidad y simplicidad para integrar la función en varios lenguajes y entornos de programación. Independientemente del enfoque que elija, Aspose.PDF Cloud ofrece herramientas sólidas y confiables para agregar imágenes y texto a la sección de pie de página de sus documentos PDF.
Enlaces útiles
Artículos relacionados
Te recomendamos visitar los siguientes artículos para conocer: