Formate formas do PowerPoint em Python
Introdução
Formate formas no PowerPoint ajustando seus contornos, preenchimentos e efeitos. Aspose.Slides for Python via .NET permite controlar essas configurações programaticamente, incluindo transparência, rotação e formatação 3D.

Aspose.Slides for Python via .NET fornece classes e propriedades que permitem formatar formas usando as mesmas opções disponíveis no PowerPoint.
Formatar linhas
Use Shape.line_format para controlar o contorno de uma forma. Este exemplo cria um retângulo sem preenchimento com um contorno azul tracejado. LineFormat.style seleciona uma linha composta grossa‑fina, enquanto LineFormat.width define sua largura para 7 pontos e LineFormat.dash_style seleciona o padrão de traço.
import aspose.slides as slides
import aspose.pydrawing as draw
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 150, 75)
shape.fill_format.fill_type = slides.FillType.NO_FILL
shape.line_format.style = slides.LineStyle.THICK_THIN
shape.line_format.width = 7
shape.line_format.dash_style = slides.LineDashStyle.DASH
shape.line_format.fill_format.fill_type = slides.FillType.SOLID
shape.line_format.fill_format.solid_fill_color.color = draw.Color.blue
presentation.save("formatted_lines.pptx", slides.export.SaveFormat.PPTX)
O resultado:

Definir padrões de traço de linha personalizados
Use LineFormat.custom_dash_pattern quando os estilos de linha predefinidos não fornecem os comprimentos de traço e espaço que você precisa, por exemplo para contornos de marca ou diagramas técnicos. Atribuir um padrão define automaticamente LineFormat.dash_style para LineDashStyle.CUSTOM.
Os valores da lista alternam entre comprimentos de traço e espaço, começando com um traço. Cada valor é um múltiplo da largura da linha: [4, 2] a uma largura de 3 pontos produz um traço de 12 pontos seguido por um espaço de 6 pontos. Use pares de valores finitos e não negativos para definir segmentos completos de traço e espaço. O exemplo usa valores positivos para manter cada traço e espaço visíveis.
Este exemplo cria cinco linhas azuis com o mesmo comprimento e extremidades planas. As três primeiras comparam padrões com largura de 3 pontos. A quarta repete o primeiro padrão com o dobro da largura, dobrando tanto os comprimentos de traço quanto de espaço. A quinta troca de um padrão personalizado para uma linha sólida.
import aspose.slides as slides
with slides.Presentation() as presentation:
presentation.slide_size.set_size(600, 300, slides.SlideSizeScaleType.DO_NOT_SCALE)
slide = presentation.slides[0]
patterns = [
[4, 2],
[1, 2],
[6, 2, 1, 2],
[4, 2],
[4, 2]
]
for i, pattern in enumerate(patterns):
line = slide.shapes.add_auto_shape(slides.ShapeType.LINE, 50, 50 + i * 50, 500, 0)
line.line_format.width = 6 if i == 3 else 3
line.line_format.fill_format.fill_type = slides.FillType.SOLID
line.line_format.fill_format.solid_fill_color.preset_color = slides.PresetColor.DARK_BLUE
line.line_format.cap_style = slides.LineCapStyle.FLAT
line.line_format.begin_arrowhead_style = slides.LineArrowheadStyle.NONE
line.line_format.end_arrowhead_style = slides.LineArrowheadStyle.NONE
line.line_format.custom_dash_pattern = pattern
# Defina a última linha como estilo sólido.
slide.shapes[4].line_format.dash_style = slides.LineDashStyle.SOLID
presentation.save("custom_dash_patterns.pptx", slides.export.SaveFormat.PPTX)
Para voltar a um estilo tracejado predefinido, atribua LineDashStyle.DASH a LineFormat.dash_style. O estilo selecionado controla a aparência da linha.
O resultado no PowerPoint, de cima para baixo: {4, 2}, 3 pt; {1, 2}, 3 pt; {6, 2, 1, 2}, 3 pt; {4, 2}, 6 pt; e Solid, 3 pt.

