Personalizza le forme di presentazione su Android

Panoramica

Questo articolo spiega come personalizzare le forme di presentazione in Aspose.Slides modificando la geometria delle forme tramite punti di modifica e percorsi geometrici. Mostra come lavorare con GeometryPath e IGeometryPath per modificare forme esistenti, eseguire operazioni base di modifica del percorso, aggiungere o rimuovere punti e applicare la geometria aggiornata a una forma.

Dimostra inoltre come creare forme personalizzate e composte, costruire forme con angoli curvi, determinare se una geometria di forma è chiusa e convertire tra GeometryPath e java.awt.Shape per ulteriori scenari di personalizzazione della geometria.

Modifica di una Forma con i Punti di Modifica

Considera un quadrato. In PowerPoint, usando punti di modifica, è possibile

spostare l’angolo del quadrato verso l’interno o l’esterno
specificare la curvatura per un angolo o un punto
aggiungere nuovi punti al quadrato
manipolare i punti del quadrato, ecc.

In sostanza, è possibile eseguire le operazioni descritte su qualsiasi forma. Con i punti di modifica puoi modificare una forma o crearne una nuova a partire da una forma esistente.

Suggerimenti per la Modifica delle Forme

overview_image

Prima di iniziare a modificare le forme di PowerPoint tramite i punti di modifica, considera questi aspetti delle forme:

Una forma (o il suo percorso) può essere chiusa o aperta.
Quando una forma è chiusa, non ha un punto di inizio o di fine. Quando è aperta, ha un inizio e una fine.
Tutte le forme sono composte da almeno 2 punti di ancoraggio collegati tra loro da linee.
Una linea è dritta o curva. I punti di ancoraggio determinano la natura della linea.
I punti di ancoraggio possono essere punti d’angolo, punti dritti o punti lisci:
- Un punto d’angolo è un punto in cui 2 linee rette si incontrano formando un angolo.
- Un punto liscio è un punto in cui 2 maniglie sono allineate e i segmenti della linea si uniscono in una curva liscia. In questo caso, tutte le maniglie sono a pari distanza dal punto di ancoraggio.
- Un punto dritto è un punto in cui 2 maniglie sono allineate ma le loro distanze dal punto di ancoraggio possono differire.
Spostando o modificando i punti di ancoraggio (che cambiano l’angolo delle linee) è possibile alterare l’aspetto di una forma.

Per modificare le forme di PowerPoint tramite i punti di modifica, Aspose.Slides fornisce la classe GeometryPath e l’interfaccia IGeometryPath.

Un’istanza di GeometryPath rappresenta il percorso geometrico dell’oggetto IGeometryShape.
Per recuperare il GeometryPath dall’istanza IGeometryShape, è possibile utilizzare il metodo IGeometryShape.getGeometryPaths .
Per impostare il GeometryPath di una forma, sono disponibili i metodi: IGeometryShape.setGeometryPath per forme solide e IGeometryShape.setGeometryPaths per forme composite.
Per aggiungere segmenti, è possibile usare i metodi di IGeometryPath.
Con i metodi IGeometryPath.setStroke e IGeometryPath.setFillMode, è possibile impostare l’aspetto di un percorso geometrico.
Utilizzando il metodo IGeometryPath.getPathData è possibile ottenere il percorso geometrico di una GeometryShape come array di segmenti di percorso.
Per accedere a ulteriori opzioni di personalizzazione della geometria di una forma, è possibile convertire un GeometryPath in un java.awt.Shape.
Usa i metodi geometryPathToGraphicsPath e graphicsPathToGeometryPath (dalla classe ShapeUtil) per convertire un GeometryPath in un java.awt.Shape e viceversa.

Operazioni di Modifica Semplici

Questo codice Java mostra come

Aggiungere una linea alla fine di un percorso

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

Aggiungere una linea in una posizione specifica di un percorso:

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

Aggiungere una curva cubica di Bézier alla fine di un percorso:

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

Aggiungere una curva cubica di Bézier in una posizione specifica di un percorso:

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

Aggiungere una curva quadratica di Bézier alla fine di un percorso:

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

Aggiungere una curva quadratica di Bézier in una posizione specifica di un percorso:

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

