effects

2009-03-26T00:07:28+02:00

Common Parameters: Name Default value Possible values duration 5.0 float timeOffset 0.0 float Diving Type: "diving" Parameters: No specific parameter. Children: The number of authorized children is in [1, 100]. Example:

fonts

2009-07-22T18:01:39+02:00

List of available fonts for the "fontname" text attribute * arial * arialbold * arialroundedmtbold * comicsansms * couriernew * landspeedrecord * saddlebag * timesnewroman * verdana

geometricanimations

2010-12-02T16:41:47+02:00

Geometric animators can be inserted in any node that is drawn or any container * sequence (or body, which is only the top level sequence) * stack * effect * text * overlay * widget * sphere * camera A arbitrary number of animators can be stacked in the same node. The geometric transformations will be then applied in the given order, except for the camera where the order is reversed (see the camera reference for more information).

gmapsimage

2009-12-18T21:00:26+02:00

You can create Google Maps image inline in the API. The arguments are center (latitude longitude), zoom (see google maps api), pixel size and an optional list of markers. You can select the map type through the maptype argument (“map”, “hybrid”, “satellite”) .

hbestmblur

2011-06-24T12:01:34+02:00

Faking Motion blur Motion blur is a very nice feature that gives an eye candy effect on moving objects. The dark side of Motion blur is that it's really heavy to process and can have a huge impact on render times. For this reason we don't support Motion blur on Stupeflix.

hbesttips

2011-08-08T16:55:59+02:00

Tips and tricks This page is still under heavy re-construction. Content to be added soon. ---------- ---------- " " << Prev Next >> " " ---------- ---------- " " Back to Table of Content" "

hcreatebezier

2012-04-17T11:06:44+02:00

Bézier curves and Expressions Expressions, Bezier curves and Hold keyframes are not natively supported by our engine, but they can easily be turned into linear keyframes while preserving ease. For layers with Bezier Curves, just Alt-Clic on the property stopwatch to create an expression and press the numeric keypad Enter key. Now select the property and go to:

hcreatecamp

2011-06-23T01:22:33+02:00

Designing a template for a personalized video ad campaign When you are designing a video for an advertising campaign, unlike a Studio Template, you are doing the storytelling for the user, but you allow him/her to somehow interact with your story by customizing the video.

hcreatecompat

2011-10-18T19:06:10+02:00

Creating a Stupeflix Compatible Project So here comes the tricky part: creating a project that is compatible with our render engine. Creating projects for Stupeflix calls for a slight change of design paradigm. I'll try to explain this on this page, along with general technical stuff. You'll find on separate pages more information on selected (and important) topics.

hcreateeffect

2011-12-07T12:49:22+02:00

Supported Effects We currently support this list of effects: * Fast Blur * Exposure * Directional Blur * Tint * Tritone * Threshold * Hue/Saturation * Ramp " " " " Support Details Fast Blur * Bluriness: supported and keyframable * Blur Dimensions: supported but not keyframable * Repeat Edge Pixels: ignored

hcreatefootage

2011-06-16T16:23:52+02:00

Supported Files Graphical Assets: * Png files * Jpeg files Video Assets: * h264 files in *.mp4, *.flv, *.f4v or *.mov container * QT Animation files * on2 VP6 files, including Alpha channel, in *.flv container If you use a special font file in your project, and if you have the correct licences, we need to install them separatly on our servers. We support *.otf or *.ttf files as long as they don't have any special character in their filename, or in their font name.

hcreateintro

2011-07-04T11:51:06+02:00

Introduction to After Effects Adobe After Effects is a widespread animation and compositing program, or, to put it another way, it's kind of Photoshop for video. If you don't have After Effects yet, or need more information about this product, you can check its dedicated page on Adobe.com, or directly download a 30 day trial version.

hcreatephtag

2011-08-31T18:15:48+02:00

Placeholder and Tagging As After Effects was not designed to have dynamic content generated from an external source, we need to specify in the project where the user content will be. We have 2 types of content, graphical content such as maps, pictures and videos, and text content. Both are tagged the same way, but are handled slightly differently.

hcreatescript

2012-04-23T17:55:55+02:00

