Personalizar formas de presentación en .NET

Resumen

Este artículo explica cómo personalizar las formas de presentación en Aspose.Slides editando la geometría de la forma mediante puntos de edición y rutas geométricas. Muestra cómo trabajar con GeometryPath y IGeometryPath para modificar formas existentes, realizar operaciones básicas de edición de rutas, añadir o eliminar puntos y aplicar la geometría actualizada a una forma.

También demuestra cómo crear formas personalizadas y compuestas, construir formas con esquinas curvas, determinar si una geometría de forma está cerrada y usar la conversión heredada entre GeometryPath y GraphicsPath para escenarios adicionales de personalización de geometría.

Cambiar una forma usando puntos de edición

En PowerPoint, puedes usar Edit Points para modificar un cuadrado:

  • Mover una esquina hacia dentro o hacia fuera.
  • Ajustar la curvatura en un punto.
  • Añadir puntos nuevos.

Editar puntos te permite modificar el contorno de una forma o usar una forma existente como base para una nueva.

Consejos para la edición de formas

overview_image

Al editar formas de PowerPoint, ten en cuenta estos conceptos:

  • Una forma (o su ruta) puede estar cerrada o abierta.
  • La ruta de una forma está formada por puntos de anclaje conectados por segmentos.
  • Un segmento puede ser recto o curvo. Los puntos de anclaje y los manejadores de control determinan su forma.
  • Los puntos de anclaje existen como puntos de esquina, puntos rectos o puntos suaves:
    • En un punto de esquina, los segmentos adyacentes pueden encontrarse en un ángulo.
    • En un punto suave, los dos manejadores de control están alineados y a la misma distancia del punto de anclaje.
    • En un punto recto, los dos manejadores de control están alineados pero pueden estar a diferentes distancias del punto de anclaje.
  • Mover los puntos de anclaje o ajustar sus manejadores cambia el contorno de la forma.

Para editar formas de PowerPoint mediante puntos de edición, Aspose.Slides proporciona la clase GeometryPath y la interfaz IGeometryPath.

Operaciones de edición simples

Utiliza los siguientes métodos para editar una ruta geométrica. Las sobrecargas que aceptan un índice insertan un segmento en esa posición basada en cero dentro del arreglo de segmentos de la ruta.

Operación Método
Añadir o insertar una línea recta. GeometryPath.LineTo
Añadir o insertar una curva Bézier cúbica con dos puntos de control y un punto final. GeometryPath.CubicBezierTo
Añadir o insertar una curva Bézier cuadrática con un punto de control y un punto final. GeometryPath.QuadraticBezierTo
Añadir un arco elíptico con las dimensiones y ángulos especificados en grados. GeometryPath.ArcTo
Cerrar la figura actual conectando su punto final con su punto inicial. GeometryPath.CloseFigure
Establecer el punto inicial de una figura. GeometryPath.MoveTo
Eliminar un segmento en un índice basado en cero. GeometryPath.RemoveAt

Añadir puntos personalizados a una forma

Este ejemplo inserta dos puntos en una forma rectangular usando GeometryPath.LineTo y aplica la ruta editada con IGeometryShape.SetGeometryPath. Las coordenadas son locales a la forma: ambos puntos nuevos están en su centro, a 100 puntos del lado izquierdo y 50 puntos de la parte superior. Los índices de segmentos 1 y 4 los colocan en los bordes superior e inferior, tirando de esos bordes hacia dentro.

using Aspose.Slides;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100);

var geometryPath = shape.GetGeometryPaths()[0];
geometryPath.LineTo(100, 50, 1);
geometryPath.LineTo(100, 50, 4);

shape.SetGeometryPath(geometryPath);

example1_image

Eliminar puntos de una forma

Este ejemplo modifica el contorno de una forma de corazón eliminando el segmento en el índice base 2 con GeometryPath.RemoveAt. Aplicar la ruta modificada con IGeometryShape.SetGeometryPath actualiza el contorno de la forma.

using Aspose.Slides;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Heart, 100, 100, 300, 300);

var path = shape.GetGeometryPaths()[0];
path.RemoveAt(2);

shape.SetGeometryPath(path);

example2_image

Crear una forma personalizada

Este ejemplo construye una estrella de cinco puntas con GeometryPath. Los radios exteriores e interiores alternados de 100 y 50 puntos definen las puntas y las indentaciones; un paso de 72 grados separa uniformemente las cinco puntas. La ruta se cierra con GeometryPath.CloseFigure y se aplica a una forma rectangular mediante IGeometryShape.SetGeometryPath, sustituyendo su contorno.

using System;
using System.Collections.Generic;
using System.Drawing;
using Aspose.Slides;

var points = new List<PointF>();

var outerRadius = 100f;
var innerRadius = 50f;
var angleStep = 72;

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

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

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

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

