Beheer diaovergangen in presentaties op Android
Overzicht
Diaovergangen bepalen hoe dia’s verschijnen tijdens een diavoorstelling. Met Aspose.Slides for Android via Java kun je een overgangseffect voor elke dia kiezen, de voortgang per muisklik of timer configureren, en opties aanpassen die specifiek zijn voor een effect. Dit artikel gebruikt Java‑voorbeelden om overgangen toe te passen, exacte overgangsduraties in te stellen, de tijd van dia’s te beheren en een Morph‑overgang tussen twee dia’s te maken. De voorbeelden laten ook zien hoe je de instellingen opslaat 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 enumeratie TransitionType, en sla vervolgens 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 com.aspose.slides.*;
Presentation presentation = new 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 {
System.out.println("The input presentation must contain at least two slides.");
}
} finally {
presentation.dispose();
}
Wiel‑overgang
De setSpokes‑methode van IWheelTransition bepaalt het aantal radiale sectoren dat de bestemmingsdia onthult. Stel het overgangstype van de dia in op Wheel via TransitionType met setType voordat je getValue benadert als IWheelTransition.
Dit voorbeeld maakt twee identieke paar dia’s: een zwarte dia gevolgd door een dia met een gouden rechthoek. De bestemmingsdia’s gebruiken respectievelijk 1 en 8 spaken, met dezelfde snelheid ingesteld via setSpeed en een expliciete duur van 8 000 milliseconden ingesteld via setDuration om het verschil duidelijk waarneembaar te maken.
import android.graphics.Color;
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
float slideWidth = (float) presentation.getSlideSize().getSize().getWidth();
float slideHeight = (float) presentation.getSlideSize().getSize().getHeight();
ISlide blackSlide = presentation.getSlides().get_Item(0);
blackSlide.getShapes().clear();
blackSlide.getBackground().setType(BackgroundType.OwnBackground);
blackSlide.getBackground().getFillFormat().setFillType(FillType.Solid);
blackSlide.getBackground().getFillFormat().getSolidFillColor().setColor(Color.BLACK);
ISlide destinationSlide = presentation.getSlides().addClone(blackSlide);
IAutoShape rectangle = destinationSlide.getShapes().addAutoShape(ShapeType.Rectangle, 0, 0, slideWidth, slideHeight);
rectangle.getFillFormat().setFillType(FillType.Solid);
int gold = Color.rgb(255, 215, 0);
rectangle.getFillFormat().getSolidFillColor().setColor(gold);
rectangle.getTextFrame().setText("Wheel transition");
presentation.getSlides().addClone(blackSlide);
presentation.getSlides().addClone(destinationSlide);
long[] spokeCounts = { 1, 8 };
for (int i = 0; i < spokeCounts.length; i++) {
ISlideShowTransition transition = presentation.getSlides().get_Item(i * 2 + 1).getSlideShowTransition();
transition.setType(TransitionType.Wheel);
IWheelTransition wheelTransition = (IWheelTransition) transition.getValue();
wheelTransition.setSpokes(spokeCounts[i]);
transition.setSpeed(TransitionSpeed.Slow);
transition.setDuration(8000);
}
presentation.save("wheel-transitions.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Open de uitvoerpresentatie in PowerPoint en start de diavoorstelling. Ga van dia 1 naar dia 2 en vervolgens van dia 3 naar dia 4. In PowerPoint‑afspelen onthult de geverifieerde spoelwaarde van 1 de dia met één klokwijzer‑sweep; de geverifieerde waarde van 8 onthult deze via acht radiale sectoren tegelijk. De inhoud en de timing van de overgang zijn identiek, dus het verschil zit in het aantal onthullingssectoren.
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 per muisklik vooruit te gaan.
- setAdvanceAfter maakt automatische voortzetting mogelijk.
- setAdvanceAfterTime specificeert de vertraging vóór automatische voortzetting, in milliseconden.
Schakel zowel klik‑ als tijds‑voortzetting in zodat de kijker kan doorgaan met een klik of wachten op de timer. Om alleen de timer te gebruiken, geef false door aan setAdvanceOnClick. De vertraging bepaalt wanneer de diavoorstelling wordt voortgezet; 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 voortzetting 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 com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
if (presentation.getSlides().size() >= 3) {
ISlideShowTransition firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
firstTransition.setType(TransitionType.Circle);
firstTransition.setAdvanceOnClick(true);
firstTransition.setAdvanceAfter(true);
firstTransition.setAdvanceAfterTime(3000);
ISlideShowTransition secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
secondTransition.setType(TransitionType.Comb);
secondTransition.setAdvanceOnClick(true);
secondTransition.setAdvanceAfter(true);
secondTransition.setAdvanceAfterTime(5000);
ISlideShowTransition 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 {
System.out.println("The input presentation must contain at least three slides.");
}
} finally {
presentation.dispose();
}
Om te controleren of tijds‑voortzetting is ingeschakeld, roep je getAdvanceAfter op. Een opgeslagen vertraging op zich geeft niet aan dat de timer actief is.
Het volgende voorbeeld opent het eerder opgeslagen bestand, rapporteert elke ingeschakelde timer en schakelt automatische voortzetting uit voor dia’s met een vertraging groter dan twee seconden. Het schakelt muisklikken voor die dia’s in en slaat de bijgewerkte instellingen op.
import com.aspose.slides.*;
Presentation presentation = new Presentation("advanced-transitions.pptx");
try {
for (ISlide slide : presentation.getSlides()) {
ISlideShowTransition transition = slide.getSlideShowTransition();
if (transition.getAdvanceAfter()) {
System.out.println("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();
}
Overgangstijd nauwkeurig regelen
Gebruik setDuration om de exacte lengte van een overgangseffect in milliseconden op te geven. De getSlideShowTransition‑methode van de dia exposeert deze instellingen via ISlideShowTransition:
| Methode | Doel |
|---|---|
| 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 beïnvloedt alleen het overgangseffect; het bepaalt niet hoe lang de dia zichtbaar blijft. Configureer de automatische voortzettingsvertraging 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 Fade‑overgang van 750 ms en schakelt automatisch voortzetten na 5 000 ms in. De overgangsduur bepaalt het effect; voortzetten bepaalt wanneer de dia wordt verlaten. Deze balken zijn schematische instellingen, geen gemeten gecombineerde tijdlijn.
Dezelfde duur toepassen op elke dia
Voor een consistente timing 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 apart automatische voortzetting in na 5 000 milliseconden en schakelt voortzetting per muisklik uit, waarna het resultaat als PPTX wordt opgeslagen.
import com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
for (ISlide slide : presentation.getSlides()) {
ISlideShowTransition transition = slide.getSlideShowTransition();
transition.setType(TransitionType.Fade);
transition.setDuration(750);
// Stel automatische voortzetting 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 duraties instellen voor individuele dia’s
Verschillende dia’s kunnen verschillende effectduur hebben. Bijvoorbeeld, gebruik 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 com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
if (presentation.getSlides().size() >= 2) {
ISlideShowTransition firstTransition = presentation.getSlides().get_Item(0).getSlideShowTransition();
firstTransition.setType(TransitionType.Fade);
firstTransition.setDuration(500);
ISlideShowTransition secondTransition = presentation.getSlides().get_Item(1).getSlideShowTransition();
secondTransition.setType(TransitionType.Push);
secondTransition.setDuration(1200);
presentation.save("individual-transition-durations.pptx", SaveFormat.Pptx);
} else {
System.out.println("The input presentation must contain at least two slides.");
}
} finally {
presentation.dispose();
}
Overgangen coördineren met geanimeerde output
Bij het maken van een animated GIF, een HTML5 presentation of een video, stel je exacte overgangsduren in vóór export om de gewenste timing te matchen. Gebruik bijvoorbeeld een fade van 600 ms tussen scènes en stel de voortzettingsvertraging van elke dia apart in zodat er tijd is voor de bijbehorende voice‑over of inhoud.
Voor GIF‑ en video‑output stem je het frame‑rate af op de effectduur: 600 ms komt overeen met 18 frames bij 30 fps. In HTML5 schakel je geanimeerde overgangen in de exportinstellingen in. Controleer welke effecten en timingopties worden ondersteund door het gekozen exportformaat en bekijk een voorbeeld om de synchronisatie te bevestigen.
Bestaande overgangsduur lezen
Roep getDuration aan voordat je de overgang wijzigt 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 bepaalt de duur aan de hand van het overgangstype en de getSpeed‑waarde. Het instellen van een overgangstype kan een duur initialiseren, dus inspecteer eerst de oorspronkelijke instellingen.
import com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
for (ISlide slide : presentation.getSlides()) {
ISlideShowTransition transition = slide.getSlideShowTransition();
int duration = transition.getDuration();
if (duration >= 0) {
System.out.println("Slide " + slide.getSlideNumber() + ": stored transition duration is " + duration + " ms.");
} else {
System.out.println("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 veranderingen 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. Dit geeft de overgang de bijbehorende objecten om te animeren tussen hun oorspronkelijke en gewijzigde toestand.
Het volgende voorbeeld maakt een dia met een tekst‑rechthoek, kloont de dia, en wijzigt de positie en grootte van de rechthoek op de kloon. Daarna selecteert het Morph uit de TransitionType‑enumeratie voor de tweede dia. Open het opgeslagen bestand in een presentatiewer die Morph ondersteunt om het effect tijdens een diavoorstelling te zien.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide firstSlide = presentation.getSlides().get_Item(0);
IAutoShape rectangle = firstSlide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 100);
rectangle.getTextFrame().setText("Morph transition");
ISlide secondSlide = presentation.getSlides().addClone(firstSlide);
IShape movedRectangle = secondSlide.getShapes().get_Item(0);
movedRectangle.setX(movedRectangle.getX() + 100);
movedRectangle.setY(movedRectangle.getY() + 50);
movedRectangle.setWidth(movedRectangle.getWidth() - 200);
movedRectangle.setHeight(movedRectangle.getHeight() - 10);
secondSlide.getSlideShowTransition().setType(TransitionType.Morph);
presentation.save("morph-transition.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Morph‑overgangstypen
De enumeratie TransitionMorphType bepaalt hoe Morph inhoud overeenkomt en animeert:
- ByObject behandelt elke vorm als één geheel.
- ByWord animeert tekst door waar mogelijk woorden te matchen.
- ByChar animeert tekst door waar mogelijk tekens te matchen.
Gebruik setType om Morph te selecteren voordat je getValue benadert. De verkregen waarde levert de IMorphTransition‑interface, waarvan de setMorphType‑methode de overeenkomende modus selecteert.
import com.aspose.slides.*;
Presentation presentation = new Presentation("morph-transition.pptx");
try {
if (presentation.getSlides().size() >= 2) {
ISlideShowTransition transition = presentation.getSlides().get_Item(1).getSlideShowTransition();
transition.setType(TransitionType.Morph);
ITransitionValueBase transitionValue = transition.getValue();
if (transitionValue instanceof IMorphTransition) {
IMorphTransition morphTransition = (IMorphTransition) transitionValue;
morphTransition.setMorphType(TransitionMorphType.ByWord);
presentation.save("morph-by-word.pptx", SaveFormat.Pptx);
} else {
System.out.println("Morph transition options are unavailable.");
}
} else {
System.out.println("The input presentation must contain at least two slides.");
}
} finally {
presentation.dispose();
}
Overgangseffecten instellen
Sommige overgangen geven extra opties vrij, 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 juiste interface via getValue.
Het volgende voorbeeld past een Cut‑overgang toe op de eerste dia van input.pptx. Het roept setFromBlack aan via IOptionalBlackTransition zodat de overgang start vanaf een zwart scherm.
import com.aspose.slides.*;
Presentation presentation = new Presentation("input.pptx");
try {
ISlideShowTransition transition = presentation.getSlides().get_Item(0).getSlideShowTransition();
transition.setType(TransitionType.Cut);
ITransitionValueBase transitionValue = transition.getValue();
if (transitionValue instanceof IOptionalBlackTransition) {
IOptionalBlackTransition cutTransition = (IOptionalBlackTransition) transitionValue;
cutTransition.setFromBlack(true);
presentation.save("cut-from-black.pptx", SaveFormat.Pptx);
} else {
System.out.println("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 voortzettingsvertraging.
Kan ik audio aan een overgang toevoegen en laten herhalen?
Ja. Wijs ingesloten audio toe met setSound, geef StartSound uit de TransitionSoundMode‑enumeratie door aan setSoundMode, en activeer setSoundLoop met true. Het geluid blijft herhalen tot het volgende geluidsevenement 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 elke dia‑overgang. Stel eventuele 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.