diff --git a/docs/random/arch b/docs/random/arch index ba7e88a7c8..3c73c75506 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 60446e2488..9a55b4e8dd 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 dd657d9216..78ac8dca52 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 e7995dd261..348b0e4f1b 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 2790c0934c..09d88e844d 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 466ef8e629..fbe6bf42d6 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 98593110ca..13cd3f1a91 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 f609ad429a..ce7e1ee7bc 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 0bb166b606..87bf619b83 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 fc854aff72..113ebe0ae8 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 d305d53577..f81e03025c 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 afe0a754fc..d98655587e 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 b2d4120771..8621d67fc3 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 8a669235b3..6c124685f5 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 7ce49460a1..6b3ce4c19a 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 86895974f7..cbb2b5d96f 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 737790946a..504f0e3384 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 420019ded1..8da58f0758 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 99a29d5cfe..b216470ca0 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 72ac2e29ff..8b1b1d08ba 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 ef05903b38..2c6e704f7a 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 1df4e724de..704a91491e 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 74d7de163e..29124539af 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 189f037023..b9b8c5a0e9 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 e226adca2e..d95c74fd12 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 f6b21fad82..81c6742aed 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 ad72b9b3e4..c4df59970f 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 18410f38ae..180d18ecfa 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 b4a480e1c6..556fbeaba1 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 46dc80f200..50e030a897 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 abe7afda41..bacc66593e 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 dad31e22dc..cacbac4231 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 1229e65e3f..c0a498cf99 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 2e9b7c5a50..58761b330b 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 9b12c3c3b5..8acf376cd8 100644 --- a/docs/random/wtay/messages +++ b/docs/random/wtay/messages @@ -1,3 +1,7 @@ +OUTDATED +-------- + + problem -------