Spravovat přechody snímků v prezentacích pomocí Pythonu přes Java
Přehled
Přechody snímků kontrolují, jak se snímky zobrazují během prezentace. S Aspose.Slides pro Python přes Java můžete pro každý snímek vybrat efekt přechodu, nastavit postup pomocí kliknutí myší nebo časovače a upravit možnosti specifické pro daný efekt. Tento článek používá příklady v Pythonu k aplikaci přechodů, nastavení přesných délek přechodů, správě časování snímků a vytvoření Morph přechodu mezi dvěma snímky. Příklady také ukazují, jak uložit nastavení do souboru PPTX.
Přidání přechodu snímku
Pro aplikaci přechodu načtěte prezentaci pomocí třídy Presentation a přistupte k nastavení přechodu snímku pomocí getSlideShowTransition. Použijte setType s hodnotou z výčtu TransitionType, poté prezentaci uložte. Následující příklad použije přechod Circle na první snímek a přechod Comb na druhý. Použijte soubor input.pptx s minimálně dvěma snímky.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TransitionType
presentation = Presentation("input.pptx")
try:
if presentation.getSlides().size() >= 2:
presentation.getSlides().get_Item(0).getSlideShowTransition().setType(TransitionType.Circle)
presentation.getSlides().get_Item(1).getSlideShowTransition().setType(TransitionType.Comb)
presentation.save("slide-transitions.pptx", SaveFormat.Pptx)
else:
print("The input presentation must contain at least two slides.")
finally:
presentation.dispose()
Kolečkový přechod
Použijte setType k výběru Wheel z TransitionType. Poté zavolejte getValue a přistupte k nastavením WheelTransition. Jeho metoda setSpokes určuje, kolik radiálních sektorů odhalí cílový snímek. Příklad vytvoří dva identické páry snímků. Každý pár začíná černým snímkem a končí zlatým obdélníkem přes celý snímek. Oba cílové snímky používají stejnou pomalou rychlost nastavenou pomocí setSpeed a stejnou explicitní dobu trvání 8 000 ms nastavenou pomocí setDuration. Pouze počet paprsků (spokes) se mění.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat, ShapeType, TransitionSpeed, TransitionType
Color = jpype.JClass("java.awt.Color")
presentation = Presentation()
try:
width = jpype.JFloat(presentation.getSlideSize().getSize().getWidth())
height = jpype.JFloat(presentation.getSlideSize().getSize().getHeight())
slides = presentation.getSlides()
black_slide = slides.get_Item(0)
black_slide.getShapes().clear()
background = black_slide.getBackground()
background.setType(BackgroundType.OwnBackground)
background.getFillFormat().setFillType(FillType.Solid)
background.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
destination_slide = slides.addClone(black_slide)
rectangle = destination_slide.getShapes().addAutoShape(ShapeType.Rectangle, 0, 0, width, height)
rectangle.getFillFormat().setFillType(FillType.Solid)
rectangle.getFillFormat().getSolidFillColor().setColor(Color(255, 215, 0))
rectangle.getTextFrame().setText("Wheel transition")
slides.addClone(black_slide)
slides.addClone(destination_slide)
for slide_index, spokes in ((1, 1), (3, 8)):
transition = slides.get_Item(slide_index).getSlideShowTransition()
transition.setType(TransitionType.Wheel)
wheel_transition = transition.getValue()
wheel_transition.setSpokes(spokes)
transition.setSpeed(TransitionSpeed.Slow)
transition.setDuration(8000)
presentation.save("wheel-transitions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Otevřete wheel-transitions.pptx v PowerPointu a spusťte prezentaci. Postupujte ze snímku 1 na snímek 2 a uvidíte, jak jeden pootočený tah odhalí zlatý obdélník. Pak postupujte ze snímku 3 na snímek 4 a uvidíte, jak osm radiálních sektorů odhalí stejný obdélník současně.
Přidání pokročilého přechodu snímku
Můžete nastavit, jak dlouho snímek zůstává na obrazovce a zda kliknutí myší posune prezentaci dál. Následující metody řídí toto chování:
- setAdvanceOnClick umožňuje divákovi posunout prezentaci kliknutím myši.
- setAdvanceAfter povoluje automatický posun.
- setAdvanceAfterTime určuje prodlevu před automatickým posunem v milisekundách.
Povolte jak kliknutí, tak časovaný posun, aby mohl divák pokračovat kliknutím nebo čekáním na časovač. Pro použití pouze časovače předávejte False metodě setAdvanceOnClick. Prodleva řídí, kdy se prezentace posune; nenastavuje délku vizuálního efektu přechodu. Tento příklad přiřadí různé efekty prvním třem snímkům a povolí automatický posun po 3, 5 a 7 sekundách. Kliknutí myší může také posunout tyto snímky. Použijte soubor input.pptx s minimálně třemi snímky.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TransitionType
presentation = Presentation("input.pptx")
try:
if presentation.getSlides().size() >= 3:
first_transition = presentation.getSlides().get_Item(0).getSlideShowTransition()
first_transition.setType(TransitionType.Circle)
first_transition.setAdvanceOnClick(True)
first_transition.setAdvanceAfter(True)
first_transition.setAdvanceAfterTime(3000)
second_transition = presentation.getSlides().get_Item(1).getSlideShowTransition()
second_transition.setType(TransitionType.Comb)
second_transition.setAdvanceOnClick(True)
second_transition.setAdvanceAfter(True)
second_transition.setAdvanceAfterTime(5000)
third_transition = presentation.getSlides().get_Item(2).getSlideShowTransition()
third_transition.setType(TransitionType.Zoom)
third_transition.setAdvanceOnClick(True)
third_transition.setAdvanceAfter(True)
third_transition.setAdvanceAfterTime(7000)
presentation.save("advanced-transitions.pptx", SaveFormat.Pptx)
else:
print("The input presentation must contain at least three slides.")
finally:
presentation.dispose()
Pro kontrolu, zda je časovaný posun povolen, zavolejte getAdvanceAfter. Uložená prodleva samotná neznamená, že je časovač aktivní. Další příklad otevře výše uložený soubor, nahlásí každý povolený časovač a zakáže automatický posun pro snímky s prodlevou delší než dvě sekundy. Pro tyto snímky povolí kliknutí myší a uloží aktualizovaná nastavení.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation("advanced-transitions.pptx")
try:
for slide in presentation.getSlides():
transition = slide.getSlideShowTransition()
if transition.getAdvanceAfter():
print(f"Slide {slide.getSlideNumber()}: advance after {transition.getAdvanceAfterTime()} ms.")
if transition.getAdvanceAfterTime() > 2000:
transition.setAdvanceAfter(False)
transition.setAdvanceOnClick(True)
presentation.save("adjusted-transitions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Přesné řízení načasování přechodu
Použijte setDuration k určení přesné délky efektu přechodu v milisekundách. Metoda snímku getSlideShowTransition zpřístupní tato nastavení přes SlideShowTransition:
| Metoda | Účel |
|---|---|
| setDuration | Nastaví délku samotného efektu přechodu v milisekundách. |
| setAdvanceAfterTime | Nastaví prodlevu před automatickým posunem snímku v milisekundách. Pro aktivaci časovače předávejte True metodě setAdvanceAfter. |
| setSpeed | Vybere předdefinovanou kategorii rychlosti z TransitionSpeed: Slow, Medium nebo Fast. Používá se, když není zadána přesná doba trvání. |
setDuration řídí pouze efekt přechodu; neurčuje, jak dlouho snímek zůstává viditelný. Automatickou prodlevu posunu nastavte samostatně. Pokud není zadána explicitní doba, Aspose.Slides určuje délku efektu podle typu přechodu a hodnoty getSpeed.
Sdílený příklad dává každému snímku přechod Fade 750 ms a samostatně povoluje automatický posun po 5 000 ms. Délka přechodu řídí efekt; posun řídí, kdy snímek opustit. Tyto pruhy jsou schematické nastavení, nikoli měřená kombinovaná časová osa.
Použít stejnou dobu trvání na všechny snímky
Pro konzistentní tempo aplikujte stejný efekt a přesnou dobu trvání na všechny snímky. Tento příklad načte input.pptx, vybere Fade z TransitionType, a každému přechodu přiřadí dobu trvání 750 ms. Samostatně povolí automatický posun po 5 000 ms a zakáže posun kliknutím myši, poté výsledek uloží jako PPTX.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TransitionType
presentation = Presentation("input.pptx")
try:
for slide in presentation.getSlides():
transition = slide.getSlideShowTransition()
transition.setType(TransitionType.Fade)
transition.setDuration(750)
# Nastavte automatické posouvání nezávisle na délce efektu.
transition.setAdvanceAfter(True)
transition.setAdvanceAfterTime(5000)
transition.setAdvanceOnClick(False)
presentation.save("precise-transitions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Nastavit různé doby trvání pro jednotlivé snímky
Různé snímky mohou používat různé doby trvání efektů. Například použijte krátký přechod pro úvodní snímek a delší přechod pro úvod sekce. Tento příklad nastaví 500 ms pro první snímek a 1 200 ms pro druhý. Použijte soubor input.pptx s minimálně dvěma snímky.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TransitionType
presentation = Presentation("input.pptx")
try:
if presentation.getSlides().size() >= 2:
first_transition = presentation.getSlides().get_Item(0).getSlideShowTransition()
first_transition.setType(TransitionType.Fade)
first_transition.setDuration(500)
second_transition = presentation.getSlides().get_Item(1).getSlideShowTransition()
second_transition.setType(TransitionType.Push)
second_transition.setDuration(1200)
presentation.save("individual-transition-durations.pptx", SaveFormat.Pptx)
else:
print("The input presentation must contain at least two slides.")
finally:
presentation.dispose()
Koordinace přechodů s animovaným výstupem
Při přípravě animated GIF, HTML5 presentation nebo video nastavte přesné doby trvání přechodů před exportem, aby odpovídaly zamýšlenému tempu. Například použijte 600 ms rozmazání (fade) mezi scénami a samostatně upravte prodlevu posunu každého snímku, aby byl dostatek času na jeho komentář nebo obsah.
Pro GIF a video koordinujte výstupní snímkovou frekvenci s délkou efektu: 600 ms odpovídá 18 snímkům při 30 fps. V HTML5 povolte animované přechody v nastavení exportu. Zkontrolujte, které efekty a časové možnosti podporuje vybraný formát exportu, a prohlédněte výstup, abyste potvrdili synchronizaci.
Načtení existující doby trvání přechodu
Zavolejte getDuration před úpravou přechodu, abyste zjistili, zda je uložena explicitní hodnota. Hodnota -1 znamená, že není nastavená explicitní doba; nezáporná hodnota určuje uloženou dobu v milisekundách. Nenastavená hodnota není vypočtená doba přehrávání: Aspose.Slides používá typ přechodu a hodnotu getSpeed k určení této doby. Nastavení typu přechodu může iniciovat dobu, proto nejprve prozkoumejte původní nastavení.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation
presentation = Presentation("input.pptx")
try:
for slide in presentation.getSlides():
transition = slide.getSlideShowTransition()
duration = transition.getDuration()
if duration >= 0:
print(f"Slide {slide.getSlideNumber()}: stored transition duration is {duration} ms.")
else:
print(f"Slide {slide.getSlideNumber()}: no explicit duration; timing depends on transition type {transition.getType()} and speed {transition.getSpeed()}.")
finally:
presentation.dispose()
Morph přechod
Morph přechod animuje změny mezi objekty na po sobě jdoucích snímcích. Pro vytvoření jednoduchého efektu Morph duplikujte snímek, přesuňte nebo změňte velikost objektu na duplikátu a na druhý snímek aplikujte Morph přechod. Tento přechod pak poskytne odpovídající objekty k animaci mezi jejich původním a upraveným stavem.
Následující příklad vytvoří snímek s textovým obdélníkem, duplikuje snímek a změní pozici a velikost obdélníku na duplikátu. Poté pro druhý snímek vybere Morph z výčtu TransitionType. Otevřete uložený soubor v prohlížeči prezentací, který podporuje Morph, abyste viděli efekt během prezentace.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TransitionType, ShapeType
presentation = Presentation()
try:
first_slide = presentation.getSlides().get_Item(0)
rectangle = first_slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 100)
rectangle.getTextFrame().setText("Morph transition")
second_slide = presentation.getSlides().addClone(first_slide)
moved_rectangle = second_slide.getShapes().get_Item(0)
moved_rectangle.setX(moved_rectangle.getX() + 100)
moved_rectangle.setY(moved_rectangle.getY() + 50)
moved_rectangle.setWidth(moved_rectangle.getWidth() - 200)
moved_rectangle.setHeight(moved_rectangle.getHeight() - 10)
second_slide.getSlideShowTransition().setType(TransitionType.Morph)
presentation.save("morph-transition.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Typy Morph přechodu
Výčtová hodnota TransitionMorphType řídí, jak Morph odpovídá a animuje obsah:
- ByObject zachází s každým tvarem jako s celým objektem.
- ByWord animuje text tím, že pokud možno odpovídá slovům.
- ByChar animuje text tím, že pokud možno odpovídá znakům.
Použijte setType k výběru Morph před přístupem k getValue. Výsledek je pak instance třídy MorphTransition, jejíž metoda setMorphType vybere režim odpovídání.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TransitionType, TransitionMorphType, MorphTransition
presentation = Presentation("morph-transition.pptx")
try:
if presentation.getSlides().size() >= 2:
transition = presentation.getSlides().get_Item(1).getSlideShowTransition()
transition.setType(TransitionType.Morph)
transition_value = transition.getValue()
if isinstance(transition_value, MorphTransition):
morph_transition = transition_value
morph_transition.setMorphType(TransitionMorphType.ByWord)
presentation.save("morph-by-word.pptx", SaveFormat.Pptx)
else:
print("Morph transition options are unavailable.")
else:
print("The input presentation must contain at least two slides.")
finally:
presentation.dispose()
Nastavení efektů přechodu
Některé přechody odhalují další možnosti, například směr nebo zda efekt začíná z černé obrazovky. Dostupné možnosti závisí na přechodu vybraném pomocí setType. Nejprve nastavte typ, poté použijte odpovídající třídu z getValue.
Následující příklad použije přechod Cut na první snímek input.pptx. Zavolá setFromBlack přes OptionalBlackTransition, aby přechod začínal z černé obrazovky.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, TransitionType, OptionalBlackTransition
presentation = Presentation("input.pptx")
try:
transition = presentation.getSlides().get_Item(0).getSlideShowTransition()
transition.setType(TransitionType.Cut)
transition_value = transition.getValue()
if isinstance(transition_value, OptionalBlackTransition):
cut_transition = transition_value
cut_transition.setFromBlack(True)
presentation.save("cut-from-black.pptx", SaveFormat.Pptx)
else:
print("Cut transition options are unavailable.")
finally:
presentation.dispose()
Často kladené dotazy
Mohu řídit rychlost přehrávání přechodu snímku?
Ano. Upřednostněte setDuration, pokud potřebujete přesnou dobu trvání efektu v milisekundách. Použijte setSpeed, když je dostačující předdefinovaná kategorie TransitionSpeed — Slow, Medium nebo Fast — a není nastavená explicitní doba. Tato nastavení řídí efekt přechodu nezávisle na prodlevě automatického posunu.
Mohu k přechodu přiřadit zvuk a nechat jej smyčkovat?
Ano. Přiřaďte vložený zvuk metodou setSound, předávejte StartSound z výčtu TransitionSoundMode metodě setSoundMode a povolte setSoundLoop s True. Zvuk se smyčkuje, dokud nenastane další zvuková událost v prezentaci.
Jaký je nejrychlejší způsob, jak použít stejný přechod na všechny snímky?
Projděte kolekci getSlides prezentace a zavolejte setType se stejnou hodnotou pro přechod každého snímku. V téže smyčce nastavte všechny časové a efektové možnosti, aby chování bylo konzistentní napříč snímky.
Jak mohu zjistit, který přechod je aktuálně nastaven na snímku?
Zavolejte getType na výsledek getSlideShowTransition snímku. Vrátí hodnotu z výčtu TransitionType; None_ znamená, že není aplikován žádný efekt přechodu.