Administrar conectores en presentaciones con Python

Introducción

Un conector de PowerPoint es una línea especializada que enlaza dos formas y permanece adherida cuando las formas se mueven o se reposicionan en una diapositiva. Los conectores se unen a puntos de conexión (puntos verdes) en las formas. Los puntos de conexión aparecen cuando el puntero se acerca a ellos. Los mangos de ajuste (puntos amarillos), disponibles en ciertos conectores, le permiten modificar la posición y la forma del conector.

Tipos de Conector

En PowerPoint, puede usar tres tipos de conectores: recto, codo (angular) y curvo.

Aspose.Slides admite los siguientes tipos de conectores:

Tipo de Conector	Imagen	Número de puntos de ajuste
`ShapeType.LINE`		0
`ShapeType.STRAIGHT_CONNECTOR1`		0
`ShapeType.BENT_CONNECTOR2`		0
`ShapeType.BENT_CONNECTOR3`		1
`ShapeType.BENT_CONNECTOR4`		2
`ShapeType.BENT_CONNECTOR5`		3
`ShapeType.CURVED_CONNECTOR2`		0
`ShapeType.CURVED_CONNECTOR3`		1
`ShapeType.CURVED_CONNECTOR4`		2
`ShapeType.CURVED_CONNECTOR5`		3

Conectar Formas con Conectores

Esta sección muestra cómo enlazar formas con conectores en Aspose.Slides. Añadirá un conector a una diapositiva, adjuntará su inicio y fin a las formas objetivo. Usar sitios de conexión garantiza que el conector permanezca «pegado» a las formas incluso cuando se muevan o cambien de tamaño.

Cree una instancia de la clase Presentation.
Obtenga una referencia a la diapositiva por su índice.
Añada dos objetos AutoShape a la diapositiva mediante el método add_auto_shape expuesto por el objeto ShapeCollection.
Añada un conector usando el método add_connector expuesto por el objeto ShapeCollection y especifique el tipo de conector.
Conecte las formas con el conector.
Llame al método reroute para aplicar la ruta de conexión más corta.
Guarde la presentación.

El siguiente código Python muestra cómo agregar un conector doblado entre dos formas (una elipse y un rectángulo):

import aspose.slides as slides

# Instanciar la clase Presentation para crear un archivo PPTX.
with slides.Presentation() as presentation:

    # Acceder a la colección de formas de la primera diapositiva.
    shapes = presentation.slides[0].shapes

    # Añadir una AutoShape de elipse.
    ellipse = shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 50, 50, 100, 100)

    # Añadir una AutoShape de rectángulo.
    rectangle = shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 200, 100, 100)

    # Añadir un conector a la diapositiva.
    connector = shapes.add_connector(slides.ShapeType.BENT_CONNECTOR2, 0, 0, 10, 10)

    # Conectar las formas con el conector.
    connector.start_shape_connected_to = ellipse
    connector.end_shape_connected_to = rectangle

    # Llamar a reroute para establecer la ruta más corta.
    connector.reroute()

    # Guardar la presentación.
    presentation.save("connected_shapes.pptx", slides.export.SaveFormat.PPTX)

NOTE

El método connector.reroute reencamina un conector, obligándolo a tomar la ruta más corta posible entre las formas. Para ello, el método puede cambiar los valores start_shape_connection_site_index y end_shape_connection_site_index.

Especificar Puntos de Conexión

Esta sección explica cómo adjuntar un conector a un punto de conexión específico en una forma en Aspose.Slides. Al apuntar a sitios de conexión precisos, puede controlar el enrutamiento y la disposición del conector, produciendo diagramas limpios y predecibles en sus presentaciones.

Cree una instancia de la clase Presentation.
Obtenga una referencia a la diapositiva por su índice.
Añada dos objetos AutoShape a la diapositiva mediante el método add_auto_shape expuesto por el objeto ShapeCollection.
Añada un conector usando el método add_connector en el objeto ShapeCollection y especifique el tipo de conector.
Conecte las formas con el conector.
Establezca sus puntos de conexión preferidos en las formas.
Guarde la presentación.

