.NET でプレゼンテーションのシェイプをカスタマイズ

編集ポイントを使用してシェイプを変更する

正方形を考えてみましょう。PowerPoint で 編集ポイント を使用すると、次のことができます

• 正方形の角を内側または外側に移動する
• 角や点の曲率を指定する
• 正方形に新しい点を追加する
• 正方形上の点を操作するなど

実質的に、これらの操作は任意のシェイプで実行できます。編集ポイントを使用すると、シェイプを変更したり、既存のシェイプから新しいシェイプを作成したりできます。

シェイプ編集のヒント

編集ポイントで PowerPoint のシェイプを編集し始める前に、シェイプに関して以下の点を考慮するとよいでしょう：

• シェイプ（またはそのパス）は閉じている場合と開いている場合があります。
• すべてのシェイプは、少なくとも 2 つのアンカーポイントが線でつながれた構成になっています。
• 線は直線または曲線のいずれかです。アンカーポイントが線の性質を決定します。
• アンカーポイントはコーナーポイント、ストレートポイント、またはスムーズポイントとして存在します：
  • コーナーポイントは、2 本の直線が角度を持って接続する点です。
  • スムーズポイントは、2 つのハンドルが一直線上にあり、線のセグメントが滑らかな曲線でつながる点です。この場合、すべてのハンドルはアンカーポイントから等距離に分離しています。
  • ストレートポイントは、2 つのハンドルが一直線上にあり、線のセグメントが滑らかな曲線でつながる点です。この場合、ハンドルはアンカーポイントから等距離にある必要はありません。
• アンカーポイントを移動または編集（線の角度が変わります）することで、シェイプの外観を変更できます。

編集ポイントで PowerPoint のシェイプを編集するには、Aspose.Slides が GeometryPath クラスと IGeometryPath インターフェイスを提供します。

• GeometryPath のインスタンスは、IGeometryShape オブジェクトのジオメトリパスを表します。
• IGeometryShape インスタンスから GeometryPath を取得するには、IGeometryShape.GetGeometryPaths メソッドを使用できます。
• シェイプに GeometryPath を設定するには、solid shapes 用に IGeometryShape.SetGeometryPath 、composite shapes 用に IGeometryShape.SetGeometryPaths メソッドを使用します。
• セグメントを追加するには、IGeometryPath の下にあるメソッドを使用できます。
• IGeometryPath.Stroke と IGeometryPath.FillMode プロパティを使用して、ジオメトリパスの外観を設定できます。
• IGeometryPath.PathData プロパティを使用して、GeometryShape のジオメトリパスをパスセグメントの配列として取得できます。
• 追加のシェイプジオメトリ カスタマイズ オプションにアクセスするには、GeometryPath を GraphicsPath に変換できます。
• GeometryPathToGraphicsPath と GraphicsPathToGeometryPath メソッド（ShapeUtil クラスから）を使用して、GeometryPath と GraphicsPath を相互に変換できます。

シンプルな編集操作

この C# コードは、以下の方法を示しています

パスの末尾に直線を追加

void LineTo(PointF point);
void LineTo(float x, float y);

パスの指定位置に直線を追加:

void LineTo(PointF point, uint index);
void LineTo(float x, float y, uint index);

パスの末尾に3次ベジエ曲線を追加:

void CubicBezierTo(PointF point1, PointF point2, PointF point3);
void CubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3);

パスの指定位置に3次ベジエ曲線を追加:

void CubicBezierTo(PointF point1, PointF point2, PointF point3, uint index);
void CubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3, uint index);

パスの末尾に2次ベジエ曲線を追加:

void QuadraticBezierTo(PointF point1, PointF point2);
void QuadraticBezierTo(float x1, float y1, float x2, float y2);

パスの指定位置に2次ベジエ曲線を追加:

void QuadraticBezierTo(PointF point1, PointF point2, uint index);
void QuadraticBezierTo(float x1, float y1, float x2, float y2, uint index);

パスに指定の円弧を追加:

void ArcTo(float width, float heigth, float startAngle, float sweepAngle);

パスの現在の図形を閉じる:

void CloseFigure();

次のポイントの位置を設定:

void MoveTo(PointF point);
void MoveTo(float x, float y);

指定されたインデックスのパスセグメントを削除:

void RemoveAt(int index);

シェイプへカスタムポイントを追加

1. GeometryShape クラスのインスタンスを作成し、ShapeType.Rectangle タイプを設定します。
2. シェイプから GeometryPath クラスのインスタンスを取得します。
3. パス上の上部の 2 つのポイント間に新しいポイントを追加します。
4. パス上の下部の 2 つのポイント間に新しいポイントを追加します。
5. パスをシェイプに適用します。

この C# コードは、シェイプにカスタムポイントを追加する方法を示しています:

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100) as GeometryShape;
    IGeometryPath geometryPath = shape.GetGeometryPaths()[0];

    geometryPath.LineTo(100, 50, 1);
    geometryPath.LineTo(100, 50, 4);
    shape.SetGeometryPath(geometryPath);
}

シェイプからポイントを削除

1. GeometryShape クラスのインスタンスを作成し、ShapeType.Heart タイプを設定します。
2. シェイプから GeometryPath クラスのインスタンスを取得します。
3. パスのセグメントを削除します。
4. パスをシェイプに適用します。

この C# コードは、シェイプからポイントを削除する方法を示しています:

using (Presentation pres = new Presentation())
{
	GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Heart, 100, 100, 300, 300) as GeometryShape;

	IGeometryPath path = shape.GetGeometryPaths()[0];
	path.RemoveAt(2);
	shape.SetGeometryPath(path);
}

カスタムシェイプを作成

1. シェイプのポイントを計算します。
2. GeometryPath クラスのインスタンスを作成します。
3. ポイントでパスを埋めます。
4. GeometryShape クラスのインスタンスを作成します。
5. パスをシェイプに適用します。

この C# は、カスタムシェイプを作成する方法を示しています:

List<PointF> points = new List<PointF>();

float R = 100, r = 50;
int step = 72;

for (int angle = -90; angle < 270; angle += step)
{
    double radians = angle * (Math.PI / 180f);
    double x = R * Math.Cos(radians);
    double y = R * Math.Sin(radians);
    points.Add(new PointF((float)x + R, (float)y + R));

    radians = Math.PI * (angle + step / 2) / 180.0;
    x = r * Math.Cos(radians);
    y = r * Math.Sin(radians);
    points.Add(new PointF((float)x + R, (float)y + R));
}

GeometryPath starPath = new GeometryPath();
starPath.MoveTo(points[0]);

for (int i = 1; i < points.Count; i++)
{
    starPath.LineTo(points[i]);
}

starPath.CloseFigure();

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, R * 2, R * 2) as GeometryShape;

    shape.SetGeometryPath(starPath);
}

複合カスタムシェイプを作成

1. GeometryShape クラスのインスタンスを作成します。
2. GeometryPath クラスの最初のインスタンスを作成します。
3. GeometryPath クラスの2番目のインスタンスを作成します。
4. パスをシェイプに適用します。

この C# コードは、複合カスタムシェイプを作成する方法を示しています:

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100) as GeometryShape;

    GeometryPath geometryPath0 = new GeometryPath();
    geometryPath0.MoveTo(0, 0);
    geometryPath0.LineTo(shape.Width, 0);
    geometryPath0.LineTo(shape.Width, shape.Height/3);
    geometryPath0.LineTo(0, shape.Height / 3);
    geometryPath0.CloseFigure();

    GeometryPath geometryPath1 = new GeometryPath();
    geometryPath1.MoveTo(0, shape.Height/3 * 2);
    geometryPath1.LineTo(shape.Width, shape.Height / 3 * 2);
    geometryPath1.LineTo(shape.Width, shape.Height);
    geometryPath1.LineTo(0, shape.Height);
    geometryPath1.CloseFigure();

    shape.SetGeometryPaths(new GeometryPath[] { geometryPath0, geometryPath1});
}

曲線コーナー付きカスタムシェイプを作成

この C# コードは、曲線コーナー（内側）付きのカスタムシェイプを作成する方法を示しています;

var shapeX = 20f;
var shapeY = 20f;
var shapeWidth = 300f;
var shapeHeight = 200f;

