Formatear formas de PowerPoint en Python

Resumen

En PowerPoint, puede agregar formas a las diapositivas. Dado que las formas están compuestas por líneas, puede formatearlas modificando o aplicando efectos a sus contornos. Además, puede formatear las formas especificando configuraciones que controlan cómo se rellenan sus interiores.

format-shape-powerpoint

Aspose.Slides para Python proporciona clases y propiedades que le permiten formatear formas utilizando las mismas opciones disponibles en PowerPoint.

Formatear líneas

Con Aspose.Slides, puede especificar un estilo de línea personalizado para una forma. Los siguientes pasos describen el procedimiento:

  1. Cree una instancia de la clase Presentation.
  2. Obtenga una referencia a una diapositiva por su índice.
  3. Agregue un AutoShape a la diapositiva.
  4. Establezca el line style de la forma.
  5. Establezca el ancho de la línea.
  6. Establezca el dash style de la forma.
  7. Establezca el color de la línea para la forma.
  8. Guarde la presentación modificada como un archivo PPTX.

El siguiente código Python muestra cómo formatear un AutoShape rectangular:

import aspose.slides as slides
import aspose.pydrawing as draw

# Instanciar la clase Presentation que representa un archivo de presentación.
with slides.Presentation() as presentation:

    # Obtener la primera diapositiva.
    slide = presentation.slides[0]

    # Agregar una forma automática del tipo Rectángulo.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 150, 150, 75)

    # Establecer el color de relleno para la forma rectangular.
    shape.fill_format.fill_type = slides.FillType.NO_FILL

    # Aplicar formato a las líneas del rectángulo.
    shape.line_format.style = slides.LineStyle.THICK_THIN
    shape.line_format.width = 7
    shape.line_format.dash_style = slides.LineDashStyle.DASH

    # Establecer el color de la línea del rectángulo.
    shape.line_format.fill_format.fill_type = slides.FillType.SOLID
    shape.line_format.fill_format.solid_fill_color.color = draw.Color.blue

    # Guardar el archivo PPTX en disco.
    presentation.save("formatted_lines.pptx", slides.export.SaveFormat.PPTX)

El resultado:

The formatted lines in the presentation

Formatear estilos de unión

Estas son las tres opciones de tipo de unión:

  • Round
  • Miter
  • Bevel

De manera predeterminada, cuando PowerPoint une dos líneas en un ángulo (como en la esquina de una forma), utiliza la configuración Round. Sin embargo, si está dibujando una forma con ángulos agudos, puede preferir la opción Miter.

The join style in the presentation

El siguiente código Python muestra cómo se crearon tres rectángulos (como se muestra en la imagen anterior) usando las configuraciones de tipo de unión Miter, Bevel y Round:

import aspose.slides as slides
import aspose.pydrawing as draw

# Instanciar la clase Presentation que representa un archivo de presentación.
with slides.Presentation() as presentation:

	# Obtener la primera diapositiva.
	slide = presentation.slides[0]

	# Agregar tres formas automáticas del tipo Rectangle.
	shape1 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 150, 75)
	shape2 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 210, 20, 150, 75)
	shape3 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 135, 150, 75)

	# Establecer el color de relleno para cada forma rectangular.
	shape1.fill_format.fill_type = slides.FillType.SOLID
	shape1.fill_format.solid_fill_color.color = draw.Color.black
	shape2.fill_format.fill_type = slides.FillType.SOLID
	shape2.fill_format.solid_fill_color.color = draw.Color.black
	shape3.fill_format.fill_type = slides.FillType.SOLID
	shape3.fill_format.solid_fill_color.color = draw.Color.black

	# Establecer el ancho de la línea.
	shape1.line_format.width = 15
	shape2.line_format.width = 15
	shape3.line_format.width = 15

	# Establecer el color de la línea de cada rectángulo.
	shape1.line_format.fill_format.fill_type = slides.FillType.SOLID
	shape1.line_format.fill_format.solid_fill_color.color = draw.Color.blue
	shape2.line_format.fill_format.fill_type = slides.FillType.SOLID
	shape2.line_format.fill_format.solid_fill_color.color = draw.Color.blue
	shape3.line_format.fill_format.fill_type = slides.FillType.SOLID
	shape3.line_format.fill_format.solid_fill_color.color = draw.Color.blue

	# Establecer el estilo de unión.
	shape1.line_format.join_style = slides.LineJoinStyle.MITER
	shape2.line_format.join_style = slides.LineJoinStyle.BEVEL
	shape3.line_format.join_style = slides.LineJoinStyle.ROUND

	# Agregar texto a cada rectángulo.
	shape1.text_frame.text = "Miter Join style"
	shape2.text_frame.text = "Bevel Join style"
	shape3.text_frame.text = "Round Join style"

	# Guardar el archivo PPTX en disco.
	presentation.save("join_styles.pptx", slides.export.SaveFormat.PPTX)