Validating your Project with the SxC Validator Script In order to help you make sure that your project is compatible with our engine, we've built an After Effects Script that will scan your project and report any error it encounters. Current version is 2.0 beta (Released April 23rd 2012).

hcreateslice

2011-09-01T18:28:26+02:00

Slicing-up your project for widgetization If you're doing a Studio Template, you project might already be spliced up into different Widgets, as described in our Designing a template for the Studio page. ---------- ---------- " " << Prev Next >> "

hcreatetemp

2011-06-23T01:20:23+02:00

Designing a template for the Studio When designing a Studio Template, it is important to keep in mind that it is the user who is storytelling his video, not you. Depending on what the user wants, and what the user wants to say, we will choose programmatically one widget or another. The most important aspect of your template is visual coherence. You don't know in what order, or in what combination your widgets will be used, so it's essential that they all have a consistent look & feel, and most …

hcreatetrans

2011-07-07T17:27:02+02:00

Creating a transition Widget A transition widget is created like any other After Effects project, but the way it's used in our engine requires some extra carefullness and involves some extra work. Transition Widgets have 2 graphical placeholders: * One for the input video * One for the output video

hcreateunsupp

2011-08-01T11:44:24+02:00

Unsupported Features As we continuously improve our rendering engine, we try to integrate more and more features. Sadly, the list below is still unsupported in our current engine: * Effects (except those mentioned here) * Masks * Time Remapping * Lights Layers * Shape Layers * Layer Styles * Adjustement Layers * 3D Material Options * Photoshop Live Layers * Photoshop 3D Layers * Blending Modes * Collapse Transformation * Motion Blur * Assets larger than 4096x4096 *…

help

2012-04-23T17:03:38+02:00

Welcome to our main documentation page about After Effects. This is a great place to start building your own AE projects to be used in Stupeflix with our render engine. This documentation is our little living thing, it regularly evoles and we feed it as regularly as we can. If you have any questions regarding the AE docs, feel free to drop me an email at seb (at) stupeflix [dot] com.

hintroaccount

2011-06-16T14:38:26+02:00

Creating an account Even if you don't need to create an account to play around with our online Studio, you'll need one to use our XML editor and request an API key. You can sign-up for a free account here. ---------- ---------- " " << Prev Next >> "

hintroapi

2011-06-17T17:25:42+02:00

Requesting an API key If you haven't created an account yet, you will need one to be able to request a Stupeflix API key. * Once your account is created, request your key here. * More information about our API, and the Developer Kit here. * More information about account creation here.

hintrostup

2011-06-16T14:54:13+02:00

What is Stupeflix ? Stupeflix is a mass video creation tool, based on an API. You have two ways to interact with Stupeflix: * You can use our online studio to make your home videos, one at a time. * You can use our API to build your video and automate it's production.

hintrowork

2011-06-16T14:55:56+02:00

How does it work ? The way Stupeflix works is really simple. You write a video definition in XML format and send it to our render engine. We then send you back a video. The XML video definition is composed of video widgets, effects, transitions, audio and source files. You can generate your XML via a web form, a smartphone App, or whatever you want.

hmixaudio

2011-10-18T17:15:31+02:00

Audio Audio is not directly supported in our conversion process as widgets inside Stupeflix are mute. What you have to do, if you have audio in your project (like sound effects or music) is to render out a wav or an mp3 file of the audio and include it in your project.

hmixeffect

2011-07-06T15:24:09+02:00

Applying XML filters Filters are effects that you can apply on your assets and even on your Widgets. The most used ones are: * Alpha * Colormap * GaussianBlur * Glow * Kenburnsadapter You can dig the full list here. " " " " Basics of an XML Definition Before applying an effect, let's have a quick look at the heart of the XML defintion. Let's see that with a simple picture.

hmixmodif

2011-07-06T17:19:05+02:00

Applying modifications to AE Widgets With After Effects Widgets, we have introduced some features to give you slightly more control on how it will look: * You can hide a layer (any layer) * You can change the color and the opacity of any solid layers

hmixstack

2011-08-08T16:55:32+02:00

Widget Stacking This page is still under heavy re-construction. Content to be added soon. ---------- ---------- " " << Prev Next >> " " ---------- ---------- " " Back to Table of Content" "

hmixtrans

2011-09-26T14:44:46+02:00