starPath.CloseFigure();

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, outerRadius * 2, outerRadius * 2);
shape.SetGeometryPath(starPath);

example3_image

Crear una forma compuesta personalizada

Este ejemplo define dos GeometryPath cerrados para el tercio superior y el tercio inferior de una forma. Aplicar ambas rutas con IGeometryShape.SetGeometryPaths crea una única forma compuesta con un hueco en el tercio medio.

using Aspose.Slides;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100);

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

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

shape.SetGeometryPaths(new GeometryPath[] { topPath, bottomPath });

example4_image

Crear una forma personalizada con esquinas curvas

Este ejemplo combina segmentos rectos con GeometryPath.ArcTo para crear una forma con esquinas curvas hacia dentro. Cada tamaño de esquina define el ancho y la altura del arco en puntos, y el barrido de -90 grados dibuja un cuarto de elipse en sentido antihorario. La ruta completada se aplica con IGeometryShape.SetGeometryPath, y la presentación se guarda en formato PPTX.

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Export;

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 slide = presentation.Slides[0];

var topLeft = new PointF(leftTopSize, 0);
var topRight = new PointF(shapeWidth - rightTopSize, 0);
var rightBottom = new PointF(shapeWidth, shapeHeight - rightBottomSize);
var bottomLeft = new PointF(leftBottomSize, shapeHeight);
var leftTop = new PointF(0, leftTopSize);

var geometryPath = new GeometryPath();
geometryPath.MoveTo(topLeft);
geometryPath.LineTo(topRight);
geometryPath.ArcTo(rightTopSize, rightTopSize, 180, -90);
geometryPath.LineTo(rightBottom);
geometryPath.ArcTo(rightBottomSize, rightBottomSize, -90, -90);
geometryPath.LineTo(bottomLeft);
geometryPath.ArcTo(leftBottomSize, leftBottomSize, 0, -90);
geometryPath.LineTo(leftTop);
geometryPath.ArcTo(leftTopSize, leftTopSize, 90, -90);
geometryPath.CloseFigure();

var shape = slide.Shapes.AddAutoShape(ShapeType.Custom, shapeX, shapeY, shapeWidth, shapeHeight);
shape.SetGeometryPath(geometryPath);

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

Comprobar si la geometría de una forma está cerrada

El siguiente asistente verifica si cada ruta geométrica no vacía termina con un segmento de cierre. Lee IGeometryPath.PathData y compara el IPathSegment.PathCommand del segmento final con PathCommandType.Close. Devuelve false cuando no hay rutas no vacías. Este chequeo examina el comando final de cada ruta; no inspecciona cada subfigura dentro de una ruta. El ejemplo muestra True para un rectángulo.

using System;
using Aspose.Slides;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 200, 100);
Console.WriteLine(IsGeometryClosed(shape));

bool IsGeometryClosed(IGeometryShape geometryShape)
{
    var hasNonemptyPath = false;

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

        hasNonemptyPath = true;
        var lastSegment = segments[segments.Length - 1];
        if (lastSegment.PathCommand != PathCommandType.Close)
        {
            return false;
        }
    }

    return hasNonemptyPath;
}

Extraer e inspeccionar los elementos de una forma

Usa IGeometryShape.CreateShapeElements para inspeccionar una forma existente como elementos que contienen puntos de ruta y tipos de punto. Convierte cada IShapeElement devuelto a ShapeElement para leer sus matrices PathPoints y PathTypes. Esta representación es útil para análisis de contornos o para pasar la geometría a herramientas de dibujo personalizadas.

El ejemplo abre una presentación, encuentra la primera forma geométrica directamente en la primera diapositiva y muestra sus segmentos de ruta. Utiliza una presentación que contenga una forma con segmentos rectos y curvos para ver ambos tipos de salida. No busca dentro de grupos.

using System;
using System.Linq;
using Aspose.Slides;

using var presentation = new Presentation("input.pptx");
var slide = presentation.Slides[0];

var shape = slide.Shapes.OfType<IGeometryShape>().FirstOrDefault();
if (shape == null)
{
    Console.WriteLine("No geometry shape found on the first slide.");
    return;
}

foreach (IShapeElement element in shape.CreateShapeElements())
{
    var shapeElement = (ShapeElement)element;
    var points = shapeElement.PathPoints;
    var types = shapeElement.PathTypes;
    Console.WriteLine("Shape element:");

    for (var i = 0; i < points.Length; i++)
    {
        var pointType = types[i] & 0x07; // Mantener el tipo de segmento, excluyendo banderas.
        switch (pointType)
        {
            case 0:
                Console.WriteLine($"Start figure at {points[i]}");
                break;
            case 1:
                Console.WriteLine($"Line to {points[i]}");
                break;
            case 3:
                Console.WriteLine($"Cubic Bezier: controls {points[i]}, {points[i + 1]}; end {points[i + 2]}");
                i += 2; // Consumir ambos puntos de control y el punto final.
                break;
        }

        if ((types[i] & 0x80) != 0)
        {
            Console.WriteLine("Close subpath back to its starting point.");
        }
    }
}

