Kinds of Reggae classes - Revision history

Krashan: /* Outputs */ Italic for method name

2010-08-16T21:57:56Z

‎Outputs: Italic for method name

Krashan: /* Filters */ style/grammar

2010-08-16T21:55:43Z

‎Filters: style/grammar

Krashan: /* Filters */ Fixed link.

2010-08-16T21:49:01Z

‎Filters: Fixed link.

Krashan: /* Decoders */ Fixed link.

2010-08-16T21:48:40Z

‎Decoders: Fixed link.

Krashan: /* Outputs */ Link fixed

2010-08-16T20:05:38Z

‎Outputs: Link fixed

Krashan: moved Reggae tutorial: Kinds of Reggae classes to Kinds of Reggae classes: It is not really a tutorial and belongs to overview section.

2010-08-16T20:01:09Z

moved Reggae tutorial: Kinds of Reggae classes to Kinds of Reggae classes: It is not really a tutorial and belongs to overview section.

Krashan: /* Internal classes */ Contents

2010-08-16T19:56:10Z

‎Internal classes: Contents

Krashan: /* Outputs */

2010-08-16T19:45:59Z

‎Outputs

Krashan: /* Outputs */ Contents.

2010-08-16T19:43:58Z

‎Outputs: Contents.

Krashan: /* Filters */ Contents added.

2010-08-16T18:55:16Z

‎Filters: Contents added.

@@ Line 30: / Line 30: @@
 * '''user presentation outputs''', which direct data stream to some output device of a computer (''audio.output'', ''picture.output''),
 * '''storage outputs''', which store data stream somewhere (''file.output'').
-Constructing a chain of connected Reggae objects does not start data processing automatically. Reggae is a pull-driven system, so something must pull data at the end of chain. It may be the application, who actively call MMM_Pull() method on output port(s) at the end of chain. Then it just gets data in some memory buffer and can do whatever it wants with them. Alternatively the last chain object may be an instance of some Reggae output class. Then the whole processing is done by Reggae.
+Constructing a chain of connected Reggae objects does not start data processing automatically. Reggae is a pull-driven system, so something must pull data at the end of chain. It may be the application, who actively call ''MMM_Pull()'' method on output port(s) at the end of chain. Then it just gets data in some memory buffer and can do whatever it wants with them. Alternatively the last chain object may be an instance of some Reggae output class. Then the whole processing is done by Reggae.
 Every Reggae output object creates a subprocess which pulls data from the chain of objects and either stores them or presents to the user. It means that '''all Reggae data processing is automatically offloaded from application to the subprocess'''. Main application process is free to handle GUI, display processing progress and control the processing by performing methods on the output object. Subprocessing Reggae chain makes creating GUI-based applications easier, and allows for example background processing, just by setting subprocess priority below 0. It may be useful for storage outputs. User presentation outputs have to work in real time, so their default priorities are above 0.

@@ Line 20: / Line 20: @@
 ==Filters==
-A Reggae filter accepts data in one of Reggae [[Reggae_common_formats|common formats]], performs some transformation on data and deliver them in the same or other Reggae common format. Most filter has the same format on inputs and outputs, but it is not the rule. Imagine a filter generating visualisations for audio player, it will accept audio and generate video.
+A Reggae filter accepts data in one of Reggae [[Reggae_common_formats|common formats]], performs some transformation on data and deliver them in the same or other Reggae common format. Most filters have the same format on inputs and outputs, but it is not the rule of thumb. Imagine a filter generating visualisations for audio player, it will accept audio and generate video.
 ==Encoders==

@@ Line 20: / Line 20: @@
 ==Filters==
-A Reggae filter accepts data in one of Reggae [[common formats]], performs some transformation on data and deliver them in the same or other Reggae common format. Most filter has the same format on inputs and outputs, but it is not the rule. Imagine a filter generating visualisations for audio player, it will accept audio and generate video.
+A Reggae filter accepts data in one of Reggae [[Reggae_common_formats|common formats]], performs some transformation on data and deliver them in the same or other Reggae common format. Most filter has the same format on inputs and outputs, but it is not the rule. Imagine a filter generating visualisations for audio player, it will accept audio and generate video.
 ==Encoders==

@@ Line 17: / Line 17: @@
 ==Decoders==
-A decoder takes a single, demuxed media stream and converts it to one of Reggae [[common formats]]. This conversion usually means decompression and decoding of stream. Some decoders are dedicated to one particular media format, some are more general and used with many demuxers.
+A decoder takes a single, demuxed media stream and converts it to one of Reggae [[Reggae_common_formats|common formats]]. This conversion usually means decompression and decoding of stream. Some decoders are dedicated to one particular media format, some are more general and used with many demuxers.
 ==Filters==

