diff -r bc39b352897e -r 69c7080681bf gst_plugins_good/gst/avi/README --- a/gst_plugins_good/gst/avi/README Fri Jul 09 16:26:45 2010 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,72 +0,0 @@ -The avi decoder plugins ------------------------ - -The avi decoder consists of a set of gstreamer plugins: - - - demuxer (avidemux) - - avi to gstreamer type converter (avitypes) - - windows dlls wrappers. - -the avidecoder element uses the above plugins to perform the avi -decoding. It is constructed as a custom bin which initially only has -the demuxer element in it. The demuxer has a set of padtemplates for -raw audio and video. - - (------------------------------------) - ! avidecoder ! - ! (video/raw)... - ! (----------) ! - ! ! demuxer (video/x-msvideo, auds).. - ! ! ! ! - ! -src ! ! - ! / ! (video/x-msvideo, vids).. - - src ! ! ! - ! (----------) (audio/raw)... - ! ! - (------------------------------------) - -the demuxer has a set of padtemplates for the raw avi header properties. - -The avi decoder will act on the new_pad signal of the demuxer element -and will attach an avitype plugin to the new pad. Caps negotiation will -convert the raw avi caps to the gstreamer caps. If the src pad of the -avitypes plugin are compatible with the avidecoder padtemplate, the -avitype pad is ghosted to the avidecoder bin, this is the case where no -codec is needed (for raw PCM samples, for example). - -When the avitypes caps are not compatible with one of the avidecoder -templates, a static autoplugger is used the find an element to connect -the demuxers pad to the decoders padtemplate. - -When no element could be found, an windec plugin is attached to the -demuxers pad and the avitypes plugin is removed from the decoder. - - -example: --------- - - An avidecoder that has a video pad (decoded with windows dlls) and an - audio pad (raw PCM). - - (----------------------------------------------------------------) - ! avidecoder (--------) (------) ! - ! !avitypes! !windec! /-- (video/raw) - ! (----------) /-sink src--sink src ----- ! - ! !demuxer (video/x-msvideo, ! ! ! ! - ! ! ! auds).. (--------) (------) ! - ! -sink ! (--------) ! - ! / ! (video/x-..,!avitypes! ! - -sink ! ! vids).. ! ! ! - ! (----------) \-sink src -------------------- (audio/raw) - ! (--------) ! - (----------------------------------------------------------------) - - - -TODO ----- - -automatically generate the padtemplates from all possible avi types -found in the registry. - -