Agregar marcas de agua a presentaciones en Android

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 evitar violaciones de derechos de autor al indicar que la presentación no debe copiarse. Las marcas de agua se utilizan tanto en los formatos de presentación de PowerPoint como de OpenOffice. En Aspose.Slides, puede agregar 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 agregar marcas de agua de texto, debe usar la interfaz ITextFrame, y para agregar marcas de agua de imagen, use la clase PictureFrame o rellene una forma de marca de agua con una imagen. PictureFrame implementa la interfaz IShape, lo que le permite utilizar todas las configuraciones flexibles del objeto forma. Dado que ITextFrame no es una forma y sus configuraciones son limitadas, se envuelve en un objeto IShape.

Hay dos formas de aplicar una marca de agua: a una sola diapositiva o a todas las diapositivas de la presentación. El Slide Master se usa para aplicar una marca de agua a todas las diapositivas de la presentación: la marca de agua se agrega al Slide Master, se diseña completamente allí y se aplica a todas las diapositivas sin afectar el permiso de modificar la marca de agua en diapositivas individuales.

Una marca de agua normalmente se considera no editable por otros usuarios. Para evitar que la marca de agua (o más bien la forma padre de la marca de agua) sea editada, Aspose.Slides ofrece funcionalidad de bloqueo de formas. Una forma específica puede bloquearse 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.

Puede establecer un nombre para la marca de agua de modo que, en el futuro, si desea eliminarla, pueda encontrarla entre las formas de la diapositiva por nombre.

Puede 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 frontal, etc. A continuación se muestra cómo usar estas características en los ejemplos.

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 u ODP, primero puede agregar una forma a la diapositiva y luego agregar un marco de texto a esa forma. El marco de texto está representado por la interfaz ITextFrame. Este tipo no hereda de IShape, que tiene un amplio conjunto de propiedades para posicionar la marca de agua de forma flexible. Por lo tanto, el objeto ITextFrame se envuelve en un objeto IAutoShape. Para agregar texto de marca de agua a la forma, use el método addTextFrame como se muestra a continuación.

String watermarkText = "CONFIDENTIAL";

Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);

IAutoShape watermarkShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 40);
ITextFrame watermarkFrame = watermarkShape.addTextFrame(watermarkText);

presentation.dispose();

Agregar una marca de agua de texto a una presentación

Si desea agregar una marca de agua de texto a toda la presentación (es decir, a todas las diapositivas a la vez), agréguela al MasterSlide. El resto de la lógica es igual que al agregar una marca de agua a una sola diapositiva: cree un objeto IAutoShape y luego agregue la marca de agua usando el método addTextFrame.

String watermarkText = "CONFIDENTIAL";

Presentation presentation = new Presentation();
IMasterSlide masterSlide = presentation.getMasters().get_Item(0);

IAutoShape watermarkShape = masterSlide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 40);
ITextFrame watermarkFrame = watermarkShape.addTextFrame(watermarkText);

presentation.dispose();

Establecer transparencia de la forma de la marca de agua

De forma predeterminada, la forma rectangular tiene colores de relleno y de línea. Las siguientes líneas de código hacen que la forma sea transparente.

watermarkShape.getFillFormat().setFillType(FillType.NoFill);
watermarkShape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);

Establecer la fuente para una marca de agua de texto

Puede cambiar la fuente de la marca de agua de texto como se muestra a continuación.

IPortionFormat textFormat = watermarkFrame.getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat();
textFormat.setLatinFont(new FontData("Arial"));
textFormat.setFontHeight(50);

Establecer el color del texto de la marca de agua

Para establecer el color del texto de la marca de agua, use este código:

int alpha = 150, red = 200, green = 200, blue = 200;

IFillFormat fillFormat = watermarkFrame.getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().getFillFormat();
fillFormat.setFillType(FillType.Solid);
fillFormat.getSolidFillColor().setColor(Color.argb(alpha, red, green, blue));

Centrar una marca de agua de texto

Es posible centrar la marca de agua en una diapositiva; para ello, puede hacer lo siguiente:

SizeF slideSize = presentation.getSlideSize().getSize();

float watermarkWidth = 400;
float watermarkHeight = 40;
float watermarkX = ((float)slideSize.getWidth() - watermarkWidth) / 2;
float watermarkY = ((float)slideSize.getHeight() - watermarkHeight) / 2;

IAutoShape watermarkShape = slide.getShapes().addAutoShape(
        ShapeType.Rectangle, watermarkX, watermarkY, watermarkWidth, watermarkHeight);

ITextFrame watermarkFrame = watermarkShape.addTextFrame(watermarkText);

La imagen a continuación muestra el resultado final.

The text watermark

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 presentación, puede hacer lo siguiente:

InputStream imageStream = new FileInputStream("watermark.png");
IPPImage image = presentation.getImages().addImage(imageStream);

watermarkShape.getFillFormat().setFillType(FillType.Picture);
watermarkShape.getFillFormat().getPictureFillFormat().getPicture().setImage(image);
watermarkShape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch);

Bloquear una marca de agua para que no se edite

Si es necesario evitar que una marca de agua sea editada, use el método IAutoShape.getAutoShapeLock sobre la forma. Con esta propiedad, puede proteger la forma contra selección, cambio de tamaño, reposicionamiento, agrupación con otros elementos, bloqueo de su texto para edición y mucho más:

// Bloquear la forma de la marca de agua de modificarse
watermarkShape.getAutoShapeLock().setSelectLocked(true);
watermarkShape.getAutoShapeLock().setSizeLocked(true);
watermarkShape.getAutoShapeLock().setTextLocked(true);
watermarkShape.getAutoShapeLock().setPositionLocked(true);
watermarkShape.getAutoShapeLock().setGroupingLocked(true);

Traer una marca de agua al frente

En Aspose.Slides, el orden Z de las formas se puede establecer mediante el método IShapeCollection.reorder. Para ello, debe 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 función es especialmente útil si necesita colocar una marca de agua delante de la presentación:

int shapeCount = slide.getShapes().size();
slide.getShapes().reorder(shapeCount - 1, watermarkShape);

Establecer rotación de la marca de agua

A continuación se muestra un ejemplo de código que ajusta la rotación de la marca de agua para que quede posicionada diagonalmente a través de la diapositiva:

double diagonalAngle = Math.atan((slideSize.getHeight() / slideSize.getWidth())) * 180 / Math.PI;

watermarkShape.setRotation((float)diagonalAngle);

Asignar un nombre a una marca de agua

Aspose.Slides le permite establecer el nombre de una forma. Mediante el nombre de la forma, puede acceder a ella en el futuro para modificarla o eliminarla. Para establecer el nombre de la forma de la marca de agua, asígnelo al método IAutoShape.setName:

watermarkShape.setName("watermark");

Eliminar una marca de agua

Para eliminar la forma de la marca de agua, use el método IAutoShape.getName para encontrarla entre las formas de la diapositiva. Luego, pase la forma de la marca de agua al método IShapeCollection.remove:

IShape[] slideShapes = slide.getShapes().toArray();
for (IShape shape : slideShapes) {
    if ("watermark".equals(shape.getName()))
    {
        slide.getShapes().remove(watermarkShape);
    }
}

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 evitar el uso no autorizado de presentaciones.

¿Puedo agregar una marca de agua a todas las diapositivas de una presentación?

Sí, Aspose.Slides le permite agregar programáticamente una marca de agua a cada diapositiva de una presentación. Puede iterar a través de 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?

Puede ajustar la transparencia de la marca de agua modificando la configuración de relleno (getFillFormat) 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 con 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í, puede elegir cualquier fuente, tamaño y estilo para que coincidan con el diseño de su presentación y mantengan la consistencia de la marca.

¿Cómo cambio la posición o la orientación de una marca de agua?

Puede ajustar la posición y la orientación de la marca de agua programáticamente modificando las coordenadas, el tamaño y las propiedades de rotación de la forma.