El siguiente código Python muestra cómo especificar un punto de conexión preferido:

import aspose.slides as slides

# Instanciar la clase Presentation para crear un archivo PPTX.
with slides.Presentation() as presentation:

    # Acceder a la colección de formas de la primera diapositiva.
    shapes = presentation.slides[0].shapes

    # Añadir una AutoShape de elipse.
    ellipse = shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 50, 50, 100, 100)

    # Añadir una AutoShape de rectángulo.
    rectangle = shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 200, 100, 100)

    # Añadir un conector a la colección de formas de la diapositiva.
    connector = shapes.add_connector(slides.ShapeType.BENT_CONNECTOR3, 0, 0, 10, 10)

    # Conectar las formas con el conector.
    connector.start_shape_connected_to = ellipse
    connector.end_shape_connected_to = rectangle

    # Establecer el índice del sitio de conexión preferido en la elipse.
    site_index = 6

    # Verificar que el índice preferido está dentro del recuento de sitios disponible.
    if  ellipse.connection_site_count > site_index:
        # Asignar el sitio de conexión preferido en la AutoShape de la elipse.
        connector.start_shape_connection_site_index = site_index

    # Guardar la presentación.
    presentation.save("connection_points.pptx", slides.export.SaveFormat.PPTX)

Ajustar Puntos del Conector

Puede modificar los conectores usando sus puntos de ajuste. Sólo los conectores que exponen puntos de ajuste pueden editarse de esta forma. Para obtener detalles sobre qué conectores admiten ajustes, consulte la tabla bajo Connector Types.

Caso Simple

Considere un caso donde un conector entre dos formas (A y B) intersecta una tercera forma (C):

Obstrucción del conector

Ejemplo de código:

import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 300, 150, 150, 75)
    shape_from = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 500, 400, 100, 50)
    shape_to = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 70, 30)
    
    connector = slide.shapes.add_connector(slides.ShapeType.BENT_CONNECTOR5, 20, 20, 400, 300)
    
    connector.line_format.end_arrowhead_style = slides.LineArrowheadStyle.TRIANGLE
    connector.line_format.fill_format.fill_type = slides.FillType.SOLID
    connector.line_format.fill_format.solid_fill_color.color = draw.Color.black
    
    connector.start_shape_connected_to = shape_from
    connector.end_shape_connected_to = shape_to
    connector.start_shape_connection_site_index = 2

Para evitar la tercera forma, ajuste el conector moviendo su segmento vertical hacia la izquierda:

Obstrucción del conector corregida

    adjustment2 = connector.adjustments[1]
    adjustment2.raw_value += 10000

Casos Complejos

Para ajustes más avanzados, considere lo siguiente:

El punto ajustable de un conector está gobernado por una fórmula que determina su posición. Cambiar este punto puede alterar la forma general del conector.
Los puntos de ajuste de un conector se almacenan en una matriz estrictamente ordenada, numerada desde el inicio del conector hasta su fin.
Los valores de los puntos de ajuste representan porcentajes del ancho/alto de la forma del conector.
- La forma está limitada por los puntos de inicio y fin del conector y se escala por 1000.
- El primer, segundo y tercer punto de ajuste representan: porcentaje de ancho, porcentaje de alto y porcentaje de ancho (de nuevo), respectivamente.
Al calcular las coordenadas de los puntos de ajuste, tenga en cuenta la rotación y reflexión del conector. Nota: Para todos los conectores listados bajo Connector Types, el ángulo de rotación es 0.

Caso 1

Considere un caso donde dos objetos de marco de texto están enlazados con un conector:

Formas enlazadas

import aspose.slides as slides
import aspose.pydrawing as draw

