Personalizar formas de presentación en Python mediante Java

De qué trata esta página

Crea y personaliza formas en presentaciones de PowerPoint con Aspose.Slides para Python mediante Java: rutas de geometría, esquinas curvas, formas compuestas.

Visión general

Este artículo explica cómo personalizar las formas de presentación en Aspose.Slides editando la geometría de la forma mediante puntos de edición y rutas de geometría. Muestra cómo trabajar con GeometryPath para modificar formas existentes, realizar operaciones básicas de edición de rutas, añadir o eliminar puntos y aplicar la geometría actualizada a una forma.

También demuestra cómo crear formas personalizadas y compuestas, construir formas con esquinas curvas, determinar si la geometría de una forma está cerrada y convertir entre GeometryPath y java.awt.Shape para escenarios adicionales de personalización de geometría.

Cambiar una forma mediante puntos de edición

Considere un cuadrado. En PowerPoint, usando puntos de edición, puede

mover la esquina del cuadrado hacia dentro o fuera
especificar la curvatura de una esquina o punto
añadir nuevos puntos al cuadrado
manipular los puntos del cuadrado, etc.

En esencia, puede realizar las tareas descritas en cualquier forma. Con los puntos de edición, puede modificar una forma o crear una nueva forma a partir de una forma existente.

Consejos para la edición de formas

overview_image

Antes de comenzar a editar formas de PowerPoint mediante puntos de edición, puede que desee considerar los siguientes aspectos sobre las formas:

Una forma (o su ruta) puede ser cerrada o abierta.
Cuando una forma es cerrada, carece de punto de inicio o fin. Cuando es abierta, tiene un comienzo y un final.
Todas las formas constan de al menos 2 puntos de anclaje vinculados entre sí por líneas.
Una línea puede ser recta o curva. Los puntos de anclaje determinan la naturaleza de la línea.
Los puntos de anclaje existen como puntos de esquina, puntos rectos o puntos suaves:
- Un punto de esquina es un punto donde se unen 2 líneas rectas formando un ángulo.
- Un punto suave es un punto donde existen 2 manejadores en una línea recta y los segmentos de la línea se unen en una curva suave. En este caso, todos los manejadores están separados del punto de anclaje por una distancia igual.
- Un punto recto es un punto donde existen 2 manejadores en una línea recta y los segmentos de esa línea se unen en una curva suave. En este caso, los manejadores no tienen que estar separados del punto de anclaje por una distancia igual.
Al mover o editar los puntos de anclaje (lo que cambia el ángulo de las líneas), puedes modificar la apariencia de una forma.

Para editar formas de PowerPoint mediante puntos de edición, Aspose.Slides proporciona la clase GeometryPath.

Una instancia de GeometryPath representa una ruta de geometría del objeto GeometryShape.
Para obtener el GeometryPath del instancia de GeometryShape puedes usar el método GeometryShape.getGeometryPaths.
Para establecer el GeometryPath de una forma, puedes usar estos métodos: GeometryShape.setGeometryPath para formas sólidas y GeometryShape.setGeometryPaths para formas compuestas.
Para añadir segmentos, puedes usar los métodos bajo GeometryPath.
Usando los métodos GeometryPath.setStroke y GeometryPath.setFillMode, puedes establecer la apariencia de una ruta de geometría.
Con el método GeometryPath.getPathData puedes obtener la ruta de geometría de un GeometryShape como una matriz de segmentos de ruta.
Para acceder a opciones adicionales de personalización de la geometría de la forma, puedes convertir GeometryPath a java.awt.Shape.
Utiliza los métodos geometryPathToGraphicsPath y graphicsPathToGeometryPath (de la clase ShapeUtil) para convertir GeometryPath a java.awt.Shape y viceversa.

Operaciones de edición simples

Las siguientes firmas muestran las operaciones básicas de edición:

Añadir una línea al final de una ruta:

geometry_path.lineTo(point)
geometry_path.lineTo(x, y)

Añadir una línea a una posición especificada en una ruta:

geometry_path.lineTo(point, index)
geometry_path.lineTo(x, y, index)

Añadir una curva cúbica Bézier al final de una ruta:

geometry_path.cubicBezierTo(point1, point2, point3)
geometry_path.cubicBezierTo(x1, y1, x2, y2, x3, y3)

Añadir una curva cúbica Bézier a una posición especificada en una ruta:

geometry_path.cubicBezierTo(point1, point2, point3, index)
geometry_path.cubicBezierTo(x1, y1, x2, y2, x3, y3, index)

Añadir una curva cuadrática Bézier al final de una ruta:

geometry_path.quadraticBezierTo(point1, point2)
geometry_path.quadraticBezierTo(x1, y1, x2, y2)

Añadir una curva cuadrática Bézier a una posición especificada en una ruta:

geometry_path.quadraticBezierTo(point1, point2, index)
geometry_path.quadraticBezierTo(x1, y1, x2, y2, index)

Añadir un arco dado a una ruta:

geometry_path.arcTo(width, height, start_angle, sweep_angle)

Cerrar la figura actual de una ruta:

geometry_path.closeFigure()

Establecer la posición del siguiente punto:

geometry_path.moveTo(point)
geometry_path.moveTo(x, y)

Eliminar el segmento de ruta en un índice dado:

geometry_path.removeAt(index)

Añadir puntos personalizados a una forma

Crea una instancia de la clase GeometryShape y establece el tipo ShapeType.Rectangle.
Obtén una instancia de la clase GeometryPath a partir de la forma.
Añade un nuevo punto entre los dos puntos superiores de la ruta.
Añade un nuevo punto entre los dos puntos inferiores de la ruta.
Aplica la ruta a la forma.

Este código Python muestra cómo añadir puntos personalizados a una forma:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100)
    geometry_path = shape.getGeometryPaths()[0]
    geometry_path.lineTo(100, 50, 1)
    geometry_path.lineTo(100, 50, 4)
    shape.setGeometryPath(geometry_path)
finally:
    presentation.dispose()

example1_image

Eliminar puntos de una forma

Crea una instancia de la clase GeometryShape y establece el tipo ShapeType.Heart.
Obtén una instancia de la clase GeometryPath a partir de la forma.
Elimina el segmento de la ruta.
Aplica la ruta a la forma.

Este código Python muestra cómo eliminar puntos de una forma:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Heart, 100, 100, 300, 300)
    geometry_path = shape.getGeometryPaths()[0]
    geometry_path.removeAt(2)
    shape.setGeometryPath(geometry_path)
finally:
    presentation.dispose()

example2_image

Crear una forma personalizada

Calcula los puntos para la forma.
Crea una instancia de la clase GeometryPath.
Rellena la ruta con los puntos.
Crea una instancia de la clase GeometryShape.
Aplica la ruta a la forma.

Este código Python muestra cómo crear una forma personalizada:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath

import math

points = []
outer_radius = 100
inner_radius = 50
step = 72

for angle in range(-90, 270, step):
    radians = math.radians(angle)
    x = outer_radius * math.cos(radians)
    y = outer_radius * math.sin(radians)
    points.append((x + outer_radius, y + outer_radius))

    radians = math.radians(angle + step / 2)
    x = inner_radius * math.cos(radians)
    y = inner_radius * math.sin(radians)
    points.append((x + outer_radius, y + outer_radius))

star_path = GeometryPath()
star_path.moveTo(*points[0])
for point in points[1:]:
    star_path.lineTo(*point)
star_path.closeFigure()

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, outer_radius * 2, outer_radius * 2)
    shape.setGeometryPath(star_path)
finally:
    presentation.dispose()

example3_image

Crear una forma compuesta personalizada

Crea una instancia de la clase GeometryShape.
Crea una primera instancia de la clase GeometryPath.
Crea una segunda instancia de la clase GeometryPath.
Aplica las rutas a la forma.

Este código Python muestra cómo crear una forma compuesta personalizada:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100)

    top_path = GeometryPath()
    top_path.moveTo(0, 0)
    top_path.lineTo(shape.getWidth(), 0)
    top_path.lineTo(shape.getWidth(), shape.getHeight() / 3)
    top_path.lineTo(0, shape.getHeight() / 3)
    top_path.closeFigure()

    bottom_path = GeometryPath()
    bottom_path.moveTo(0, shape.getHeight() / 3 * 2)
    bottom_path.lineTo(shape.getWidth(), shape.getHeight() / 3 * 2)
    bottom_path.lineTo(shape.getWidth(), shape.getHeight())
    bottom_path.lineTo(0, shape.getHeight())
    bottom_path.closeFigure()

    shape.setGeometryPaths([top_path, bottom_path])
finally:
    presentation.dispose()

example4_image

Crear una forma personalizada con esquinas curvas

Este código Python muestra cómo crear una forma personalizada con esquinas curvas (hacia dentro):

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath, SaveFormat

shape_x = 20
shape_y = 20
shape_width = 300
shape_height = 200

