~ubuntu-branches/ubuntu/karmic/gnash/karmic

« back to all changes in this revision

Viewing changes to libcore/asobj/README.NetStream

  • Committer: Bazaar Package Importer
  • Author(s): Alexander Sack
  • Date: 2008-10-13 14:29:49 UTC
  • mfrom: (1.1.9 upstream)
  • Revision ID: james.westby@ubuntu.com-20081013142949-f6qdvnu4mn05ltdc
Tags: 0.8.4~~bzr9980-0ubuntu1
* new upstream release 0.8.4 (LP: #240325)
* ship new lib usr/lib/gnash/libmozsdk.so.* in mozilla-plugin-gnash
  - update debian/mozilla-plugin-gnash.install
* ship new lib usr/lib/gnash/libgnashnet.so.* in gnash-common
  - update debian/gnash-common.install
* add basic debian/build_head script to build latest CVS head packages.
  - add debian/build_head
* new sound architecture requires build depend on libsdl1.2-dev
  - update debian/control
* head build script now has been completely migrated to bzr (upstream +
  ubuntu)
  - update debian/build_head
* disable kde gui until klash/qt4 has been fixed; keep kde packages as empty
  packages for now.
  - update debian/rules
  - debian/klash.install
  - debian/klash.links
  - debian/klash.manpages
  - debian/konqueror-plugin-gnash.install
* drop libkonq5-dev build dependency accordingly
  - update debian/control
* don't install headers manually anymore. gnash doesnt provide a -dev
  package after all
  - update debian/rules
* update libs installed in gnash-common; libgnashserver-*.so is not available
  anymore (removed); in turn we add the new libgnashcore-*.so
  - update debian/gnash-common.install
* use -Os for optimization and properly pass CXXFLAGS=$(CFLAGS) to configure
  - update debian/rules
* touch firefox .autoreg in postinst of mozilla plugin
  - update debian/mozilla-plugin-gnash.postinst
* link gnash in ubufox plugins directory for the plugin alternative switcher
  - add debian/mozilla-plugin-gnash.links
* suggest ubufox accordingly
  - update debian/control
* add new required build-depends on libgif-dev
  - update debian/control
* add Xb-Npp-Description and Xb-Npp-File as new plugin database meta data
  - update debian/control

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Design info for NetStream based media playing
 
2
 
 
3
===============================================================================
 
4
 Data flow diagram for Gnash implementation of NetStream playback using FFMPEG
 
5
===============================================================================
 
6
 
 
7
Notation: process, [dataStore], <externalEvent>
 
8
 
 
9
  [input] --> (2) parser --> [parsedBuffer]
 
10
                                   |
 
11
      +----------------------------+
 
12
      |
 
13
      V
 
14
 (2) decoder <-+-> [videoQueue] --> (1) videoFrameUpdater --> [renderableFrame]
 
15
      ^        |                              ^                     |
 
16
      |        |                              |                     |
 
17
      +------- | -----------------------------+                     |
 
18
               |                              |                     V
 
19
               |          (1) <seek>  ---> [PlayHead]       (1) renderer 
 
20
               |                              ^                     |
 
21
               |                              |                     V
 
22
               |                              |                 [videoOut]   
 
23
               |                              |       
 
24
               +-> [audioQueue] ---> (3) soundPlayer -> [audioOut]
 
25
 
 
26
 Processes
 
27
===========
 
28
 
 
29
 
 
30
                parser : FLVParser           
 
31
               decoder : av_streamer        
 
32
     videoFrameUpdater : refreshVideoFrame  
 
33
              renderer : render_handler    
 
34
           soundPlayer : sound_streamer   
 
35
                  seek : NetStream::seek
 
36
 
 
37
 
 
38
 
 
39
 Datastores and protection
 
40
===========================
 
41
 
 
42
           [input] : Accessible through LoadThread, providing thread-safe interfaces
 
43
    [parsedBuffer] : Accessible through FLVParser, providing thread-safe interfaces
 
44
      [videoQueue] : Accessible through multithread_queue, providing thread-safe interfaces
 
45
      [audioQueue] : Accessible through multithread_queue, providing thread-safe interfaces
 
46
 [renderableFrame] : Direct access, disciplined by image_mutex
 
47
        [audioOut] : Audio output channel
 
48
        [videoOut] : Video output channel
 
49
        [PlayHead] : m_current_timestamp, m_go and m_pause. protection UNCLEAR !! refactoring planned 
 
50
 
 
51
 
 
52
 Threads
 
53
=========
 
54
 
 
55
  thread1 (main)              : videoFrameUpdater, renderer, seek
 
56
  thread2 (load/parse/decode) : parser, decoder
 
57
  thread3 (playsound)         : soundPlayer
 
58
 
 
59
===============================================================================
 
60
 Data flow diagram for Gnash implementation of NetStream playback using GST
 
61
===============================================================================
 
62
 
 
63
 
 
64
                         +-->  (2) [ParsedVideoBuffer]---+
 
65
                         |                               |
 
66
(2) [input] --> parser --+                               +---> (2) GST pipeline --> [renderableFrame] --> (1) renderer -> [videoOut]
 
67
                         |                               |               |                                      
 
68
                         +-->  (2) [ParsedAudioBuffer]---+               |
 
69
                                                                         +---> (2) soundPlayer --> [audioOut]
 
70
 
 
71
 
 
72
 Processes
 
73
===========
 
74
 
 
75
 
 
76
 thread 2 : FLVParser, decoder, audio output
 
77
 thread 1 : fetch videoframe
 
78