Anpassa presentationsformer i Java

Översikt

Denna artikel förklarar hur du anpassar presentationsformer i Aspose.Slides genom att redigera formens geometri via redigeringspunkter och geometriska banor. Den visar hur du arbetar med GeometryPath och IGeometryPath för att ändra befintliga former, utföra grundläggande banredigeringsoperationer, lägga till eller ta bort punkter och applicera den uppdaterade geometrin på en form.

Den demonstrerar också hur du skapar anpassade och sammansatta former, bygger former med rundade hörn, avgör om en formgeometri är sluten samt konverterar mellan GeometryPath och java.awt.Shape för ytterligare anpassningsscenarier.

Ändra en form med redigeringspunkter

Tänk på en kvadrat. I PowerPoint, med redigeringspunkter, kan du

flytta kvadratens hörn inåt eller utåt
ange kurvaturen för ett hörn eller en punkt
lägga till nya punkter på kvadraten
manipulera punkter på kvadraten osv.

I princip kan du utföra dessa uppgifter på vilken form som helst. Med redigeringspunkter kan du ändra en form eller skapa en ny form utifrån en befintlig form.

Tips för formredigering

overview_image

Innan du börjar redigera PowerPoint‑former via redigeringspunkter kan du överväga följande aspekter om former:

En form (eller dess bana) kan antingen vara sluten eller öppen.
När en form är sluten saknar den en start‑ eller slutpunkt. När en form är öppen har den en början och ett slut.
Alla former består av minst 2 ankarpunkter som är förbundna med varandra av linjer
En linje är antingen rak eller kurvig. Ankarnpunkter bestämmer linjens karaktär.
Ankarnpunkter kan vara hörnpunkter, raka punkter eller mjuka punkter:
- En hörnpunkt är en punkt där 2 raka linjer möts i en vinkel.
- En mjuk punkt är en punkt där 2 handtag ligger på en rak linje och linjesegmenten förenas i en mjuk kurva. I detta fall är alla handtag lika långt från ankarnpunkten.
- En rak punkt är en punkt där 2 handtag ligger på en rak linje men linjesegmenten förenas i en kurva. I detta fall behöver handtagen inte vara lika långt från ankarnpunkten.
Genom att flytta eller redigera ankarnpunkter (vilket ändrar vinkeln på linjerna) kan du förändra hur en form ser ut.

För att redigera PowerPoint‑former via redigeringspunkter tillhandahåller Aspose.Slides klassen GeometryPath och gränssnittet IGeometryPath.

En GeometryPath‑instans representerar en geometrisk bana för objektet IGeometryShape.
För att hämta GeometryPath från IGeometryShape‑instansen kan du använda metoden IGeometryShape.getGeometryPaths.
För att sätta GeometryPath för en form kan du använda dessa metoder: IGeometryShape.setGeometryPath för solida former och IGeometryShape.setGeometryPaths för sammansatta former.
För att lägga till segment kan du använda metoderna under IGeometryPath.
Med metoderna IGeometryPath.setStroke och IGeometryPath.setFillMode kan du ange utseendet för en geometrisk bana.
Med metoden IGeometryPath.getPathData kan du hämta en GeometryShapes geometriska bana som en array av banasegment.
För att få tillgång till ytterligare anpassningsalternativ för formgeometri kan du konvertera GeometryPath till java.awt.Shape.
Använd metoderna geometryPathToGraphicsPath och graphicsPathToGeometryPath (från klassen ShapeUtil) för att konvertera GeometryPath till java.awt.Shape fram och tillbaka.

Enkla redigeringsoperationer

Denna Java‑kod visar hur du

Lägger till en linje i slutet av en bana

public void lineTo(java.awt.geom.Point2D.Float point);
public void lineTo(float x, float y);

Lägger till en linje på en angiven position i en bana:

public void lineTo(java.awt.geom.Point2D.Float point, long index);
public void lineTo(float x, float y, long index);

Lägger till en kubisk Bézier‑kurva i slutet av en bana:

public void cubicBezierTo(java.awt.geom.Point2D.Float point1, java.awt.geom.Point2D.Float point2, java.awt.geom.Point2D.Float point3);
public void cubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3);

Lägger till en kubisk Bézier‑kurva på en angiven position i en bana:

public void cubicBezierTo(java.awt.geom.Point2D.Float point1, java.awt.geom.Point2D.Float point2, java.awt.geom.Point2D.Float point3, long index);
public void cubicBezierTo(float x1, float y1, float x2, float y2, float x3, float y3, long index);