# Instanciar la clase Presentation para crear un archivo PPTX.
with slides.Presentation() as presentation:

    # Obtener la primera diapositiva.
    slide = presentation.slides[0]

    # Obtener la primera diapositiva.
    shape_from = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 60, 25)
    shape_from.text_frame.text = "From"
    shape_to = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 500, 100, 60, 25)
    shape_to.text_frame.text = "To"

    # Añadir un conector.
    connector = slide.shapes.add_connector(slides.ShapeType.BENT_CONNECTOR4, 20, 20, 400, 300)
    # Establecer la dirección del conector.
    connector.line_format.end_arrowhead_style = slides.LineArrowheadStyle.TRIANGLE
    # Establecer el color del conector.
    connector.line_format.fill_format.fill_type = slides.FillType.SOLID
    connector.line_format.fill_format.solid_fill_color.color = draw.Color.crimson
    # Establecer el grosor de la línea del conector.
    connector.line_format.width = 3

    # Vincular las formas con el conector.
    connector.start_shape_connected_to = shape_from
    connector.start_shape_connection_site_index = 3
    connector.end_shape_connected_to = shape_to
    connector.end_shape_connection_site_index = 2

    # Obtener los puntos de ajuste del conector.
    adjustment_0 = connector.adjustments[0]
    adjustment_1 = connector.adjustments[1]

Adjustment

Cambie los valores de los puntos de ajuste del conector aumentando el porcentaje de ancho en un 20 % y el porcentaje de alto en un 200 %, respectivamente:

    # Cambiar los valores de los puntos de ajuste.
    adjustment_0.raw_value += 20000
    adjustment_1.raw_value += 200000

El resultado:

Ajuste del conector 1

Para definir un modelo que nos permita determinar las coordenadas y la forma de los segmentos del conector, cree una forma que corresponda al componente vertical del conector en connector.adjustments[0]:

    # Dibujar el componente vertical del conector.
    x = connector.x + connector.width * adjustment_0.raw_value / 100000
    y = connector.y
    height = connector.height * adjustment_1.raw_value / 100000

    slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, x, y, 0, height)

El resultado:

Ajuste del conector 2

Caso 2

En el Caso 1, demostramos un ajuste simple del conector usando principios básicos. En escenarios típicos, debe tener en cuenta la rotación del conector y sus configuraciones de visualización (controladas por connector.rotation, connector.frame.flip_h y connector.frame.flip_v). Así es como funciona el proceso.

Primero, añada un nuevo objeto de marco de texto (To 1) a la diapositiva (para conexión), y cree un nuevo conector verde que lo enlace a los objetos existentes.

    # Crear un nuevo objeto de destino.
    shape_to_1 = sld.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 400, 60, 25)
    shape_to_1.text_frame.text = "To 1"

    # Crear un nuevo conector.
    connector = sld.shapes.add_connector(slides.ShapeType.BENT_CONNECTOR4, 20, 20, 400, 300)
    connector.line_format.end_arrowhead_style = slides.LineArrowheadStyle.TRIANGLE
    connector.line_format.fill_format.fill_type = slides.FillType.SOLID
    connector.line_format.fill_format.solid_fill_color.color = draw.Color.medium_aquamarine
    connector.line_format.width = 3

    # Conectar los objetos mediante el conector recién creado.
    connector.start_shape_connected_to = shapeFrom
    connector.start_shape_connection_site_index = 2
    connector.end_shape_connected_to = shape_to_1
    connector.end_shape_connection_site_index = 3

    # Obtener los puntos de ajuste del conector.
    adjustment_0 = connector.adjustments[0]
    adjustment_1 = connector.adjustments[1]
    
    # Cambiar los valores de los puntos de ajuste.
    adjustment_0.raw_value += 20000
    adjustment_1.raw_value += 200000

El resultado:

Ajuste del conector 3

Segundo, cree una forma que corresponda al segmento horizontal del conector que pasa por el nuevo punto de ajuste del conector, connector.adjustments[0]. Utilice los valores de connector.rotation, connector.frame.flip_h y connector.frame.flip_v, y aplique la fórmula estándar de conversión de coordenadas para rotación alrededor de un punto dado x0:

X = (x — x0) * cos(alpha) — (y — y0) * sin(alpha) + x0; Y = (x — x0) * sin(alpha) + (y — y0) * cos(alpha) + y0;