Applying transitions Until now we have seen how to modify a Widget inside an XML definition, and now it's tiime to see how to put several Widgets one after another, with and without transitions. " " " " Putting two bricks together Putting two Widgets together is as easy as putting them one after another in the section of your XML definition. Let's have a closer look by remixing this project.

hmixxml

2012-04-23T17:59:23+02:00

The XML Editor The XML Editor is our home to test your XML definitions. An XML definition is usually a list of widgets, may they be from an After Effects project or a build-in Widget, and a list of assets to fill the placeholders. If you've designed a video ad campaign, your XML definition will mainly be an ordered Widget succession.

hoptimasize

2012-04-23T18:26:41+02:00

Assets size As you may have read in our Unsupported Features page, we don't allow graphical assets larger than 4096 pixel in width and/or 4096 pixel in height. That is also true for your composition sizes. This limatation is due to graphic card memory and Open GL drivers to ensure best performances.

hoptimconv

2011-09-01T18:31:16+02:00

Naming Convention We need your layers to avoid special characters in their name to be properly used within an XML context (changing layer color, hiding a layer....). Please, only use [a-z][A-Z][0-9] along with “_” in your layer names. ----------

hoptimdepth

2012-04-25T12:00:07+02:00

Depth and Matte The most render time intensive elements in an After Effects project are depth of the composition nesting, and the trackmattes. And the more you nest both, the bigger the render hit. Matting a precomp is something sometimes you can't avoid, but matting a precomp which already have matting inside will be killing the render time. If on top of that your precomps are exceeding the recommanded max size of 2048×2048 it will get ugly.

hoptiminout

2011-08-08T16:54:09+02:00

Start/End Points - In/Out Points In After Effects, each layer have 2 starting points and 2 ending points. By default, they are the same, but sometimes you might need to change them, and they'll become out of sync. If that's not a problem for the ending / out point, our engine will struggle if the Starting / In point are different. But what are those points ?

hoptimpre

2011-06-21T15:56:24+02:00

Pre-Rendering Proxies and pre-rendering are really usefull when you have a bunch of layers with motion blur and effects that are not supported by our engine. They can also be used to reduce the amount of layers and effects to be processed by our engine, resulting in faster rendering times.

howto

2009-07-15T21:52:31+02:00

* How to use the php class StupeflixDefinition * How can I create several video elements to be displayed together but with different start time ? * How to use overlays ?

howtouseoverlays

2009-07-15T22:53:20+02:00

Just add the overlays at the end of a stack element, so they will be drawn on top of the others stack elements. Sample XML file : > " " ---------- ---------- " " Back to Table of Content" "

hpipemod

2011-08-08T16:41:21+02:00

Modifications This page is still under heavy re-construction. Content to be added soon. ---------- ---------- " " << Prev Next >> " " ---------- ---------- " " Back to Table of Content" "

hpipestock

2011-08-08T16:40:08+02:00

Using our stock Widgets This page is still under heavy re-construction. Content to be added soon. ---------- ---------- " " << Prev Next >> " " ---------- ---------- " " Back to Table of Content" "

hpipestup

2011-10-18T17:01:44+02:00

Stupeflixion of your Project This process is not automated yet, but is aimed to be in a forseable future. * Once you have created your After Effects project following our guidelines, you will have to run our validation script to make sure that everything is ok. * If everything is ok, you will have to send us your project in a zipped folder. For that simply select your main composition and go to File > Collect Files. Make sure to include all the needed assets. * I recommand running the…

hpipetest

2011-08-08T16:40:41+02:00

Live Testing This page is still under heavy re-construction. Content to be added soon. ---------- ---------- " " << Prev Next >> " " ---------- ---------- " " Back to Table of Content" "

inputurlprotocols

2009-03-11T12:05:35+02:00

Supported protocols (for filename xml attributes) : * HTTP * HTTPS

maskingtutorial

2010-12-01T16:07:01+02:00

Masking and Keying are very important compositing operators. They are used everywhere, from the weather forecast clip to blockbusters. The basic idea is to let a given color become transparent when you compose an image on top another one. There are two ways to proceed in the SXML language.

notification

2011-12-02T11:27:40+02:00