Las matrices se corresponden por índice: points[i] es un punto y types[i] describe su rol. El tipo 0 inicia una figura, y el tipo 1 dibuja una línea desde el punto anterior hasta el punto actual. Un segmento Bézier cúbico comienza en el extremo anterior y utiliza tres entradas consecutivas de tipo 3: dos puntos de control y el nuevo punto final. El bucle consume esas tres entradas juntas y verifica el punto final para determinar el cierre.

Los tipos de punto también contienen banderas. Enmascara con 0x07 para identificar el tipo de segmento y prueba 0x80 por separado para detectar una subruta cerrada. Por ejemplo, 129 (0x81) indica un extremo de línea que cierra una subruta, y 131 (0x83) indica un extremo Bézier que la cierra. Comparar el valor bruto solo con 1 o 3 pasaría por alto estos casos. Otras banderas, como la de guion (0x10) y la de marcador (0x20), no cambian el tipo básico del segmento.

Coordenadas y transformaciones. Los puntos se miden en puntos (1/72 de pulgada), con X aumentando hacia la derecha y Y aumentando hacia abajo. Para una forma no agrupada, las coordenadas extraídas ya incluyen su posición X y Y y reflejan su ancho y alto actuales. Por ejemplo, un rectángulo sin rotar en (100, 200) con tamaño 120 × 80 tiene límites de contorno (100, 200)–(220, 280). No añadas la posición de la forma de nuevo. Resta su X y Y para obtener coordenadas relativas a su marco sin rotar.

Los puntos extraídos no aplican la Rotation de la forma ni los volteos horizontal y vertical. Para reproducir el contorno mostrado, aplica esas transformaciones alrededor del centro de la forma. Para formas agrupadas, también ten en cuenta el mapeo de coordenadas del grupo y sus transformaciones; no asumas que los puntos extraídos son las coordenadas finales renderizadas en la diapositiva ni apliques una traslación o escala dos veces si ya están reflejadas en el marco del hijo.

Inspección frente a edición. Las matrices extraídas describen el contorno; modificarlas no actualiza la forma original. Elige este enfoque cuando tu código de análisis o dibujo necesite matrices de punto/tipo. Usa GetGeometryPaths cuando necesites comandos de geometría en el sistema de coordenadas local de la forma o quieras editar su geometría. Aplica rutas editadas mediante SetGeometryPath o SetGeometryPaths.

Convertir GeometryPath a GraphicsPath (System.Drawing.Drawing2D)

El siguiente ejemplo requiere un ensamblado heredado de Aspose.Slides for .NET que admita ShapeUtil.GraphicsPathToGeometryPath, como la versión 25.10, y un entorno Windows con System.Drawing.Common. Los métodos de conversión se eliminaron en la versión 25.11.

Este ejemplo combina un contorno rectangular con texto convertido a geometría. El IGeometryPath.FillMode del contorno se establece para desactivar su relleno. Un GraphicsPath almacena el contorno del texto, que ShapeUtil.GraphicsPathToGeometryPath convierte en una ruta geométrica rellenada. Aplicar ambas rutas con IGeometryShape.SetGeometryPaths produce una única forma que contiene el rectángulo y el texto. Para la conversión en sentido contrario, usa ShapeUtil.GeometryPathToGraphicsPath.

using System.Drawing;
using System.Drawing.Drawing2D;
using Aspose.Slides;
using Aspose.Slides.Util;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 300, 100);

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

using var graphicsPath = new GraphicsPath();
using var fontFamily = new FontFamily("Arial");
using var stringFormat = StringFormat.GenericDefault;

graphicsPath.AddString("Text in shape", fontFamily, (int)FontStyle.Bold, 40, new PointF(10, 10), stringFormat);

var textPath = ShapeUtil.GraphicsPathToGeometryPath(graphicsPath);
textPath.FillMode = PathFillModeType.Normal;

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

example5_image

FAQ

¿Qué ocurrirá con el relleno y el contorno después de sustituir la geometría?

El estilo permanece con la forma; solo cambia el contorno. El relleno y el contorno se aplican automáticamente a la nueva geometría.

¿Cómo rotar correctamente una forma personalizada junto con su geometría?

Utiliza la propiedad Rotation de la forma; la geometría gira con la forma porque está vinculada al propio sistema de coordenadas de la forma.

¿Puedo convertir una forma personalizada en una imagen para “bloquear” el resultado?

Sí. Exporta la slide o la shape requerida a un formato raster; esto simplifica el trabajo posterior con geometrías complejas.

Related features

Gestionar conectores en presentaciones en .NET Agregar elipses a presentaciones en .NET