Relleno degradado

En PowerPoint, el Relleno degradado es una opción de formato que le permite aplicar una combinación continua de colores a una forma. Por ejemplo, puede aplicar dos o más colores de manera que uno se difumine gradualmente en otro.

Así es como se aplica un relleno degradado a una forma usando Aspose.Slides:

  1. Cree una instancia de la clase Presentation.
  2. Obtenga una referencia a una diapositiva por su índice.
  3. Agregue un AutoShape a la diapositiva.
  4. Establezca el FillType de la forma a GRADIENT.
  5. Añada sus dos colores preferidos con posiciones definidas usando los métodos add de la colección gradient_stops expuesta por la clase GradientFormat.
  6. Guarde la presentación modificada como un archivo PPTX.

El siguiente código Python muestra cómo aplicar un efecto de relleno degradado a una elipse:

import aspose.slides as slides

# Instanciar la clase Presentation que representa un archivo de presentación.
with slides.Presentation() as presentation:

    # Obtener la primera diapositiva.
    slide = presentation.slides[0]

    # Agregar una forma automática del tipo Elipse.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 50, 50, 150, 75)

    # Aplicar formato de degradado al elipse.
    shape.fill_format.fill_type = slides.FillType.GRADIENT
    shape.fill_format.gradient_format.gradient_shape = slides.GradientShape.LINEAR

    # Establecer la dirección del degradado.
    shape.fill_format.gradient_format.gradient_direction = slides.GradientDirection.FROM_CORNER2

    # Añadir dos puntos de degradado.
    shape.fill_format.gradient_format.gradient_stops.add(1.0, slides.PresetColor.PURPLE)
    shape.fill_format.gradient_format.gradient_stops.add(0, slides.PresetColor.RED)

    # Guardar el archivo PPTX en disco.
    presentation.save("gradient_fill.pptx", slides.export.SaveFormat.PPTX)

El resultado:

The ellipse with gradient fill

Relleno de patrón

En PowerPoint, el Relleno de patrón es una opción de formato que le permite aplicar un diseño de dos colores—como puntos, rayas, tramas o cuadros—a una forma. Puede elegir colores personalizados para el primer plano y el fondo del patrón.

Aspose.Slides ofrece más de 45 estilos de patrón predefinidos que puede aplicar a las formas para mejorar el atractivo visual de sus presentaciones. Incluso después de seleccionar un patrón predefinido, aún puede especificar los colores exactos que debe usar.

Así es como se aplica un relleno de patrón a una forma usando Aspose.Slides:

  1. Cree una instancia de la clase Presentation.
  2. Obtenga una referencia a una diapositiva por su índice.
  3. Agregue un AutoShape a la diapositiva.
  4. Establezca el FillType de la forma a PATTERN.
  5. Elija un estilo de patrón entre las opciones predefinidas.
  6. Establezca el back_color del patrón.
  7. Establezca el fore_color del patrón.
  8. Guarde la presentación modificada como un archivo PPTX.

El siguiente código Python muestra cómo aplicar un relleno de patrón a un rectángulo:

import aspose.slides as slides
import aspose.pydrawing as draw

# Instanciar la clase Presentation que representa un archivo de presentación.
with slides.Presentation() as presentation:

    # Obtener la primera diapositiva.
    slide = presentation.slides[0]

    # Agregar una forma automática del tipo Rectangle.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 150, 75)

    # Establecer el tipo de relleno a Pattern.
    shape.fill_format.fill_type = slides.FillType.PATTERN

    # Establecer el estilo de patrón.
    shape.fill_format.pattern_format.pattern_style = slides.PatternStyle.TRELLIS

    # Establecer los colores de fondo y de primer plano del patrón.
    shape.fill_format.pattern_format.back_color.color = draw.Color.light_gray
    shape.fill_format.pattern_format.fore_color.color = draw.Color.yellow

    # Guardar el archivo PPTX en disco.
    presentation.save("pattern_fill.pptx", slides.export.SaveFormat.PPTX)

El resultado:

The rectangle with pattern fill

Relleno de imagen

