Agregar marcas de agua a presentaciones en Python
Acerca de las marcas de agua
Una marca de agua en una presentación es un sello de texto o imagen que se utiliza en una diapositiva o en todas las diapositivas de la presentación. Normalmente, una marca de agua se usa para indicar que la presentación es un borrador (p. ej., una marca de agua “Borrador”), que contiene información confidencial (p. ej., una marca de agua “Confidencial”), para especificar a qué empresa pertenece (p. ej., una marca de agua “Nombre de la empresa”), para identificar al autor de la presentación, etc. Una marca de agua ayuda a prevenir violaciones de derechos de autor al indicar que la presentación no debe ser copiada. Las marcas de agua se usan tanto en formatos de presentación PowerPoint como OpenOffice. En Aspose.Slides, puedes añadir una marca de agua a los formatos de archivo PowerPoint PPT, PPTX y OpenOffice ODP.
En Aspose.Slides, existen varias formas de crear marcas de agua en documentos PowerPoint o OpenOffice y modificar su diseño y comportamiento. El aspecto común es que, para añadir marcas de agua de texto, debes usar la clase TextFrame, y para añadir marcas de agua de imagen, usar la clase PictureFrame o rellenar una forma de marca de agua con una imagen. PictureFrame implementa la clase Shape, lo que permite usar todas las configuraciones flexibles del objeto forma. Como TextFrame no es una forma y sus configuraciones son limitadas, se envuelve en un objeto Shape.
Hay dos formas de aplicar una marca de agua: a una única diapositiva o a todas las diapositivas de la presentación. El patrón de diapositivas (Slide Master) se usa para aplicar una marca de agua a todas las diapositivas: la marca de agua se agrega al Slide Master, se diseña allí completamente y se aplica a todas las diapositivas sin afectar el permiso para modificar la marca de agua en diapositivas individuales.
Una marca de agua suele considerarse no disponible para edición por otros usuarios. Para evitar que la marca de agua (o mejor dicho, la forma padre de la marca de agua) sea editada, Aspose.Slides proporciona funcionalidad de bloqueo de formas. Se puede bloquear una forma específica en una diapositiva normal o en un Slide Master. Cuando la forma de la marca de agua está bloqueada en el Slide Master, estará bloqueada en todas las diapositivas de la presentación.
Puedes asignar un nombre a la marca de agua para que, en el futuro, si deseas eliminarla, puedas encontrarla en las formas de la diapositiva por nombre.
Puedes diseñar la marca de agua de cualquier manera; sin embargo, suelen existir características comunes en las marcas de agua, como alineación centrada, rotación, posición al frente, etc. Consideraremos cómo usar estas características en los ejemplos a continuación.
Marca de agua de texto
Agregar una marca de agua de texto a una diapositiva
Para agregar una marca de agua de texto en PPT, PPTX o ODP, puedes primero añadir una forma a la diapositiva y luego agregar un marco de texto a esa forma. El marco de texto está representado por la clase TextFrame. Este tipo no hereda de Shape, que tiene un amplio conjunto de propiedades para posicionar la marca de agua de forma flexible. Por lo tanto, el objeto TextFrame se envuelve en un objeto AutoShape. Para agregar texto de marca de agua a la forma, utiliza el método add_text_frame como se muestra a continuación.
watermark_text = "CONFIDENTIAL"
with Presentation() as presentation:
slide = presentation.slides[0]
watermark_shape = slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 100, 100, 400, 40)
watermark_frame = watermark_shape.add_text_frame(watermark_text)
Ver también
Agregar una marca de agua de texto a una presentación
Si deseas agregar una marca de agua de texto a toda la presentación (es decir, a todas las diapositivas a la vez), añádela al MasterSlide. El resto de la lógica es igual que al agregar una marca de agua a una única diapositiva: crea un objeto AutoShape y luego agrega la marca de agua usando el método add_text_frame.
watermark_text = "CONFIDENTIAL"
with Presentation() as presentation:
master_slide = presentation.masters[0]
watermark_shape = master_slide.shapes.add_auto_shape(ShapeType.RECTANGLE, 100, 100, 400, 40)
watermark_frame = watermark_shape.add_text_frame(watermark_text)
Ver también
Establecer la transparencia de la forma de la marca de agua
De forma predeterminada, la forma rectangular tiene estilos de colores de relleno y línea. Las siguientes líneas de código hacen que la forma sea transparente.
watermark_shape.fill_format.fill_type = FillType.NO_FILL
watermark_shape.line_format.fill_format.fill_type = FillType.NO_FILL
Establecer la fuente para una marca de agua de texto
Puedes cambiar la fuente de la marca de agua de texto como se muestra a continuación.
text_format = watermark_frame.paragraphs[0].paragraph_format.default_portion_format
text_format.latin_font = FontData("Arial")
text_format.font_height = 50
Establecer el color del texto de la marca de agua
Para establecer el color del texto de la marca de agua, usa este código:
alpha = 150
red = 200
green = 200
blue = 200
fill_format = watermark_frame.paragraphs[0].paragraph_format.default_portion_format.fill_format
fill_format.fill_type = FillType.SOLID
fill_format.solid_fill_color.color = drawing.Color.from_argb(alpha, red, green, blue)
Centrar una marca de agua de texto
Es posible centrar la marca de agua en una diapositiva; para ello, puedes hacer lo siguiente:
slide_size = presentation.slide_size.size
watermark_width = 400
watermark_height = 40
watermark_x = (slide_size.width - watermark_width) / 2
watermark_y = (slide_size.height - watermark_height) / 2
watermark_shape = slide.shapes.add_auto_shape(
ShapeType.RECTANGLE, watermark_x, watermark_y, watermark_width, watermark_height)
watermark_frame = watermark_shape.add_text_frame(watermark_text)
La imagen a continuación muestra el resultado final.
Marca de agua de imagen
Agregar una marca de agua de imagen a una presentación
Para agregar una marca de agua de imagen a una diapositiva de la presentación, puedes hacer lo siguiente:
with open("watermark.png", "rb") as image_stream:
image = presentation.images.add_image(image_stream.read())
watermark_shape.fill_format.fill_type = FillType.PICTURE
watermark_shape.fill_format.picture_fill_format.picture.image = image
watermark_shape.fill_format.picture_fill_format.picture_fill_mode = PictureFillMode.STRETCH
Bloquear una marca de agua para que no se edite
Si es necesario evitar que una marca de agua se edite, usa la propiedad AutoShape.auto_shape_lock en la forma. Con esta propiedad, puedes proteger la forma contra la selección, el cambio de tamaño, el reposicionamiento, la agrupación con otros elementos, bloquear su texto para edición y mucho más:
# Bloquear la forma de la marca de agua para que no se modifique
watermark_shape.auto_shape_lock.select_locked = True
watermark_shape.auto_shape_lock.size_locked = True
watermark_shape.auto_shape_lock.text_locked = True
watermark_shape.auto_shape_lock.position_locked = True
watermark_shape.auto_shape_lock.grouping_locked = True
Traer una marca de agua al frente
En Aspose.Slides, el orden Z de las formas se puede establecer mediante el método ShapeCollection.reorder. Para hacerlo, debes llamar a este método desde la lista de diapositivas de la presentación y pasar la referencia de la forma y su número de orden al método. De esta manera, es posible llevar una forma al frente o enviarla al fondo de la diapositiva. Esta característica es especialmente útil si necesitas colocar una marca de agua delante de la presentación:
shape_count = len(slide.shapes)
slide.shapes.reorder(shape_count - 1, watermark_shape)
Establecer la rotación de la marca de agua
A continuación se muestra un ejemplo de código de cómo ajustar la rotación de la marca de agua para que quede posicionada diagonalmente a lo largo de la diapositiva:
diagonal_angle = math.atan(slide_size.height / slide_size.width) * 180 / math.pi
watermark_shape.rotation = float(diagonal_angle)
Asignar un nombre a una marca de agua
Aspose.Slides permite asignar un nombre a una forma. Mediante el nombre de la forma, puedes acceder a ella en el futuro para modificarla o eliminarla. Para establecer el nombre de la forma de la marca de agua, asígnalo a la propiedad AutoShape.name:
watermark_shape.name = "watermark"
Eliminar una marca de agua
Para eliminar la forma de la marca de agua, usa el método AutoShape.name para encontrarla en las formas de la diapositiva. Luego, pasa la forma de la marca de agua al método ShapeCollection.remove:
slide_shapes = list(slide.shapes)
for shape in slide_shapes:
if shape.name == "watermark":
slide.shapes.remove(watermark_shape)
Un ejemplo en vivo
Es posible que desees probar las herramientas en línea Aspose.Slides free Add Watermark y Remove Watermark.
Preguntas frecuentes
¿Qué es una marca de agua y por qué debería usarla?
Una marca de agua es una superposición de texto o imagen aplicada a las diapositivas que ayuda a proteger la propiedad intelectual, mejorar el reconocimiento de la marca o prevenir el uso no autorizado de presentaciones.
¿Puedo agregar una marca de agua a todas las diapositivas de una presentación?
Sí, Aspose.Slides permite agregar una marca de agua a cada diapositiva de una presentación. Puedes iterar por todas las diapositivas y aplicar la configuración de la marca de agua individualmente.
¿Cómo puedo ajustar la transparencia de la marca de agua?
Puedes ajustar la transparencia de la marca de agua modificando la configuración de relleno (FillFormat) de la forma. Esto garantiza que la marca de agua sea sutil y no distraiga del contenido de la diapositiva.
¿Qué formatos de imagen son compatibles para las marcas de agua?
Aspose.Slides admite varios formatos de imagen como PNG, JPEG, GIF, BMP, SVG y más.
¿Puedo personalizar la fuente y el estilo de una marca de agua de texto?
Sí, puedes elegir cualquier fuente, tamaño y estilo para que coincidan con el diseño de tu presentación y mantengan la consistencia de la marca.
¿Cómo cambio la posición o la orientación de una marca de agua?
Puedes ajustar la posición y orientación de la marca de agua modificando las coordenadas, el tamaño y las propiedades de rotación de la shape.