Definir extremidades de linha
Use LineFormat.cap_style para definir as extremidades de uma linha aberta. A enumeração LineCapStyle fornece três estilos de extremidade explícitos:
FLAT: O traço termina no ponto final.ROUND: Uma extremidade semicircular se estende além do ponto final por metade da largura da linha.SQUARE: Uma extremidade quadrada se estende além do ponto final por metade da largura da linha.
A enumeração também inclui NOT_DEFINED, que significa que nenhum estilo de extremidade foi atribuído explicitamente.
Extremidades são diferentes de pontas de seta, que adicionam símbolos às extremidades da linha, e de junções, que controlam cantos entre segmentos de linha. Este exemplo desabilita as pontas de seta através de LineFormat.begin_arrowhead_style e LineFormat.end_arrowhead_style para que apenas as formas de extremidade sejam comparadas.
O exemplo a seguir cria três linhas horizontais idênticas, com 20 pontos de largura. De cima para baixo, elas usam extremidades plana, redonda e quadrada. Seus pontos finais têm as mesmas coordenadas horizontais; as extremidades redondas e quadradas se estendem 10 pontos além de cada ponto final.
import aspose.slides as slides
with slides.Presentation() as presentation:
presentation.slide_size.set_size(500, 240, slides.SlideSizeScaleType.DO_NOT_SCALE)
slide = presentation.slides[0]
cap_styles = [slides.LineCapStyle.FLAT, slides.LineCapStyle.ROUND, slides.LineCapStyle.SQUARE]
for i, cap_style in enumerate(cap_styles):
line = slide.shapes.add_auto_shape(slides.ShapeType.LINE, 100, 50 + i * 70, 300, 0)
line.line_format.width = 20
line.line_format.fill_format.fill_type = slides.FillType.SOLID
line.line_format.fill_format.solid_fill_color.preset_color = slides.PresetColor.DARK_BLUE
line.line_format.dash_style = slides.LineDashStyle.SOLID
line.line_format.cap_style = cap_style
line.line_format.begin_arrowhead_style = slides.LineArrowheadStyle.NONE
line.line_format.end_arrowhead_style = slides.LineArrowheadStyle.NONE
presentation.save("line_caps.pptx", slides.export.SaveFormat.PPTX)
O resultado no PowerPoint, de cima para baixo: Flat, Round e Square.

Aplicar efeitos de esboço nas linhas de forma
Um efeito de esboço faz com que a linha de uma forma pareça desenhada à mão. Use Shape.line_format para acessar as configurações da linha, LineFormat.sketch_format para acessar as configurações de esboço, e SketchFormat.sketch_type para selecionar um valor da enumeração LineSketchType.
O código Python a seguir mostra como aplicar um efeito LineSketchType.CURVED , ler o valor atribuído explicitamente e remover o efeito com LineSketchType.NONE:
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 200, 100)
sketch_format = shape.line_format.sketch_format
sketch_format.sketch_type = slides.LineSketchType.CURVED
explicit_sketch_type = sketch_format.sketch_type
print(f"Explicit sketch type: {explicit_sketch_type}")
sketch_format.sketch_type = slides.LineSketchType.NONE
O valor retornado por SketchFormat.sketch_type representa a configuração atribuída diretamente à forma. Se a formatação da linha puder ser herdada de um tema, slide mestre ou slide de layout, use LineFormat.get_effective, acesse ILineFormatEffectiveData.sketch_format, e leia ISketchFormatEffectiveData.sketch_type. O valor efetivo reflete a formatação realmente aplicada após a resolução da herança. Este exemplo requer uma apresentação existente com ao menos uma forma no primeiro slide e imprime ambos os valores:
import aspose.slides as slides
with slides.Presentation("presentation.pptx") as presentation:
shape = presentation.slides[0].shapes[0]
line_format = shape.line_format
explicit_sketch_type = line_format.sketch_format.sketch_type
effective_line_format = line_format.get_effective()
effective_sketch_type = effective_line_format.sketch_format.sketch_type
print(f"Explicit sketch type: {explicit_sketch_type}")
print(f"Effective sketch type: {effective_sketch_type}")
Formatar estilos de junção
Estas são as três opções de tipo de junção:
- Round
- Miter
- Bevel
O estilo de junção controla como dois segmentos de contorno se encontram em um canto. Use Round para cantos arredondados, Miter para cantos agudos, ou Bevel para cantos chanfrados.