Aggiungere un arco a un percorso:

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

Chiudere la figura corrente di un percorso:

public void closeFigure();

Impostare la posizione per il punto successivo:

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

Rimuovere il segmento di percorso a un indice specificato:

public void removeAt(int index);

Aggiungere Punti Personalizzati a una Forma

Crea un’istanza della classe GeometryShape e imposta il tipo ShapeType.Rectangle.
Ottieni un’istanza della classe GeometryPath dalla forma.
Aggiungi un nuovo punto tra i due punti superiori del percorso.
Aggiungi un nuovo punto tra i due punti inferiori del percorso.
Applica il percorso alla forma.

Questo codice Java mostra come aggiungere punti personalizzati a una forma:

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

Rimuovere Punti da una Forma

Crea un’istanza della classe GeometryShape e imposta il tipo ShapeType.Heart.
Ottieni un’istanza della classe GeometryPath dalla forma.
Rimuovi il segmento del percorso.
Applica il percorso alla forma.

Questo codice Java mostra come rimuovere punti da una forma:

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

Creare una Forma Personalizzata

Calcola i punti per la forma.
Crea un’istanza della classe GeometryPath.
Riempie il percorso con i punti.
Crea un’istanza della classe GeometryShape.
Applica il percorso alla forma.

Questo esempio Java mostra come creare una forma personalizzata:

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

Creare una Forma Personalizzata Composta

Crea un’istanza della classe GeometryShape.
Crea una prima istanza della classe GeometryPath.
Crea una seconda istanza della classe GeometryPath.
Applica i percorsi alla forma.

Questo codice Java mostra come creare una forma personalizzata composta:

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

Creare una Forma Personalizzata con Angoli Curvi

Questo codice Java mostra come creare una forma personalizzata con angoli curvi (verso l’interno);

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

Verificare se una Geometria di Forma è Chiusa

Una forma chiusa è definita come quella i cui lati si connettono tutti, formando un unico contorno senza interruzioni. Tale forma può essere una semplice figura geometrica o un profilo personalizzato complesso. L’esempio di codice seguente mostra come verificare se la geometria di una forma è chiusa:

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

Convertire GeometryPath in java.awt.Shape

Crea un’istanza della classe GeometryShape.
Crea un’istanza della classe java.awt.Shape.
Converte l’istanza di java.awt.Shape in un’istanza di GeometryPath usando ShapeUtil.
Applica i percorsi alla forma.

Questo codice Java—un’implementazione dei passaggi sopra—dimostra il processo di conversione da GeometryPath a GraphicsPath:

Presentation pres = new Presentation();
try {
    // Crea nuova forma
    GeometryShape shape = (GeometryShape)pres.getSlides().get_Item(0).
            getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 100);

    // Ottieni il percorso geometrico della forma
    IGeometryPath originalPath = shape.getGeometryPaths()[0];
    originalPath.setFillMode(PathFillModeType.None);

    // Crea nuovo percorso grafico con testo
    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();
    }

    // Converti il percorso grafico in percorso geometrico
    IGeometryPath textPath = ShapeUtil.graphicsPathToGeometryPath(graphicsPath);
    textPath.setFillMode(PathFillModeType.Normal);

    // Imposta la combinazione del nuovo percorso geometrico e del percorso geometrico originale sulla forma
    shape.setGeometryPaths(new IGeometryPath[] { originalPath, textPath });
} finally {
    if (pres != null) pres.dispose();
}

example5_image

FAQ

Cosa accade a riempimento e contorno dopo la sostituzione della geometria?

Lo stile rimane associato alla forma; cambia solo il contorno. Riempimento e contorno vengono applicati automaticamente alla nuova geometria.

Come ruotare correttamente una forma personalizzata insieme alla sua geometria?

Usa il metodo setRotation della forma; la geometria ruota con la forma perché è legata al sistema di coordinate della forma stessa.

Posso convertire una forma personalizzata in immagine per “bloccare” il risultato?

Sì. Esporta l’area della slide o la shape stessa in un formato raster; questo semplifica il lavoro successivo con geometrie complesse.

Gestire i connettori nelle presentazioni su Android Aggiungere ellissi a presentazioni su Android