[cheese/three-point-oh] add effect specification

[Daniel G. Siegel <dgsiegel src gnome org>]

commit 58b9aa7da6b880b6f6c88eb6bfdd09ff277513fa
Author: daniel g. siegel <dgsiegel gnome org>
Date:   Thu Jul 15 20:52:30 2010 +0200

    add effect specification

 data/effects/Makefile.am |    7 +++++--
 data/effects/README      |   44 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 49 insertions(+), 2 deletions(-)
---
diff --git a/data/effects/Makefile.am b/data/effects/Makefile.am
index d0240fb..9745d76 100644
--- a/data/effects/Makefile.am
+++ b/data/effects/Makefile.am
@@ -18,10 +18,13 @@ effects_in_files = \
 	vertigotv.effect.in \
 	warptv.effect.in
 
-effects_DATA = $(effects_in_files:.effect.in=.effect)
+effects_DATA = \
+	$(effects_in_files:.effect.in=.effect) \
+	README
 
 EXTRA_DIST = \
-	$(effects_in_files)
+	$(effects_in_files) \
+	README
 
 DISTCLEANFILES = \
 	$(effects_DATA)
diff --git a/data/effects/README b/data/effects/README
new file mode 100644
index 0000000..9d02bd7
--- /dev/null
+++ b/data/effects/README
@@ -0,0 +1,44 @@
+Introduction
+============
+
+Writing effects is very easy: just create a file with the extion ".effect" and
+use the following format for it:
+
+
+[Effect]
+Encoding=UTF-8
+Name=[The human readable effect name]
+Name[LangCode]=[The translated human readable effect name]
+...
+PipelineDescription=[A valid GStreamer pipeline]
+Category=[The category of your effect, e.g. "Colors".]
+Comment=[Optional Element: Description of the effect]
+Comment[LangCode]=[Optional Element: Translation of the description of the effect]
+...
+
+
+Possible Effect Categories
+==========================
+
+  Analysis
+  Blur
+  Colors
+  Fancy
+  Geometry
+  Noise
+  Time
+
+
+A sample effect could look like
+===============================
+
+[Effect]
+Encoding=UTF-8
+Name=The Hulk
+Name[de]=Der Hulk
+Name[it]=Lo Hulk
+PipelineDescription=videobalance saturation=1.5 hue=-0.5
+Category=Color;Fancy;
+Comment=Transform yourself into the amazing Hulk
+Comment[de]=Verwandle dich in den unglaublichen Hulk
+Comment[it]=Trasformati in Hulk