SWF::VideoStream(3)

NAME
SWF::VideoStream - SWF Video class

SYNOPSIS
        use SWF::VideoStream;
        $videostream = new SWF::VideoStream("test.flv");

DESCRIPTION
SWF::VideoStream is a helper class useful for playing videos via SWF applications, either via embedded video data, or controlled by ActionScript.

METHODS

$videostream = new SWF::VideoStream($filename)
    Creates a SWF::VideoStream object. If the file can't be opened the constructor will return an empty object. The filename is not limited to 'flv' extension.

$frames = $videostream->getNumFrames()
    This method returns the number of video-frames of an object of SWF::VideoStream, this works only for embedded streams. In case of error you will get result of -1.

$videostream->setDimension(width, height)
    This method sets width and height for streamed videos, this works only on streamed videos (progressive download or rtmp).

$bool = $videostream->hasAudio()
    A test whether the embedded FLV stream also has audio data.

$videostream->setFrameMode($mode)
    If the mode == SWFVIDEOSTREAM_MODE_AUTO (default) on every SWF movie frame a video frame is added. In SWFVIDEOSTREAM_MODE_MANUAL mode, the user needs to call the nextFrame() method to change the video's frame. This works only with embedded video streams. Does return the previous mode or -1 if an invalid mode was passed.

$result = $videostream->nextFrame()
    Switch to next video frame. Works only with embedded video streams. Returns -1 if an error happend. Here follows some demo code how to use SWF::VideoStream objects (without ActionScript):

            use SWF qw(:ALL);                       # to be lazy
            $movie = new SWF::Movie();
            $movie->setRate( 25 );
            # $movie->setRate( 5 );                 # e.g. 5 for slow motion
            # here movie set background etc. etc.
            #
            $video=new SWF::VideoStream('MyTestVideo.flv');
            die if (-1 == $v->getNumFrames());      # abort if something went wrong
            #
            $video->setFrameMode(SWF::Constants::SWFVIDEOSTREAM_MODE_MANUAL);
            $video->seek(1000, 0);                  # for example only
            $displayitem = $movie->add($video);
            #
            # 250 for a 10 seconds movie part (at rate of 25 per minute)
            for(my $n = 0; $n < 250; ++$n)
            {
             $video->nextFrame();
             $movie->nextFrame();
            }
            $movie->save("MyTestVideo.swf",9);
            # that's all, folks

$result = $videostream->seek($frame, $whence)
    This functions allows seeking $frame in video stream, returning the old video frame position. As value of $whence use one of the following:

            0 for seeking from beginning
            1 for seeking from current position
            2 for seeking from end of file

AUTHOR
        developers of ming
        ming.sourceforge.net

SEE ALSO
SWF, SWF::Action, SWF::Movie, SWF::MovieClip, SWF::Sound, SWF::SoundStream, SWF::Constants