Formátování tvarů PowerPointu v Pythonu přes Javu
Úvod
Formátujte tvary v PowerPointu úpravou jejich obrysů, výplní a efektů. Aspose.Slides pro Python prostřednictvím Javy vám umožňuje tato nastavení řídit programově, včetně průhlednosti, otáčení a 3D formátování.

Aspose.Slides pro Python prostřednictvím Javy poskytuje třídy a metody, které vám umožňují formátovat tvary pomocí stejných možností, jaké jsou k dispozici v PowerPointu.
Formátování čar
Použijte Shape.getLineFormat k řízení obrysu tvaru. Tento příklad vytváří nevyplněný obdélník s modrým, čárkovaným obrysem. LineFormat.setStyle vybírá složenou čáru tlustá‑tenká, zatímco LineFormat.setWidth nastavuje její šířku na 7 bodů a LineFormat.setDashStyle vybírá vzor čáry.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineDashStyle, LineStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
shape.getFillFormat().setFillType(FillType.NoFill)
shape.getLineFormat().setStyle(LineStyle.ThickThin)
shape.getLineFormat().setWidth(7)
shape.getLineFormat().setDashStyle(LineDashStyle.Dash)
shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
presentation.save("formatted_lines.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek:

Nastavení vlastních vzorů čáry
Použijte LineFormat.setCustomDashPattern když předdefinované styly čar neposkytují požadované délky čáry a mezer, například pro firemní obrysy nebo technické diagramy. Přiřazení vzoru automaticky mění styl čáry na LineDashStyle.Custom.
Pole položek střídavě obsahuje délky čáry a mezery, počínaje čárou. Každá hodnota je násobkem šířky čáry: [4, 2] při šířce 3 bodií vytvoří čáru dlouhou 12 bodů následovanou mezerou 6 bodů. Používejte dvojice konečných, nezáporných hodnot pro definování úplných úseků čáry‑mezery. Příklad používá kladné hodnoty, aby byla každá čára i mezera viditelná.
Tento příklad vytvoří pět modrých čar se stejnou délkou a plochými konci. První tři porovnávají vzory při šířce 3 bodů. Čtvrtá opakuje první vzor při dvojnásobné šířce, čímž zdvojnásobí jak délky čáry, tak mezery. Pátá přepíná z vlastního vzoru na plnou čáru.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineArrowheadStyle, LineCapStyle, LineDashStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(600, 300, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
patterns = [
[4, 2],
[1, 2],
[6, 2, 1, 2],
[4, 2],
[4, 2]
]
for i, pattern in enumerate(patterns):
line = slide.getShapes().addAutoShape(ShapeType.Line, 50, 50 + i * 50, 500, 0)
line.getLineFormat().setWidth(6 if i == 3 else 3)
line.getLineFormat().getFillFormat().setFillType(FillType.Solid)
color = Color(0, 0, 139)
line.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
line.getLineFormat().setCapStyle(LineCapStyle.Flat)
line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None_)
line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None_)
line.getLineFormat().setCustomDashPattern(jpype.JArray(jpype.JFloat)(pattern))
# Vrátit poslední čáru na plný styl.
slide.getShapes().get_Item(4).getLineFormat().setDashStyle(LineDashStyle.Solid)
presentation.save("custom_dash_patterns.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Chcete‑li se vrátit k předdefinovanému přerušovanému stylu, předávejte LineDashStyle.Dash metodě LineFormat.setDashStyle. Vybraný styl řídí vzhled čáry.
Výsledek v PowerPointu, shora dolů: {4, 2}, 3 pt; {1, 2}, 3 pt; {6, 2, 1, 2}, 3 pt; {4, 2}, 6 pt; a Solid, 3 pt.

Nastavení koncových stylů čáry
Použijte LineFormat.setCapStyle k nastavení konců otevřené čáry. Třída LineCapStyle poskytuje tři explicitní styly konců:
Flat: Tah končí na koncovém bodě.Round: Polokruhový koncový prvek přesahuje za koncový bod o polovinu šířky čáry.Square: Čtvercový koncový prvek přesahuje za koncový bod o polovinu šířky čáry.
Třída také obsahuje NotDefined, což znamená, že žádný styl konce není explicitně přiřazen.
Konce se liší od šipek, které přidávají symboly k koncům čáry, a od spojení, která řídí rohy mezi úseky čáry. Tento příklad vypíná šipky pomocí LineFormat.setBeginArrowheadStyle a LineFormat.setEndArrowheadStyle, aby se porovnávaly jen tvary konců.
Následující příklad vytvoří tři jinak identické vodorovné čáry, široké 20 bodů. Shora dolů používají plochý, kulatý a čtvercový konec. Jejich koncové souřadnice jsou stejné; kulaté a čtvercové konce přesahují o 10 bodů za každý konec.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineArrowheadStyle, LineCapStyle, LineDashStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(500, 240, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
cap_styles = [LineCapStyle.Flat, LineCapStyle.Round, LineCapStyle.Square]
for i, cap_style in enumerate(cap_styles):
line = slide.getShapes().addAutoShape(ShapeType.Line, 100, 50 + i * 70, 300, 0)
line.getLineFormat().setWidth(20)
line.getLineFormat().getFillFormat().setFillType(FillType.Solid)
color = Color(0, 0, 139)
line.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
line.getLineFormat().setDashStyle(LineDashStyle.Solid)
line.getLineFormat().setCapStyle(cap_style)
line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None_)
line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None_)
presentation.save("line_caps.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek v PowerPointu, shora dolů: Flat, Round a Square.

Použití skicových efektů na čáry tvaru
Skicový efekt způsobí, že čára tvaru vypadá ručně kreslená. Použijte Shape.getLineFormat pro přístup k nastavení čáry, LineFormat.getSketchFormat pro přístup k nastavení skici a SketchFormat.setSketchType pro výběr hodnoty ze třídy LineSketchType.
Následující Python kód ukazuje, jak použít efekt LineSketchType.Curved, přečíst explicitně přiřazenou hodnotu a odstranit efekt pomocí LineSketchType.None_:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import LineSketchType, Presentation, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100)
sketch_format = shape.getLineFormat().getSketchFormat()
sketch_format.setSketchType(LineSketchType.Curved)
explicit_sketch_type = sketch_format.getSketchType()
print("Explicit sketch type:", explicit_sketch_type)
sketch_format.setSketchType(LineSketchType.None_)
finally:
presentation.dispose()
Hodnota vrácená metodou SketchFormat.getSketchType představuje nastavení přiřazené přímo tvaru. Pokud může být formátování čáry zděděno z témy, hlavního snímku nebo rozložení, použijte LineFormat.getEffective a přečtěte typ skici z vráceného efektivního formátování čáry, jak je ukázáno níže. Efektivní hodnota odráží formátování, které je skutečně použito po vyřešení dědičnosti. Tento příklad vyžaduje existující prezentaci s alespoň jedním tvarem na prvním snímku a vypíše obě hodnoty:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation
presentation = Presentation("presentation.pptx")
try:
shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)
line_format = shape.getLineFormat()
explicit_sketch_type = line_format.getSketchFormat().getSketchType()
effective_line_format = line_format.getEffective()
effective_sketch_type = effective_line_format.getSketchFormat().getSketchType()
print("Explicit sketch type:", explicit_sketch_type)
print("Effective sketch type:", effective_sketch_type)
finally:
presentation.dispose()
Formátování stylů spojení
Zde jsou tři možnosti typu spojení:
- Round
- Miter
- Bevel
Styl spojení řídí, jak se dva obrysové úseky setkají v rohu. Použijte Round pro zaoblené rohy, Miter pro ostré rohy nebo Bevel pro zploštělé rohy.

