Beheer diaovergangen in presentaties met Python via Java
Overzicht
Diaovergangen bepalen hoe dia’s verschijnen tijdens een diavoorstelling. Met Aspose.Slides voor Python via Java kun je voor elke dia een overgangseffect kiezen, de voortgang via muisklik of timer configureren, en opties die specifiek zijn voor een effect aanpassen. Dit artikel gebruikt Python‑voorbeelden om overgangen toe te passen, exacte overgangsduren in te stellen, de timing van dia’s te beheren en een Morph‑overgang tussen twee dia’s te maken. De voorbeelden laten ook zien hoe de instellingen opgeslagen kunnen worden in een PPTX‑bestand.
Diaovergang toevoegen
Om een overgang toe te passen, laad je een presentatie met de Presentation klasse en krijg je toegang tot de overgangsinstellingen van de dia via getSlideShowTransition. Gebruik setType met een waarde uit de TransitionType enumeratie, en sla daarna de presentatie op.
Het volgende voorbeeld past een Circle‑overgang toe op de eerste dia en een Comb‑overgang op de tweede. Gebruik een input.pptx‑bestand met ten minste twee dia’s.
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()
Wielovergang
Gebruik setType om Wheel te selecteren uit TransitionType. Roep daarna getValue aan om de instellingen van WheelTransition te benaderen. De methode setSpokes bepaalt hoeveel radiale sectoren de doeldia onthullen.
Het voorbeeld maakt twee identieke paren dia’s. Elk paar begint met een zwarte dia en eindigt met een gouden rechthoek die de volledige dia beslaat. Beide doeldia’s gebruiken dezelfde langzame snelheid ingesteld met setSpeed en dezelfde expliciete duur van 8,000 milliseconden ingesteld met setDuration. Alleen het aantal spaken verandert.
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()
Open wheel-transitions.pptx in PowerPoint en start de diavoorstelling. Ga van dia 1 naar dia 2 om een enkele, met de klok mee, beweging te zien die de gouden rechthoek onthult. Ga vervolgens van dia 3 naar dia 4 om acht radiale sectoren tegelijk dezelfde rechthoek te laten onthullen.
Geavanceerde diaovergang toevoegen
Je kunt configureren hoe lang een dia op het scherm blijft en of een muisklik de diavoorstelling voortzet. De volgende methoden regelen dit gedrag:
- setAdvanceOnClick staat de kijker toe om door te gaan door op de muis te klikken.
- setAdvanceAfter schakelt automatische voortgang in.
- setAdvanceAfterTime geeft de vertraging vóór automatische voortgang op, in milliseconden.
Schakel zowel klik‑ als timer‑voortgang in zodat de kijker kan doorgaan met een klik of kan wachten op de timer. Om alleen de timer te gebruiken, geef je False door aan setAdvanceOnClick. De vertraging bepaalt wanneer de diavoorstelling voortgaat; hij stelt de duur van het visuele overgangseffect niet in.
Dit voorbeeld kent verschillende effecten toe aan de eerste drie dia’s en schakelt automatische voortgang in na respectievelijk 3, 5 en 7 seconden. Muisklikken kunnen deze dia’s ook voortzetten. Gebruik een input.pptx‑bestand met ten minste drie dia’s.
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()
Om te controleren of timer‑voortgang is ingeschakeld, roep je getAdvanceAfter aan. Een opgeslagen vertraging alleen geeft niet aan dat de timer actief is.
Het volgende voorbeeld opent het hierboven opgeslagen bestand, meldt elke ingeschakelde timer, en schakelt automatische voortgang uit voor dia’s met een vertraging van meer dan twee seconden. Het schakelt muisklikken in voor die dia’s en slaat de bijgewerkte instellingen op.
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()
Overgangstiming nauwkeurig regelen
Gebruik setDuration om de exacte lengte van een overgangseffect in milliseconden op te geven. De getSlideShowTransition‑methode van de dia maakt deze instellingen bloot via SlideShowTransition:
| Method | Purpose |
|---|---|
| setDuration | Stelt de duur van het overgangseffect zelf in, in milliseconden. |
| setAdvanceAfterTime | Stelt de vertraging in voordat de dia automatisch wordt voortgezet, in milliseconden. Geef True door aan setAdvanceAfter om deze timer te activeren. |
| setSpeed | Selecteert een vooraf gedefinieerde snelheidscategorie uit TransitionSpeed: Slow, Medium of Fast. Wordt gebruikt wanneer geen exacte duur is opgegeven. |
setDuration regelt alleen het overgangseffect; hij bepaalt niet hoe lang de dia zichtbaar blijft. Configureer de automatische voortgangsvertraging apart. Wanneer geen expliciete duur is ingesteld, bepaalt Aspose.Slides de effectduur aan de hand van het overgangstype en de getSpeed‑waarde.
Het gedeelde voorbeeld geeft elke dia een 750‑ms Fade‑overgang en schakelt afzonderlijk automatische voortgang in op 5.000 ms. De overgangsduur regelt het effect; voortgang regelt wanneer de dia verlaten wordt. Deze balken zijn schematische instellingen, geen gemeten gecombineerde tijdlijn.
Dezelfde duur toepassen op elke dia
Voor een consistente tempo, pas je hetzelfde effect en dezelfde exacte duur toe op elke dia. Dit voorbeeld laadt input.pptx, selecteert Fade uit TransitionType, en geeft elke overgang een duur van 750 milliseconden. Het schakelt afzonderlijk automatische voortgang in na 5.000 milliseconden en schakelt voortgang via muisklik uit, waarna het resultaat als PPTX wordt opgeslagen.
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)
# Stelt automatische voortgang in, onafhankelijk van de effectduur.
transition.setAdvanceAfter(True)
transition.setAdvanceAfterTime(5000)
transition.setAdvanceOnClick(False)
presentation.save("precise-transitions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Verschillende duurwaarden instellen voor individuele dia’s
Verschillende dia’s kunnen verschillende effectduur gebruiken. Gebruik bijvoorbeeld een korte overgang voor een titel‑dia en een langere overgang voor een sectie‑introductie. Dit voorbeeld stelt 500 milliseconden in voor de eerste dia en 1.200 milliseconden voor de tweede. Gebruik een input.pptx‑bestand met ten minste twee dia’s.
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()
Overgangen coördineren met geanimeerde output
Bij het voorbereiden van een animated GIF, een HTML5 presentation of een video, stel je exacte overgangsduren in vóór het exporteren om het beoogde tempo te behalen. Gebruik bijvoorbeeld een fade van 600 milliseconden tussen scènes, en pas elke dia‑voortgangsvertraging afzonderlijk aan om tijd te geven voor de bijbehorende vertelling of inhoud.
Voor GIF en video, stem je de uitvoer‑frame‑rate af op de effectduur: 600 milliseconden komt overeen met 18 frames bij 30 frames per seconde. In HTML5 schakel je geanimeerde overgangen in via de exportinstellingen. Controleer de ondersteunde effecten en timing‑opties van het gekozen exportformaat, en bekijk een voorbeeld van de output om de synchronisatie te bevestigen.
Bestaande overgangsduur lezen
Roep getDuration aan vóór het wijzigen van de overgang om te bepalen of er een expliciete waarde is opgeslagen. Een waarde van -1 betekent dat er geen expliciete duur is ingesteld; een niet‑negatieve waarde geeft de opgeslagen duur in milliseconden aan. De niet‑ingestelde waarde is niet de berekende afspeelduur: Aspose.Slides gebruikt het overgangstype en de getSpeed‑waarde om die duur te bepalen. Het instellen van een overgangstype kan een duur initialiseren, dus inspecteer eerst de oorspronkelijke instellingen.
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‑overgang
De Morph‑overgang animeert wijzigingen tussen objecten op opeenvolgende dia’s. Om een eenvoudige Morph‑effect te maken, kloon je een dia, verplaats of wijzig je de grootte van een object op de kloon, en pas je de Morph‑overgang toe op de tweede dia. Hierdoor krijgt de overgang de bijbehorende objecten om te animeren tussen hun oorspronkelijke en aangepaste staat.
Het volgende voorbeeld maakt een dia met een tekstrechthoek, kloont de dia, en verandert de positie en grootte van de rechthoek op de kloon. Vervolgens selecteert het Morph uit de TransitionType‑enumeratie voor de tweede dia. Open het opgeslagen bestand in een presentatieweergave die Morph ondersteunt om het effect tijdens een diavoorstelling te zien.
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()
Morph‑overgangstypen
De TransitionMorphType‑enumeratie bepaalt hoe Morph inhoud overeenkomstig matcht en animeert:
- ByObject behandelt elke vorm als één geheel.
- ByWord animeert tekst door woorden, waar mogelijk, te matchen.
- ByChar animeert tekst door tekens, waar mogelijk, te matchen.
Gebruik setType om Morph te selecteren vóór het benaderen van getValue. De waarde is dan een instantie van de MorphTransition‑klasse, waarvan de setMorphType‑methode de overeenkomstige modus selecteert.
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()
Overgangseffecten instellen
Sommige overgangen bieden extra opties, zoals richting of of het effect start vanaf een zwart scherm. De beschikbare opties hangen af van de overgang die met setType is geselecteerd. Stel eerst het type in, en gebruik vervolgens de passende klasse via getValue.
Het volgende voorbeeld past een Cut‑overgang toe op de eerste dia van input.pptx. Het roept setFromBlack aan via OptionalBlackTransition zodat de overgang start vanaf een zwart scherm.
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()
FAQ
Kan ik de afspeelsnelheid van een diaovergang regelen?
Ja. Geef de voorkeur aan setDuration wanneer je een exacte effectduur in milliseconden nodig hebt. Gebruik setSpeed wanneer een vooraf gedefinieerde TransitionSpeed‑categorie — Slow, Medium of Fast — voldoende is en er geen expliciete duur is ingesteld. Deze instellingen regelen het overgangseffect onafhankelijk van de automatische voortgangsvertraging.
Kan ik audio aan een overgang koppelen en deze laten loopen?
Ja. Wijs ingebedde audio toe met setSound, geef StartSound uit de TransitionSoundMode‑enumeratie door aan setSoundMode, en schakel setSoundLoop in met True. Het geluid blijft loopen tot het volgende geluids‑event in de diavoorstelling.
Wat is de snelste manier om dezelfde overgang op elke dia toe te passen?
Loop door de getSlides‑collectie van de presentatie en roep setType aan met dezelfde waarde voor de overgang van elke dia. Stel alle timing‑ en effectopties in dezelfde lus in om het gedrag consistent te houden over alle dia’s.
Hoe kan ik controleren welke overgang momenteel op een dia is ingesteld?
Roep getType aan op het resultaat van getSlideShowTransition van de dia. Het retourneert een waarde uit de TransitionType‑enumeratie; None_ betekent dat er geen overgangseffect is toegepast.