| OUTDATED |
| -------- |
| |
| |
| case 1) |
| |
| (--------) (--------) (--------) |
| ! fakesrc! !identity! !fakesink! |
| ! src ----- sink src ---- sink ! |
| (--------) (--------) (--------) |
| |
| |
| |
| fakesrc detects the end of stream. It just sent the last buffer |
| and sets the srcpad to EOS with gst_pad_eos (). |
| |
| gst_pad_eos() will notify the parent about the plugins attempt to |
| signal eos. the parent adds the element to its possible EOS |
| providers. |
| |
| gst_pad_eos() will by default propagate to identy and to fakesink. |
| none of these plugins override the default behaviour so gst_pad_eos |
| returns TRUE and fakesrc signals EOS with the value TRUE. |
| |
| The parent looks in the list of EOS providers and finds the faksrc |
| element that is now signaling EOS. all EOS providers are now in EOS |
| and so the bin fires EOS. |
| |
| |
| |
| case 2) |
| (---------------) |
| !thread ! |
| (--------) (--------) (--------) ! (--------)! |
| ! fakesrc! !identity! ! queue ! ! !fakesink!! |
| ! src ----- sink src ---- sink src ---- sink !! |
| (--------) (--------) (--------) ! (--------)! |
| (---------------) |
| |
| |
| fakesrc detects the end of stream. It just sent the last buffer |
| and sets the srcpad to EOS with gst_pad_eos (). |
| |
| gst_pad_eos() will notify the parent about the plugins attempt to |
| signal eos. the parent adds the element to its possible EOS |
| providers. |
| |
| gst_pad_eos() will by default propagate to identy and to queue. |
| queue overrides the eos handler and returns false on the eos |
| request. fakesrc signals EOS with a value of false and the parent |
| bin removes the EOS provider from its list. |
| |
| after the queue has sent out the last buffer, its calls eos on its |
| src pad. queue is added to the top level bin as an eos provider and |
| the default eos handler signals EOS with a value of TRUE to the parent. |
| |
| the parent sees that all the eos providers are in eos now and signals |
| EOS. |
| |
| |
| case 3) |
| (---------------) |
| !thread ! |
| (--------) (--------) (--------) ! (--------)! |
| ! fakesrc! ! tee ! ! queue1 ! ! !fakesink!! |
| ! src ----- sink src ---- sink src ---- sink !! |
| (--------) ! ! (--------) ! (--------)! |
| ! ! (---------------) |
| ! ! |
| ! ! (---------------) |
| ! ! !thread ! |
| ! ! (--------) ! (--------)! |
| ! ! ! queue2 ! ! !fakesink!! |
| ! src ---- sink src ---- sink !! |
| ! ! (--------) ! (--------)! |
| (--------) (---------------) |
| |
| |
| fakesrc detects the end of stream. It just sent the last buffer |
| and sets the srcpad to EOS with gst_pad_eos (). |
| |
| the eos handler returns false because both queues return false on the |
| eos request. the parent removes fakesrc as an EOS provider. |
| |
| queue1 and queue2 were responsible for the EOS delay and so they get |
| added to the bin as possible EOS providers. |
| |
| after the queues have sent out their last buffer, they calls eos on their |
| src pads. |
| the parent already has the two queues in the EOS provider list so they dont |
| get added twice. |
| the two queues perform gst_pad_eos () on their pads when the queue is empty, |
| the parent removes the EOS providers from its list, when the list is empty, |
| the parent fires EOS. |
| |
| |
| case 4) |
| |
| (---------------) |
| !thread ! |
| (--------) (----------) (--------) ! (--------)! |
| ! fakesrc! !mpeg1parse! ! queue1 ! ! !fakesink!! |
| ! src -- sink src ---- sink src ---- sink !! |
| (--------) ! ! (--------) ! (--------)! |
| ! ! (---------------) |
| ! ! |
| ! ! (---------------) |
| ! ! !thread ! |
| ! ! (--------) ! (--------)! |
| ! ! ! queue2 ! ! !fakesink!! |
| ! src ---- sink src ---- sink !! |
| ! ! (--------) ! (--------)! |
| (----------) (---------------) |
| |
| |
| this case differs from case3 in that one of the queues can be empty |
| while the other isn't. we assume queue1 is empty while queue2 isn't yet. |
| |
| fakesrc detects the end of stream. It just sent the last buffer |
| and sets the srcpad to EOS with gst_pad_eos (). |
| |
| the eos handler returns false because queue2 returns false on the |
| eos request. the parent removes fakesrc as an EOS provider. |
| |
| queue2 was responsible for the EOS delay and so it gets added to the bin |
| as a possible EOS provider. |
| |
| after the queue2 has sent its last buffer, it performs gst_pad_eos on its |
| src pad. |
| the parent already has the queue2 in the list of EOS providers so it does not |
| get added twice. |
| queue2 finally fires the EOS signal and the parent removes the EOS provider |
| from its list, when the list is empty, the parent fires EOS. |
| |
| |
| |
| case 5) |
| |
| (--------) (--------) (--------) |
| ! disksrc! ! mad ! !filesink! |
| ! src ----- sink src ---- sink ! |
| (--------) (--------) (--------) |
| |
| |
| disksrc detects the end of stream. It just sent the last buffer |
| and sets the srcpad to EOS with gst_pad_eos (). |
| |
| the eos handler returns false because mad returns false on the |
| eos request. the parent removes mad as an EOS provider. |
| |
| mad was responsible for the EOS delay and so it gets added to the bin |
| as a possible EOS provider. |
| |
| After mad has sent its last buffer, it performs gst_pad_eos on its |
| src pad. |
| the parent already has mad in the list of EOS providers so it does not |
| get added twice. |
| mad finally fires the EOS signal. This time, filesink returns false on |
| the eos request. the parent removes mad as an EOS provider. |
| |
| filesink was responsible for the EOS delay and gets added to the bin |
| as a possible EOS provider. |
| When filesink has written all of it's data and closed the output file, |
| it fires EOS. |
| The parent already has filesink in the list of EOS providers so it does |
| not get added twice. |
| The parent removes the EOS provider |
| from its list, and since the list is empty, the parent fires EOS. |
| |
| case 6) |
| |
| (--------) (--------) (--------) |
| !disksrc1! ! mad1 ! ! mixer ! |
| ! src ----- sink src ---- sink1 ! (--------) |
| (--------) (--------) ! ! !filesink! |
| ! src ---- sink ! |
| (--------) (--------) ! ! (--------) |
| !disksrc2! ! mad2 ! ! ! |
| ! src ----- sink src ---- sink2 ! |
| (--------) (--------) (--------) |
| |
| In this case, we want to make sure the pipeline keeps running after one |
| of the two sources reaches eos. Suppose in this case that disksrc1 will |
| reach eos first. |
| |
| disksrc1 detects the end of stream. It sets eos, mad1 will return false, |
| and mad1 will be responsible for eos. When mad1 had sent out the last |
| buffer, it sends out eos. |
| |
| The mixer intercepts eos and returns false. mad1 is removed from the |
| eos providers and mixer is added. |
| |
| (At this point, the mixer might choose to disconnect mad1->src and |
| mixer->sink1 pads, since it's received eos on mad1->src) |
| |
| mixer will not send out eos since it hasn't received eos from |
| mad2->src. |
| |
| After a while, disksrc2 will detect end of stream, and eos will finally |
| propagate to mixer. mixer might disconnect mad->src2, and after |
| realizing all of it's sources have reached eos, it sends out the final |
| buffer and fires EOS. |
| |
| At this point, filesink will return false, mixer will be removed as an |
| eos provider, and filesink will write out it's final buffer and close |
| the file on disk. At this point, it fires eos, and since it's the last |
| eos provider, the parent can fire eos. |
| |
| |