Tento příklad vytvoří tři černé obdélníky s modrými obrysy širokými 15 bodů. Používá LineFormat.setJoinStyle k nastavení hodnot miter, bevel a round třídy LineJoinStyle, aby porovnal, jak jsou rohy vykresleny.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineJoinStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
miter_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 75)
bevel_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 210, 20, 150, 75)
round_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 135, 150, 75)
miter_shape.getFillFormat().setFillType(FillType.Solid)
miter_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
bevel_shape.getFillFormat().setFillType(FillType.Solid)
bevel_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
round_shape.getFillFormat().setFillType(FillType.Solid)
round_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
miter_shape.getLineFormat().setWidth(15)
bevel_shape.getLineFormat().setWidth(15)
round_shape.getLineFormat().setWidth(15)
miter_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
miter_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
bevel_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
bevel_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
round_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
round_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
miter_shape.getLineFormat().setJoinStyle(LineJoinStyle.Miter)
bevel_shape.getLineFormat().setJoinStyle(LineJoinStyle.Bevel)
round_shape.getLineFormat().setJoinStyle(LineJoinStyle.Round)
miter_shape.getTextFrame().setText("Miter Join Style")
bevel_shape.getTextFrame().setText("Bevel Join Style")
round_shape.getTextFrame().setText("Round Join Style")
presentation.save("join_styles.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Omezení spojení Miter u ostrých rohů
Použijte LineFormat.setMiterLimit spolu s LineFormat.setJoinStyle nastaveným na LineJoinStyle.Miter pro omezení, jak daleko může ostrý roh vyčnívat.
Limit je poměr mezi vzdáleností vnitřního a vnějšího rohu spoje a šířkou čáry. Například hodnota 8 umožňuje délku miteru až osmkrát větší než šířka čáry; nejde o míru v bodech. Pokud by roh překročil limit, PowerPoint použije na tomto místě zkosený spoj. Větší limit umožňuje ostřejší body. Nastavení ovlivňuje jen spoje typu miter a jeho změna se neprojeví, pokud roh zůstane v obou limitech.
Tento příklad vytvoří dva identické, nevyplněné trojúhelníky s obrysy širokými 20 bodů. Levý trojúhelník používá limit 2 a pravý limit 8. Každý trojúhelník má šířku 80 bodů a výšku 160 bodů, což dává poměr délky miteru k šířce čáry přibližně 4.12. Výsledkem je, že PowerPoint zkosení levého vrcholu a zachová ostrý pravý vrchol.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, LineJoinStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(500, 320, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
miter_limits = [2.0, 8.0]
for i, miter_limit in enumerate(miter_limits):
triangle = slide.getShapes().addAutoShape(ShapeType.Triangle, 90 + i * 240, 110, 80, 160)
triangle.getFillFormat().setFillType(FillType.NoFill)
triangle.getLineFormat().setWidth(20)
triangle.getLineFormat().getFillFormat().setFillType(FillType.Solid)
color = Color(0, 0, 139)
triangle.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
triangle.getLineFormat().setJoinStyle(LineJoinStyle.Miter)
triangle.getLineFormat().setMiterLimit(miter_limit)
presentation.save("miter_limits.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek v PowerPointu: Miter limit 2 vlevo a miter limit 8 vpravo.

Gradient Fill
Gradientní výplň míchá barvy napříč tvarem. Tento příklad vyplní elipsu lineárním gradientem pod úhlem 45 stupňů od červené po fialovou pomocí FillFormat.getGradientFormat. Metoda GradientStopCollection.addPresetColor umístí zastávky barev na 0 a 1, tedy na začátek a konec gradientu. Vymazání existujících zastávek zajistí, že budou použity jen tyto dvě barvy.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientShape, Presentation, PresetColor, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 50, 50, 150, 75)
shape.getFillFormat().setFillType(FillType.Gradient)
shape.getFillFormat().getGradientFormat().setGradientShape(GradientShape.Linear)
shape.getFillFormat().getGradientFormat().setLinearGradientAngle(45)
shape.getFillFormat().getGradientFormat().getGradientStops().clear()
shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(1.0, PresetColor.Purple)
shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(0.0, PresetColor.Red)
presentation.save("gradient_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek:

Pokud gradient v exportovaném obrázku vypadá odlišně než v PowerPointu, podívejte se na Choose a Gradient Rendering Style. Můžete vybrat styl vykreslování bez změny gradientní výplně uložené v prezentaci.
Nastavení úhlu lineárního gradientu
Použijte GradientFormat.setLinearGradientAngle pro řízení orientace výplně GradientShape.Linear. Úhel se měří ve stupních a roste po směru hodinových ručiček: 0 běží z leva doprava, 90 shora dolů, 180 zprava doleva a 270 zdola nahoru. Podporují se i desetinné úhly. Konečné úhly mimo interval [0, 360) se normalizují na jednu revoluci; například -45 se změní na 315 a 360 na 0.
Tento příklad vytvoří šest obdélníků se stejnými červenými, zelenými a modrými zastávkami na pozicích 0, 0.5 a 1. Škálování je vypnuto, takže úhel lze porovnávat nezávisle na proporcích obdélníků. Úhly z leva doprava jsou 0, 45 a 90 v prvním řádku a 135, 180 a 270 ve druhém řádku.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(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.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 200, 150)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
shape.getFillFormat().setFillType(FillType.Gradient)
gradient = shape.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.getGradientStops().clear()
gradient.getGradientStops().add(0, Color.RED)
gradient.getGradientStops().add(0.5, Color.GREEN)
gradient.getGradientStops().add(1, Color.BLUE)
gradient.setLinearGradientScaled(NullableBool.False_)
gradient.setLinearGradientAngle(angle)
presentation.save("linear_gradient_angles.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek v PowerPointu:

Škálování lineárního gradientu s tvarem
GradientFormat.setLinearGradientScaled přijímá hodnotu typu NullableBool. Nastavte ji explicitně na False_, aby úhel geometrického gradientu zůstal stejný při změně proporcí tvaru, nebo na True_, aby se gradient škáloval se šířkou a výškou tvaru. Při zapnutém škálování se viditelný úhel může lišit od přiřazeného úhlu u nečtvercového tvaru.
Následující příklad používá úhel 45 stupňů a stejné zastávky barev jako v příkladu porovnání úhlů. Levý sloupec používá False_; pravý True_. Každý sloupec obsahuje široký obdélník nad vysokým obdélníkem. Oba začínají se stejnými širokými rozměry; změna šířky a výšky druhého obdélníku ukazuje, jak výplň reaguje na změnu velikosti bez změny nastavení gradientu.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(720, 460, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
scaling_options = [NullableBool.False_, NullableBool.True_]
for column, scaled in enumerate(scaling_options):
for row in range(2):
x = 30 + column * 360
y = 30 if row == 0 else 150
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 300, 90)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
shape.getFillFormat().setFillType(FillType.Gradient)
gradient = shape.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.getGradientStops().clear()
gradient.getGradientStops().add(0, Color.RED)
gradient.getGradientStops().add(0.5, Color.GREEN)
gradient.getGradientStops().add(1, Color.BLUE)
gradient.setLinearGradientAngle(45)
gradient.setLinearGradientScaled(scaled)
if row == 1:
shape.setWidth(90)
shape.setHeight(280)
presentation.save("linear_gradient_scaling.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek v PowerPointu, škálování vypnuto vlevo a zapnuto vpravo:

Při vypnutém škálování zůstávají diagonální barevné pásy orientovány stejně v obou obdélnících. Při zapnutém škálování se pásy natáhnou s proporcemi tvaru. To pomáhá reprodukovat gradient šablony při úpravě tvaru na jinou velikost. U čtverce nezmění zapnuté škálování vzhled tohoto 45‑stupňového gradientu.
Oba nastavení – úhel i škálování – se vztahují na lineární gradienty. Neovlivňují výplně GradientShape.Radial nebo GradientShape.Rectangle.
Kombinace úhlu se směrem gradientu
GradientFormat.setGradientDirection vybírá styl gradientu ze třídy GradientDirection; není náhradou za číselný úhel. Pro lineární gradient mohou styly rohů měnit oblast, na kterou jsou barvy rozloženy, aniž by se změnil úhel nastavený přes setLinearGradientAngle. Při porovnávání úhlů nebo škálování ponechte směr beze změny.
Následující příklad aplikuje stejná nastavení v opačném pořadí. Oba obdélníky mají stejný vzhled: nastavení směru před nebo po úhlu nemění výsledek.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, GradientDirection, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
for i in range(2):
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 30 + i * 140, 320, 100)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
shape.getFillFormat().setFillType(FillType.Gradient)
gradient = shape.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.getGradientStops().clear()
gradient.getGradientStops().add(0, Color.RED)
gradient.getGradientStops().add(0.5, Color.GREEN)
gradient.getGradientStops().add(1, Color.BLUE)
gradient.setLinearGradientScaled(NullableBool.True_)
if i == 0:
gradient.setGradientDirection(GradientDirection.FromCorner1)
gradient.setLinearGradientAngle(30)
else:
gradient.setLinearGradientAngle(30)
gradient.setGradientDirection(GradientDirection.FromCorner1)
presentation.save("linear_gradient_direction.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Pattern Fill
Patternová výplň aplikuje dvoubarevný návrh, například tečky, pruhy nebo šachovnici. Tento příklad používá PatternFormat.setPatternStyle k výběru vzoru “trellis”. PatternFormat.getBackColor nastaví světle šedé pozadí a PatternFormat.getForeColor žlutou barvu vzoru.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, PatternStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
shape.getFillFormat().setFillType(FillType.Pattern)
shape.getFillFormat().getPatternFormat().setPatternStyle(PatternStyle.Trellis)
shape.getFillFormat().getPatternFormat().getBackColor().setColor(Color.LIGHT_GRAY)
shape.getFillFormat().getPatternFormat().getForeColor().setColor(Color.YELLOW)
presentation.save("pattern_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek:

Picture Fill
Obrázková výplň používá obrázek uvnitř tvaru. Tento příklad vyžaduje lokální obrázek a načte jej do kolekce obrázků prezentace pomocí Images.fromFile. Nastavením PictureFillFormat.setPictureFillMode na režim dlaždic se obrázek opakuje uvnitř obdélníku. Zdrojový obrázek použitý zde je zobrazen níže:

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Images, PictureFillMode, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 255, 130)
shape.getFillFormat().setFillType(FillType.Picture)
shape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Tile)
image = Images.fromFile("lotus.png")
try:
picture = presentation.getImages().addImage(image)
finally:
image.dispose()
shape.getFillFormat().getPictureFillFormat().getPicture().setImage(picture)
presentation.save("picture_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek:

Tile Picture As Texture
Pokud chcete nastavit dlaždicový obrázek jako texturu a přizpůsobit chování dlaždic, můžete použít následující metody třídy PictureFillFormat:
- setPictureFillMode: Nastavuje režim výplně obrázkem –
TileneboStretch. - setTileAlignment: Určuje zarovnání dlaždic uvnitř tvaru.
- setTileFlip: Řídí, zda se dlaždice převrací horizontálně, vertikálně nebo obojí.
- setTileOffsetX: Nastavuje horizontální posun dlaždice (v bodech) od počátku tvaru.
- setTileOffsetY: Nastavuje vertikální posun dlaždice (v bodech) od počátku tvaru.
- setTileScaleX: Definuje horizontální měřítko dlaždice v procentech.
- setTileScaleY: Definuje vertikální měřítko dlaždice v procentech.
Tento příklad vyžaduje lokální obrázek a konfiguruje PictureFillFormat tak, aby jej opakoval s 50 % původní velikosti. Posuny −32 bodů posunou dlaždice horizontálně i vertikálně; zarovnání vpravo dole a převrácení v obou směrech určuje uspořádání opakované textury.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Images, PictureFillMode, Presentation, RectangleAlignment, SaveFormat, ShapeType, TileFlip
presentation = Presentation()
try:
first_slide = presentation.getSlides().get_Item(0)
shape = first_slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 190, 95)
shape.getFillFormat().setFillType(FillType.Picture)
source_image = Images.fromFile("lotus.png")
try:
presentation_image = presentation.getImages().addImage(source_image)
finally:
source_image.dispose()
picture_fill_format = shape.getFillFormat().getPictureFillFormat()
picture_fill_format.getPicture().setImage(presentation_image)
picture_fill_format.setPictureFillMode(PictureFillMode.Tile)
picture_fill_format.setTileOffsetX(-32)
picture_fill_format.setTileOffsetY(-32)
picture_fill_format.setTileScaleX(50)
picture_fill_format.setTileScaleY(50)
picture_fill_format.setTileAlignment(RectangleAlignment.BottomRight)
picture_fill_format.setTileFlip(TileFlip.FlipBoth)
presentation.save("tile.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek:

Solid Color Fill
Plná výplň dává tvaru jedinou, jednotnou barvu. Tento příklad používá FillFormat.setFillType k nastavení režimu plné výplně a přiřadí žlutou barvu pomocí FillFormat.getSolidFillColor, pak uloží obdélník do prezentace.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
shape.getFillFormat().setFillType(FillType.Solid)
shape.getFillFormat().getSolidFillColor().setColor(Color.YELLOW)
presentation.save("solid_color_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek:

Copy Colors While Preserving Theme References
Použijte ColorFormat.copyFrom k zkopírování definice barvy, včetně typu barvy, odkazu na téma a transformací. Toto je užitečné při přenosu barvy výplně mezi tvary, které by měly nadále sledovat téma prezentace. Metoda kopíruje jen barvu: nekopíruje typ výplně, obrys ani jiné formátování tvaru. Nastavte cílový typ výplně explicitně pomocí FillFormat.setFillType.
Tento příklad vytvoří tři obdélníky, z leva doprava: zdroj, kopii citlivou na téma a pevnou RGB kopii. Zdroj používá ColorFormat.setSchemeColor k odkazu na první akcentní barvu a přidává odstín pomocí ColorOperationCollection.add. RGB kopie používá efektivní barvu výplně zdroje, takže všechny tři vypadají identicky. Volání ColorFormat.setColor nastaví pevnou RGB hodnotu a vymaže jakékoli existující transformace barvy.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import ColorTransformOperation, FillType, ImageFormat, Presentation, SaveFormat, SchemeColor, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(660, 220, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
accent_color = Color(65, 105, 225)
presentation.getMasterTheme().getColorScheme().getAccent1().setColor(accent_color)
source = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 40, 180, 140)
theme_copy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 240, 40, 180, 140)
rgb_copy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 450, 40, 180, 140)
for shape in (source, theme_copy, rgb_copy):
shape.getFillFormat().setFillType(FillType.Solid)
shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
source_color = source.getFillFormat().getSolidFillColor()
source_color.setSchemeColor(SchemeColor.Accent1)
source_color.getColorTransform().add(ColorTransformOperation.Tint, 0.75)
theme_copy.getFillFormat().getSolidFillColor().copyFrom(source_color)
rgb_copy.getFillFormat().getSolidFillColor().setColor(source.getFillFormat().getEffective().getSolidFillColor())
before = slide.getImage(1.0, 1.0)
try:
before.save("color-copy-before.png", ImageFormat.Png)
finally:
before.dispose()
# Odkazy na téma následují novou akcentní barvu; pevná hodnota RGB ne.
accent_color = Color(255, 69, 0)
presentation.getMasterTheme().getColorScheme().getAccent1().setColor(accent_color)
after = slide.getImage(1.0, 1.0)
try:
after.save("color-copy-after.png", ImageFormat.Png)
finally:
after.dispose()
presentation.save("copied_colors.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Před změnou tématu všechny tři výplně odpovídají:

Po změně tématu zdroj a kopie citlivá na téma sledují novou akcentní barvu a zachovávají odstín. Pevná RGB kopie zůstává modrá:

Zkopírovaná definice je nezávislá na zdroji. Následná změna odkazu na téma u zdroje, přiřazení jiné barvy nebo přidání/odebrání transformací nemění cíl. Změna tématu stále ovlivní oba tvary, protože každý samostatně odkazuje na stejnou barvu tématu.
Uložení a opětovné otevření PPTX zachová typ zkopírované barvy vrácený metodou ColorFormat.getColorType, odkaz na téma a kolekci transformací vrácenou metodou ColorFormat.getColorTransform; nedojde k zploštění definice na RGB.
Při kopírování mezi různými kontexty témat, například mezi prezentacemi s rozdílnými akcentními paletami, se zkopírovaný odkaz vyhodnocuje vůči tématu cíle. Stejný odkaz a transformace tak mohou vést k odlišné viditelné barvě. Viz Presentation Theme pro více informací o konfiguraci barev tématu.
Use the Slide Background as a Shape Fill
Použijte AutoShape.setUseBackgroundFill, když má tvar odpovídat pozadí snímku, například v šabloně prezentace. Nastavte typ výplně pomocí FillFormat.setFillType na FillType.NotDefined nejprve, abyste odstranili explicitní výplň. S tímto spojením tvar použije pozadí snímku místo své vlastní výplně. Pouze zapnutí příznaku neodstraní existující explicitní výplň.
To se liší od FillType.NoFill: výplň pozadím zakrývá objekty za tvarem odpovídající oblastí pozadí snímku, zatímco žádná výplň ponechává tyto objekty viditelné. Gradient zůstává zarovnán k snímku místo opětovného zahájení uvnitř každého tvaru.
Následující příklad vytvoří hlavní pozadí zděděné snímkem a umístí fialový pás za tři obdélníky. Levý obdélník používá pozadí, prostřední nemá výplň a pravý přepíná z výplně pozadím na explicitní oranžovou výplň.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, GradientShape, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color
presentation = Presentation()
try:
presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
# Zdědit gradient z hlavního snímku.
slide.getBackground().setType(BackgroundType.NotDefined)
slide.getLayoutSlide().getBackground().setType(BackgroundType.NotDefined)
background = slide.getLayoutSlide().getMasterSlide().getBackground()
background.setType(BackgroundType.OwnBackground)
background.getFillFormat().setFillType(FillType.Gradient)
gradient = background.getFillFormat().getGradientFormat()
gradient.setGradientShape(GradientShape.Linear)
gradient.setLinearGradientAngle(0)
gradient.getGradientStops().clear()
color = Color(0, 0, 139)
gradient.getGradientStops().add(0, color)
color = Color(135, 206, 250)
gradient.getGradientStops().add(1, color)
# Přidat tento objekt jako první, aby byl za obdélníky.
band = slide.getShapes().addAutoShape(ShapeType.Rectangle, 25, 150, 670, 100)
band.getFillFormat().setFillType(FillType.Solid)
band.getFillFormat().getSolidFillColor().setColor(Color.MAGENTA)
band.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
background_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 100, 160, 200)
background_shape.getFillFormat().setFillType(FillType.NotDefined)
background_shape.setUseBackgroundFill(True)
no_fill_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 280, 100, 160, 200)
no_fill_shape.getFillFormat().setFillType(FillType.NoFill)
explicit_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 510, 100, 160, 200)
explicit_shape.getFillFormat().setFillType(FillType.NotDefined)
explicit_shape.setUseBackgroundFill(True)
# Zakázat výplň pozadí před použitím explicitní výplně.
explicit_shape.setUseBackgroundFill(False)
explicit_shape.getFillFormat().setFillType(FillType.Solid)
color = Color(255, 165, 0)
explicit_shape.getFillFormat().getSolidFillColor().setColor(color)
presentation.save("background_fill.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek, z leva doprava: výplň pozadím, žádná výplň a explicitní výplň. Fialový pás je skrytý levým a pravým obdélníkem, ale zůstává viditelný skrz prostřední obdélník.

Stejné chování platí pro pozadí definované přímo na snímku nebo zděděné z rozložení. Tvar používá rozpoznané pozadí snímku; příklad ponechává pozadí snímku i rozložení nedefinována, takže jej dodává hlavní šablona.
Set Transparency
U plné výplně komponenta alfa barvy řídí neprůhlednost: 0 je zcela průhledná a 255 zcela neprůhledná. Tento příklad používá alfa hodnotu 128 pro žlutý obdélník, což jej činí přibližně 50 % průhledným, takže pod ním viditelný obdélník zůstává zřetelný. Barva je přiřazena přes FillFormat.getSolidFillColor.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
solid_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
transparent_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 80, 80, 150, 75)
transparent_shape.getFillFormat().setFillType(FillType.Solid)
color = Color(255, 255, 0, 128)
transparent_shape.getFillFormat().getSolidFillColor().setColor(color)
presentation.save("shape_transparency.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek:

Rotate Shapes
Použijte Shape.setRotation k otočení tvaru v rovině snímku. Úhel se měří ve stupních; tento příklad otočí obdélník o 5 stupňů po směru hodinových ručiček a uloží prezentaci.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
shape.setRotation(5)
presentation.save("shape_rotation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek:

Add 3D Bevel Effects
Použijte Shape.getThreeDFormat k přidání hloubky a zkosených hran tvaru. Tento příklad vytvoří zelenou elipsu s oranžovým obrysem, použije ThreeDFormat.setDepth k nastavení hloubky na 4 body a aplikuje kulatý horní zkosení s šířkou a výškou 6 bodů přes ThreeDFormat.getBevelTop. Přední ortografická kamera a tříbodové osvětlení umožňují viditelnost zkosení.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BevelPresetType, CameraPresetType, FillType, LightRigPresetType, LightingDirection, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 50, 50, 100, 100)
shape.getFillFormat().setFillType(FillType.Solid)
color = Color(0, 128, 0)
shape.getFillFormat().getSolidFillColor().setColor(color)
shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
color = Color(255, 165, 0)
shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
shape.getLineFormat().setWidth(2.0)
shape.getThreeDFormat().setDepth(4)
shape.getThreeDFormat().getBevelTop().setBevelType(BevelPresetType.Circle)
shape.getThreeDFormat().getBevelTop().setHeight(6)
shape.getThreeDFormat().getBevelTop().setWidth(6)
shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront)
shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.ThreePt)
shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top)
presentation.save("3D_bevel_effect.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek:

Add 3D Rotation Effects
3D pohled tvaru je řízen nastavením kamery. Tento příklad používá Camera.setRotation s úhly šířky (latitude), délky (longitude) a otáčení (revolution) 40, 35 a 20 stupňů. Vybere izometrickou kameru přes Camera.setCameraType a vyvážené osvětlení přes LightRig.setLightType, pak uloží formátovaný obdélník.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import CameraPresetType, LightRigPresetType, Presentation, SaveFormat, ShapeType
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
auto_shape.getTextFrame().setText("Hello, Aspose!")
auto_shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.IsometricLeftUp)
auto_shape.getThreeDFormat().getCamera().setRotation(40, 35, 20)
auto_shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Balanced)
presentation.save("3D_rotation_effect.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Výsledek:

Control Black-and-White Rendering for Shapes
Metoda Shape.setBlackWhiteMode určuje, jak je jednotlivý tvar vykreslen při zobrazení či zpracování prezentace v černobílém režimu. Nepovoluje černobílý režim sama o sobě a nemění výplň, obrys ani jiné formátování tvaru v normálním barevném režimu.
Použijte hodnotu ze třídy BlackWhiteMode pro výběr požadovaného chování. Například Automatic nechává aplikaci zvolit konverzi, Gray a LightGray používají odstíny šedi, BlackWhite používá jen černou a bílou, Black a White vynutí jedinou barvu, Color zachovává normální barvy a Hidden vynechává tvar v černobílém režimu. NotDefined znamená, že není přiřazen žádný režim na úrovni tvaru.
Tento příklad vytvoří oranžový obdélník a použije Shape.setBlackWhiteMode pro nastavení režimu na šedou. Uložený tvar si zachová oranžovou výplň pro normální barevné zobrazení a požaduje šedé zabarvení od aplikací, které respektují nastavení černobílého režimu:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BlackWhiteMode, FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100)
shape.getFillFormat().setFillType(FillType.Solid)
color = Color(255, 165, 0)
shape.getFillFormat().getSolidFillColor().setColor(color)
shape.setBlackWhiteMode(BlackWhiteMode.Gray)
presentation.save("shape_black_white_mode.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
V normálním barevném režimu si obdélník zachová oranžovou výplň. V pracovním postupu černobílého zobrazení používá šedé zabarvení, protože jeho režim je nastaven na Gray. To vám umožní zachovat plnobarevný snímek a zároveň definovat odlišný vzhled pro tisk, náhled nebo jiné workflowy, které respektují nastavení černobílého zobrazení prezentace.
Reset Formatting
Použijte Slide.reset k obnovení polohy, velikosti a formátování zástupných objektů snímku z jejich odpovídajících zástupných objektů rozložení. Tento příklad vyžaduje existující prezentaci s rozloženími propojenými se zástupnými objekty a před uložením resetuje každý snímek. Tvary bez odpovídajících zástupných objektů rozložení nejsou resetovány.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("sample.pptx")
try:
for slide in presentation.getSlides():
slide.reset()
presentation.save("reset_formatting.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
FAQ
Ovplyvňuje formátování tvaru konečnou velikost souboru prezentace?
Barvy, styly čar a nastavení efektů obecně přidávají jen málo dat ve srovnání s vloženými obrázky a multimédii. Obrázkové výplně mohou velikost souboru zvětšit, protože jejich obrázky jsou uloženy v prezentaci.
Jak mohu zjistit tvary na snímku, které mají identické formátování, abych je mohl seskupit?
Porovnejte klíčové vlastnosti formátování každého tvaru – výplň, čáru a nastavení efektů. Pokud se všechny odpovídající hodnoty shodují, považujte jejich styly za identické a logicky je seskupte; to později usnadní správu stylů.
Mohu uložit sadu vlastních stylů tvarů do samostatného souboru pro opětovné použití v jiných prezentacích?
Ano. Uložte ukázkové tvary s požadovanými styly do šablony snímků nebo souboru .POTX. Při vytváření nové prezentace otevřete šablonu, klonujte potřebné stylované tvary a znovu použijte jejich formátování tam, kde je potřeba.