var leftTopSize = 50f;
var rightTopSize = 20f;
var rightBottomSize = 40f;
var leftBottomSize = 10f;

using (var presentation = new Presentation())
{
    var childShape = presentation.Slides[0].Shapes.AddAutoShape(
        ShapeType.Custom, shapeX, shapeY, shapeWidth, shapeHeight);

    var geometryPath = new GeometryPath();

    var point1 = new PointF(leftTopSize, 0);
    var point2 = new PointF(shapeWidth - rightTopSize, 0);
    var point3 = new PointF(shapeWidth, shapeHeight - rightBottomSize);
    var point4 = new PointF(leftBottomSize, shapeHeight);
    var point5 = new PointF(0, leftTopSize);

    geometryPath.MoveTo(point1);
    geometryPath.LineTo(point2);
    geometryPath.ArcTo(rightTopSize, rightTopSize, 180, -90);
    geometryPath.LineTo(point3);
    geometryPath.ArcTo(rightBottomSize, rightBottomSize, -90, -90);
    geometryPath.LineTo(point4);
    geometryPath.ArcTo(leftBottomSize, leftBottomSize, 0, -90);
    geometryPath.LineTo(point5);
    geometryPath.ArcTo(leftTopSize, leftTopSize, 90, -90);

    geometryPath.CloseFigure();

    childShape.SetGeometryPath(geometryPath);

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

シェイプジオメトリが閉じているか確認する

閉じたシェイプとは、すべての辺が接続され、隙間のない単一の境界を形成するものです。そのようなシェイプは、単純な幾何形状でも、複雑なカスタム輪郭でもかまいません。以下のコード例は、シェイプジオメトリが閉じているかどうかを確認する方法を示しています:

bool IsGeometryClosed(IGeometryShape geometryShape)
{
    bool? isClosed = null;

    foreach (var geometryPath in geometryShape.GetGeometryPaths())
    {
        var dataLength = geometryPath.PathData.Length;
        if (dataLength == 0)
            continue;

        var lastSegment = geometryPath.PathData[dataLength - 1];
        isClosed = lastSegment.PathCommand == PathCommandType.Close;

        if (isClosed == false)
            return false;
    }
    
    return isClosed == true;
}

GeometryPath を GraphicsPath に変換 (System.Drawing.Drawing2D)

1. GeometryShape クラスのインスタンスを作成します。
2. System.Drawing.Drawing2D 名前空間の GraphicsPath クラスのインスタンスを作成します。
3. ShapeUtil を使用して、GraphicsPath インスタンスを GeometryPath インスタンスに変換します。
4. パスをシェイプに適用します。

この C# コードは、上記の手順を実装したもので、GeometryPath から GraphicsPath への変換プロセスを示しています:

using (Presentation pres = new Presentation())
{
    GeometryShape shape = pres.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 100) as GeometryShape;

    IGeometryPath originalPath = shape.GetGeometryPaths()[0];
    originalPath.FillMode = PathFillModeType.None;

    GraphicsPath gPath = new GraphicsPath();

    gPath.AddString("Text in shape", new FontFamily("Arial"), 1, 40, new PointF(10, 10), StringFormat.GenericDefault);

    IGeometryPath textPath = ShapeUtil.GraphicsPathToGeometryPath(gPath);
    textPath.FillMode = PathFillModeType.Normal;

    shape.SetGeometryPaths(new[] {originalPath, textPath}) ;
}

FAQ

ジオメトリを置き換えた後、塗りつぶしと輪郭はどうなりますか？
スタイルはシェイプに残り、輪郭だけが変更されます。塗りつぶしと輪郭は自動的に新しいジオメトリに適用されます。

カスタムシェイプとジオメトリを正しく回転させるにはどうすればよいですか？
シェイプのrotationプロパティを使用します。ジオメトリはシェイプの座標系に結び付いているため、シェイプとともに回転します。

カスタムシェイプを画像に変換して結果を「ロック」できますか？
はい。必要なslide領域またはshape自体をラスタ形式でエクスポートしてください。これにより、複雑なジオメトリの後処理が容易になります。