Lägger till en kvadratisk Bézier‑kurva i slutet av en bana:

public void quadraticBezierTo(java.awt.geom.Point2D.Float point1, java.awt.geom.Point2D.Float point2);
public void quadraticBezierTo(float x1, float y1, float x2, float y2);

Lägger till en kvadratisk Bézier‑kurva på en angiven position i en bana:

public void quadraticBezierTo(java.awt.geom.Point2D.Float point1, java.awt.geom.Point2D.Float point2, long index);
public void quadraticBezierTo(float x1, float y1, float x2, float y2, long index);

Lägger till en given båge till en bana:

public void arcTo(float width, float heigth, float startAngle, float sweepAngle);

Stänger den aktuella figuren i en bana:

public void closeFigure();

Sätter positionen för nästa punkt:

public void moveTo(java.awt.geom.Point2D.Float point);
public void moveTo(float x, float y);

Tar bort bana‑segmentet på ett givet index:

public void removeAt(int index);

Lägg till anpassade punkter i en form

Skapa en instans av klassen GeometryShape och ange typen ShapeType.Rectangle.
Hämta en instans av klassen GeometryPath från formen.
Lägg till en ny punkt mellan de två översta punkterna på banan.
Lägg till en ny punkt mellan de två nedersta punkterna på banan.
Applicera banan på formen.

Denna Java‑kod visar hur du lägger till anpassade punkter i en form:

Presentation pres = new Presentation();
try {
    GeometryShape shape = (GeometryShape) pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100);
    IGeometryPath geometryPath = shape.getGeometryPaths()[0];

    geometryPath.lineTo(100, 50, 1);
    geometryPath.lineTo(100, 50, 4);
    shape.setGeometryPath(geometryPath);
} finally {
    if (pres != null) pres.dispose();
}

example1_image

Ta bort punkter från en form

Skapa en instans av klassen GeometryShape och ange typen ShapeType.Heart.
Hämta en instans av klassen GeometryPath från formen.
Ta bort segmentet för banan.
Applicera banan på formen.

Denna Java‑kod visar hur du tar bort punkter från en form:

Presentation pres = new Presentation();
try {
    GeometryShape shape = (GeometryShape) pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Heart, 100, 100, 300, 300);

    IGeometryPath path = shape.getGeometryPaths()[0];
    path.removeAt(2);
    shape.setGeometryPath(path);
} finally {
    if (pres != null) pres.dispose();
}

example2_image

Skapa en anpassad form

Beräkna punkterna för formen.
Skapa en instans av klassen GeometryPath.
Fyll banan med punkterna.
Skapa en instans av klassen GeometryShape.
Applicera banan på formen.

Denna Java‑kod visar hur du skapar en anpassad form:

List<Point2D.Float> points = new ArrayList<Point2D.Float>();

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 Point2D.Float((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 Point2D.Float((float)x + R, (float)y + R));
}

GeometryPath starPath = new GeometryPath();
starPath.moveTo(points.get(0));

for (int i = 1; i < points.size(); i++)
{
    starPath.lineTo(points.get(i));
}

starPath.closeFigure();

Presentation pres = new Presentation();
try {
    GeometryShape shape = (GeometryShape) pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, R * 2, R * 2);

    shape.setGeometryPath(starPath);
} finally {
    if (pres != null) pres.dispose();
}

example3_image

Skapa en sammansatt anpassad form

Skapa en instans av klassen GeometryShape.
Skapa en första instans av klassen GeometryPath.
Skapa en andra instans av klassen GeometryPath.
Applicera banorna på formen.

Denna Java‑kod visar hur du skapar en sammansatt anpassad form:

Presentation pres = new Presentation();
try {
    GeometryShape shape = (GeometryShape) pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100);

    GeometryPath geometryPath0 = new GeometryPath();
    geometryPath0.moveTo(0, 0);
    geometryPath0.lineTo(shape.getWidth(), 0);
    geometryPath0.lineTo(shape.getWidth(), shape.getHeight()/3);
    geometryPath0.lineTo(0, shape.getHeight() / 3);
    geometryPath0.closeFigure();

    GeometryPath geometryPath1 = new GeometryPath();
    geometryPath1.moveTo(0, shape.getHeight()/3 * 2);
    geometryPath1.lineTo(shape.getWidth(), shape.getHeight() / 3 * 2);
    geometryPath1.lineTo(shape.getWidth(), shape.getHeight());
    geometryPath1.lineTo(0, shape.getHeight());
    geometryPath1.closeFigure();

    shape.setGeometryPaths(new GeometryPath[] { geometryPath0, geometryPath1});
} finally {
    if (pres != null) pres.dispose();
}