Este exemplo cria três retângulos pretos com contornos azuis de 15 pontos de largura. Ele define LineFormat.join_style para os valores miter, bevel e round da LineJoinStyle, respectivamente, para comparar como os cantos são desenhados.
import aspose.slides as slides
import aspose.pydrawing as draw
with slides.Presentation() as presentation:
slide = presentation.slides[0]
miter_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 150, 75)
bevel_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 210, 20, 150, 75)
round_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 135, 150, 75)
miter_shape.fill_format.fill_type = slides.FillType.SOLID
miter_shape.fill_format.solid_fill_color.color = draw.Color.black
bevel_shape.fill_format.fill_type = slides.FillType.SOLID
bevel_shape.fill_format.solid_fill_color.color = draw.Color.black
round_shape.fill_format.fill_type = slides.FillType.SOLID
round_shape.fill_format.solid_fill_color.color = draw.Color.black
miter_shape.line_format.width = 15
bevel_shape.line_format.width = 15
round_shape.line_format.width = 15
miter_shape.line_format.fill_format.fill_type = slides.FillType.SOLID
miter_shape.line_format.fill_format.solid_fill_color.color = draw.Color.blue
bevel_shape.line_format.fill_format.fill_type = slides.FillType.SOLID
bevel_shape.line_format.fill_format.solid_fill_color.color = draw.Color.blue
round_shape.line_format.fill_format.fill_type = slides.FillType.SOLID
round_shape.line_format.fill_format.solid_fill_color.color = draw.Color.blue
miter_shape.line_format.join_style = slides.LineJoinStyle.MITER
bevel_shape.line_format.join_style = slides.LineJoinStyle.BEVEL
round_shape.line_format.join_style = slides.LineJoinStyle.ROUND
miter_shape.text_frame.text = "Miter Join Style"
bevel_shape.text_frame.text = "Bevel Join Style"
round_shape.text_frame.text = "Round Join Style"
presentation.save("join_styles.pptx", slides.export.SaveFormat.PPTX)
Limitar junções tipo Miter em cantos agudos
Use LineFormat.miter_limit com LineFormat.join_style definido para LineJoinStyle.MITER para limitar o quanto um canto agudo pode se estender.
O limite é uma proporção da distância entre os cantos interno e externo da junção em relação à largura da linha. Por exemplo, um valor 8 permite um comprimento de miter de até oito vezes a largura da linha; não é uma medida em pontos. Se o canto exceder o limite, o PowerPoint usa uma junção chanfrada naquele ponto. Um limite maior permite pontos mais afiados. A configuração afeta apenas junções tipo miter, e alterá‑la não tem efeito visível quando o canto permanece dentro dos limites.
Este exemplo cria dois triângulos idênticos, sem preenchimento, com contornos de 20 pontos de largura. O triângulo à esquerda usa um limite de 2 e o da direita usa 8. Cada triângulo tem 80 pontos de largura e 160 pontos de altura, proporcionando ao canto superior uma proporção de comprimento‑miter‑para‑largura‑da‑linha de aproximadamente 4.12. Consequentemente, o PowerPoint chanfra o ápice esquerdo e preserva o ápice direito.
import aspose.slides as slides
with slides.Presentation() as presentation:
presentation.slide_size.set_size(500, 320, slides.SlideSizeScaleType.DO_NOT_SCALE)
slide = presentation.slides[0]
miter_limits = [2.0, 8.0]
for i, miter_limit in enumerate(miter_limits):
triangle = slide.shapes.add_auto_shape(slides.ShapeType.TRIANGLE, 90 + i * 240, 110, 80, 160)
triangle.fill_format.fill_type = slides.FillType.NO_FILL
triangle.line_format.width = 20
triangle.line_format.fill_format.fill_type = slides.FillType.SOLID
triangle.line_format.fill_format.solid_fill_color.preset_color = slides.PresetColor.DARK_BLUE
triangle.line_format.join_style = slides.LineJoinStyle.MITER
triangle.line_format.miter_limit = miter_limit
presentation.save("miter_limits.pptx", slides.export.SaveFormat.PPTX)
O resultado no PowerPoint: Miter limit 2 à esquerda e miter limit 8 à direita.

Preenchimento gradiente
Um preenchimento gradiente mescla cores ao longo de uma forma. Este exemplo preenche uma elipse com um gradiente linear em ângulo de 45 graus do vermelho ao púrpura usando FillFormat.gradient_format. O método GradientStopCollection.add coloca as paradas de cor em 0 e 1, o início e o fim do gradiente. Limpar as paradas existentes garante que apenas essas duas cores sejam usadas.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.ELLIPSE, 50, 50, 150, 75)
shape.fill_format.fill_type = slides.FillType.GRADIENT
shape.fill_format.gradient_format.gradient_shape = slides.GradientShape.LINEAR
shape.fill_format.gradient_format.linear_gradient_angle = 45
shape.fill_format.gradient_format.gradient_stops.clear()
shape.fill_format.gradient_format.gradient_stops.add(1.0, slides.PresetColor.PURPLE)
shape.fill_format.gradient_format.gradient_stops.add(0.0, slides.PresetColor.RED)
presentation.save("gradient_fill.pptx", slides.export.SaveFormat.PPTX)
O resultado:

Se um gradiente parecer diferente em uma imagem exportada do que no PowerPoint, veja Escolher um estilo de renderização de gradiente. Você pode selecionar um estilo de renderização sem alterar o preenchimento gradiente armazenado na apresentação.
Definir o ângulo do gradiente linear
Use GradientFormat.linear_gradient_angle para controlar a orientação de um preenchimento GradientShape.LINEAR. O ângulo é medido em graus e aumenta no sentido horário: 0 vai da esquerda para a direita, 90 de cima para baixo, 180 da direita para a esquerda e 270 de baixo para cima. Ângulos fracionários são suportados. Ângulos finitos fora de [0, 360) são normalizados para uma revolução; por exemplo, -45 torna‑se 315 e 360 torna‑se 0.
Este exemplo cria seis retângulos com paradas de cor vermelho, verde e azul idênticas nas posições 0, 0.5 e 1. O escalonamento está desativado para que o ângulo possa ser comparado independentemente das proporções dos retângulos. Os ângulos, da esquerda para a direita, são 0, 45 e 90 na primeira linha, e 135, 180 e 270 na segunda linha.
import aspose.slides as slides
with slides.Presentation() as presentation:
presentation.slide_size.set_size(720, 400, slides.SlideSizeScaleType.DO_NOT_SCALE)
slide = presentation.slides[0]
angles = [0, 45, 90, 135, 180, 270]
for i, angle in enumerate(angles):
x = 30 + (i % 3) * 230
y = 30 + (i // 3) * 190
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, x, y, 200, 150)
shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
shape.fill_format.fill_type = slides.FillType.GRADIENT
gradient = shape.fill_format.gradient_format
gradient.gradient_shape = slides.GradientShape.LINEAR
gradient.gradient_stops.clear()
gradient.gradient_stops.add(0.0, slides.PresetColor.RED)
gradient.gradient_stops.add(0.5, slides.PresetColor.LIME)
gradient.gradient_stops.add(1.0, slides.PresetColor.BLUE)
gradient.linear_gradient_scaled = slides.NullableBool.FALSE
gradient.linear_gradient_angle = angle
presentation.save("linear_gradient_angles.pptx", slides.export.SaveFormat.PPTX)
O resultado no PowerPoint:

Escalar um gradiente linear com a forma
GradientFormat.linear_gradient_scaled aceita um valor NullableBool. Defina‑o explicitamente para FALSE para manter o ângulo geométrico do gradiente enquanto as proporções da forma mudam, ou para TRUE para escalar o gradiente com a largura e altura da forma. Com o escalonamento ativado, o ângulo visível pode diferir do ângulo atribuído em uma forma não quadrada.
O exemplo a seguir usa um ângulo de 45 graus e as mesmas paradas de cor da comparação de ângulos. A coluna da esquerda usa FALSE; a da direita usa TRUE. Cada coluna contém um retângulo largo acima de um retângulo alto. Ambos começam com as mesmas dimensões largas; mudar a largura e altura do segundo retângulo demonstra como o preenchimento responde ao redimensionamento sem alterar suas configurações de gradiente.
import aspose.slides as slides
with slides.Presentation() as presentation:
presentation.slide_size.set_size(720, 460, slides.SlideSizeScaleType.DO_NOT_SCALE)
slide = presentation.slides[0]
scaling_options = [slides.NullableBool.FALSE, slides.NullableBool.TRUE]
for column, scaling in enumerate(scaling_options):
for row in range(2):
x = 30 + column * 360
y = 30 if row == 0 else 150
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, x, y, 300, 90)
shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
shape.fill_format.fill_type = slides.FillType.GRADIENT
gradient = shape.fill_format.gradient_format
gradient.gradient_shape = slides.GradientShape.LINEAR
gradient.gradient_stops.clear()
gradient.gradient_stops.add(0.0, slides.PresetColor.RED)
gradient.gradient_stops.add(0.5, slides.PresetColor.LIME)
gradient.gradient_stops.add(1.0, slides.PresetColor.BLUE)
gradient.linear_gradient_angle = 45
gradient.linear_gradient_scaled = scaling
if row == 1:
shape.width = 90
shape.height = 280
presentation.save("linear_gradient_scaling.pptx", slides.export.SaveFormat.PPTX)
O resultado no PowerPoint, com escalonamento desativado à esquerda e ativado à direita:

