From 7e0656ec4fb400bc015b2351a5f4b2266b79e230 Mon Sep 17 00:00:00 2001 From: Wim Taymans Date: Fri, 2 Aug 2002 11:23:05 +0000 Subject: [PATCH] Added status of the documents Original commit message from CVS: Added status of the documents --- docs/random/arch | 3 +++ docs/random/autoplug1 | 4 ++++ docs/random/buffers | 4 ++++ docs/random/caps | 4 ++++ docs/random/company/gstdata | 3 +++ docs/random/dynpads | 4 ++-- docs/random/eos | 3 +++ docs/random/events | 3 +++ docs/random/example | 4 ++++ docs/random/hierarchy | 4 ++++ docs/random/intro | 3 +-- docs/random/metadata | 3 +++ docs/random/omega/eos.old | 4 ++++ docs/random/omega/pad-negotiation | 3 +++ docs/random/omega/padtemplates | 3 +++ docs/random/omega/plan-generation | 3 +++ docs/random/omega/sched-commit1 | 3 +++ docs/random/omega/scheduling | 3 +++ docs/random/omega/type-properties | 4 ++++ docs/random/plugins | 4 ++++ docs/random/states | 4 ++++ docs/random/states.new | 3 +++ docs/random/states.old | 3 +++ docs/random/types2 | 4 ++++ docs/random/types3 | 4 ++++ docs/random/walkthrough | 3 +++ docs/random/wtay/caps-negociation | 4 ++++ docs/random/wtay/capsnego-cases | 3 +++ docs/random/wtay/eos-19012001 | 3 +++ docs/random/wtay/eos2 | 3 +++ docs/random/wtay/eos3 | 3 +++ docs/random/wtay/eos4 | 3 +++ docs/random/wtay/eos5 | 3 +++ docs/random/wtay/events2 | 3 +++ docs/random/wtay/messages | 4 ++++ 35 files changed, 115 insertions(+), 4 deletions(-) diff --git a/docs/random/arch b/docs/random/arch index ba7e88a..3c73c75 100644 --- a/docs/random/arch +++ b/docs/random/arch @@ -1,3 +1,6 @@ +OUTDATED +-------- + GstElementFactory: Base class for all elementfactories. Is a single-instance (per program) diff --git a/docs/random/autoplug1 b/docs/random/autoplug1 index 60446e2..9a55b4e 100644 --- a/docs/random/autoplug1 +++ b/docs/random/autoplug1 @@ -1,3 +1,7 @@ +COMPLETELY OUTDATED +------------------- + + A little explanation of the first autoplugger in GStreamer: Autoplugging is implemented in the following places: diff --git a/docs/random/buffers b/docs/random/buffers index dd657d9..78ac8dc 100644 --- a/docs/random/buffers +++ b/docs/random/buffers @@ -1,3 +1,7 @@ +METADATA ON BUFFERS IS OUTDATED +------------------------------- + + Buffer mutability properties are the most important part of gst, and similarly are the most complex. diff --git a/docs/random/caps b/docs/random/caps index e7995dd..348b0e4 100644 --- a/docs/random/caps +++ b/docs/random/caps @@ -1,3 +1,7 @@ +SOME OF THE FIRST IDEAS, PRETTY OUTDATED +---------------------------------------- + + During the course of a discussion on IRC, it turned out that there are many possible ways to handle the capabilities. diff --git a/docs/random/company/gstdata b/docs/random/company/gstdata index 2790c09..09d88e8 100644 --- a/docs/random/company/gstdata +++ b/docs/random/company/gstdata @@ -1,3 +1,6 @@ +STATUS: GstData is not implemented as a class for speed reasons. +---------------------------------------------------------------- + NB: This document does not represent the current state of CVS but my current plans on how to implement this. Basics diff --git a/docs/random/dynpads b/docs/random/dynpads index 466ef8e..fbe6bf4 100644 --- a/docs/random/dynpads +++ b/docs/random/dynpads @@ -10,14 +10,14 @@ and properties of a pad can be obtained from the elementfactory using the padtemplates. Dynamic pad usually have the presence indicator set to -GST_PAD_FACTORY_SOMETIMES. This indicated that the pad might become +GST_PAD_SOMETIMES. This indicated that the pad might become available at runtime. When the pad is actually created in the element, the element will signal the new_pad signal. This signal can then be used to attach a desired (compatible) element to the pad. For certain elements, like a tee and a muxer, we need another pad -presence flag: GST_PAD_FACTORY_REQUEST. With this flag, the +presence flag: GST_PAD_REQUEST. With this flag, the elementfactory will announce that some of the pads are available on request. For the tee element, for example, one might obtain a new output pad by looking up a suitable padtemplate (temp) and performing: diff --git a/docs/random/eos b/docs/random/eos index 9859311..13cd3f1 100644 --- a/docs/random/eos +++ b/docs/random/eos @@ -1,3 +1,6 @@ +OUTDATED +-------- + case 1) diff --git a/docs/random/events b/docs/random/events index f609ad4..ce7e1ee 100644 --- a/docs/random/events +++ b/docs/random/events @@ -1,3 +1,6 @@ +EARLY DOCUMENT, NOT EXACTLY AS IMPLEMENTED +------------------------------------------ + EVENTS RFC ========== diff --git a/docs/random/example b/docs/random/example index 0bb166b..87bf619 100644 --- a/docs/random/example +++ b/docs/random/example @@ -1,3 +1,7 @@ +OUTDATED, methods have different names now +------------------------------------------ + + Here's a pipeline that does audio/video MPEG streams with a queue on either side of each decompressor, for a total of 5 threads (read/split, decode audio, decode video, play audio, play video): diff --git a/docs/random/hierarchy b/docs/random/hierarchy index fc854af..113ebe0 100644 --- a/docs/random/hierarchy +++ b/docs/random/hierarchy @@ -1,3 +1,7 @@ +OUTDATED +-------- + + Face it, the plugins/ directory hierarchy is crap. We want to propose a better layout for it now. Some things to consider: diff --git a/docs/random/intro b/docs/random/intro index d305d53..f81e030 100644 --- a/docs/random/intro +++ b/docs/random/intro @@ -1,6 +1,5 @@ GNOME Streamer is a pipeline-based media streaming framework. It is built -on top of the Gtk+ object model, and while it currently sits on top of -gtk, it can be divorced from it at any point in the future. +on top of the gobject object model. A pipeline consists of at one or more each of sources, sinks, and filters. These elements may be combined inside container elements, which may have diff --git a/docs/random/metadata b/docs/random/metadata index afe0a75..d986555 100644 --- a/docs/random/metadata +++ b/docs/random/metadata @@ -1,3 +1,6 @@ +OUTDATED +-------- + The point of the metadata is to provide some context for each buffer. In the case of audio data, for instance, it would provide the samplerate, bit depth, and channel count. diff --git a/docs/random/omega/eos.old b/docs/random/omega/eos.old index b2d4120..8621d67 100644 --- a/docs/random/omega/eos.old +++ b/docs/random/omega/eos.old @@ -1,3 +1,7 @@ +OUTDATED +-------- + + What I propose for EOS condition is th following: As is stands, EOS is a flag in a buffer. However, it's also a signal from an element, which is odd. What I propose is that EOS become a pad thing. Here's how it would diff --git a/docs/random/omega/pad-negotiation b/docs/random/omega/pad-negotiation index 8a66923..6c12468 100644 --- a/docs/random/omega/pad-negotiation +++ b/docs/random/omega/pad-negotiation @@ -1,3 +1,6 @@ +OUTDATED, EARLY IDEA +-------------------- + When two pads are connected, a negotiation phase is going to have to happen. Ideally, the caps of the two pads will both be fully-specified, and match. That's the ideal case, but may rarely happen in practice. diff --git a/docs/random/omega/padtemplates b/docs/random/omega/padtemplates index 7ce4946..6b3ce4c 100644 --- a/docs/random/omega/padtemplates +++ b/docs/random/omega/padtemplates @@ -1,3 +1,6 @@ +OUTDATED +-------- + typedef gpointer GstCapsFactoryEntry; typedef GstCapsFactoryEntry GstCapsFactory[]; typedef GstCapsFactory *GstCapsListFactory[]; diff --git a/docs/random/omega/plan-generation b/docs/random/omega/plan-generation index 8689597..cbb2b5d 100644 --- a/docs/random/omega/plan-generation +++ b/docs/random/omega/plan-generation @@ -1,3 +1,6 @@ +OUTDATED +-------- + Plan generation happens at transition from NULL to READY (and PLAYING to READY right now, need to fix that). By way of some logic in gst_bin_change_state(), gst_bin_create_plan() is only called for the outer Bin, usually a Pipeline. This keeps things from getting nasty later on. diff --git a/docs/random/omega/sched-commit1 b/docs/random/omega/sched-commit1 index 7377909..504f0e3 100644 --- a/docs/random/omega/sched-commit1 +++ b/docs/random/omega/sched-commit1 @@ -1,3 +1,6 @@ +STATUS: pushregion/pullregion is gone +------------------------------------- + Changed the way things are scheduled, especially sources. A Src used to have a push() function, and optionally a pushregion() to deal with async reads, etc. That whole thing has gone away, in favor of providing a diff --git a/docs/random/omega/scheduling b/docs/random/omega/scheduling index 420019d..8da58f0 100644 --- a/docs/random/omega/scheduling +++ b/docs/random/omega/scheduling @@ -1,3 +1,6 @@ +STATUS: pull on srcpads is outdated, they use _get +-------------------------------------------------- + 0) definitions: All pads without further specifiers are assumed to belong to the element diff --git a/docs/random/omega/type-properties b/docs/random/omega/type-properties index 99a29d5..b216470 100644 --- a/docs/random/omega/type-properties +++ b/docs/random/omega/type-properties @@ -1,3 +1,7 @@ +OUTDATED +-------- + + A type properties system might look like following: diff --git a/docs/random/plugins b/docs/random/plugins index 72ac2e2..8b1b1d0 100644 --- a/docs/random/plugins +++ b/docs/random/plugins @@ -1,3 +1,7 @@ +SOMEWHAT OUTDATED +----------------- + + We describe how the plugin system works. Plugins diff --git a/docs/random/states b/docs/random/states index ef05903..2c6e704 100644 --- a/docs/random/states +++ b/docs/random/states @@ -1,3 +1,7 @@ +OUTDATED +-------- + + GST State Bits and Transition Rules (graph to follow) ----------------------------------- diff --git a/docs/random/states.new b/docs/random/states.new index 1df4e72..704a914 100644 --- a/docs/random/states.new +++ b/docs/random/states.new @@ -1,3 +1,6 @@ +OUTDATED +-------- + Since the plan generation only happens as a result of the state mechanism, I'll describe that first. diff --git a/docs/random/states.old b/docs/random/states.old index 74d7de1..2912453 100644 --- a/docs/random/states.old +++ b/docs/random/states.old @@ -1,3 +1,6 @@ +OUTDATED +-------- + GST States and Transition Rules (graph to follow) ------------------------------- diff --git a/docs/random/types2 b/docs/random/types2 index 189f037..b9b8c5a 100644 --- a/docs/random/types2 +++ b/docs/random/types2 @@ -1,3 +1,7 @@ +OUTDATED +-------- + + 1. Introduction --------------- diff --git a/docs/random/types3 b/docs/random/types3 index e226adc..d95c74f 100644 --- a/docs/random/types3 +++ b/docs/random/types3 @@ -1,3 +1,7 @@ +SOMEWHAT OUTDATED, design still holds though +-------------------------------------------- + + 1. Introduction --------------- diff --git a/docs/random/walkthrough b/docs/random/walkthrough index f6b21fa..81c6742 100644 --- a/docs/random/walkthrough +++ b/docs/random/walkthrough @@ -1,3 +1,6 @@ +OUTDATED +-------- + You might start by creating a source element and put it into a pipeline. At this point both element's state would be GST_STATE_NEW, since they don't have enough state to actually run yet. At this point you can set diff --git a/docs/random/wtay/caps-negociation b/docs/random/wtay/caps-negociation index ad72b9b..c4df599 100644 --- a/docs/random/wtay/caps-negociation +++ b/docs/random/wtay/caps-negociation @@ -1,3 +1,7 @@ +OUTDATED +-------- + + caps negotiation ================ diff --git a/docs/random/wtay/capsnego-cases b/docs/random/wtay/capsnego-cases index 18410f3..180d18e 100644 --- a/docs/random/wtay/capsnego-cases +++ b/docs/random/wtay/capsnego-cases @@ -1,3 +1,6 @@ +OUTDATED +-------- + pad has caps | pad has template diff --git a/docs/random/wtay/eos-19012001 b/docs/random/wtay/eos-19012001 index b4a480e..556fbea 100644 --- a/docs/random/wtay/eos-19012001 +++ b/docs/random/wtay/eos-19012001 @@ -1,3 +1,6 @@ +OUTDATED +-------- + EOS as implemented on Jan 21 2001: 1) terminology diff --git a/docs/random/wtay/eos2 b/docs/random/wtay/eos2 index 46dc80f..50e030a 100644 --- a/docs/random/wtay/eos2 +++ b/docs/random/wtay/eos2 @@ -1,3 +1,6 @@ +OUTDATED +-------- + case 1) diff --git a/docs/random/wtay/eos3 b/docs/random/wtay/eos3 index abe7afd..bacc665 100644 --- a/docs/random/wtay/eos3 +++ b/docs/random/wtay/eos3 @@ -1,3 +1,6 @@ +OUTDATED +-------- + case 1) diff --git a/docs/random/wtay/eos4 b/docs/random/wtay/eos4 index dad31e2..cacbac4 100644 --- a/docs/random/wtay/eos4 +++ b/docs/random/wtay/eos4 @@ -1,3 +1,6 @@ +OUTDATED +-------- + case 1) diff --git a/docs/random/wtay/eos5 b/docs/random/wtay/eos5 index 1229e65..c0a498c 100644 --- a/docs/random/wtay/eos5 +++ b/docs/random/wtay/eos5 @@ -1,3 +1,6 @@ +OUTDATED +-------- + case 1) diff --git a/docs/random/wtay/events2 b/docs/random/wtay/events2 index 2e9b7c5..58761b3 100644 --- a/docs/random/wtay/events2 +++ b/docs/random/wtay/events2 @@ -1,3 +1,6 @@ +INITIAL RAMBLINGS +----------------- + some random ramblings about the event system: Possible candidates for events diff --git a/docs/random/wtay/messages b/docs/random/wtay/messages index 9b12c3c..8acf376 100644 --- a/docs/random/wtay/messages +++ b/docs/random/wtay/messages @@ -1,3 +1,7 @@ +OUTDATED +-------- + + problem ------- -- 2.7.4