example4_image

Skapa en anpassad form med rundade hörn

Denna Java‑kod visar hur du skapar en anpassad form med rundade hörn (inåtvända);

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

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

Presentation pres = new Presentation();
try {
    IAutoShape childShape = pres.getSlides().get_Item(0).getShapes().addAutoShape(
            ShapeType.Custom, shapeX, shapeY, shapeWidth, shapeHeight);

    GeometryPath geometryPath = new GeometryPath();

    Point2D.Float point1 = new Point2D.Float(leftTopSize, 0);
    Point2D.Float point2 = new Point2D.Float(shapeWidth - rightTopSize, 0);
    Point2D.Float point3 = new Point2D.Float(shapeWidth, shapeHeight - rightBottomSize);
    Point2D.Float point4 = new Point2D.Float(leftBottomSize, shapeHeight);
    Point2D.Float point5 = new Point2D.Float(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);

    pres.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (pres!= null) pres.dispose();
}

Ta reda på om en formgeometri är sluten

En sluten form definieras som en där alla sidor är sammanlänkade och bildar en enda omkrets utan hål. En sådan form kan vara en enkel geometrisk figur eller en komplex anpassad kontur. Följande kodexempel visar hur du kontrollerar om en formgeometri är sluten:

boolean isGeometryClosed(IGeometryShape geometryShape)
{
    Boolean isClosed = null;

    for (IGeometryPath geometryPath : geometryShape.getGeometryPaths()) {
        int dataLength = geometryPath.getPathData().length;
        if (dataLength == 0)
            continue;

        IPathSegment lastSegment = geometryPath.getPathData()[dataLength - 1];
        isClosed = lastSegment.getPathCommand() == PathCommandType.Close;

        if (isClosed == false)
            return false;
    }

    return isClosed == true;
}

Konvertera GeometryPath till java.awt.Shape

Skapa en instans av klassen GeometryShape.
Skapa en instans av klassen java.awt.Shape.
Konvertera java.awt.Shape‑instansen till GeometryPath‑instansen med hjälp av ShapeUtil.
Applicera banorna på formen.

Denna Java‑kod – en implementation av stegen ovan – demonstrerar konverteringsprocessen GeometryPath till GraphicsPath:

Presentation pres = new Presentation();
try {
    // Skapa ny form
    GeometryShape shape = (GeometryShape)pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 100);

    // Hämta geometribana för formen
    IGeometryPath originalPath = shape.getGeometryPaths()[0];
    originalPath.setFillMode(PathFillModeType.None);

    // Skapa ny grafisk bana med text
    Shape graphicsPath;
    Font font = new java.awt.Font("Arial", Font.PLAIN, 40);
    String text = "Text in shape";
    BufferedImage img = new BufferedImage(100, 100, BufferedImage.TYPE_INT_ARGB);
    Graphics2D g2 = img.createGraphics();

    try
    {
        GlyphVector glyphVector = font.createGlyphVector(g2.getFontRenderContext(), text);
        graphicsPath = glyphVector.getOutline(20f, ((float) -glyphVector.getVisualBounds().getY()) + 10);
    }
    finally {
        g2.dispose();
    }

    // Konvertera grafisk bana till geometribana
    IGeometryPath textPath = ShapeUtil.graphicsPathToGeometryPath(graphicsPath);
    textPath.setFillMode(PathFillModeType.Normal);

    // Ange kombination av ny geometribana och ursprunglig geometribana för formen
    shape.setGeometryPaths(new IGeometryPath[] { originalPath, textPath });
} finally {
    if (pres != null) pres.dispose();
}

example5_image

FAQ

Vad händer med fyllning och kontur efter att geometrin har ersatts?

Stilen förblir knuten till formen; endast konturen förändras. Fyllning och kontur appliceras automatiskt på den nya geometrin.

Hur roterar jag en anpassad form korrekt tillsammans med dess geometri?

Använd formens setRotation‑metod; geometrin roterar med formen eftersom den är bunden till formens egna koordinatsystem.

Kan jag konvertera en anpassad form till en bild för att “låsa” resultatet?

Ja. Exportera det önskade slide-området eller själva shape till ett rasterformat; detta förenklar vidare arbete med tunga geometrier.

Hantera anslutare i presentationer med Java Lägg till ellipser i presentationer i Java