Com o escalonamento desativado, as faixas de cor diagonais mantêm a mesma orientação em ambos os retângulos. Com o escalonamento ativado, as faixas se esticam com as proporções da forma. Isso ajuda a reproduzir o gradiente de um modelo ao adaptar uma forma a um tamanho diferente. Em um quadrado, habilitar o escalonamento não altera a aparência deste gradiente de 45 graus.
Tanto o ângulo quanto as configurações de escalonamento se aplicam a gradientes lineares. Eles não controlam preenchimentos GradientShape.RADIAL ou GradientShape.RECTANGLE.
Combinar o ângulo com a direção do gradiente
GradientFormat.gradient_direction seleciona um estilo de gradiente da enumeração GradientDirection; não substitui um ângulo numérico. Para um gradiente linear, os estilos de canto podem mudar a área sobre a qual as cores são distribuídas sem alterar linear_gradient_angle. Mantenha a direção inalterada ao comparar ângulos ou escalonamento.
O exemplo a seguir aplica as mesmas configurações em ordens opostas. Os dois retângulos têm a mesma aparência: atribuir a direção antes ou depois do ângulo não altera o resultado.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
for i in range(2):
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 30, 30 + i * 140, 320, 100)
shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
shape.fill_format.fill_type = slides.FillType.GRADIENT
gradient = shape.fill_format.gradient_format
gradient.gradient_shape = slides.GradientShape.LINEAR
gradient.gradient_stops.clear()
gradient.gradient_stops.add(0.0, slides.PresetColor.RED)
gradient.gradient_stops.add(0.5, slides.PresetColor.LIME)
gradient.gradient_stops.add(1.0, slides.PresetColor.BLUE)
gradient.linear_gradient_scaled = slides.NullableBool.TRUE
if i == 0:
gradient.gradient_direction = slides.GradientDirection.FROM_CORNER1
gradient.linear_gradient_angle = 30
else:
gradient.linear_gradient_angle = 30
gradient.gradient_direction = slides.GradientDirection.FROM_CORNER1
presentation.save("linear_gradient_direction.pptx", slides.export.SaveFormat.PPTX)
Preenchimento de padrão
Um preenchimento de padrão aplica um design bicolor, como pontos, listras ou quadriculados. Este exemplo usa PatternFormat.pattern_style para selecionar um padrão de treliça. PatternFormat.back_color fornece o fundo cinza‑claro, e PatternFormat.fore_color fornece a cor amarela do padrão.
import aspose.slides as slides
import aspose.pydrawing as draw
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 150, 75)
shape.fill_format.fill_type = slides.FillType.PATTERN
shape.fill_format.pattern_format.pattern_style = slides.PatternStyle.TRELLIS
shape.fill_format.pattern_format.back_color.color = draw.Color.light_gray
shape.fill_format.pattern_format.fore_color.color = draw.Color.yellow
presentation.save("pattern_fill.pptx", slides.export.SaveFormat.PPTX)
O resultado:

Preenchimento de imagem
Um preenchimento de imagem usa uma foto dentro de uma forma. Este exemplo requer uma imagem local e usa Images.from_file para carregá‑la na coleção de imagens da apresentação. Definir PictureFillFormat.picture_fill_mode para o modo em mosaico repete a imagem dentro do retângulo. A imagem de origem usada aqui é mostrada abaixo:

import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 255, 130)
shape.fill_format.fill_type = slides.FillType.PICTURE
shape.fill_format.picture_fill_format.picture_fill_mode = slides.PictureFillMode.TILE
with slides.Images.from_file("lotus.png") as image:
presentation_image = presentation.images.add_image(image)
shape.fill_format.picture_fill_format.picture.image = presentation_image
presentation.save("picture_fill.pptx", slides.export.SaveFormat.PPTX)
O resultado:

Usar imagem em tile como textura
Se você quiser definir uma imagem em tile como textura e personalizar o comportamento de ladrilhamento, pode usar as seguintes propriedades da classe PictureFillFormat:
- picture_fill_mode: Define o modo de preenchimento da imagem — either
TILEorSTRETCH. - tile_alignment: Especifica o alinhamento dos tiles dentro da forma.
- tile_flip: Controla se o tile é invertido horizontalmente, verticalmente ou em ambas as direções.
- tile_offset_x: Define o deslocamento horizontal do tile (em pontos) a partir da origem da forma.
- tile_offset_y: Define o deslocamento vertical do tile (em pontos) a partir da origem da forma.
- tile_scale_x: Define a escala horizontal do tile como porcentagem.
- tile_scale_y: Define a escala vertical do tile como porcentagem.
Este exemplo requer uma imagem local e configura PictureFillFormat para repeti‑la em 50% do seu tamanho original. Deslocamentos de −32 pontos deslocam os tiles horizontal e verticalmente; alinhamento bottom‑right e inversão em ambas as direções determinam como a textura repetida é organizada.
import aspose.slides as slides
with slides.Presentation() as presentation:
first_slide = presentation.slides[0]
shape = first_slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 190, 95)
shape.fill_format.fill_type = slides.FillType.PICTURE
with slides.Images.from_file("lotus.png") as source_image:
presentation_image = presentation.images.add_image(source_image)
picture_fill_format = shape.fill_format.picture_fill_format
picture_fill_format.picture.image = presentation_image
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
presentation.save("tile.pptx", slides.export.SaveFormat.PPTX)
O resultado:

