Diaátmenetek kezelése prezentációkban PHP használatával
Áttekintés
A diaátmenetek szabályozzák, hogyan jelennek meg a diák a diavetítés során. Az Aspose.Slides for PHP via Java használatával kiválaszthat egy átmenet‑effektust minden diához, konfigurálhatja az előrehaladást egérkattintás vagy időzítő alapján, és beállíthatja az effektusra jellemző opciókat. Ez a cikk PHP példákkal mutatja be az átmenetek alkalmazását, az átmenet pontos időtartamának beállítását, a diaidőzítés kezelését, valamint egy Morph átmenet létrehozását két dia között. A példák azt is bemutatják, hogyan menthetők a beállítások PPTX fájlba.
Diaátmenet hozzáadása
Átmenet alkalmazásához töltse be a prezentációt a Presentation osztállyal, és a dia átmenet‑beállításait érje el a getSlideShowTransition segítségével. Használja a setType metódust a TransitionType felsorolásból származó értékkel, majd mentse a prezentációt.
Az alábbi példa Circle átmenetet alkalmaz az első diára, és Comb átmenetet a másodikra. Használjon egy input.pptx fájlt, amely legalább két diát tartalmaz.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TransitionType;
$presentation = new Presentation("input.pptx");
try {
if (java_values($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 {
echo "The input presentation must contain at least two slides." . PHP_EOL;
}
} finally {
$presentation->dispose();
}
Kerék átmenet
A setSpokes metódus szabályozza, hány sugárirányú szektor fedje fel a céldiat. A setType segítségével válassza ki a Wheel opciót a TransitionType felsorolásból, majd hívja a getValue metódust a WheelTransition beállításainak eléréséhez.
A példa két azonos diapárt hoz létre. Minden pár egy fekete diával kezdődik, és egy arany téglalappal zárul. A 2. dia egy szektorral, a 4. dia nyolccal fed le. Mindkét átmenet lassú sebességet használ, amelyet a setSpeed metódussal állítanak be, és explicit 8 000 ms időtartamot a setDuration metódussal.
use aspose\slides\BackgroundType;
use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
use aspose\slides\TransitionSpeed;
use aspose\slides\TransitionType;
use java\awt\Color;
$presentation = new Presentation();
try {
$slides = $presentation->getSlides();
$width = java_values($presentation->getSlideSize()->getSize()->getWidth());
$height = java_values($presentation->getSlideSize()->getSize()->getHeight());
$blackSlide = $slides->get_Item(0);
$blackSlide->getShapes()->clear();
$background = $blackSlide->getBackground();
$background->setType(BackgroundType::OwnBackground);
$background->getFillFormat()->setFillType(FillType::Solid);
$black = new Color(0, 0, 0);
$background->getFillFormat()->getSolidFillColor()->setColor($black);
$destinationSlide = $slides->addClone($blackSlide);
$rectangle = $destinationSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 0, 0, $width, $height);
$rectangle->getFillFormat()->setFillType(FillType::Solid);
$gold = new Color(255, 215, 0);
$rectangle->getFillFormat()->getSolidFillColor()->setColor($gold);
$rectangle->getTextFrame()->setText("Wheel transition");
$slides->addClone($blackSlide);
$slides->addClone($destinationSlide);
foreach ([1 => 1, 3 => 8] as $slideIndex => $spokes) {
$transition = $slides->get_Item($slideIndex)->getSlideShowTransition();
$transition->setType(TransitionType::Wheel);
$transition->getValue()->setSpokes($spokes);
$transition->setSpeed(TransitionSpeed::Slow);
$transition->setDuration(8000);
}
$presentation->save("wheel-transitions.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Nyissa meg a mentett prezentációt PowerPointban, és indítsa el a diavetítést. Lépjen a 1. diáról a 2. diára, hogy egy óramutató járásával megegyező szekciót lásson. Ezután lépjen a 3. diáról a 4. diára, hogy nyolc sugárirányú szektor fedje le egyszerre a téglalapot.
Speciális diaátmenet hozzáadása
Beállíthatja, mennyi ideig marad a dia a képernyőn, és hogy egérkattintás indítja‑e a diavetítést. Az alábbi metódusok szabályozzák ezt a viselkedést:
- setAdvanceOnClick lehetővé teszi a felhasználó számára, hogy egérkattintással lépjen előre.
- setAdvanceAfter automatikus előrehaladást engedélyez.
- setAdvanceAfterTime adja meg az automatikus előrehaladás késleltetését milliszekundumban.
Engedélyezze mind a kattintást, mind az időzített előrehaladást, hogy a felhasználó kattintással vagy a várakozással léphessen tovább. Ha csak az időzítőt szeretné használni, adjon false értéket a setAdvanceOnClick metódusnak. A késleltetés azt szabályozza, mikor lép tovább a diavetítés; nem befolyásolja az átmenet vizuális időtartamát.
Ez a példa különböző effektusokat rendel az első három diához, és automatikus előrehaladást állít be 3, 5 és 7 másodperc után. Egérkattintással is lehet előre lépni ezeken a diákon. Használjon egy input.pptx fájlt, amely legalább három diát tartalmaz.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TransitionType;
$presentation = new Presentation("input.pptx");
try {
if (java_values($presentation->getSlides()->size()) >= 3) {
$firstTransition = $presentation->getSlides()->get_Item(0)->getSlideShowTransition();
$firstTransition->setType(TransitionType::Circle);
$firstTransition->setAdvanceOnClick(true);
$firstTransition->setAdvanceAfter(true);
$firstTransition->setAdvanceAfterTime(3000);
$secondTransition = $presentation->getSlides()->get_Item(1)->getSlideShowTransition();
$secondTransition->setType(TransitionType::Comb);
$secondTransition->setAdvanceOnClick(true);
$secondTransition->setAdvanceAfter(true);
$secondTransition->setAdvanceAfterTime(5000);
$thirdTransition = $presentation->getSlides()->get_Item(2)->getSlideShowTransition();
$thirdTransition->setType(TransitionType::Zoom);
$thirdTransition->setAdvanceOnClick(true);
$thirdTransition->setAdvanceAfter(true);
$thirdTransition->setAdvanceAfterTime(7000);
$presentation->save("advanced-transitions.pptx", SaveFormat::Pptx);
} else {
echo "The input presentation must contain at least three slides." . PHP_EOL;
}
} finally {
$presentation->dispose();
}
Az időzített előrehaladás engedélyezve van‑e, ellenőrizheti a getAdvanceAfter meghívásával. Egy 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 azon diákon, amelyek késleltetése nagyobb, mint két másodperc. Ezeken a diákon engedélyezi az egérkattintást, majd elmenti a módosított beállításokat.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("advanced-transitions.pptx");
try {
for ($slideIndex = 0; $slideIndex < java_values($presentation->getSlides()->size()); $slideIndex++) {
$slide = $presentation->getSlides()->get_Item($slideIndex);
$transition = $slide->getSlideShowTransition();
if (java_values($transition->getAdvanceAfter())) {
echo "Slide " . java_values($slide->getSlideNumber()) . ": advance after " . java_values($transition->getAdvanceAfterTime()) . " ms." . PHP_EOL;
if (java_values($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 szabályozása
Használja a setDuration metódust az átmenet‑effektus pontos hosszának milliszekundumban történő megadásához. A dia getSlideShowTransition metódusa ezeket a beállításokat a SlideShowTransition objektumon keresztül teszi elérhetővé:
| Metódus | Leírás |
|---|---|
| setDuration | Beállítja az átmenet‑effektus tényleges időtartamát milliszekundumban. |
| setAdvanceAfterTime | Beállítja a késleltetést, mielőtt a dia automatikusan tovább lép, milliszekundumban. A setAdvanceAfter meghívásával aktiválja az időzítőt. |
| 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 pontos időtartam megadva. |
A setDuration csak az átmenet‑effektust szabályozza; nem határozza meg, mennyi ideig látható a dia. Az automatikus előrehaladás késleltetését külön kell beállítani. Ha nincs explicit időtartam megadva, az Aspose.Slides az átmenet típusából és a getSpeed értékéből számítja ki az effektus időtartamát.
Az itt bemutatott példa minden diához 750 ms Fade átmenetet ad, és külön engedélyezi az automatikus előrehaladást 5 000 ms után. Az átmenet időtartama az effektust szabályozza; az előrehaladás azt határozza meg, mikor hagyja el a diát. Ezek a sávok csak vázlatos beállítások, nem egy mért kombinált idővonal.
Azonos időtartam alkalmazása minden diára
Az egységes ritmus érdekében alkalmazzon ugyanazt az effektust és pontos időtartamot minden diára. Ez a példa beolvassa a input.pptx fájlt, a TransitionType felsorolásból a Fade‑et választja, és minden átmenethez 750 ms időtartamot állít be. Emellett külön engedélyezi az automatikus előrehaladást 5 000 ms után, és letiltja a kattintással történő előrehaladást, majd menti az eredményt PPTX‑ként.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TransitionType;
$presentation = new Presentation("input.pptx");
try {
for ($slideIndex = 0; $slideIndex < java_values($presentation->getSlides()->size()); $slideIndex++) {
$slide = $presentation->getSlides()->get_Item($slideIndex);
$transition = $slide->getSlideShowTransition();
$transition->setType(TransitionType::Fade);
$transition->setDuration(750);
// Állítsa be az automatikus előrehaladást az effektus időtartamától függetlenü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önböző diák különböző átmeneti időtartamokat használhatnak. Például egy címoldalhoz rövid átmenetet, egy szekcióbevezetőhöz hosszabbat használhat. Ez a példa 500 ms‑ot állít be az első diára, és 1 200 ms‑ot a másodikra. Használjon egy input.pptx fájlt, amely legalább két diát tartalmaz.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TransitionType;
$presentation = new Presentation("input.pptx");
try {
if (java_values($presentation->getSlides()->size()) >= 2) {
$firstTransition = $presentation->getSlides()->get_Item(0)->getSlideShowTransition();
$firstTransition->setType(TransitionType::Fade);
$firstTransition->setDuration(500);
$secondTransition = $presentation->getSlides()->get_Item(1)->getSlideShowTransition();
$secondTransition->setType(TransitionType::Push);
$secondTransition->setDuration(1200);
$presentation->save("individual-transition-durations.pptx", SaveFormat::Pptx);
} else {
echo "The input presentation must contain at least two slides." . PHP_EOL;
}
} finally {
$presentation->dispose();
}
Átmenetek összehangolása animált kimenettel
Amikor animált GIF, HTML5 prezentáció vagy videó készül, a pontos átmeneti időtartamokat exportálás előtt állítsa be, hogy megfeleljenek a kívánt ütemnek. Például használjon 600 ms‑os fade‑et a jelenetek között, és a dia előrehaladási késleltetését külön szabályozza, hogy legyen elegendő idő a narrációnak vagy a tartalomnak.
GIF‑nél és videónál a kimeneti képkockasebességet az effektus időtartamához kell igazítani: 600 ms 30 fps‑nél 18 képkockának felel meg. HTML5‑nél engedélyezze az animált átmeneteket az export beállításaiban. Ellenőrizze a választott exportformátum támogatott effektusait és időzítési lehetőségeit, és tekintse meg az előzetes megjelenítést a szinkronizáció ellenőrzéséhez.
Létező átmeneti időtartam kiolvasása
Módosítás előtt hívja meg a getDuration metódust, hogy megállapítsa, tárolva van‑e explicit érték. A -1 érték azt jelenti, hogy nincs explicit időtartam; egy nem negatív érték a tárolt időtartamot adja vissza milliszekundumban. A nem beállított érték nem a számított lejátszási idő: az Aspose.Slides a TransitionType és a getSpeed érték alapján határozza meg azt. Egy átmenettípus beállítása inicializálhat időtartamot, ezért először ellenőrizze az eredeti beállításokat.
use aspose\slides\Presentation;
$presentation = new Presentation("input.pptx");
try {
for ($slideIndex = 0; $slideIndex < java_values($presentation->getSlides()->size()); $slideIndex++) {
$slide = $presentation->getSlides()->get_Item($slideIndex);
$transition = $slide->getSlideShowTransition();
$duration = java_values($transition->getDuration());
if ($duration >= 0) {
echo "Slide " . java_values($slide->getSlideNumber()) . ": stored transition duration is " . $duration . " ms." . PHP_EOL;
} else {
echo "Slide " . java_values($slide->getSlideNumber()) . ": no explicit duration; timing depends on transition type " . java_values($transition->getType()) . " and speed " . java_values($transition->getSpeed()) . "." . PHP_EOL;
}
}
} finally {
$presentation->dispose();
}
Morph átmenet
A Morph átmenet animálja a tárgyak változását egymást követő diáknál. Egy egyszerű Morph hatás létrehozásához klónozzon egy diát, mozdítsa vagy méretezze át a tárgyat a klónon, és alkalmazza a Morph átmenetet a második diára. Így a megfelelő objektumok animálódnak az eredeti és a módosított állapot között.
Az alábbi példa egy szöveges téglalappal rendelkező diát hoz létre, klónozza a diát, majd a klónon megváltoztatja a téglalap helyzetét és méretét. Ezután a TransitionType felsorolásból a Morph‑ot választja a második diára. Nyissa meg a mentett fájlt egy Morph‑ot támogató prezentációs megjelenítőben, hogy lássa a hatást diavetítés közben.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
use aspose\slides\TransitionType;
$presentation = new Presentation();
try {
$firstSlide = $presentation->getSlides()->get_Item(0);
$rectangle = $firstSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 400, 100);
$rectangle->getTextFrame()->setText("Morph transition");
$secondSlide = $presentation->getSlides()->addClone($firstSlide);
$movedRectangle = $secondSlide->getShapes()->get_Item(0);
$movedRectangle->setX(java_values($movedRectangle->getX()) + 100);
$movedRectangle->setY(java_values($movedRectangle->getY()) + 50);
$movedRectangle->setWidth(java_values($movedRectangle->getWidth()) - 200);
$movedRectangle->setHeight(java_values($movedRectangle->getHeight()) - 10);
$secondSlide->getSlideShowTransition()->setType(TransitionType::Morph);
$presentation->save("morph-transition.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Morph átmenet típusok
A TransitionMorphType felsorolás szabályozza, hogy a Morph hogyan párosít és animálja a tartalmat:
- ByObject minden alakzatot teljes objektumként kezel.
- ByWord a szöveget szavak szerint animálja, ahol lehetséges.
- ByChar a szöveget karakterek szerint animálja, ahol lehetséges.
Használja a setType metódust a Morph kiválasztásához, mielőtt meghívná a getValue metódust. Az így kapott érték egy MorphTransition objektumot ad, amelynek a setMorphType metódusa választja ki a párosítási módot.
Ez a példa megnyitja az előző szakaszban létrehozott prezentációt, és a második diát szó‑alapú Morph animációra állítja.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TransitionMorphType;
use aspose\slides\TransitionType;
$presentation = new Presentation("morph-transition.pptx");
try {
if (java_values($presentation->getSlides()->size()) >= 2) {
$transition = $presentation->getSlides()->get_Item(1)->getSlideShowTransition();
$transition->setType(TransitionType::Morph);
$morphTransition = $transition->getValue();
if (!java_is_null($morphTransition)) {
$morphTransition->setMorphType(TransitionMorphType::ByWord);
$presentation->save("morph-by-word.pptx", SaveFormat::Pptx);
} else {
echo "Morph transition options are unavailable." . PHP_EOL;
}
} else {
echo "The input presentation must contain at least two slides." . PHP_EOL;
}
} finally {
$presentation->dispose();
}
Átmeneti effektusok beállítása
Néhány átmenet további beállításokkal rendelkezik, például irány vagy a fekete képernyőről történő indulás. Az elérhető opciók attól függenek, melyik átmenetet választotta a setType metódussal. Először állítsa be a típust, majd a megfelelő átmenet‑objektumot használja a getValue hívásával.
Az alábbi példa egy Cut átmenetet alkalmaz az input.pptx első diájára. A OptionalBlackTransition segítségével a setFromBlack metódust hívja, így az átmenet fekete képernyőről indul.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TransitionType;
$presentation = new Presentation("input.pptx");
try {
$transition = $presentation->getSlides()->get_Item(0)->getSlideShowTransition();
$transition->setType(TransitionType::Cut);
$cutTransition = $transition->getValue();
if (!java_is_null($cutTransition)) {
$cutTransition->setFromBlack(true);
$presentation->save("cut-from-black.pptx", SaveFormat::Pptx);
} else {
echo "Cut transition options are unavailable." . PHP_EOL;
}
} 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őt akar milliszekundumban megadni. 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 átmenet‑effektust szabályozzák, függetlenül az automatikus előrehaladási késleltetéstől.
Csatolhatok hangot egy átmenethez, és beállíthatom a hurok‑lejátszást?
Igen. A setSound segítségével beágyazott hangot adhat, a TransitionSoundMode felsorolásból a StartSound értéket adja át a setSoundMode metódusnak, és a setSoundLoop metódust true‑ra állítva engedélyezi a hang hurkolását. A hang a következő hangeseményig körkörös lesz a diavetítésben.
Mi a leggyorsabb módja annak, hogy ugyanazt az átmenetet alkalmazzam minden diára?
Iteráljon végig a prezentáció getSlides gyűjteményén, és a setType metódust ugyanazzal az értékkel hívja meg minden dia átmeneténél. A időzítési és effektus‑opciókat ugyanabban a ciklusban állítsa be, hogy a viselkedés konzisztens maradjon a diák között.
Hogyan ellenőrizhetem, melyik átmenet van beállítva egy adott dián?
Hívja meg a getType metódust a dia getSlideShowTransition eredményén. Ez egy értéket ad vissza a TransitionType felsorolásból; a None azt jelenti, hogy nincs alkalmazva átmenet‑effektus.