En PowerPoint, el Relleno de imagen es una opción de formato que le permite insertar una imagen dentro de una forma—usando efectivamente la imagen como fondo de la forma.

Así es como se usa Aspose.Slides para aplicar un relleno de imagen a una forma:

  1. Cree una instancia de la clase Presentation.
  2. Obtenga una referencia a una diapositiva por su índice.
  3. Agregue un AutoShape a la diapositiva.
  4. Establezca el FillType de la forma a PICTURE.
  5. Establezca el modo de relleno de imagen a TILE (u otro modo preferido).
  6. Cree un objeto PPImage a partir de la imagen que desea usar.
  7. Asigne esta imagen a la propiedad picture.image del picture_fill_format de la forma.
  8. Guarde la presentación modificada como un archivo PPTX.

Supongamos que tenemos un archivo “lotus.png” con la siguiente imagen:

The lotus picture

El siguiente código Python muestra cómo rellenar una forma con la imagen:

import aspose.slides as slides

# Instanciar la clase Presentation que representa un archivo de presentación.
with slides.Presentation() as presentation:

    # Obtener la primera diapositiva.
    slide = presentation.slides[0]

    # Agregar una forma automática del tipo Rectangle.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 192, 95)

    # Establecer el tipo de relleno a Picture.
    shape.fill_format.fill_type = slides.FillType.PICTURE

    # Establecer el modo de relleno de imagen.
    shape.fill_format.picture_fill_format.picture_fill_mode = slides.PictureFillMode.TILE

    # Cargar una imagen y añadirla a los recursos de la presentación.
    with slides.Images.from_file("lotus.png") as image:
        presentation_image = presentation.images.add_image(image)

    # Establecer la imagen.
    shape.fill_format.picture_fill_format.picture.image = presentation_image

    # Guardar el archivo PPTX en disco.
    presentation.save("picture_fill.pptx", slides.export.SaveFormat.PPTX)

El resultado:

The shape with picture fill

Imagen de mosaico como textura

Si desea establecer una imagen en mosaico como textura y personalizar el comportamiento de mosaico, puede usar las siguientes propiedades de la clase PictureFillFormat:

  • picture_fill_mode: Establece el modo de relleno de imagen—TILE o STRETCH.
  • tile_alignment: Especifica la alineación de los mosaicos dentro de la forma.
  • tile_flip: Controla si el mosaico se voltea horizontalmente, verticalmente o en ambas direcciones.
  • tile_offset_x: Define el desplazamiento horizontal del mosaico (en puntos) desde el origen de la forma.
  • tile_offset_y: Define el desplazamiento vertical del mosaico (en puntos) desde el origen de la forma.
  • tile_scale_x: Define la escala horizontal del mosaico como porcentaje.
  • tile_scale_y: Define la escala vertical del mosaico como porcentaje.

El siguiente ejemplo de código muestra cómo agregar una forma rectangular con un relleno de imagen en mosaico y configurar las opciones de mosaico:

import aspose.slides as slides

# Instanciar la clase Presentation que representa un archivo de presentación.
with slides.Presentation() as presentation:

    # Obtener la primera diapositiva.
    first_slide = presentation.slides[0]

    # Agregar una forma automática de rectángulo.
    shape = first_slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 190, 95)

    # Establecer el tipo de relleno de la forma a Picture.
    shape.fill_format.fill_type = slides.FillType.PICTURE

    # Cargar la imagen y añadirla a los recursos de la presentación.
    with slides.Images.from_file("lotus.png") as source_image:
        presentation_image = presentation.images.add_image(source_image)

    # Asignar la imagen a la forma.
    picture_fill_format = shape.fill_format.picture_fill_format
    picture_fill_format.picture.image = presentation_image

    # Configurar el modo de relleno de imagen y las propiedades de mosaico.
    picture_fill_format.picture_fill_mode = slides.PictureFillMode.TILE
    picture_fill_format.tile_offset_x = -32
    picture_fill_format.tile_offset_y = -32
    picture_fill_format.tile_scale_x = 50
    picture_fill_format.tile_scale_y = 50
    picture_fill_format.tile_alignment = slides.RectangleAlignment.BOTTOM_RIGHT
    picture_fill_format.tile_flip = slides.TileFlip.FLIP_BOTH

    # Guardar el archivo PPTX en disco.
    presentation.save("tile.pptx", slides.export.SaveFormat.PPTX)

El resultado:

The tile options

Relleno de color sólido