Preenchimento de cor sólida
Um preenchimento sólido dá a uma forma uma única cor uniforme. Este exemplo define FillFormat.fill_type para o modo de preenchimento sólido e atribui amarelo através de FillFormat.solid_fill_color, depois salva o retângulo em uma apresentação.
import aspose.slides as slides
import aspose.pydrawing as draw
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 150, 75)
shape.fill_format.fill_type = slides.FillType.SOLID
shape.fill_format.solid_fill_color.color = draw.Color.yellow
presentation.save("solid_color_fill.pptx", slides.export.SaveFormat.PPTX)
O resultado:

Copiar cores preservando referências de tema
Use ColorFormat.copy_from para copiar uma definição de cor, incluindo seu tipo de cor, referência de tema e transformações. Isso é útil ao transferir a cor de preenchimento entre formas que devem continuar seguindo o tema da apresentação. O método copia apenas a cor: não copia o tipo de preenchimento, contorno ou outra formatação da forma. Defina explicitamente o FillFormat.fill_type do destino.
Este exemplo cria três retângulos, da esquerda para a direita: a fonte, uma cópia consciente do tema e uma cópia RGB fixa. A fonte usa ColorFormat.scheme_color para referenciar a primeira cor de destaque e adiciona um matiz através de ColorOperationCollection.add. A cópia RGB usa a cor de preenchimento efetiva da fonte, de modo que todas as três inicialmente pareçam idênticas. Atribuir ColorFormat.color define um valor RGB fixo e limpa quaisquer transformações de cor existentes.
import aspose.slides as slides
import aspose.pydrawing as draw
with slides.Presentation() as presentation:
presentation.slide_size.set_size(660, 220, slides.SlideSizeScaleType.DO_NOT_SCALE)
slide = presentation.slides[0]
presentation.master_theme.color_scheme.accent1.color = draw.Color.royal_blue
source = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 30, 40, 180, 140)
theme_copy = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 240, 40, 180, 140)
rgb_copy = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 450, 40, 180, 140)
for shape in (source, theme_copy, rgb_copy):
shape.fill_format.fill_type = slides.FillType.SOLID
shape.line_format.fill_format.fill_type = slides.FillType.NO_FILL
source_color = source.fill_format.solid_fill_color
source_color.scheme_color = slides.SchemeColor.ACCENT1
source_color.color_transform.add(slides.ColorTransformOperation.TINT, 0.75)
theme_copy.fill_format.solid_fill_color.copy_from(source_color)
rgb_copy.fill_format.solid_fill_color.color = source.fill_format.get_effective().solid_fill_color
with slide.get_image(1.0, 1.0) as before:
before.save("color-copy-before.png", slides.ImageFormat.PNG)
# As referências de tema seguem a nova cor de destaque; o valor RGB fixo não segue.
presentation.master_theme.color_scheme.accent1.color = draw.Color.orange_red
with slide.get_image(1.0, 1.0) as after:
after.save("color-copy-after.png", slides.ImageFormat.PNG)
presentation.save("copied_colors.pptx", slides.export.SaveFormat.PPTX)
Antes da mudança de tema, todos os três preenchimentos correspondem:

Após a mudança de tema, a fonte e a cópia consciente do tema seguem a nova cor de destaque e mantêm seu matiz. A cópia RGB fixa permanece azul:

