Gérer les transitions de diapositives dans les présentations avec PHP
Vue d’ensemble
Les transitions de diapositive contrôlent la façon dont les diapositives apparaissent pendant un diaporama. Avec Aspose.Slides for PHP via Java, vous pouvez choisir un effet de transition pour chaque diapositive, configurer l’avancement par clic de souris ou par minuteur, et ajuster les options spécifiques à un effet. Cet article utilise des exemples PHP pour appliquer des transitions, définir des durées de transition précises, gérer le minutage des diapositives et créer une transition Morph entre deux diapositives. Les exemples montrent également comment enregistrer les paramètres dans un fichier PPTX.
Ajouter une transition de diapositive
Pour appliquer une transition, chargez une présentation avec la classe Presentation et accédez aux paramètres de transition de la diapositive via getSlideShowTransition. Utilisez setType avec une valeur de l’énumération TransitionType, puis enregistrez la présentation.
L’exemple suivant applique une transition Circle à la première diapositive et une transition Comb à la deuxième. Utilisez un fichier input.pptx contenant au moins deux diapositives.
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();
}
Transition Wheel
La méthode setSpokes contrôle le nombre de secteurs radiaux qui dévoilent la diapositive de destination. Utilisez setType pour sélectionner Wheel dans TransitionType, puis appelez getValue pour accéder aux paramètres de WheelTransition.
L’exemple crée deux paires de diapositives identiques. Chaque paire commence par une diapositive noire et se termine par une diapositive recouverte d’un rectangle doré. La diapositive 2 utilise un rayon et la diapositive 4 utilise huit rayons. Les deux transitions utilisent la même vitesse lente, définie avec setSpeed, et une durée explicite de 8 000 millisecondes, définie avec setDuration.
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();
}
Ouvrez la présentation enregistrée dans PowerPoint et démarrez le diaporama. Passez de la diapositive 1 à la diapositive 2 pour voir un seul balayage horaire. Puis passez de la diapositive 3 à la diapositive 4 pour voir huit secteurs radiaux révéler le même rectangle simultanément.
Ajouter une transition de diapositive avancée
Vous pouvez configurer la durée pendant laquelle une diapositive reste à l’écran et si un clic de souris fait avancer le diaporama. Les méthodes suivantes contrôlent ce comportement :
- setAdvanceOnClick permet au spectateur d’avancer en cliquant avec la souris.
- setAdvanceAfter active l’avancement automatique.
- setAdvanceAfterTime spécifie le délai avant l’avancement automatique, en millisecondes.
Activez à la fois l’avancement par clic et le minutage pour permettre au spectateur de poursuivre avec un clic ou d’attendre le minuteur. Pour n’utiliser que le minuteur, transmettez false à setAdvanceOnClick. Le délai contrôle le moment où le diaporama avance ; il ne définit pas la durée de l’effet de transition visuel.
Cet exemple attribue des effets différents aux trois premières diapositives et active l’avancement automatique après 3, 5 et 7 secondes, respectivement. Des clics de souris peuvent également faire avancer ces diapositives. Utilisez un fichier input.pptx contenant au moins trois diapositives.
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();
}
Pour vérifier si l’avancement chronométré est activé, appelez getAdvanceAfter. Un délai stocké seul n’indique pas que le minuteur est actif.
L’exemple suivant ouvre le fichier enregistré précédemment, signale chaque minuteur activé, et désactive l’avancement automatique pour les diapositives dont le délai dépasse deux secondes. Il active les clics de souris pour ces diapositives et enregistre les paramètres mis à jour.
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();
}
Contrôler précisément le minutage des transitions
Utilisez setDuration pour spécifier la longueur exacte d’un effet de transition en millisecondes. La méthode getSlideShowTransition de la diapositive expose ces paramètres via SlideShowTransition :
| Méthode | Objectif |
|---|---|
| setDuration | Définit la durée de l’effet de transition lui‑même, en millisecondes. |
| setAdvanceAfterTime | Définit le délai avant que la diapositive avance automatiquement, en millisecondes. Transmettez true à setAdvanceAfter pour activer ce minuteur. |
| setSpeed | Sélectionne une catégorie de vitesse prédéfinie dans TransitionSpeed : Slow, Medium ou Fast. Elle est utilisée lorsqu’aucune durée exacte n’est spécifiée. |
setDuration ne contrôle que l’effet de transition ; il ne détermine pas le temps pendant lequel la diapositive reste visible. Configurez séparément le délai d’avancement automatique. Lorsqu’aucune durée explicite n’est définie, Aspose.Slides détermine la durée de l’effet à partir du type de transition et de la valeur getSpeed.
L’exemple partagé donne à chaque diapositive une transition de fondu de 750 ms et active séparément l’avancement automatique à 5 000 ms. La durée de transition contrôle l’effet ; l’avancement contrôle le moment de quitter la diapositive. Ces barres sont des réglages schématiques, pas une chronologie combinée mesurée.
Appliquer la même durée à chaque diapositive
Pour un rythme cohérent, appliquez le même effet et la même durée exacte à chaque diapositive. Cet exemple charge input.pptx, sélectionne Fade dans TransitionType, et attribue à chaque transition une durée de 750 millisecondes. Il active séparément l’avancement automatique après 5 000 millisecondes et désactive l’avancement par clic de souris, puis enregistre le résultat au format PPTX.
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);
// Configurer l'avancement automatique indépendamment de la durée de l'effet.
$transition->setAdvanceAfter(true);
$transition->setAdvanceAfterTime(5000);
$transition->setAdvanceOnClick(false);
}
$presentation->save("precise-transitions.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Définir des durées différentes pour des diapositives individuelles
Des diapositives différentes peuvent utiliser des durées d’effet différentes. Par exemple, utilisez une transition brève pour une diapositive de titre et une transition plus longue pour l’introduction d’une section. Cet exemple fixe 500 millisecondes pour la première diapositive et 1 200 millisecondes pour la seconde. Utilisez un fichier input.pptx contenant au moins deux diapositives.
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();
}
Coordonner les transitions avec la sortie animée
Lorsque vous préparez un animated GIF, une HTML5 presentation ou une video, définissez des durées de transition exactes avant l’exportation pour correspondre au rythme prévu. Par exemple, utilisez un fondu de 600 millisecondes entre les scènes, et ajustez séparément le délai d’avancement de chaque diapositive pour laisser le temps à la narration ou au contenu.
Pour les GIF et les vidéos, coordonnez la fréquence d’images de sortie avec la durée de l’effet : 600 millisecondes correspondent à 18 images à 30 images par seconde. En HTML5, activez les transitions animées dans les paramètres d’exportation. Vérifiez les effets et options de minutage pris en charge par le format d’exportation choisi, et prévisualisez la sortie pour confirmer la synchronisation.
Lire une durée de transition existante
Appelez getDuration avant de modifier la transition pour déterminer si une valeur explicite est stockée. Une valeur de -1 signifie qu’aucune durée explicite n’est définie ; une valeur non négative indique la durée stockée en millisecondes. La valeur non définie n’est pas la durée de lecture calculée : Aspose.Slides utilise le type de transition et la valeur getSpeed pour déterminer cette durée. La définition d’un type de transition peut initialiser une durée, il convient donc d’inspecter d’abord les paramètres d’origine.
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();
}
Transition Morph
La transition Morph anime les changements entre les objets sur des diapositives consécutives. Pour créer un effet Morph simple, clonez une diapositive, déplacez ou redimensionnez un objet sur le clone, et appliquez la transition Morph à la deuxième diapositive. Cela donne aux objets correspondants la possibilité d’animer entre leurs états d’origine et modifié.
L’exemple suivant crée une diapositive contenant un rectangle de texte, clone la diapositive, puis modifie la position et la taille du rectangle sur le clone. Il sélectionne ensuite Morph dans l’énumération TransitionType pour la deuxième diapositive. Ouvrez le fichier enregistré dans un visualiseur de présentations prenant en charge Morph pour voir l’effet pendant un diaporama.
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();
}
Types de transition Morph
L’énumération TransitionMorphType contrôle la façon dont Morph associe et anime le contenu :
- ByObject traite chaque forme comme un objet complet.
- ByWord anime le texte en associant les mots lorsque c’est possible.
- ByChar anime le texte en associant les caractères lorsque c’est possible.
Utilisez setType pour sélectionner Morph avant d’accéder à getValue. La valeur renvoie alors un objet MorphTransition, dont la méthode setMorphType sélectionne le mode d’association.
Cet exemple ouvre la présentation créée dans la section précédente et configure la deuxième diapositive pour utiliser l’animation Morph basée sur les mots.
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();
}
Définir des effets de transition
Certaines transitions exposent des options supplémentaires, telles que la direction ou le fait que l’effet débute à partir d’un écran noir. Les options disponibles dépendent de la transition sélectionnée avec setType. Définissez d’abord le type, puis utilisez l’objet de transition approprié obtenu via getValue.
L’exemple suivant applique une transition Cut à la première diapositive de input.pptx. Il appelle setFromBlack via OptionalBlackTransition afin que la transition démarre depuis un écran noir.
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();
}
FAQ
Puis‑je contrôler la vitesse de lecture d’une transition de diapositive ?
Oui. Privilégiez setDuration lorsque vous avez besoin d’une durée d’effet exacte en millisecondes. Utilisez setSpeed lorsqu’une catégorie prédéfinie de TransitionSpeed — Slow, Medium ou Fast — suffit et qu’aucune durée explicite n’est définie. Ces paramètres contrôlent l’effet de transition indépendamment du délai d’avancement automatique.
Puis‑je attacher un son à une transition et le faire boucler ?
Oui. Assignez un son incorporé avec setSound, transmettez StartSound de l’énumération TransitionSoundMode à setSoundMode, et activez setSoundLoop avec true. Le son se répète jusqu’au prochain événement sonore du diaporama.
Quelle est la façon la plus rapide d’appliquer la même transition à chaque diapositive ?
Parcourez la collection getSlides de la présentation et appelez setType avec la même valeur pour la transition de chaque diapositive. Définissez les options de minutage et d’effet dans la même boucle afin de conserver un comportement homogène sur toutes les diapositives.
Comment puis‑je vérifier quelle transition est actuellement définie sur une diapositive ?
Appelez getType sur le résultat de getSlideShowTransition de la diapositive. Elle renvoie une valeur de l’énumération TransitionType ; None signifie qu’aucun effet de transition n’est appliqué.