Přizpůsobení tvarů prezentací v .NET

Přehled

Tento článek vysvětluje, jak přizpůsobit tvary v prezentaci v Aspose.Slides úpravou geometrie tvaru pomocí editačních bodů a geometrických cest. Ukazuje, jak pracovat s GeometryPath a IGeometryPath k úpravě existujících tvarů, provádění základních operací úpravy cest, přidávání nebo odstraňování bodů a aplikaci aktualizované geometrie zpět na tvar.

Také demonstruje, jak vytvářet vlastní a kompozitní tvary, vytvářet tvary se zakřivenými rohy, zjistit, zda je geometrie tvaru uzavřená, a převádět mezi GeometryPath a GraphicsPath pro další scénáře přizpůsobení geometrie.

Změna tvaru pomocí editačních bodů

Zvažte čtverec. V PowerPointu, pomocí edit points, můžete

přesunout roh čtverce dovnitř nebo ven
specifikovat zakřivení rohu nebo bodu
přidat nové body do čtverce
manipulovat body na čtverci atd.

V podstatě můžete provádět popsané úkoly na libovolném tvaru. Používáním edit points můžete změnit tvar nebo vytvořit nový tvar z existujícího tvaru.

Tipy pro úpravu tvarů

prehled_obrazek

Než začnete upravovat tvary v PowerPointu pomocí edit points, můžete zvážit následující body o tvarech:

Tvar (nebo jeho cesta) může být buď uzavřený, nebo otevřený.
Všechny tvary se skládají alespoň ze 2 ukotvovacích bodů spojených čarami
Čára je buď rovná, nebo zakřivená. Ukotvovací body určují charakter čáry.
Ukotvovací body existují jako rohové body, rovné body nebo hladké body:
- Rohový bod je bod, kde se dva rovné segmenty setkávají pod úhlem.
- Hladký bod je bod, kde jsou dva ovládací výběry (handle) na jedné přímce a segmenty čáry se spojují plynulou křivkou. V tomto případě jsou všechny ovládací výběry od ukotvovacího bodu vzdáleny stejně.
- Rovný bod je bod, kde jsou dva ovládací výběry na jedné přímce a segmenty čáry se spojují plynulou křivkou. V tomto případě nemusí být ovládací výběry od ukotvovacího bodu vzdáleny stejně.
Přesunem nebo úpravou ukotvovacích bodů (což mění úhel čar) můžete změnit vzhled tvaru.

To edit PowerPoint shapes through edit points, Aspose.Slides provides the GeometryPath class and IGeometryPath interface.

Instance třídy GeometryPath představuje geometrickou cestu objektu IGeometryShape.
Chcete-li získat GeometryPath z instance IGeometryShape, můžete použít metodu IGeometryShape.GetGeometryPaths.
Chcete-li nastavit GeometryPath pro tvar, můžete použít tyto metody: IGeometryShape.SetGeometryPath pro solid shapes a IGeometryShape.SetGeometryPaths pro composite shapes.
Pro přidání segmentů můžete použít metody pod IGeometryPath.
Pomocí vlastností IGeometryPath.Stroke a IGeometryPath.FillMode můžete nastavit vzhled geometrické cesty.
Pomocí vlastnosti IGeometryPath.PathData můžete získat geometrickou cestu objektu GeometryShape jako pole segmentů cesty.
Pro přístup k dalším možnostem přizpůsobení geometrie tvaru můžete převést GeometryPath na GraphicsPath
Použijte metody GeometryPathToGraphicsPath a GraphicsPathToGeometryPath (z třídy ShapeUtil) k převodu GeometryPath na GraphicsPath a zpět.

Jednoduché operace úpravy

Tento C# kód vám ukazuje, jak

Přidat čáru na konec cesty

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

Přidat čáru na určenou pozici v cestě:

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

Přidat kubickou Bézierovu křivku na konec cesty:

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