Principle Notification is an option when declaring the profiles to be generated. This will enable pinging to a fixed url with information on the current state of processing for a given profile. Notification messages are sent for each of the parts of the video generation process. You can select a maximum frequency for pings for parts sending multiple message. Default is 10 seconds.

overlaytutorial

2009-07-15T22:50:22+02:00

Overlays are just like text nodes. They can be placed on screen using CSS like parameters : - top, bottom, left, right - width, height The only difference with text nodes is that you can add to them an image or a video: the aspect ratio of the image/video will be kept, so the overlay may not be completely filled by its content.

phpstupeflixdefinition

2009-03-11T12:05:35+02:00

How to use the StupeflixDefinition PHP class (in stupeflix.php). // Set the zip file name $zipfile = "movie.zip"; // Create the helper class $definition = new StupeflixDefinition($zipfile); // Add the definition file : in the zip, it will be called movie.xml $definition->setDefinitionFile($filename) // Add some media $definition->addImage("lena.png"); $definition->addVideo("movie.mpg"); // Finalize the zip file $definition->finalize(); // You can now use the zip file with stupeflix client, a…

profiles

2010-08-17T12:37:24+02:00

profile namewidth x heightframeratevideo bit rateaudio bit ratevideo/audio codecsfile extensioniphone480×320 25 fps 700k 96k h264/aac mp4 youtube640×360 25 fps 1024k 128k h264/aac mp4 quicktime640×480 25 fps 1024k 128k h264/aac mp4 quicktime-small320×240 25 fps 256k 64k h264/aac mp4 flash-small320×240 25 fps 192k 64k flv/mp3 flv iphone-flv480×320 25 fps 1024k 96k flv/mp3 flv youtube-flv640×360 25 fps 1700k 128k flv/mp3 flv flash640×480 25 fps 512k 96k flv/mp3 flv flash-hq…

restapi

2010-03-01T23:39:06+02:00

REST The API is RESTful. That's fine, it means it's easy to create client libraries for a lot of different languages. But it's clearly not enough to know how to use the API ... URL Schema Parameters * Date * AccessKey * Signature Available resources The REST philosophy says that everything should be a resource. So here is the list of resources:

start

2011-10-25T17:40:51+02:00

Welcome to the stupeflix developer center. Here you will find all the documentation to use the Stupeflix services. If you find any error or need some additional information, please contact us! You will need access keys to use the sample code and client libraries: sign up and start using the Stupeflix API now !

stupeflixapi1.0codesamples

2010-05-21T22:44:11+02:00

stupeflixapiuploadtargets

2011-12-02T11:30:00+02:00

Introduction Using the Stupeflix API, you can choose the kind of video you want to generate, through a XML file which is send by POST by the createProfiles function. But in the same call, you can choose too to upload the video to several targets : Amazon S3 bucket, http server, and even YouTube, Facebook or Dailymotion.

stupeflixnewapirequests

2009-03-11T12:05:35+02:00

Please propose here new services to be included in the Stupeflix APIs set !

stupeflixxmlintroduction

2009-08-21T00:52:26+02:00

Introduction The Stupeflix Video Description Language is an XML language (called SXML below). It is intended to be as simple as possible to create videos, yet powerful enough to allow complex projects. It was designed around several fundamental ideas :

stupeflixxmltimemargins

2010-12-02T18:17:33+02:00

Duration computation is an important part of the Stupeflix Video XML Language processing. Margins are there to position in time the different parts of a video. The three parameters are called margin-start margin-end and margin-both Margins are relative to a container. This container can be anything except a sequence (or body, which is a sequence too).

supportedformats

2008-12-01T16:06:06+02:00

* Supported protocols for assets (filename attribute in xml). * Available video profiles * Assets and formats

templates

2010-01-11T19:06:24+02:00

A Stupeflix template is basically an url who takes a data structure on input and returns a ready to render Stupeflix's XML chunk. Stupeflix templates can be written in any language and hosted everywhere. Today 2 types of templates are used at Stupeflix:

test

2009-12-09T11:37:54+02:00

Test

testauto

2009-03-25T23:51:47+02:00

This is another test

texteffects

2011-09-28T21:49:01+02:00

Legend Type attribute for the text tag: “legend”. Your text here. Common attributes for all tags with type “legend” : * direction : possible values : “up”, “left”, “right” * fontname : name of the font or a link to the ttf or otf font like “” * fontcolor : color of the font * backgroundcolor : color of the background * height : float between 0.0 and 1.0, gives the proportion of the scre…