A definição copiada é independente da fonte. Alterar posteriormente a referência de tema da fonte, atribuir outra cor ou adicionar ou remover suas transformações não altera o destino. Uma mudança de tema ainda afeta ambas as formas porque cada uma refere‑se independentemente à mesma cor de tema.
Salvar e reabrir o PPTX preserva o ColorFormat.color_type copiado, a referência de tema e a coleção ColorFormat.color_transform; não converte a definição para RGB.
Ao copiar entre diferentes contextos de tema, como apresentações com paletas de destaque distintas, a referência copiada é resolvida contra o tema do destino. A mesma referência e transformações podem, portanto, produzir uma cor visível diferente. Veja Tema da Apresentação para mais detalhes sobre a configuração de cores de tema.
Usar o plano de fundo do slide como preenchimento de forma
Use AutoShape.use_background_fill quando uma forma deve corresponder ao plano de fundo do slide, por exemplo em um modelo de apresentação. Defina FillFormat.fill_type para FillType.NOT_DEFINED primeiro para remover qualquer preenchimento explícito. Com essa combinação, a forma usa o plano de fundo do slide em vez do seu preenchimento de estilo. Habilitar a flag sozinha não remove um preenchimento explícito existente.
Isso difere de FillType.NO_FILL: o preenchimento de fundo cobre objetos atrás da forma com a área correspondente do plano de fundo do slide, enquanto sem preenchimento deixa esses objetos visíveis. Um gradiente permanece alinhado com o slide em vez de reiniciar dentro de cada forma.
O exemplo a seguir cria um plano de fundo mestre herdado pelo slide e coloca uma faixa magenta atrás de três retângulos. O retângulo esquerdo usa o fundo, o do meio não tem preenchimento e o da direita troca de preenchimento de fundo para um preenchimento laranja explícito.
import aspose.slides as slides
import aspose.pydrawing as draw
with slides.Presentation() as presentation:
presentation.slide_size.set_size(720, 400, slides.SlideSizeScaleType.DO_NOT_SCALE)
slide = presentation.slides[0]
# Herdar o gradiente do mestre.
slide.background.type = slides.BackgroundType.NOT_DEFINED
slide.layout_slide.background.type = slides.BackgroundType.NOT_DEFINED
background = slide.layout_slide.master_slide.background
background.type = slides.BackgroundType.OWN_BACKGROUND
background.fill_format.fill_type = slides.FillType.GRADIENT
gradient = background.fill_format.gradient_format
gradient.gradient_shape = slides.GradientShape.LINEAR
gradient.linear_gradient_angle = 0
gradient.gradient_stops.clear()
gradient.gradient_stops.add(0, draw.Color.dark_blue)
gradient.gradient_stops.add(1, draw.Color.light_sky_blue)
# Adicione este objeto primeiro para que apareça atrás dos retângulos.
band = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 25, 150, 670, 100)
band.fill_format.fill_type = slides.FillType.SOLID
band.fill_format.solid_fill_color.color = draw.Color.magenta
band.line_format.fill_format.fill_type = slides.FillType.NO_FILL
background_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 100, 160, 200)
background_shape.fill_format.fill_type = slides.FillType.NOT_DEFINED
background_shape.use_background_fill = True
no_fill_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 280, 100, 160, 200)
no_fill_shape.fill_format.fill_type = slides.FillType.NO_FILL
explicit_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 510, 100, 160, 200)
explicit_shape.fill_format.fill_type = slides.FillType.NOT_DEFINED
explicit_shape.use_background_fill = True
# Desabilitar preenchimento de fundo antes de aplicar um preenchimento explícito.
explicit_shape.use_background_fill = False
explicit_shape.fill_format.fill_type = slides.FillType.SOLID
explicit_shape.fill_format.solid_fill_color.color = draw.Color.orange
presentation.save("background_fill.pptx", slides.export.SaveFormat.PPTX)
O resultado, da esquerda para a direita: background fill, no fill, e explicit fill. A faixa magenta fica oculta pelos retângulos esquerdo e direito, mas permanece visível através do retângulo do meio.

O mesmo comportamento se aplica a um fundo definido diretamente no slide ou herdado de um layout. A forma usa o fundo resolvido do slide; o exemplo deixa os fundos do slide e do layout indefinidos para que o mestre o forneça.
Definir transparência
Para um preenchimento sólido, o componente alfa da cor controla a opacidade: 0 é totalmente transparente e 255 totalmente opaco. Este exemplo usa um valor alfa de 128 para um retângulo amarelo, tornando‑o aproximadamente 50 % transparente para que o retângulo abaixo permaneça visível. A cor é atribuída por meio de FillFormat.solid_fill_color.
import aspose.slides as slides
import aspose.pydrawing as draw
alpha = 128
with slides.Presentation() as presentation:
slide = presentation.slides[0]
solid_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 150, 75)
transparent_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 80, 80, 150, 75)
transparent_shape.fill_format.fill_type = slides.FillType.SOLID
transparent_shape.fill_format.solid_fill_color.color = draw.Color.from_argb(alpha, draw.Color.yellow)
presentation.save("shape_transparency.pptx", slides.export.SaveFormat.PPTX)
O resultado:

Rotacionar formas
Use Shape.rotation para rotacionar uma forma no plano do slide. O ângulo é medido em graus; este exemplo rotaciona um retângulo 5 graus no sentido horário e salva a apresentação.
import aspose.slides as slides
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 150, 75)
shape.rotation = 5
presentation.save("shape_rotation.pptx", slides.export.SaveFormat.PPTX)
O resultado:

