Diaátmenetek kezelése prezentációkban Python via Java segítségével
Áttekintés
A diaátmenetek szabályozzák, hogyan jelennek meg a diák a diavetítés során. Az Aspose.Slides for Python via Java segítségével kiválaszthat egy átmeneti effektet minden diára, beállíthatja a haladást egérkattintással vagy időzítővel, és módosíthatja az effektusra jellemző opciókat. Ez a cikk Python példákat használ átmenetek alkalmazásához, pontos átmeneti időtartamok beállításához, a diák időzítésének kezeléséhez, valamint egy Morph átmenet létrehozásához két dia között. A példák azt is bemutatják, hogyan menthetőek a beállítások PPTX fájlba.
Diaátmenet hozzáadása
A diaátmenet alkalmazásához töltsön be egy prezentációt a Presentation osztállyal, és érje el a dia átmenet beállításait a getSlideShowTransition segítségével. Használja a setType metódust a TransitionType felsorolás egy értékével, majd mentse a prezentációt.
Az alábbi példa egy Circle átmenetet alkalmaz az első diára, és egy Comb átmenetet a másodikra. Használjon egy input.pptx fájlt, amely legalább két diát tartalmaz.
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()
Kerék átmenet
Használja a setType metódust a Wheel kiválasztásához a TransitionType felsorolásból. Ezután hívja a getValue metódust a WheelTransition beállításainak eléréséhez. Ennek a setSpokes metódusának segítségével állítható, hány radiális szektor fedje fel a cél diát.
A példa két azonos diapárt hoz létre. Minden pár egy fekete diával kezdődik, és egy teljes diát kitöltő arany téglalappal ér véget. Mindkét cél dia ugyanazzal a lassú sebességgel rendelkezik, amelyet a setSpeed állít be, és ugyanazzal a 8 000 ms explicit időtartammal, amelyet a setDuration állít be. Csak a szektorok száma változik.
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()
Nyissa meg a wheel-transitions.pptx fájlt a PowerPointban, és indítsa el a diavetítést. Haladjon az 1‑es diáról a 2‑es diára, hogy egy óramutató járásával megegyező körív fedje fel az arany téglalapot. Ezután haladjon a 3‑as diáról a 4‑es diára, hogy nyolc radiális szektor fedje fel egyszerre ugyanazt a téglalapot.
Fejlett diaátmenet hozzáadása
Konfigurálhatja, mennyi ideig marad a dia a képernyőn, és hogy egérkattintás-e vagy időzítő hozza-e előre a diavetítést. A következő metódusok szabályozzák ezt a viselkedést:
- setAdvanceOnClick lehetővé teszi a néző számára, hogy az egérkattintással továbbhaladjon.
- setAdvanceAfter engedélyezi az automatikus előrehaladást.
- setAdvanceAfterTime határozza meg az automatikus előrehaladás előtti késleltetést ezredmásodpercben.
Engedélyezze mind a kattintást, mind az időzített előrehaladást, hogy a néző kattintással vagy a várakozással léphessen tovább. Ha csak az időzítőt szeretné használni, adja át a False értéket a setAdvanceOnClick metódusnak. A késleltetés azt szabályozza, mikor halad előre a diavetítés; nem határozza meg a vizuális átmeneti effektus időtartamát.
Ez a példa különböző effektusokat rendel az első három diához, és automatikus előrehaladást engedélyez 3, 5 és 7 másodperc után, rendre. Egérkattintással is előre lehet lépni ezeken a diákon. Használjon egy input.pptx fájlt, amely legalább három diát tartalmaz.
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()
Annak ellenőrzéséhez, hogy az időzített előrehaladás engedélyezve van-e, hívja a getAdvanceAfter metódust. A tárolt késleltetés önmagában nem jelzi, hogy az időzítő aktív.
A következő példa megnyitja a fent mentett fájlt, jelentést készít minden engedélyezett időzítőről, és letiltja az automatikus előrehaladást azoknál a diáknál, amelyeknél a késleltetés nagyobb mint két másodperc. Ezeknél a diáknál engedélyezi az egérkattintást, majd menti a frissített beállításokat.
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()
Az átmenet időzítésének pontos vezérlése
Használja a setDuration metódust egy átmeneti effektus pontos hosszának ezredmásodpercben történő megadásához. A dia getSlideShowTransition metódusa ezeket a beállításokat a SlideShowTransition osztályon keresztül teszi elérhetővé:
| Módszer | Cél |
|---|---|
| setDuration | Beállítja az átmeneti effektus tényleges időtartamát ezredmásodpercben. |
| setAdvanceAfterTime | Beállítja a diák automatikus előrehaladása előtti késleltetést ezredmásodpercben. Pass True to setAdvanceAfter to activate this timer. |
| setSpeed | Kiválaszt egy előre definiált sebességkategóriát a TransitionSpeed felsorolásból: Slow, Medium vagy Fast. Akkor használatos, ha nincs megadva pontos időtartam. |
A setDuration csak az átmeneti effektust irányítja; nem határozza meg, mennyi ideig látható a dia. Az automatikus előrehaladási késleltetést külön kell konfigurálni. Ha nincs explicit időtartam beállítva, az Aspose.Slides a transition type és a getSpeed érték alapján határozza meg az effektus időtartamát.
A megosztott példa minden diára 750 ms‑es Fade átmenetet ad, és külön engedélyezi az automatikus előrehaladást 5 000 ms‑nél. Az átmeneti időtartam az effektust, az előrehaladás pedig azt szabályozza, hogy mikor lépjünk a következő diára. Ezek a sávok szimbolikus beállítások, nem egy mérő kombinált idővonal.
Azonos időtartam alkalmazása minden diára
Az egységes ütemezés érdekében alkalmazza ugyanazt az effektust és pontos időtartamot minden diára. Ez a példa betölti a input.pptx fájlt, a TransitionType felsorolásból a Fade‑t választja, és minden átmenetnek 750 ms‑es időtartamot ad. Külön engedélyezi az automatikus előrehaladást 5 000 ms után, letiltja az egérkattintást, majd menti az eredményt PPTX‑ként.
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)
# Az automatikus előrehaladást állítsa be függetlenül az effektus időtartamától.
transition.setAdvanceAfter(True)
transition.setAdvanceAfterTime(5000)
transition.setAdvanceOnClick(False)
presentation.save("precise-transitions.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Különböző időtartamok beállítása egyedi diákhoz
Külön diák különböző effektus időtartamot használhatnak. Például egy cím dián rövid átmenetet, egy szekció bevezetőjénél hosszabb átmenetet alkalmazhat. Ez a példa az első diára 500 ms‑et, a másodikra 1 200 ms‑et állít be. Használjon egy input.pptx fájlt, amely legalább két diát tartalmaz.
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()
Átmenetek koordinálása animált kimenettel
Ha animated GIF, HTML5 presentation vagy video készül, állítsa be a pontos átmeneti időtartamokat az exportálás előtt, hogy megfeleljenek a kívánt ütemezésnek. Például használjon 600 ms‑es fade‑et a jelenetek között, és állítsa be minden dia előrehaladási késleltetését külön-külön, hogy elegendő legyen a narráció vagy a tartalom számára.
A GIF és videó esetében szinkronizálja a kimeneti képkocka‑sebességet az effektus időtartamával: 600 ms 18 képkocka 30 fps‑nél. HTML5‑ben engedélyezze az animált átmeneteket az export beállításaiban. Ellenőrizze az adott export formátum támogatott effektusait és időzítési opcióit, és tekintse meg az eredményt a szinkronizáció ellenőrzéséhez.
Meglévő átmeneti időtartam beolvasása
Hívja a getDuration metódust az átmenet módosítása előtt, hogy megállapítsa, tárolt‑e explicit érték. A -1 érték azt jelenti, hogy nincs explicit időtartam beállítva; egy nem negatív érték a tárolt ezredmásodperces időtartamot adja meg. A nem beállított érték nem a számított lejátszási időtartam: az Aspose.Slides a transition type és a getSpeed érték alapján határozza meg azt. Egy átmenet típus beállítása inicializálhat időtartamot, ezért először vizsgálja meg az eredeti beállításokat.
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 átmenet
A Morph átmenet animálja az objektumok változását egymást követő diákon. Egy egyszerű Morph effektus létrehozásához klónozzon egy diát, mozdítsa vagy méretezze át egy objektumot a klónon, és alkalmazza a Morph átmenetet a második diára. Így az átmenet az eredeti és a módosított állapot között animálja a megfelelő objektumokat.
Az alábbi példa egy szöveges téglalappal rendelkező diát hoz létre, klónozza azt, majd a klónon megváltoztatja a téglalap pozícióját és méretét. Ezután a TransitionType felsorolásból a Morph‑ot választja a második diához. Nyissa meg a mentett fájlt egy olyan prezentációs megjelenítőben, amely támogatja a Morph‑ot, hogy lássa az effektust diavetítés közben.
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 átmenet típusok
A TransitionMorphType felsorolás szabályozza, hogyan illeszkedik és animálja a Morph a tartalmat:
- ByObject az egyes alakzatokat egész objektumként kezeli.
- ByWord a szöveget szavak egyezésével animálja, ahol lehetséges.
- ByChar a szöveget karakterek egyezésével animálja, ahol lehetséges.
Használja a setType metódust a Morph kiválasztásához, mielőtt hozzáférne a getValue metódushoz. Ekkor a visszatérési érték a MorphTransition osztály egy példánya, amelynek a setMorphType metódusa választja ki a megfelelő módot.
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()
Átmeneti effektek beállítása
Néhány átmenet további opciókat is kínál, például irányt vagy azt, hogy az effektus fekete képernyőről induljon-e. A rendelkezésre álló opciók a setType által kiválasztott átmenettől függnek. Állítsa be először a típust, majd a getValue megfelelő osztályával használja a kapcsolódó beállításokat.
Az alábbi példa egy Cut átmenetet alkalmaz az input.pptx első diájára. A OptionalBlackTransition osztály setFromBlack metódusával állítja be, hogy az átmenet fekete képernyőről induljon.
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()
GYIK
Kezelhetem a diaátmenet lejátszási sebességét?
Igen. Használja a setDuration metódust, ha pontos effektus-időtartamot szeretne meghatározni ezredmásodpercben. Használja a setSpeed metódust, ha egy előre definiált TransitionSpeed kategória (Slow, Medium vagy Fast) elegendő, és nincs explicit időtartam beállítva. Ezek a beállítások az átmeneti effektust irányítják, függetlenül az automatikus előrehaladási késleltetéstől.
Csatolhatok hangot egy átmenethez, és hagyhatom, hogy ismétlődjön?
Igen. Az setSound metódussal adhat hozzá beágyazott hangot, a TransitionSoundMode felsorolásból a StartSound értéket adja át az setSoundMode metódusnak, és a setSoundLoop metódussal True értéket állít be. A hang a következő hangeseményig a diavetítésben ismétlődik.
Mi a leggyorsabb módja annak, hogy ugyanazt az átmenetet alkalmazzuk minden diára?
Iteráljon a prezentáció getSlides gyűjteményén, és minden dia átmenetéhez hívja a setType metódust azonos értékkel. A felhasználható időzítési és effektus beállításokat ugyanabban a ciklusban állítsa be, hogy a viselkedés minden dián konzisztens maradjon.
Hogyan ellenőrizhetem, hogy melyik átmenet van jelenleg beállítva egy dián?
Hívja a getType metódust a dia getSlideShowTransition eredményén. Ez a TransitionType felsorolásból egy értéket ad vissza; a None_ azt jelenti, hogy nincs átmeneti effektus alkalmazva.