diff --git a/docs/pwg/intro-basics.xml b/docs/pwg/intro-basics.xml index b31fdaf13d..16ca6e4f70 100644 --- a/docs/pwg/intro-basics.xml +++ b/docs/pwg/intro-basics.xml @@ -37,14 +37,16 @@ A filter is an important type of element that processes a stream of data. Producers and consumers of data are called source and sink elements, - respectively. Elements that link other elements together are called - autoplugger elements, and a bin - element contains other elements. Bins are often responsible for scheduling - the elements that they contain so that data flows smoothly. + respectively. Bin elements contain other elements. + One type of bin is responsible for scheduling the elements that they + contain so that data flows smoothly. Another type of bin, called + autoplugger elements, automatically add other + elements to the bin and link them together so that they act as a + filter between two arbitary stream types. The plugin mechanism is used everywhere in &GStreamer;, even if only the - standard package is being used. A few very basic functions reside in the + standard packages are being used. A few very basic functions reside in the core library, and all others are implemented in plugins. A plugin registry is used to store the details of the plugins in an XML file. This way, a program using &GStreamer; does not have to load all plugins to determine @@ -68,10 +70,11 @@ Pads are used to negotiate links and data flow between elements in &GStreamer;. A pad can be viewed as a place or port on an element where - links may be made with other elements. Pads have specific data - handling capabilities: A pad only knows how to give or receive certain - types of data. Links are only allowed when the capabilities of two - pads are compatible. + links may be made with other elements, and through which data can + flow to or from those elements. Pads have specific data handling + capabilities: A pad can restrict the type of data that flows + through it. Links are only allowed between two pads when the + allowed data types of the two pads are compatible. An analogy may be helpful here. A pad is similar to a plug or jack on a @@ -85,7 +88,7 @@ same purpose as the jacks in the home theater system. - For the moment, all data in &GStreamer; flows one way through a link + For the most part, all data in &GStreamer; flows one way through a link between elements. Data flows out of one element through one or more source pads, and elements accept incoming data through one or more sink pads. Source and sink elements have