Hantera bildövergångar i presentationer på Android

Översikt

Bildövergångar styr hur bilder visas under ett bildspel. Med Aspose.Slides för Android via Java kan du välja en övergångseffekt för varje bild, konfigurera avancemang med musklick eller timer och justera alternativ som är specifika för en effekt. Denna artikel använder Java‑exempel för att tillämpa övergångar, ange exakt övergångstid, hantera bildtid och skapa en Morph‑övergång mellan två bilder. Exemplen visar också hur du sparar inställningarna i en PPTX‑fil.

Lägg till bildövergång

För att tillämpa en övergång, läs in en presentation med klassen Presentation och kom åt bildens övergångsinställningar via getSlideShowTransition. Använd setType med ett värde från uppräkningen TransitionType, spara sedan presentationen.

Följande exempel tillämpar en Circle‑övergång på den första bilden och en Comb‑övergång på den andra. Använd en input.pptx‑fil med minst två bilder.

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();
}

Wheel‑övergång

Metoden setSpokes i IWheelTransition styr antalet radiala sektorer som avslöjar målbilden. Ställ in bildens övergångstyp till Wheel från TransitionType med setType innan du når getValue via IWheelTransition.

Detta exempel skapar två identiska bildpar: en svart bild följd av en bild med en gul rektangel. Målbilderna använder spokantal 1 respektive 8, med samma hastighet inställd via setSpeed och en explicit varaktighet på 8 000 ms satt med setDuration för att göra skillnaden lätt att observera.

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();
}

Öppna den skapade presentationen i PowerPoint och kör bildspelet. Gå från bild 1 till bild 2, sedan från bild 3 till bild 4. I PowerPoint‑uppspelning visar det verifierade spokantalet 1 bilden med en medurs svepning; det verifierade antalet 8 avslöjar den genom åtta radiala sektorer samtidigt. Bildinnehållet och övergångstiden är identiska, så skillnaden är antalet avslöjandesektorer.

Lägg till avancerad bildövergång

Du kan konfigurera hur länge en bild visas på skärmen och om ett musklick avancerar bildspelet. Följande metoder styr detta beteende:

Aktivera både klick‑ och tidsbaserat avancemang så att åskådaren kan gå vidare med ett klick eller vänta på timern. För att bara använda timern, skicka false till setAdvanceOnClick. Fördröjningen styr när bildspelet avancerar; den sätter inte varaktigheten för den visuella övergångseffekten.

Detta exempel tilldelar olika effekter till de tre första bilderna och aktiverar automatiskt avancemang efter 3, 5 respektive 7 sekunder. Musklick kan också gå vidare på dessa bilder. Använd en input.pptx‑fil med minst tre bilder.

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();
}

För att kontrollera om tidsbaserat avancemang är aktiverat, anropa getAdvanceAfter. En lagrad fördröjning betyder inte att timern är aktiv.

Nästa exempel öppnar filen som sparades ovan, rapporterar varje aktiverad timer och inaktiverar automatiskt avancemang för bilder med en fördröjning längre än två sekunder. Det aktiverar musklick för dessa bilder och sparar de uppdaterade inställningarna.

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();
}

Styr övergångstid exakt

Använd setDuration för att ange exakt längd för en övergångseffekt i millisekunder. Bildens getSlideShowTransition‑metod exponerar dessa inställningar via ISlideShowTransition:

Metod Syfte
setDuration Anger varaktigheten för själva övergångseffekten, i millisekunder.
setAdvanceAfterTime Anger fördröjningen innan bilden avancerar automatiskt, i millisekunder. Skicka true till setAdvanceAfter för att aktivera timern.
setSpeed Väljer en fördefinierad hastighetskategorin från TransitionSpeed: Slow, Medium eller Fast. Den används när ingen exakt varaktighet anges.

setDuration styr endast övergångseffekten; den avgör inte hur länge bilden förblir synlig. Konfigurera den automatiska fördröjningen separat. När ingen explicit varaktighet anges bestämmer Aspose.Slides effektens varaktighet utifrån övergångstypen och värdet från getSpeed.

Separata staplar identifierar 750 ms övergångstid och 5 000 ms automatisk avanceringsinställning.

Det delade exemplet ger varje bild en 750 ms Fade‑övergång och aktiverar separat automatisk avancerning efter 5 000 ms. Övergångstiden styr effekten; avancemanget styr när bilden lämnas. Dessa staplar är schematiska inställningar, inte en uppmätt kombinerad tidslinje.

Tillämpa samma varaktighet på alla bilder