En PowerPoint, el Relleno de color sólido es una opción de formato que llena una forma con un solo color uniforme. Este fondo simple se aplica sin degradados, texturas ni patrones.

Para aplicar un relleno de color sólido a una forma usando Aspose.Slides, siga estos pasos:

  1. Cree una instancia de la clase Presentation.
  2. Obtenga una referencia a una diapositiva por su índice.
  3. Agregue un AutoShape a la diapositiva.
  4. Establezca el FillType de la forma a SOLID.
  5. Asigne su color de relleno preferido a la forma.
  6. Guarde la presentación modificada como un archivo PPTX.

El siguiente código Python muestra cómo aplicar un relleno de color sólido a un rectángulo en una diapositiva de PowerPoint:

import aspose.slides as slides
import aspose.pydrawing as draw

# Instanciar la clase Presentation que representa un archivo de presentación.
with slides.Presentation() as presentation:

    # Obtener la primera diapositiva.
    slide = presentation.slides[0]

    # Agregar una forma automática del tipo Rectangle.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 150, 75)

    # Establecer el tipo de relleno a Solid.
    shape.fill_format.fill_type = slides.FillType.SOLID

    # Establecer el color de relleno.
    shape.fill_format.solid_fill_color.color = draw.Color.yellow

    # Guardar el archivo PPTX en disco.
    presentation.save("solid_color_fill.pptx", slides.export.SaveFormat.PPTX)

El resultado:

The shape with solid color fill

Establecer transparencia

En PowerPoint, cuando aplica un color sólido, degradado, imagen o textura a las formas, también puede establecer un nivel de transparencia para controlar la opacidad del relleno. Un valor de transparencia mayor hace que la forma sea más translúcida, permitiendo que el fondo o los objetos subyacentes sean parcialmente visibles.

Aspose.Slides le permite establecer el nivel de transparencia ajustando el valor alfa del color usado para el relleno. Así es como se hace:

  1. Cree una instancia de la clase Presentation.
  2. Obtenga una referencia a una diapositiva por su índice.
  3. Agregue un AutoShape a la diapositiva.
  4. Establezca el tipo de relleno a SOLID.
  5. Use Color.from_argb para definir un color con transparencia (el componente alpha controla la transparencia).
  6. Guarde la presentación.

El siguiente código Python muestra cómo aplicar un color de relleno transparente a un rectángulo:

import aspose.pydrawing as draw
import aspose.slides as slides

# Instanciar la clase Presentation que representa un archivo de presentación.
with slides.Presentation() as presentation:

    # Obtener la primera diapositiva.
    slide = presentation.slides[0]
    
    # Agregar una forma automática de rectángulo sólido.
    slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 150, 75)

    # Agregar una forma automática de rectángulo transparente sobre la forma sólida.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 80, 80, 150, 75)
    shape.fill_format.fill_type = slides.FillType.SOLID
    shape.fill_format.solid_fill_color.color = draw.Color.from_argb(128, 204, 102, 0)
    
    presentation.save("shape_transparency.pptx", slides.export.SaveFormat.PPTX)

El resultado:

The transparent shape

Rotar formas

Aspose.Slides le permite rotar formas en presentaciones de PowerPoint. Esto puede ser útil al posicionar elementos visuales con necesidades específicas de alineación o diseño.

Para rotar una forma en una diapositiva, siga estos pasos:

  1. Cree una instancia de la clase Presentation.
  2. Obtenga una referencia a una diapositiva por su índice.
  3. Agregue un AutoShape a la diapositiva.
  4. Establezca la propiedad rotation de la forma al ángulo deseado.
  5. Guarde la presentación.

El siguiente código Python muestra cómo rotar una forma 5 grados:

import aspose.slides as slides

# Instanciar la clase Presentation que representa un archivo de presentación.
with slides.Presentation() as presentation:

    # Obtener la primera diapositiva.
    slide = presentation.slides[0]

    # Agregar una forma automática del tipo Rectangle.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 150, 75)

    # Rotar la forma en 5 grados.
    shape.rotation = 5

    # Guardar el archivo PPTX en disco.
    presentation.save("shape_rotation.pptx", slides.export.SaveFormat.PPTX)

El resultado:

The shape rotation

Agregar efectos de bisel 3D

Aspose.Slides le permite aplicar efectos de bisel 3D a las formas configurando sus propiedades ThreeDFormat.