Adicionar efeitos de chanfro 3D
Use Shape.three_d_format para dar profundidade e bordas chanfradas a uma forma. Este exemplo cria uma elipse verde com contorno laranja, define ThreeDFormat.depth para 4 pontos e aplica um chanfro superior circular com largura e altura de 6 pontos através de ThreeDFormat.bevel_top. Uma câmera ortográfica frontal e iluminação de três pontos tornam o chanfro visível.
import aspose.slides as slides
import aspose.pydrawing as draw
with slides.Presentation() as presentation:
slide = presentation.slides[0]
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
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
presentation.save("3D_bevel_effect.pptx", slides.export.SaveFormat.PPTX)
O resultado:

Adicionar efeitos de rotação 3D
A visualização 3D de uma forma é controlada pelas configurações da câmera. Este exemplo usa Camera.set_rotation com ângulos de latitude, longitude e revolução de 40, 35 e 20 graus, respectivamente. Seleciona uma câmera isométrica através de Camera.camera_type e iluminação balanceada através de LightRig.light_type, depois salva o retângulo formatado.
import aspose.slides as slides
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.camera.camera_type = slides.CameraPresetType.ISOMETRIC_LEFT_UP
auto_shape.three_d_format.camera.set_rotation(40, 35, 20)
auto_shape.three_d_format.light_rig.light_type = slides.LightRigPresetType.BALANCED
presentation.save("3D_rotation_effect.pptx", slides.export.SaveFormat.PPTX)
O resultado:

Controlar renderização em preto e branco para formas
A propriedade Shape.black_white_mode especifica como uma forma individual é renderizada quando uma apresentação é visualizada ou processada em modo preto‑e‑branco. Ela não habilita a exibição em preto‑e‑branco por si só, nem altera o preenchimento, contorno ou outra formatação da forma no modo de cor normal.
Use um valor da enumeração BlackWhiteMode para selecionar o comportamento desejado. Por exemplo, AUTOMATIC permite que o aplicativo de renderização escolha a conversão, GRAY e LIGHT_GRAY usam coloração cinza, BLACK_WHITE usa apenas preto e branco, BLACK e WHITE forçam uma única cor, COLOR preserva a coloração normal e HIDDEN omite a forma no modo preto‑e‑branco. NOT_DEFINED significa que nenhum modo de nível de forma foi atribuído.
Este exemplo cria um retângulo laranja e define Shape.black_white_mode para cinza. A forma salva mantém seu preenchimento laranja para exibição em cor normal e solicita coloração cinza em aplicativos que respeitam as configurações de exibição em preto‑e‑branco:
import aspose.slides as slides
import aspose.pydrawing as draw
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 200, 100)
shape.fill_format.fill_type = slides.FillType.SOLID
shape.fill_format.solid_fill_color.color = draw.Color.orange
shape.black_white_mode = slides.BlackWhiteMode.GRAY
presentation.save("shape_black_white_mode.pptx", slides.export.SaveFormat.PPTX)
Em modo de cor normal, o retângulo mantém seu preenchimento laranja. Em um fluxo de trabalho de exibição em preto‑e‑branco, ele usa coloração cinza porque seu modo está definido como GRAY. Isso permite preservar um slide em cores completas enquanto define uma aparência distinta para impressão, visualização ou outros fluxos que respeitam as configurações de exibição em preto‑e‑branco da apresentação.
Redefinir formatação
Use Slide.reset para restaurar a posição, tamanho e formatação dos marcadores de posição do slide a partir de seus respectivos marcadores de posição de layout. Este exemplo requer uma apresentação existente com marcadores de posição vinculados ao layout e redefine cada slide antes de salvar. Formas sem marcadores de posição correspondentes no layout não são redefinidas.
import aspose.slides as slides
with slides.Presentation("sample.pptx") as presentation:
for slide in presentation.slides:
slide.reset()
presentation.save("reset_formatting.pptx", slides.export.SaveFormat.PPTX)
Perguntas frequentes
A formatação de forma afeta o tamanho final do arquivo da apresentação?
Cores, estilos de linha e configurações de efeito geralmente adicionam poucos dados em comparação com imagens e mídia incorporadas. Preenchimentos de imagem podem aumentar o tamanho do arquivo porque suas imagens são armazenadas na apresentação.
Como posso detectar formas em um slide que compartilham formatação idêntica para que eu possa agrupá‑las?
Compare as principais propriedades de formatação de cada forma — preenchimento, linha e configurações de efeito. Se todos os valores correspondentes coincidirem, trate seus estilos como idênticos e agrupe logicamente essas formas, o que simplifica o gerenciamento posterior de estilos.
Posso salvar um conjunto de estilos de forma personalizados em um arquivo separado para reutilizar em outras apresentações?
Sim. Armazene formas de exemplo com os estilos desejados em um slide‑modelo ou em um arquivo de modelo .POTX. Ao criar uma nova apresentação, abra o modelo, clone as formas estilizadas de que precisa e reaplique sua formatação onde for necessário.