texteffectstutorial

2010-01-21T18:05:27+02:00

Warning: this is still a bit experimental. It will be supported in next releases, so you can use it right now for production deployment. Rendering quality will be improved for specific cases, but it is already a large improvement compared to the previous bitmap based method, as text rendering is now vector-based on a frame-by-frame basis.

transitions

2009-03-11T12:05:35+02:00

Common Parameters: Name Default value Possible values duration 1 float Circle Type: "circle" Parameters: No specific parameter. Example: Crossfade Type: "crossfade" Parameters: No specific parameter.

troubleshooting

2009-03-11T12:05:35+02:00

"API Call is too old" Each call to the API is signed, and the date is part of the query. This is intended to avoid replay attacks (someone saw your request on the network and would like to re-do the same request on another time). So each query is valid for a limited amount of time, typically 15 minutes. Several cases may lead to that error: - you tried to use a profile url, to play a video for example, after the 15 minutes delay - the machine that issued the request as incorrect time settings

videoalphalayer

2011-02-22T12:14:56+02:00

Maybe be you have some video assets that have been keyed, for example shot on a green background then postprocessed to turn the green channel into transparent. Or maybe you bought some pre-keyed asset on Toolfarm, .

videocontenttutorial

2010-06-10T20:58:16+02:00

You can use you own videos in a Stupeflix XML script. Just add a tag instead of an image tag. Sample XML movie: Audio is enabled by default, and volume is 1.0 . You can skip N seconds, and change the video playing speed too.

videotoolkitapi

2011-08-16T19:27:35+02:00

The Stupeflix Video Toolkit API allows you to perform various image & videos operations using simple http(s) POST and GET requests. Authentication The Video Toolkit API authentication relies on https and use an ACCESS_KEY + APP_SECRET to identify the client app. ACCESS_KEY and APP_SECRET are available by request to Stupeflix. The APP_SECRET should not be shared with anyone or embedded in any code that you will distribute. On the other hand your ACCESS_KEY can be exposed.

widgets

2010-05-21T18:23:13+02:00

(coming soon)

workflow

2009-05-22T16:57:46+02:00

The sequence of operations to create a video is : * sendDefinition : create a new definition file * createProfiles : launch generation of a video profile, that means a video based on the definition but with given size, codec, bitrate and specific settings for notification, uploads etc.

zippedmoviefiles

2010-03-01T23:48:15+02:00

Here is a sample zip file. Each asset kind must be stored in its own sub-directory: images, audios, videos, fonts At the root of the zip file you must add a movie.xml file conforming to the Stupeflix Video XML Language and describing the video. The assets are named in the movie.xml file without specifying their directory prefix:

Stupeflix Developer Center

advancedtextrendering

advancedtextrenderinglayout

advancedtextrenderingstyle

animatorstutorial

assetsformats

audiotutorial

coca

craftsmanapi1.0

developerkit

ebusinessvideotutorial

effects

fonts

geometricanimations

gmapsimage

hbestmblur

hbesttips

hcreatebezier

hcreatecamp

hcreatecompat

hcreateeffect

hcreatefootage

hcreateintro

hcreatephtag

hcreatescript

hcreateslice

hcreatetemp

hcreatetrans

hcreateunsupp

help

hintroaccount

hintroapi

hintrostup

hintrowork

hmixaudio

hmixeffect

hmixmodif

hmixstack

hmixtrans

hmixxml

hoptimasize

hoptimconv

hoptimdepth

hoptiminout

hoptimpre

howto

howtouseoverlays

hpipemod

hpipestock

hpipestup

hpipetest

inputurlprotocols

maskingtutorial

notification

overlaytutorial

phpstupeflixdefinition

profiles

restapi

start

stupeflixapi1.0codesamples

stupeflixapiuploadtargets

stupeflixnewapirequests

stupeflixxmlintroduction

stupeflixxmltimemargins

supportedformats

templates

test

testauto

texteffects

texteffectstutorial

transitions

troubleshooting

videoalphalayer

videocontenttutorial

videotoolkitapi

widgets

workflow

zippedmoviefiles