Python を使用したプレゼンテーションの形状カスタマイズ
概要
正方形を考えてください。PowerPoint で Edit Points を使用すると、次のことができます。
- 正方形の角を内側または外側に移動する
- 角やポイントの曲率を調整する
- 正方形に新しいポイントを追加する
- ポイントを操作する
これらの操作は任意の図形に適用できます。Edit Points を使用すると、既存の図形を変更したり、既存の図形から新しい図形を作成したりできます。
図形編集のヒント
PowerPoint の図形を Edit Points で編集する前に、図形に関する次の点に留意してください。
- 図形（またはそのパス）は 閉じている か 開いている かのいずれかです。
- 閉じた図形には開始点や終了点がありません。開いた図形には開始点と終了点があります。
- すべての図形は、少なくとも 2 つのアンカーポイントが線分で接続されています。
- 線分は直線または曲線のいずれかで、アンカーポイントがその性質を決定します。
- アンカーポイントは コーナー、スムーズ、または ストレート に分類されます。
- コーナー ポイントは、2 本の直線セグメントが角度を持って交わる場所です。
- スムーズ ポイントは 2 つのハンドルが共線であり、隣接するセグメントが滑らかな曲線を形成します。この場合、両ハンドルはアンカーポイントから同じ距離にあります。
- ストレート ポイントも 2 つのハンドルが共線ですが、ハンドルの距離は同じである必要はありません。
- アンカーポイントを移動または編集して（セグメントの角度を変更して）図形の外観を変えることができます。
PowerPoint の図形を編集するには、Aspose.Slides が提供する GeometryPath クラスを使用します。
- GeometryPath のインスタンスは、GeometryShape オブジェクトのジオメトリパスを表します。
- GeometryShape のインスタンスから GeometryPath を取得するには、GeometryShape.get_geometry_paths メソッドを使用します。
- 図形に GeometryPath を設定するには、単体図形 の場合は GeometryShape.set_geometry_path を、複合図形 の場合は GeometryShape.set_geometry_paths を使用します。
- セグメントを追加するには、GeometryPath のメソッドを使用します。
- ジオメトリパスの外観は、GeometryPath.stroke および GeometryPath.fill_mode プロパティで制御します。
- 図形のジオメトリパスをパスセグメントの配列として取得するには、GeometryPath.path_data プロパティを使用します。
シンプルな編集操作
以下のメソッドはシンプルな編集操作に使用されます。
パスの末尾に直線を追加:
line_to(point)
line_to(x, y)
パスの指定位置に直線を追加:
line_to(point, index)
line_to(x, y, index)
パスの末尾に 3 次ベジェ曲線を追加:
cubic_bezier_to(point1, point2, point3)
cubic_bezier_to(x1, y1, x2, y2, x3, y3)
パスの指定位置に 3 次ベジェ曲線を追加:
cubic_bezier_to(point1, point2, point3, index)
cubic_bezier_to(x1, y1, x2, y2, x3, y3, index)
パスの末尾に 2 次ベジェ曲線を追加:
quadratic_bezier_to(point1, point2)
quadratic_bezier_to(x1, y1, x2, y2)
パスの指定位置に 2 次ベジェ曲線を追加:
quadratic_bezier_to(point1, point2, index)
quadratic_bezier_to(x1, y1, x2, y2, index)
パスに円弧を追加:
arc_to(width, heigth, startAngle, sweepAngle)
パス内の現在の図形を閉じる:
close_figure()
次のポイントの位置を設定:
move_to(point)
move_to(x, y)
指定インデックスのパスセグメントを削除:
remove_at(index)
図形にカスタムポイントを追加
ここでは、独自のポイントシーケンスを追加してフリーフォーム図形を定義する方法を学びます。順序付けられたポイントとセグメントタイプ（直線または曲線）を指定し、必要に応じてパスを閉じることで、正確なカスタムグラフィック（多角形、アイコン、吹き出し、ロゴなど）をスライド上に直接描画できます。
- GeometryShape クラスのインスタンスを作成し、ShapeType.RECTANGLE を設定します。
- 図形から GeometryPath のインスタンスを取得します。
- パス上の上部 2 点の間に新しいポイントを挿入します。
- パス上の下部 2 点の間に新しいポイントを挿入します。
- 更新されたパスを図形に適用します。
以下の Python コードは、図形にカスタムポイントを追加する方法を示しています:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 200, 100)
geometry_path = shape.get_geometry_paths()[0]
geometry_path.line_to(100, 50, 1)
geometry_path.line_to(100, 50, 4)
shape.set_geometry_path(geometry_path)
presentation.save("custom_points.pptx", slides.export.SaveFormat.PPTX)
図形からポイントを削除
カスタム形状に不要なポイントが含まれていると、ジオメトリが複雑になったり、レンダリングに影響したりします。このセクションでは、図形のパスから特定のポイントを削除して輪郭をシンプルにし、よりクリーンで正確な結果を得る方法を示します。
- GeometryShape クラスのインスタンスを作成し、ShapeType.HEART タイプを設定します。
- 図形から GeometryPath のインスタンスを取得します。
- パスからセグメントを削除します。
- 更新されたパスを図形に適用します。
以下の Python コードは、図形からポイントを削除する方法を示しています:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.HEART, 100, 100, 300, 300)
path = shape.get_geometry_paths()[0]
path.remove_at(2)
shape.set_geometry_path(path)
presentation.save("removed_points.pptx", slides.export.SaveFormat.PPTX)
カスタム形状の作成
GeometryPath を定義し、直線、円弧、ベジエ曲線で構成することで、オリジナルのベクター形状を作成します。このセクションでは、ゼロからジオメトリを構築し、スライドに形状を追加する方法を示します。
- 形状のポイントを計算します。
- GeometryPath クラスのインスタンスを作成します。
- パスにポイントを設定します。
- GeometryShape クラスのインスタンスを作成します。
- パスを形状に適用します。
以下の Python コードは、カスタム形状を作成する方法を示しています:
import aspose.slides as slides
import aspose.pydrawing as draw
import math
points = []
R = 100
r = 50
step = 72
for angle in range(-90, 270, step):
radians = angle * (math.pi / 180)
x = R * math.cos(radians)
y = R * math.sin(radians)
points.append(draw.PointF(x + R, y + R))
radians = math.pi * (angle + step / 2) / 180.0
x = r * math.cos(radians)
y = r * math.sin(radians)
points.append(draw.PointF(x + R, y + R))
star_path = slides.GeometryPath()
star_path.move_to(points[0])
for i in range(len(points)):
star_path.line_to(points[i])
star_path.close_figure()
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, R * 2, R * 2)
shape.set_geometry_path(star_path)
presentation.save("custom_shape.pptx", slides.export.SaveFormat.PPTX)
複合カスタム形状の作成
複合カスタム形状を作成すると、複数のジオメトリパスを 1 つの再利用可能な形状に結合できます。これらのパスを定義して結合することで、標準の図形セットを超える複雑なビジュアルを構築できます。
- GeometryShape クラスのインスタンスを作成します。
- 最初の GeometryPath クラスのインスタンスを作成します。
- 2 番目の GeometryPath クラスのインスタンスを作成します。
- 両方のパスを形状に適用します。
以下の Python コードは、複合カスタム形状を作成する方法を示しています:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 100, 100, 200, 100)
geometry_path_0 = slides.GeometryPath()
geometry_path_0.move_to(0, 0)
geometry_path_0.line_to(shape.width, 0)
geometry_path_0.line_to(shape.width, shape.height/3)
geometry_path_0.line_to(0, shape.height / 3)
geometry_path_0.close_figure()
geometry_path_1 = slides.GeometryPath()
geometry_path_1.move_to(0, shape.height/3 * 2)
geometry_path_1.line_to(shape.width, shape.height / 3 * 2)
geometry_path_1.line_to(shape.width, shape.height)
geometry_path_1.line_to(0, shape.height)
geometry_path_1.close_figure()
shape.set_geometry_paths([ geometry_path_0, geometry_path_1])
presentation.save("composite_shape.pptx", slides.export.SaveFormat.PPTX)
曲線コーナー付きカスタム形状の作成
このセクションでは、ジオメトリパスを使用して滑らかな曲線コーナーを持つカスタム形状を描く方法を示します。直線セグメントと円弧を組み合わせて輪郭を形成し、完成した形状をスライドに追加します。
以下の Python コードは、曲線コーナー付きカスタム形状を作成する方法を示しています:
import aspose.slides as slides
import aspose.pydrawing as draw
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
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(
slides.ShapeType.CUSTOM, shape_x, shape_y, shape_width, shape_height)
point1 = draw.PointF(left_top_size, 0)
point2 = draw.PointF(shape_width - right_top_size, 0)
point3 = draw.PointF(shape_width, shape_height - right_bottom_size)
point4 = draw.PointF(left_bottom_size, shape_height)
point5 = draw.PointF(0, left_top_size)
geometry_path = slides.GeometryPath()
geometry_path.move_to(point1)
geometry_path.line_to(point2)
geometry_path.arc_to(right_top_size, right_top_size, 180, -90)
geometry_path.line_to(point3)
geometry_path.arc_to(right_bottom_size, right_bottom_size, -90, -90)
geometry_path.line_to(point4)
geometry_path.arc_to(left_bottom_size, left_bottom_size, 0, -90)
geometry_path.line_to(point5)
geometry_path.arc_to(left_top_size, left_top_size, 90, -90)
geometry_path.close_figure()
shape.set_geometry_path(geometry_path)
presentation.save("curved_corners.pptx", slides.export.SaveFormat.PPTX)
形状ジオメトリが閉じているかの判定
閉じた形状は、すべての辺が接続され、ギャップのない単一の境界を形成するものとして定義されます。このような形状は単純な幾何形状でも複雑なカスタム輪郭でも構いません。以下のコード例は、形状ジオメトリが閉じているかどうかを確認する方法を示します:
def is_geometry_closed(geometry_shape):
is_closed = None
for geometry_path in geometry_shape.get_geometry_paths():
data_length = len(geometry_path.path_data)
if data_length == 0:
continue
last_segment = geometry_path.path_data[data_length - 1]
is_closed = last_segment.path_command == PathCommandType.CLOSE
if not is_closed:
return False
return is_closed
FAQ
ジオメトリを置き換えた後、塗りつぶしと輪郭はどうなりますか？
スタイルは図形に残り、輪郭だけが変更されます。塗りつぶしと輪郭は新しいジオメトリに自動的に適用されます。
ジオメトリとともにカスタム形状を正しく回転させるにはどうすればよいですか？
図形の rotation プロパティを使用します。ジオメトリは図形の座標系にバインドされているため、図形とともに回転します。
カスタム形状を画像に変換して「ロック」できますか？
はい。必要な slide 領域または shape 自体をラスタ形式でエクスポートすれば、重いジオメトリの後続作業が簡素化されます。