Agregar marcas de agua a presentaciones en Java
Acerca de las marcas de agua
Una marca de agua en una presentación es un sello de texto o imagen utilizado 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 utilizan 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 u OpenOffice y de modificar su diseño y comportamiento. El aspecto común es que, para añadir marcas de agua de texto, debes usar la interfaz ITextFrame, y para marcar de agua de imagen, usar la clase PictureFrame o rellenar una forma de marca de agua con una imagen. PictureFrame implementa la interfaz IShape, lo que permite usar 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: la marca de agua se añade al Slide Master, se diseña 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 mejor dicho, la forma padre de la marca de agua) sea editada, Aspose.Slides proporciona 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.
Puedes asignar un nombre a la marca de agua para que, en el futuro, si deseas eliminarla, puedas encontrarla entre 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, primero puedes 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 interfaz ITextFrame. Este tipo no hereda de IShape, que posee 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, utiliza 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();
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 añadir una marca de agua a una sola diapositiva: crea un objeto IAutoShape y luego agrega 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();
Ver también
Establecer la transparencia de la forma de la marca de agua
Por defecto, 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
Puedes 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, usa 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(new Color(red, green, blue, alpha));
Centrar una marca de agua de texto
Es posible centrar la marca de agua en una diapositiva; para ello, puedes hacer lo siguiente:
Dimension2D 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.
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:
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 impedir que se edite una marca de agua, usa el método IAutoShape.getAutoShapeLock sobre 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
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 puede establecerse mediante el método IShapeCollection.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 traer una forma al frente o enviarla al fondo de la diapositiva. Esta función es especialmente útil si necesitas colocar una marca de agua delante de la presentación:
int shapeCount = slide.getShapes().size();
slide.getShapes().reorder(shapeCount - 1, watermarkShape);
Establecer la rotación de la marca de agua
A continuación se muestra un ejemplo de código sobre cómo ajustar la rotación de la marca de agua para que quede diagonalmente posicionada en 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 permite establecer el nombre de una forma. Mediante el nombre de la forma, puedes acceder a ella en el futuro para modificarla o eliminarla. Para asignar el nombre a la forma de la marca de agua, utiliza el método IAutoShape.setName:
watermarkShape.setName("watermark");
Eliminar una marca de agua
Para eliminar la forma de la marca de agua, usa el método IAutoShape.getName para encontrarla entre las formas de la diapositiva. Luego, pasa 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 impedir el uso no autorizado de las presentaciones.
¿Puedo agregar una marca de agua a todas las diapositivas de una presentación?
Sí, Aspose.Slides permite agregar programáticamente 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 (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 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 coherencia de la marca.
¿Cómo cambio la posición o la orientación de una marca de agua?
Puedes 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.