@@ Line 27: / Line 27: @@
 ==Outputs==
-Outputs form output abstraction layer of Reggae. They are not symmetrical to [[Reggae_tutorial:_Kinds_of_Reggae_classes#Streams|streams]] however. Outputs can be divided into two groups:
+Outputs form output abstraction layer of Reggae. They are not symmetrical to [[Kinds_of_Reggae_classes#Streams|streams]] however. Outputs can be divided into two groups:
 * '''user presentation outputs''', which direct data stream to some output device of a computer (''audio.output'', ''picture.output''),
 * '''storage outputs''', which store data stream somewhere (''file.output'').

← Older revision	Revision as of 20:01, 16 August 2010
(No difference)

← Older revision		Revision as of 19:56, 16 August 2010
Line 35:		Line 35:

	==Internal classes==		==Internal classes==
		+	There are some helper classes, which are used by Reggae internally, but may be interesting for advanced Reggae programmers. Here is a brief description of them:
		+	* ''processblock.class'' is used for grouping sets of connected objects into groups seen as a single object from outside. For example ''MediaNewObject()'' call returns a "single" object, which is in fact a complete tree consisting of at least four objects (a stream, a multiread buffer, a demuxer and a decoder).
		+	* ''multiread.buffer'' implements a FIFO buffer with data peeking feature. It is used in format recognition process to present the same stream header to multiple recognition routines, even if the source stream is not seekable.
		+	See autodocs of these classes for more details.

@@ Line 32: / Line 32: @@
 Constructing a chain of connected Reggae objects does not start data processing automatically. Reggae is a pull-driven system, so something must pull data at the end of chain. It may be the application, who actively call MMM_Pull() method on output port(s) at the end of chain. Then it just gets data in some memory buffer and can do whatever it wants with them. Alternatively the last chain object may be an instance of some Reggae output class. Then the whole processing is done by Reggae.
-Every Reggae output object creates a subprocess which pulls data from the chain of objects and either stores them or presents to the user. It means that '''all Reggae data processing is offloaded from application to the subprocess'''. Main application process is free to handle GUI, display processing progress and control the processing by performing methods on the output object. Subprocessing Reggae chain makes creating GUI-based applications easier, and allows for example background processing, just by setting subprocess priority below 0. It may be useful for storage outputs. User presentation outputs have to work in real time, so their default priorities are above 0.
+Every Reggae output object creates a subprocess which pulls data from the chain of objects and either stores them or presents to the user. It means that '''all Reggae data processing is automatically offloaded from application to the subprocess'''. Main application process is free to handle GUI, display processing progress and control the processing by performing methods on the output object. Subprocessing Reggae chain makes creating GUI-based applications easier, and allows for example background processing, just by setting subprocess priority below 0. It may be useful for storage outputs. User presentation outputs have to work in real time, so their default priorities are above 0.
 ==Internal classes==

← Older revision		Revision as of 19:43, 16 August 2010
Line 27:		Line 27:

	==Outputs==		==Outputs==
		+	Outputs form output abstraction layer of Reggae. They are not symmetrical to [[Reggae_tutorial:_Kinds_of_Reggae_classes#Streams\|streams]] however. Outputs can be divided into two groups:
		+	* '''user presentation outputs''', which direct data stream to some output device of a computer (''audio.output'', ''picture.output''),
		+	* '''storage outputs''', which store data stream somewhere (''file.output'').
		+	Constructing a chain of connected Reggae objects does not start data processing automatically. Reggae is a pull-driven system, so something must pull data at the end of chain. It may be the application, who actively call MMM_Pull() method on output port(s) at the end of chain. Then it just gets data in some memory buffer and can do whatever it wants with them. Alternatively the last chain object may be an instance of some Reggae output class. Then the whole processing is done by Reggae.
		+
		+	Every Reggae output object creates a subprocess which pulls data from the chain of objects and either stores them or presents to the user. It means that '''all Reggae data processing is offloaded from application to the subprocess'''. Main application process is free to handle GUI, display processing progress and control the processing by performing methods on the output object. Subprocessing Reggae chain makes creating GUI-based applications easier, and allows for example background processing, just by setting subprocess priority below 0. It may be useful for storage outputs. User presentation outputs have to work in real time, so their default priorities are above 0.

	==Internal classes==		==Internal classes==

← Older revision		Revision as of 18:55, 16 August 2010
Line 20:		Line 20:

	==Filters==		==Filters==
		+	A Reggae filter accepts data in one of Reggae [[common formats]], performs some transformation on data and deliver them in the same or other Reggae common format. Most filter has the same format on inputs and outputs, but it is not the rule. Imagine a filter generating visualisations for audio player, it will accept audio and generate video.

	==Encoders==		==Encoders==