Personalizar formas de presentación en PHP

Cambiar una forma usando puntos de edición

Considere un cuadrado. En PowerPoint, usando puntos de edición, puede

mover la esquina del cuadrado hacia dentro o fuera
especificar la curvatura de una esquina o punto
añadir nuevos puntos al cuadrado
manipular los puntos del cuadrado, etc.

En esencia, puede realizar las tareas descritas en cualquier forma. Usando puntos de edición, puede cambiar una forma o crear una nueva forma a partir de una forma existente.

Consejos para editar formas

overview_image

Antes de comenzar a editar formas de PowerPoint mediante puntos de edición, quizás desee considerar los siguientes aspectos sobre las formas:

Una forma (o su ruta) puede ser cerrada o abierta.
Cuando una forma está cerrada, carece de punto de inicio o fin. Cuando una forma está abierta, tiene un comienzo y un final.
Todas las formas constan de al menos 2 puntos de anclaje vinculados entre sí por líneas
Una línea es recta o curva. Los puntos de anclaje determinan la naturaleza de la línea.
Los puntos de anclaje existen como puntos de esquina, puntos rectos o puntos suaves:
- Un punto de esquina es un punto donde se unen 2 líneas rectas formando un ángulo.
- Un punto suave es un punto donde existen 2 manipuladores en una línea recta y los segmentos de la línea se unen en una curva suave. En este caso, todos los manipuladores están separados del punto de anclaje por una distancia igual.
- Un punto recto es un punto donde existen 2 manipuladores en una línea recta y los segmentos de esa línea se unen en una curva suave. En este caso, los manipuladores no tienen que estar separados del punto de anclaje por una distancia igual.
Al mover o editar los puntos de anclaje (lo que cambia el ángulo de las líneas), puede modificar la apariencia de una forma.

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

Una instancia de GeometryPath representa una ruta geométrica del objeto GeometryShape.
Para obtener el GeometryPath de la instancia GeometryShape, puede usar el método GeometryShape::getGeometryPaths.
Para establecer el GeometryPath de una forma, puede usar estos métodos: GeometryShape::setGeometryPath para formas sólidas y GeometryShape::setGeometryPaths para formas compuestas.
Para añadir segmentos, puede usar los métodos bajo GeometryPath.
Usando los métodos GeometryPath::setStroke y GeometryPath::setFillMode puede establecer la apariencia de una ruta geométrica.
Usando el método GeometryPath::getPathData puede obtener la ruta geométrica de un GeometryShape como una matriz de segmentos de ruta.
Para acceder a opciones adicionales de personalización de geometría de forma, puede convertir GeometryPath a java.awt.Shape
Utilice los métodos geometryPathToGraphicsPath y graphicsPathToGeometryPath (de la clase ShapeUtil) para convertir GeometryPath a java.awt.Shape y viceversa.

Operaciones de edición simples

Este código PHP le muestra cómo

Agregar una línea al final de una ruta

Agregar una línea a una posición especificada en una ruta:

Agregar una curva Bézier cúbica al final de una ruta:

Agregar una curva Bézier cúbica a la posición especificada en una ruta:

Agregar una curva Bézier cuadrática al final de una ruta:

Agregar una curva Bézier cuadrática a una posición especificada en una ruta:

Añadir un arco dado a una ruta:

Cerrar la figura actual de una ruta:

Establecer la posición del siguiente punto:

Eliminar el segmento de ruta en un índice dado:

Agregar puntos personalizados a una forma

Cree una instancia de la clase GeometryShape y establezca el tipo ShapeType::Rectangle.
Obtenga una instancia de la clase GeometryPath a partir de la forma.
Añada un nuevo punto entre los dos puntos superiores de la ruta.
Añada un nuevo punto entre los dos puntos inferiores de la ruta.
Aplique la ruta a la forma.

Este código PHP le muestra cómo agregar puntos personalizados a una forma:

  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 200, 100);
    $geometryPath = $shape->getGeometryPaths()[0];
    $geometryPath->lineTo(100, 50, 1);
    $geometryPath->lineTo(100, 50, 4);
    $shape->setGeometryPath($geometryPath);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

example1_image

Eliminar puntos de una forma

Cree una instancia de la clase GeometryShape y establezca el tipo ShapeType::Heart.
Obtenga una instancia de la clase GeometryPath a partir de la forma.
Elimine el segmento de la ruta.
Aplique la ruta a la forma.

Este código PHP le muestra cómo eliminar puntos de una forma:

  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Heart, 100, 100, 300, 300);
    $path = $shape->getGeometryPaths()[0];
    $path->removeAt(2);
    $shape->setGeometryPath($path);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

example2_image

Crear una forma personalizada

Calcule los puntos para la forma.
Cree una instancia de la clase GeometryPath.
Rellene la ruta con los puntos.
Cree una instancia de la clase GeometryShape.
Aplique la ruta a la forma.