Přidat kubickou Bézierovu křivku na určenou pozici v cestě:

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);

Přidat kvadratickou Bézierovu křivku na konec cesty:

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

Přidat kvadratickou Bézierovu křivku na určenou pozici v cestě:

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

Přidat daný oblouk do cesty:

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

Uzavřít aktuální figuru cesty:

void CloseFigure();

Nastavit pozici pro další bod:

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

Odstranit segment cesty na daném indexu:

void RemoveAt(int index);

Přidání vlastních bodů do tvaru

Vytvořte instanci třídy GeometryShape a nastavte typ ShapeType.Rectangle.
Získejte instanci třídy GeometryPath ze tvaru.
Přidejte nový bod mezi dva horní body na cestě.
Přidejte nový bod mezi dva dolní body na cestě.
Aplikujte cestu na tvar.

Tento C# kód vám ukazuje, jak přidat vlastní body do tvaru:

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);
}

priklad1_obrazek

Odstranění bodů z tvaru

Vytvořte instanci třídy GeometryShape a nastavte typ ShapeType.Heart.
Získejte instanci třídy GeometryPath ze tvaru.
Odstraňte segment cesty.
Aplikujte cestu na tvar.

Tento C# kód vám ukazuje, jak odstranit body z tvaru:

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);
}

priklad2_obrazek

Vytvoření vlastního tvaru

Vypočítejte body pro tvar.
Vytvořte instanci třídy GeometryPath.
Naplněte cestu body.
Vytvořte instanci třídy GeometryShape.
Aplikujte cestu na tvar.

Tento C# kód vám ukazuje, jak vytvořit vlastní tvar:

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);
}

priklad3_obrazek

Vytvoření kompozitního vlastního tvaru

Vytvořte instanci třídy GeometryShape.
Vytvořte první instanci třídy GeometryPath.
Vytvořte druhou instanci třídy GeometryPath.
Aplikujte cesty na tvar.

Tento C# kód vám ukazuje, jak vytvořit kompozitní vlastní tvar:

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});
}

priklad4_obrazek

Vytvoření vlastního tvaru se zakřivenými rohy

Tento C# kód vám ukazuje, jak vytvořit vlastní tvar se zakřivenými rohy (dovnitř);

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);
}

Zjistit, zda je geometrie tvaru uzavřená

Uzavřený tvar je definován jako takový, kde všechny jeho strany jsou propojeny, tvoří jeden okraj bez mezer. Takový tvar může být jednoduchý geometrický útvar nebo složitý vlastní obrys. Následující ukázka kódu ukazuje, jak zkontrolovat, zda je geometrie tvaru uzavřená:

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;
}

Převod GeometryPath na GraphicsPath (System.Drawing.Drawing2D)

Vytvořte instanci třídy GeometryShape.
Vytvořte instanci třídy GraphicsPath z namespace System.Drawing.Drawing2D.
Převěďte instanci GraphicsPath na instanci GeometryPath pomocí třídy ShapeUtil.
Aplikujte cesty na tvar.

Tento C# kód — implementace výše uvedených kroků — ukazuje proces převodu GeometryPath na 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}) ;
}

priklad5_obrazek

FAQ

Co se stane s výplní a obrysem po nahrazení geometrie?

Styl zůstává u tvaru; mění se pouze kontura. Výplň a obrys jsou automaticky aplikovány na novou geometrii.

Jak správně otočit vlastní tvar spolu s jeho geometrií?

Použijte vlastnost rotation tvaru; geometrie se otáčí spolu s tvarem, protože je svázána se souřadnicovým systémem tvaru.

Mohu převést vlastní tvar na obrázek, aby byl výsledek „zamčen“?

Ano. Exportujte požadovanou oblast slide nebo samotný shape do rastrového formátu; to usnadňuje další práci s těžkými geometriemi.

Správa konektorů v prezentacích v .NET Přidání elips do prezentací v .NET