För en enhetlig takt, tillämpa samma effekt och exakt varaktighet på varje bild. Detta exempel läser input.pptx, väljer Fade från TransitionType, och ger varje övergång en varaktighet på 750 ms. Det aktiverar också automatiskt avancemang efter 5 000 ms och inaktiverar avancerning med musklick, för att sedan spara resultatet som PPTX.

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);

        // Konfigurera automatisk avancerning oberoende av effektens varaktighet.
        transition.setAdvanceAfter(true);
        transition.setAdvanceAfterTime(5000);
        transition.setAdvanceOnClick(false);
    }

    presentation.save("precise-transitions.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Ange olika varaktigheter för enskilda bilder

Olika bilder kan använda olika effektvaraktigheter. Till exempel kan en titelbild ha en kort övergång och en sektionintroduktion en längre. Detta exempel sätter 500 ms för den första bilden och 1 200 ms för den andra. Använd en input.pptx‑fil med minst två bilder.

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();
}

Koordinera övergångar med animerad export

När du förbereder en animated GIF, en HTML5 presentation, eller en video, ange exakta övergångstider före export för att matcha den avsedda takten. Till exempel, använd en 600 ms fade mellan scener och justera varje bilds avanceringsfördröjning separat så att det finns tid för berättarröst eller innehåll.

För GIF och video, samordna bildfrekvensen med effektens varaktighet: 600 ms motsvarar 18 bilder vid 30 fps. I HTML5, aktivera animerade övergångar i exportinställningarna. Kontrollera vilka övergångar och tidsalternativ som stöds av det valda exportformatet, och förhandsgranska resultatet för att bekräfta synkronisering.

Läs en befintlig övergångsvaraktighet

Anropa getDuration innan du ändrar övergången för att avgöra om ett explicit värde lagras. Ett värde på -1 betyder att ingen explicit varaktighet är satt; ett icke‑negativt värde anger den lagrade varaktigheten i millisekunder. Det odefinierade värdet är inte den beräknade uppspelningsvaraktigheten: Aspose.Slides använder övergångstypen och värdet från getSpeed för att bestämma den varaktigheten. Att ange en övergångstyp kan initiera en varaktighet, så inspektera de ursprungliga inställningarna först.

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‑övergång

Morph‑övergången animera förändringar mellan objekt på på varandra följande bilder. För att skapa en enkel Morph‑effekt, klona en bild, flytta eller ändra storlek på ett objekt på klonen och applicera Morph‑övergången på den andra bilden. Detta ger övergången motsvarande objekt att animera mellan deras ursprungliga och modifierade tillstånd.

Följande exempel skapar en bild med en textruta, klonar bilden och ändrar rektangelns position och storlek på klonen. Därefter väljer den Morph från uppräkningen TransitionType för den andra bilden. Öppna den sparade filen i en presentationsvisare som stödjer Morph för att se effekten under ett bildspel.

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‑övergångstyper

Uppräkningen TransitionMorphType styr hur Morph matchar och animerar innehåll:

  • ByObject behandlar varje form som ett helt objekt.
  • ByWord animera text genom att matcha ord där det är möjligt.
  • ByChar animera text genom att matcha tecken där det är möjligt.

Använd setType för att välja Morph innan du når getValue. Värdet ger sedan gränssnittet IMorphTransition, vars metod setMorphType väljer matchningsläget.

Detta exempel öppnar presentationen som skapades i föregående avsnitt och konfigurerar den andra bilden att använda ord‑baserad Morph‑animation.

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();
}

Ange övergångseffekter

Vissa övergångar avslöjar ytterligare alternativ, såsom riktning eller om effekten startar från en svart skärm. De tillgängliga alternativen beror på övergången som valts med setType. Ställ in typen först, och använd sedan rätt gränssnitt från getValue.

Följande exempel tillämpar en Cut‑övergång på den första bilden i input.pptx. Det anropar setFromBlack via IOptionalBlackTransition så att övergången startar från en svart skärm.

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 jag styra uppspelningshastigheten för en bildövergång?

Ja. Föredra setDuration när du behöver en exakt effektvaraktighet i millisekunder. Använd setSpeed när en fördefinierad TransitionSpeed‑kategori — Slow, Medium eller Fast — räcker och ingen explicit varaktighet är angiven. Dessa inställningar styr övergångseffekten oberoende av den automatiska avanceringsfördröjningen.

Kan jag bifoga ljud till en övergång och låta det loopa?

Ja. Tilldela inbäddat ljud med setSound, skicka StartSound från uppräkningen TransitionSoundMode till setSoundMode, och aktivera setSoundLoop med true. Ljudet loopas tills nästa ljudhändelse i bildspelet.

Vad är det snabbaste sättet att applicera samma övergång på varje bild?

Iterera genom presentationens getSlides‑samling och anropa setType med samma värde för varje bilds övergång. Ställ in eventuella tider och effektalternativ i samma loop för att hålla beteendet konsekvent över alla bilder.

Hur kan jag kontrollera vilken övergång som för närvarande är inställd på en bild?

Anropa getType på resultatet från bildens getSlideShowTransition. Den returnerar ett värde från uppräkningen TransitionType; None betyder att ingen övergångseffekt är tillämpad.