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><<id>></userid> <!-- required-->
    <userkey><<key>></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": "<<id>>",
        "userkey": "<<key>>",
        "action": "AddMedia",
        "source": [
            "[SlideSource]?effect=kenburns&direction=[EffectDirection]&size=[SlideSize]&duration=[Duration]&transition=[on|off]"
        ],
        "slideshow": "1",
        "format": {
            "output": "[OutputFormat]",
            "size": "[OutputSize]"
        }
    }
}

Parameter

Description

Allowed Values

Default Value

direction

StartX 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

size

Specify the image frame size.

[Width]x[Height]

None

duration

Specify the effect duration in seconds.

Positive integer

None

transition

Enable fade transitions between slides.

on, off

None