Python でプレゼンテーションのコネクタを管理する

はじめに

PowerPoint のコネクタは、2 つの図形を結ぶ特殊な線で、スライド上で図形を移動または再配置しても接続されたままです。コネクタは図形上の connection points（緑の点）に接続します。ポインタが近づくと connection points が表示されます。特定のコネクタに利用できる Adjustment handles（黄色の点）を使用すると、コネクタの位置や形状を変更できます。

コネクタの種類

PowerPoint では、直線、エルボー（折れ線）、曲線の 3 種類のコネクタを使用できます。

Aspose.Slides は以下のコネクタの種類をサポートしています。

コネクタの種類	画像	調整ポイントの数
`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

コネクタで図形を接続する

このセクションでは、Aspose.Slides で図形をコネクタでリンクする方法を示します。スライドにコネクタを追加し、開始点と終了点を対象の図形に接続します。接続サイトを使用すると、図形が移動またはサイズ変更されてもコネクタが「くっついた」状態を保ちます。

Presentation クラスのインスタンスを作成します。
インデックスでスライドへの参照を取得します。
ShapeCollection オブジェクトが提供する add_auto_shape メソッドを使用して、スライドに 2 つの AutoShape オブジェクトを追加します。
ShapeCollection オブジェクトが提供する add_connector メソッドを使用してコネクタを追加し、コネクタの種類を指定します。
コネクタで図形を接続します。
reroute メソッドを呼び出して、最短接続パスを適用します。
プレゼンテーションを保存します。

以下の Python コードは、楕円と矩形の間に折れ線コネクタを追加する方法を示しています:

import aspose.slides as slides

# PPTX ファイルを作成するために Presentation クラスのインスタンスを作成します。
with slides.Presentation() as presentation:

    # 最初のスライドのシェイプ コレクションにアクセスします。
    shapes = presentation.slides[0].shapes

    # 楕円の AutoShape を追加します。
    ellipse = shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 50, 50, 100, 100)

    # 矩形の AutoShape を追加します。
    rectangle = shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 200, 100, 100)

    # スライドにコネクタを追加します。
    connector = shapes.add_connector(slides.ShapeType.BENT_CONNECTOR2, 0, 0, 10, 10)

    # コネクタで図形を接続します。
    connector.start_shape_connected_to = ellipse
    connector.end_shape_connected_to = rectangle

    # 最短パスを設定するために reroute を呼び出します。
    connector.reroute()

    # プレゼンテーションを保存します。
    presentation.save("connected_shapes.pptx", slides.export.SaveFormat.PPTX)

NOTE

connector.reroute メソッドはコネクタを再ルーティングし、図形間で可能な限り最短のパスを取らせます。その際、start_shape_connection_site_index と end_shape_connection_site_index の値が変更されることがあります。

接続ポイントの指定

このセクションでは、Aspose.Slides でコネクタを図形上の特定の接続ポイントに固定する方法を説明します。正確な接続サイトを指定することで、コネクタの経路とレイアウトを制御し、プレゼンテーション内で整然とした予測可能な図を作成できます。

Presentation クラスのインスタンスを作成します。
インデックスでスライドへの参照を取得します。
ShapeCollection オブジェクトが提供する add_auto_shape メソッドを使用して、スライドに 2 つの AutoShape オブジェクトを追加します。
ShapeCollection オブジェクトの add_connector メソッドでコネクタを追加し、コネクタの種類を指定します。
コネクタで図形を接続します。
図形上の希望する接続ポイントを設定します。
プレゼンテーションを保存します。

以下の Python コードは、希望する接続ポイントを指定する方法を示しています:

import aspose.slides as slides

# PPTX ファイルを作成するために Presentation クラスのインスタンスを生成します。
with slides.Presentation() as presentation:

    # 最初のスライドのシェイプ コレクションにアクセスします。
    shapes = presentation.slides[0].shapes

    # 楕円の AutoShape を追加します。
    ellipse = shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 50, 50, 100, 100)

    # 矩形の AutoShape を追加します。
    rectangle = shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 150, 200, 100, 100)

    # スライドのシェイプ コレクションにコネクタを追加します。
    connector = shapes.add_connector(slides.ShapeType.BENT_CONNECTOR3, 0, 0, 10, 10)

    # コネクタで図形を接続します。
    connector.start_shape_connected_to = ellipse
    connector.end_shape_connected_to = rectangle

    # 楕円の優先接続サイト インデックスを設定します。
    site_index = 6

    # 優先インデックスが利用可能なサイト数以内であることを確認します。
    if  ellipse.connection_site_count > site_index:
        # 楕円 AutoShape に優先接続サイトを割り当てます。
        connector.start_shape_connection_site_index = site_index

    # プレゼンテーションを保存します。
    presentation.save("connection_points.pptx", slides.export.SaveFormat.PPTX)

コネクタポイントの調整

調整ポイントを使用してコネクタを変更できます。調整ポイントを公開しているコネクタだけがこの方法で編集可能です。どのコネクタが調整に対応しているかは、コネクタの種類の表をご参照ください。

シンプルなケース

2 つの図形（A と B）を結ぶコネクタが 3 番目の図形（C）と交差しているケースを考えます:

コネクタの障害

コード例:

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

3 番目の図形を回避するために、縦セグメントを左へ移動してコネクタを調整します:

調整後のコネクタ障害回避

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

複雑なケース

より高度な調整の場合、以下を考慮してください。

コネクタの調整ポイントは位置を決定する数式に支配されます。このポイントを変更するとコネクタ全体の形状が変わります。
コネクタの調整ポイントは厳密に順序付けられた配列に格納され、コネクタの開始点から終了点へ番号付けされます。
調整ポイントの値はコネクタ形状の幅/高さのパーセンテージを表します。
- 形状はコネクタの開始点と終了点で境界付けされ、1000 でスケーリングされます。
- 最初、二番目、三番目の調整ポイントはそれぞれ幅のパーセンテージ、高さのパーセンテージ、再び幅のパーセンテージを表します。
調整ポイントの座標を計算する際は、コネクタの回転と反転を考慮してください。注: コネクタの種類に列挙されているすべてのコネクタは回転角が 0 です。

ケース 1

2 つのテキストフレームオブジェクトがコネクタでリンクされているケースを考えます:

リンクされた図形

コード例:

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

# PPTX ファイルを作成するために Presentation クラスのインスタンスを生成します。
with slides.Presentation() as presentation:

    # 最初のスライドを取得します。
    slide = presentation.slides[0]

    # 最初のスライドを取得します。
    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"

    # コネクタを追加します。
    connector = slide.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.crimson
    # コネクタの線の太さを設定します。
    connector.line_format.width = 3

    # コネクタで図形を接続します。
    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

    # コネクタの調整ポイントを取得します。
    adjustment_0 = connector.adjustments[0]
    adjustment_1 = connector.adjustments[1]

調整

幅のパーセンテージを 20% 増加し、高さのパーセンテージを 200% 増加させて、コネクタの調整ポイントの値を変更します:

    # 調整ポイントの値を変更します。
    adjustment_0.raw_value += 20000
    adjustment_1.raw_value += 200000

結果:

コネクタ調整 1

connector.adjustments[0] に対応する垂直コンポーネントの形状を作成して、コネクタのセグメント座標と形状を決定できるモデルを定義します:

    # コネクタの垂直コンポーネントを描画します。
    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)

結果:

コネクタ調整 2

ケース 2

ケース 1 では、基本原則を用いたシンプルなコネクタ調整を示しました。実際のシナリオでは、コネクタの回転や表示設定（connector.rotation、connector.frame.flip_h、connector.frame.flip_v）も考慮する必要があります。以下に手順を示します。

最初に、スライドに新しいテキストフレームオブジェクト（To 1）を追加し、既存オブジェクトに接続する緑のコネクタを作成します。

    # 新しいターゲットオブジェクトを作成します。
    shape_to_1 = sld.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 400, 60, 25)
    shape_to_1.text_frame.text = "To 1"

    # 新しいコネクタを作成します。
    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

    # 作成したコネクタでオブジェクトを接続します。
    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

    # コネクタの調整ポイントを取得します。
    adjustment_0 = connector.adjustments[0]
    adjustment_1 = connector.adjustments[1]
    
    # 調整ポイントの値を変更します。
    adjustment_0.raw_value += 20000
    adjustment_1.raw_value += 200000

結果:

コネクタ調整 3

次に、新しいコネクタの調整ポイント connector.adjustments[0] を通過する horizontal セグメントに対応する形状を作成します。connector.rotation、connector.frame.flip_h、connector.frame.flip_v の値を使用し、基準点 x0 周りの回転に対する標準座標変換式を適用します。

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

本例ではオブジェクトの回転角は 90 度で、コネクタは垂直に表示されるため、対応するコードは次のとおりです:

    # コネクタの座標を保存します。
    x = connector.x
    y = connector.y
    
    # コネクタがフリップされている場合は座標を補正します。
    if connector.frame.flip_h == 1:
        x += connector.width
    if connector.frame.flip_v == 1:
        y += connector.height

    # 調整ポイントの値を座標として使用します。
    x += connector.width * adjValue_0.raw_value / 100000
    
    # sin(90°)=1, cos(90°)=0 のため座標を変換します。
    xx = connector.frame.center_x - y + connector.frame.center_y
    yy = x - connector.frame.center_x + connector.frame.center_y

    # 第2調整ポイントの値を使って水平セグメントの幅を決定します。
    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

結果:

コネクタ調整 4

シンプルな調整と、回転を考慮した複雑な調整ポイントの計算例を示しました。この知識を活用して、座標に基づく GraphicsPath オブジェクトを取得したり、スライド座標に応じてコネクタの調整ポイント値を設定したりする独自のモデルやコードを作成できます。

コネクタ線の角度を求める

以下の例を使用して、Aspose.Slides でスライド上のコネクタ線の角度を求める方法を学びます。コネクタの端点を取得し、向きを計算することで、矢印やラベル、その他の図形を正確に配置できます。

Presentation クラスのインスタンスを作成します。
インデックスでスライドへの参照を取得します。
コネクタ線のシェイプにアクセスします。
線の幅と高さ、シェイプフレームの幅と高さを使用して角度を計算します。

以下の Python コードは、コネクタ線シェイプの角度を計算する方法を示しています:

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)

よくある質問

特定の図形にコネクタを「くっつけ」られるかどうかはどうやって確認できますか？

その図形が connection sites を公開しているか確認してください。存在しない、またはカウントが 0 の場合はくっ付けは利用できません。その場合は自由端点を使用し、手動で位置を設定します。接続前にサイト数をチェックするのが賢明です。

接続されている図形の一方を削除した場合、コネクタはどうなりますか？

端点は切り離され、コネクタは普通の線としてスライド上に残ります（開始点/終了点が自由になります）。削除するか、接続を再割り当てし、必要に応じて reroute してください。

スライドを別のプレゼンテーションにコピーしたとき、コネクタのバインディングは保持されますか？

通常は保持されますが、対象の図形も同時にコピーされていることが前提です。接続された図形が存在しない状態でスライドを別ファイルに挿入した場合、端点は自由になり、再接続が必要になります。

Python を使用したプレゼンテーションの形状カスタマイズ