Para agregar efectos de bisel 3D a una forma, siga estos pasos:

  1. Instancie la clase Presentation.
  2. Obtenga una referencia a una diapositiva por su índice.
  3. Agregue un AutoShape a la diapositiva.
  4. Configure el ThreeDFormat de la forma para definir la configuración del bisel.
  5. Guarde la presentación.

El siguiente código Python muestra cómo aplicar efectos de bisel 3D a una forma:

import aspose.slides as slides
import aspose.pydrawing as draw

# Crear una instancia de la clase Presentation.
with slides.Presentation() as presentation:

    slide = presentation.slides[0]

    # Agregar una forma a la diapositiva.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 50, 50, 100, 100)
    shape.fill_format.fill_type = slides.FillType.SOLID
    shape.fill_format.solid_fill_color.color = draw.Color.green
    shape.line_format.fill_format.fill_type = slides.FillType.SOLID
    shape.line_format.fill_format.solid_fill_color.color = draw.Color.orange
    shape.line_format.width = 2.0

    # Establecer las propiedades ThreeDFormat de la forma.
    shape.three_d_format.depth = 4
    shape.three_d_format.bevel_top.bevel_type = slides.BevelPresetType.CIRCLE
    shape.three_d_format.bevel_top.height = 6
    shape.three_d_format.bevel_top.width = 6
    shape.three_d_format.camera.camera_type = slides.CameraPresetType.ORTHOGRAPHIC_FRONT
    shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.THREE_PT
    shape.three_d_format.light_rig.direction = slides.LightingDirection.TOP

    # Guardar la presentación como archivo PPTX.
    presentation.save("3D_bevel_effect.pptx", slides.export.SaveFormat.PPTX)

El resultado:

The 3D bevel effect

Agregar efectos de rotación 3D

Aspose.Slides le permite aplicar efectos de rotación 3D a las formas configurando sus propiedades ThreeDFormat.

Para aplicar rotación 3D a una forma:

  1. Cree una instancia de la clase Presentation.
  2. Obtenga una referencia a una diapositiva por su índice.
  3. Agregue un AutoShape a la diapositiva.
  4. Establezca el camera_type y el light_type de la forma para definir la rotación 3D.
  5. Guarde la presentación.

El siguiente código Python muestra cómo aplicar efectos de rotación 3D a una forma:

import aspose.slides as slides

# Crear una instancia de la clase Presentation.
with slides.Presentation() as presentation:

    slide = presentation.slides[0]

    auto_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 150, 75)
    auto_shape.text_frame.text = "Hello, Aspose!"

    auto_shape.three_d_format.depth = 6
    auto_shape.three_d_format.camera.set_rotation(40, 35, 20)
    auto_shape.three_d_format.camera.camera_type = slides.CameraPresetType.ISOMETRIC_LEFT_UP
    auto_shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.BALANCED

    # Guardar la presentación como archivo PPTX.      
    presentation.save("3D_rotation_effect.pptx", slides.export.SaveFormat.PPTX)

El resultado:

The 3D rotation effect

Restablecer formato

El siguiente código Python muestra cómo restablecer el formato de una diapositiva y devolver la posición, el tamaño y el formato de todas las formas con marcadores de posición en el LayoutSlide a sus configuraciones predeterminadas:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:

    for slide in presentation.slides:
        # Restablecer cada forma en la diapositiva que tiene un marcador de posición en el diseño.
        slide.reset()

    presentation.save("reset_formatting.pptx", slides.export.SaveFormat.PPTX)

FAQ

¿El formato de la forma afecta al tamaño final del archivo de la presentación?

Sólo de forma mínima. Las imágenes y los medios incrustados ocupan la mayor parte del espacio del archivo, mientras que los parámetros de la forma, como colores, efectos y degradados, se almacenan como metadatos y prácticamente no añaden tamaño adicional.

¿Cómo puedo detectar formas en una diapositiva que compartan el mismo formato para poder agruparlas?

Compare las propiedades clave de formato de cada forma—relleno, línea y ajustes de efectos. Si todos los valores correspondientes coinciden, considere sus estilos como idénticos y agrupe lógicamente esas formas, lo que simplifica la gestión de estilos posterior.

¿Puedo guardar un conjunto de estilos de forma personalizados en un archivo separado para reutilizarlos en otras presentaciones?

Sí. Guarde formas de ejemplo con los estilos deseados en una presentación de diapositivas de plantilla o en un archivo de plantilla .POTX. Al crear una nueva presentación, abra la plantilla, clone las formas con estilo que necesite y vuelva a aplicar su formato donde sea necesario.

Tipos de Forma Efecto de Forma