Este código Java le muestra cómo crear una forma personalizada:

  $points = new Java("java.util.ArrayList");
  $R = 100;
  $r = 50;
  $step = 72;
  for($angle = -90; $angle < 270; $angle += $step) {
    $radians = $angle * java("java.lang.Math")->PI / 180.0;
    $x = $R * java("java.lang.Math")->cos($radians);
    $y = $R * java("java.lang.Math")->sin($radians);
    $points->add(new Point2DFloat($x + $R, $y + $R));
    $radians = java("java.lang.Math")->PI * $angle . $step / 2 / 180.0;
    $x = $r * java("java.lang.Math")->cos($radians);
    $y = $r * java("java.lang.Math")->sin($radians);
    $points->add(new Point2DFloat($x + $R, $y + $R));
  }
  $starPath = new GeometryPath();
  $starPath->moveTo($points->get(0));
  for($i = 1; $i < java_values($points->size()) ; $i++) {
    $starPath->lineTo($points->get($i));
  }
  $starPath->closeFigure();
  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, $R * 2, $R * 2);
    $shape->setGeometryPath($starPath);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

example3_image

Crear una forma personalizada compuesta

Cree una instancia de la clase GeometryShape.
Cree una primera instancia de la clase GeometryPath.
Cree una segunda instancia de la clase GeometryPath.
Aplique las rutas a la forma.

Este código PHP le muestra cómo crear una forma personalizada compuesta:

  $pres = new Presentation();
  try {
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 200, 100);
    $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();
    $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(array($geometryPath0, $geometryPath1 ));
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

example4_image

Crear una forma personalizada con esquinas curvas

Este código PHP le muestra cómo crear una forma personalizada con esquinas curvas (hacia dentro);

  $shapeX = 20.0;
  $shapeY = 20.0;
  $shapeWidth = 300.0;
  $shapeHeight = 200.0;
  $leftTopSize = 50.0;
  $rightTopSize = 20.0;
  $rightBottomSize = 40.0;
  $leftBottomSize = 10.0;
  $pres = new Presentation();
  try {
    $childShape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Custom, $shapeX, $shapeY, $shapeWidth, $shapeHeight);
    $geometryPath = new GeometryPath();
    $point1 = new Point2DFloat($leftTopSize, 0);
    $point2 = new Point2DFloat($shapeWidth - $rightTopSize, 0);
    $point3 = new Point2DFloat($shapeWidth, $shapeHeight - $rightBottomSize);
    $point4 = new Point2DFloat($leftBottomSize, $shapeHeight);
    $point5 = new Point2DFloat(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 (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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

Una forma cerrada se define como aquella en la que todos sus bordes se conectan, formando un contorno único sin huecos. Esta forma puede ser una forma geométrica simple o un contorno personalizado complejo. El siguiente ejemplo de código muestra cómo comprobar si la geometría de una forma está cerrada:

function isGeometryClosed($geometryShape)
{
    $isClosed = null;

    foreach ($geometryShape->getGeometryPaths() as $geometryPath) {
        $dataLength = count(java_values($geometryPath->getPathData()));
        if ($dataLength === 0) {
            continue;
        }

        $lastSegment = java_values($geometryPath->getPathData())[$dataLength - 1];
        $isClosed = $lastSegment->getPathCommand() === PathCommandType::Close;

        if ($isClosed === false) {
            return false;
        }
    }

    return $isClosed === true;
}

Convertir GeometryPath a java.awt.Shape

Cree una instancia de la clase GeometryShape.
Cree una instancia de la clase java.awt.Shape.
Convierta la instancia de java.awt.Shape a la instancia de GeometryPath usando ShapeUtil.
Aplique las rutas a la forma.

Este código PHP—una implementación de los pasos anteriores—demuestra el proceso de conversión de GeometryPath a GraphicsPath:

  $pres = new Presentation();
  try {
    # Crear nueva forma
    $shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 300, 100);
    # Obtener la ruta geométrica de la forma
    $originalPath = $shape->getGeometryPaths()[0];
    $originalPath->setFillMode(PathFillModeType::None);
    # Crear nueva ruta gráfica con texto
    $graphicsPath;
    $font = new Font("Arial", Font->PLAIN, 40);
    $text = "Text in shape";
    $img = new BufferedImage(100, 100, BufferedImage->TYPE_INT_ARGB);
    $g2 = $img->createGraphics();
    try {
      $glyphVector = $font->createGlyphVector($g2->getFontRenderContext(), $text);
      $graphicsPath = $glyphVector->getOutline(20.0, -$glyphVector->getVisualBounds()->getY() + 10);
    } finally {
      $g2->dispose();
    }
    # Convertir ruta gráfica a ruta geométrica
    $textPath = ShapeUtil->graphicsPathToGeometryPath($graphicsPath);
    $textPath->setFillMode(PathFillModeType::Normal);
    # Establecer la combinación de la nueva ruta geométrica y la ruta original en la forma
    $shape->setGeometryPaths(array($originalPath, $textPath ));
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

example5_image

FAQ

¿Qué ocurrirá con el relleno y el contorno después de reemplazar 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?

Utilice el método setRotation de la forma; la geometría rota 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í. Exporte la diapositiva requerida o la propia forma a un formato raster; esto simplifica el trabajo posterior con geometrías complejas.

Gestionar conectores en presentaciones con PHP Añadir elipses a presentaciones en PHP