Ken Burns Slideshow Effect

The Ken Burns effect is a type of panning and zooming effect used in video production from still imagery. The feature enables a widely used technique of embedding still photographs in motion pictures, displayed with slow zooming and panning effects, and fading transitions between frames.

You can use the Ken Burns effect for images in a slideshow. You just need to specify the starting and ending frames and duration.

🚧

Note

This effect is only compatible with mp4 outputs.

<query>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>AddMedia</action>
    <source>[SlideSource]?effect=kenburns&amp;direction=[EffectDirection]&amp;size=[SlideSize]&amp;duration=[Duration]&amp;transition=[on|off]</source>
    <source><!-- next slides --></source>
    <slideshow>1</slideshow>
    <format>
        <output>mp4</output>
        <size>[OutputSize]</size>
    </format>
</query>
{
    "query": {
        "userid": "[UserID]",
        "userkey": "[UserKey]",
        "action": "AddMedia",
        "source": [
            "[SlideSource]?effect=kenburns&direction=[EffectDirection]&size=[SlideSize]&duration=[Duration]&transition=[on|off]"
        ],
        "slideshow": "1",
        "format": {
            "output": "[OutputFormat]",
            "size": "[OutputSize]"
        }
    }
}
ParameterDescriptionAllowed ValuesDefault Value
directionStartX Left coordinate of the starting frame

StartY Top coordinate of the starting frame

StartWidth Starting frame width. Height would be calculated automatically.

EndX Left coordinate of the ending frame.

EndY Top coordinate of the ending frame.

EndWidth Ending frame width. Height would be calculated automatically.

EXAMPLES: 1. Image: 800×600; Starting frame width: 600; 10% zoom out from center. direction=100,75,600;70,53,660 2. Image: 800×600; Starting frame width: 600; 10% zoom in from center. direction=100,75,600;130,98,540 3. Image: 800×600; Starting frame width: 600; Move from left top corner to right bottom corner w/o zoom. direction=0,0,600;200,150,600 4. Image: 800×600; Starting frame width: 600; Frame at left side vertically centered zoom out to fill width. direction=0,75,600;0,0,800
[StartX],[StartY],[StartWidth];[EndX],[EndY],[EndWidth]

Positive Integer(in pixels)
None
sizeSpecify the image frame size.[Width]x[Height]None
durationSpecify the effect duration in seconds.Positive integerNone
transitionEnable fade transitions between slides.on, offNone