left_top_size = 50
right_top_size = 20
right_bottom_size = 40
left_bottom_size = 10

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Custom, shape_x, shape_y, shape_width, shape_height)
    geometry_path = GeometryPath()
    geometry_path.moveTo(left_top_size, 0)
    geometry_path.lineTo(shape_width - right_top_size, 0)
    geometry_path.arcTo(right_top_size, right_top_size, 180, -90)
    geometry_path.lineTo(shape_width, shape_height - right_bottom_size)
    geometry_path.arcTo(right_bottom_size, right_bottom_size, -90, -90)
    geometry_path.lineTo(left_bottom_size, shape_height)
    geometry_path.arcTo(left_bottom_size, left_bottom_size, 0, -90)
    geometry_path.lineTo(0, left_top_size)
    geometry_path.arcTo(left_top_size, left_top_size, 90, -90)
    geometry_path.closeFigure()
    shape.setGeometryPath(geometry_path)
    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Descubrir si la geometría de una forma está cerrada

Una forma cerrada se define como aquella en la que todos sus lados se conectan, formando un único contorno sin huecos. Esa forma puede ser una figura geométrica simple o un contorno personalizado complejo. El siguiente ejemplo de código muestra cómo comprobar si la geometría de una forma está cerrada:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import PathCommandType

def is_geometry_closed(geometry_shape):
    is_closed = False
    for geometry_path in geometry_shape.getGeometryPaths():
        path_data = geometry_path.getPathData()
        if len(path_data) == 0:
            continue
        last_segment = path_data[-1]
        is_closed = last_segment.getPathCommand() == PathCommandType.Close
        if not is_closed:
            return False
    return is_closed

Convertir GeometryPath a java.awt.Shape

Crea una instancia de la clase GeometryShape.
Crea una instancia de la clase java.awt.Shape.
Convierte la instancia de java.awt Shape a la instancia GeometryPath recorriendo su PathIterator y reproduciendo cada segmento en la ruta.
Aplica las rutas a la forma.

Este código Python implementa los pasos anteriores para convertir una ruta gráfica a una ruta de geometría:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath, PathFillModeType

from java.awt import Font
from java.awt.geom import PathIterator
from java.awt.image import BufferedImage

presentation = Presentation()
try:
    # Crear una nueva forma.
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 100)

    # Obtener la ruta de geometría de la forma.
    original_path = shape.getGeometryPaths()[0]
    original_path.setFillMode(PathFillModeType.None_)

    # Crear una nueva ruta gráfica con texto.
    font = Font("Arial", Font.PLAIN, 40)
    text = "Text in shape"
    image = BufferedImage(100, 100, BufferedImage.TYPE_INT_ARGB)
    graphics = image.createGraphics()
    try:
        glyph_vector = font.createGlyphVector(graphics.getFontRenderContext(), text)
        graphics_path = glyph_vector.getOutline(20.0, -glyph_vector.getVisualBounds().getY() + 10)
    finally:
        graphics.dispose()

    # Convertir la ruta gráfica a una ruta de geometría.
    text_path = GeometryPath()
    path_iterator = graphics_path.getPathIterator(None)
    points = jpype.JArray(jpype.JFloat)(6)
    while not path_iterator.isDone():
        segment_type = path_iterator.currentSegment(points)
        if segment_type == PathIterator.SEG_MOVETO:
            text_path.moveTo(points[0], points[1])
        elif segment_type == PathIterator.SEG_LINETO:
            text_path.lineTo(points[0], points[1])
        elif segment_type == PathIterator.SEG_QUADTO:
            text_path.quadraticBezierTo(points[0], points[1], points[2], points[3])
        elif segment_type == PathIterator.SEG_CUBICTO:
            text_path.cubicBezierTo(points[0], points[1], points[2], points[3], points[4], points[5])
        elif segment_type == PathIterator.SEG_CLOSE:
            text_path.closeFigure()
        path_iterator.next()
    text_path.setFillMode(PathFillModeType.Normal)

    # Aplicar la ruta de texto junto con la ruta de geometría original.
    shape.setGeometryPaths([original_path, text_path])
finally:
    presentation.dispose()

example5_image

Preguntas frecuentes

¿Qué ocurrirá con el relleno y el contorno después de reemplazar la geometría?

El estilo permanece con la forma; solo cambia el contorno. El relleno y el contorno se aplican automáticamente a la nueva geometría.

¿Cómo rotar correctamente una forma personalizada junto con su geometría?

Utiliza el método setRotation de la forma; la geometría gira con la forma porque está vinculada al propio sistema de coordenadas de la forma.

¿Puedo convertir una forma personalizada en una imagen para “bloquear” el resultado?

Sí. Exporta la zona de la slide requerida o la propia shape a un formato raster; esto simplifica el trabajo posterior con geometrías complejas.

Gestionar conectores en presentaciones en Python mediante Java Añadir elipses a presentaciones en Python mediante Java