APTR handle = BeginAnimStream(STRPTR filename, int width, int height, int format, int quality, int fps);
format parameter specifies the pixel format of the source frame data that will
be passed by WriteAnimFrame() later. This can be one
of the following constants:
You will only have to handle those formats that you have explicitly declared as supported when Hollywood called your RegisterAnimSaver() function.
quality parameter contains a value between 0 and 100 indicating the desired quality for the output
file. Animation formats that use lossy compression can use this member to determine compression
settings for the animation. Animation formats that don't use any compression or offer lossless
compression can ignore this parameter.
fps parameter contains the desired playback rate for the animation in frames
per second. This is not supported by all animation formats so you can ignore it
if you want. Some animation formats also support a frame-based delay value that
Hollywood will pass to you in its WriteAnimFrame() calls.
Please note that in case your plugin supports multiple output animation formats,
you'll have to wait until the first call to WriteAnimFrame()
on that stream until you can tell which format the user has chosen for the stream.
This inconvenience is due to a design flaw in Hollywood: Support for multiple output
animation formats wasn't available before Hollywood 5.3 but the API was designed for
Hollywood 5.0. So there's just no room for another parameter in the
prototype declaration because it doesn't accept a tag list or any other parameter that
could by dynamically extended as Hollywood functionality increases. Thus, you'll have
to wait until WriteAnimFrame() which gives you the information
FormatID structure member.
This function has to return a handle to the stream if the animation has been successfully
NULL if there was an error.
NULLin case of an error