En nuestro caso, el ángulo de rotación del objeto es 90 grados y el conector se muestra verticalmente, por lo que el código correspondiente es:

    # Guardar las coordenadas del conector.
    x = connector.x
    y = connector.y
    
    # Corregir las coordenadas del conector si está invertido.
    if connector.frame.flip_h == 1:
        x += connector.width
    if connector.frame.flip_v == 1:
        y += connector.height

    # Usar el valor del punto de ajuste como coordenada.
    x += connector.width * adjValue_0.raw_value / 100000
    
    # Convertir las coordenadas porque sin(90°) = 1 y cos(90°) = 0.
    xx = connector.frame.center_x - y + connector.frame.center_y
    yy = x - connector.frame.center_x + connector.frame.center_y

    # Determinar el ancho del segmento horizontal usando el valor del segundo punto de ajuste.
    width = connector.height * adjValue_1.raw_value / 100000
    shape = sld.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, xx, yy, width, 0)
    shape.line_format.fill_format.fill_type = slides.FillType.SOLID
    shape.line_format.fill_format.solid_fill_color.color = draw.Color.red

El resultado:

Ajuste del conector 4

Demostramos cálculos que involucran ajustes simples y puntos de ajuste más complejos (aquellos que consideran la rotación). Con este conocimiento, puede desarrollar su propio modelo —o escribir código— para obtener un objeto GraphicsPath o incluso establecer los valores de los puntos de ajuste de un conector basándose en coordenadas específicas de la diapositiva.

Encontrar Ángulos de Líneas de Conector

Utilice el ejemplo a continuación para determinar el ángulo de las líneas de conector en una diapositiva con Aspose.Slides. Aprenderá cómo leer los puntos finales de un conector y calcular su orientación para alinear con precisión flechas, etiquetas y otras formas.

Cree una instancia de la clase Presentation.
Obtenga una referencia a la diapositiva por índice.
Acceda a la forma de línea del conector.
Utilice el ancho y alto de la línea, y el ancho y alto del marco de la forma, para calcular el ángulo.

El siguiente código Python muestra cómo calcular el ángulo para una forma de línea de conector:

import aspose.slides as slides
import math

def get_direction(w, h, flip_h, flip_v):
    end_line_x = w * (-1 if flip_h else 1)
    end_line_y = h * (-1 if flip_v else 1)
    end_y_axis_x = 0
    end_y_axis_y = h
    angle = math.atan2(end_y_axis_y, end_y_axis_x) - math.atan2(end_line_y, end_line_x)
    if (angle < 0):
         angle += 2 * math.pi
    return angle * 180.0 / math.pi

with slides.Presentation("connector_line_angle.pptx") as presentation:
    slide = presentation.slides[0]
    for shape_index in range(len(slide.shapes)):
        direction = 0.0
        shape = slide.shapes[shape_index]
        if type(shape) is slides.AutoShape and shape.shape_type == slides.ShapeType.LINE:
            direction = get_direction(shape.width, shape.height, shape.frame.flip_h, shape.frame.flip_v)
        elif type(shape) is slides.Connector:
            direction = get_direction(shape.width, shape.height, shape.frame.flip_h, shape.frame.flip_v)
        print(direction)

FAQ

¿Cómo puedo saber si un conector puede estar «pegado» a una forma específica?

Verifique que la forma exponga puntos de conexión. Si no hay ninguno o el recuento es cero, la función de pegado no está disponible; en ese caso, use puntos finales libres y colóquelos manualmente. Es aconsejable comprobar el recuento de sitios antes de adjuntar.

¿Qué ocurre con un conector si elimino una de las formas conectadas?

Sus extremos se desacoplarán; el conector permanecerá en la diapositiva como una línea ordinaria con inicio y fin libres. Puede eliminarlo o reasignar las conexiones y, si es necesario, reroute.

¿Se conservan los enlaces de los conectores al copiar una diapositiva a otra presentación?

Generalmente sí, siempre que las formas objetivo también se copien. Si la diapositiva se inserta en otro archivo sin las formas conectadas, los extremos se vuelven libres y deberá volver a adjuntarlos.

Personalizar formas en presentaciones con Python