# HG changeset patch
# User Alessio Caiazza <nolith@abisso.org>
# Date 1241364386 -7200
# Node ID 4ddd1bb9cdffa629fe56403df1ad7da65f720862
# Parent  e95d85cdf925bd9e07709fee525cd971f7971902
Examples added / now compliant with http://dev.processing.org/libraries/guidelines.html

diff -r e95d85cdf925bd9e07709fee525cd971f7971902 -r 4ddd1bb9cdffa629fe56403df1ad7da65f720862 build.xml
--- a/build.xml	Thu Jul 24 17:56:48 2008 +0200
+++ b/build.xml	Sun May 03 17:26:26 2009 +0200
@@ -127,8 +127,6 @@
 	<mkdir dir="${release}"/>
 	<mkdir dir="${release}/capturemjpeg"/>
 	<mkdir dir="${release}/capturemjpeg/library"/>
-	<mkdir dir="${release}/capturemjpeg/licenses"/>
-	<mkdir dir="${release}/capturemjpeg/documentation"/>
   </target>
 
   <target name="deploy" depends="jar, doc">
@@ -141,9 +139,17 @@
 	  <fileset dir="./licenses"/>
 	</copy>
 	<!-- copy documentation -->
-	<copy todir="${release}/capturemjpeg/documentation">
+	<copy todir="${release}/capturemjpeg/reference">
 	  <fileset dir="${docs}/api"/>
 	</copy>
+	<!-- copy examples -->
+	<copy todir="${release}/capturemjpeg/examples">
+	  <fileset dir="${docs}/examples"/>
+	</copy>
+	<!-- copy source -->
+	<copy todir="${release}/capturemjpeg/src">
+	  <fileset dir="${src}"/>
+	</copy>
 	<!-- create zip file -->
 	<zip destfile="${release}/capturemjpeg.zip"
 		 basedir="${release}"
diff -r e95d85cdf925bd9e07709fee525cd971f7971902 -r 4ddd1bb9cdffa629fe56403df1ad7da65f720862 docs/examples/adaptive_frame_size/adaptive_frame_size.pde
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/examples/adaptive_frame_size/adaptive_frame_size.pde	Sun May 03 17:26:26 2009 +0200
@@ -0,0 +1,38 @@
+/* 
+   CaptureMJPEG - example
+Adaptive frame size
+
+We also provide a way to dynamically resize the applet according to the image size.
+This is especially useful when you want to build a simple viewer without caring of 
+the original image size.
+
+(c) 2008 Alessio Caiazza, Cosimo Cecchi
+*/
+
+import it.lilik.capturemjpeg.*;
+
+private CaptureMJPEG capture;
+private PImage next_img = null;
+
+void setup() {
+  frame.setResizable (true);
+  background(0);
+  capture = new CaptureMJPEG (this,
+                              "http://mynetworkcamera.foo/image?speed=20",
+                              "user",
+                              "password");
+  capture.setAdaptFrameSize(true);
+  capture.startCapture();
+  frameRate(20);
+}
+
+void draw() {
+  if (next_img != null) {
+    image(next_img, 0, 0);
+  }
+}
+
+void captureMJPEGEvent(PImage img) {
+  next_img = img;
+}
+
diff -r e95d85cdf925bd9e07709fee525cd971f7971902 -r 4ddd1bb9cdffa629fe56403df1ad7da65f720862 docs/examples/basic_usage/basic_usage.pde
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/examples/basic_usage/basic_usage.pde	Sun May 03 17:26:26 2009 +0200
@@ -0,0 +1,38 @@
+/* 
+   CaptureMJPEG - example
+Basic usage
+
+If you use the generic URL parser, you have to specify the full path of
+your video camera, including "http://".
+
+(c) 2008 Alessio Caiazza, Cosimo Cecchi
+*/
+import it.lilik.capturemjpeg.*;
+
+private CaptureMJPEG capture;
+private PImage next_img = null;
+
+void setup() {
+  size(400, 300);
+  background(0);
+  capture = new CaptureMJPEG (this,
+                              "http://mynetworkcamera.foo/image?speed=20",
+                              "user",
+                              "password");
+  // or this if you don't need auth
+  // capture = new CaptureMJPEG(this, "http://mynetworkcamera.foo/image?speed=20");
+
+  capture.startCapture();
+  frameRate(20);
+}
+
+void draw() {
+  if (next_img != null) {
+    image(next_img, 0, 0);
+  }
+}
+
+void captureMJPEGEvent(PImage img) {
+  next_img = img;
+}
+
diff -r e95d85cdf925bd9e07709fee525cd971f7971902 -r 4ddd1bb9cdffa629fe56403df1ad7da65f720862 docs/examples/buffer/buffer.pde
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/examples/buffer/buffer.pde	Sun May 03 17:26:26 2009 +0200
@@ -0,0 +1,38 @@
+/* 
+   CaptureMJPEG - example
+Usage of the buffer facility
+
+In other examples, you can see that we're defining a captureMJPEGEvent() function.
+This function is called from within CaptureMJPEG every time a new image is ready to be displayed.
+You may prefer to avoid defining this function and choose yourself when to display the images.
+CaptureMJPEG has an internal circular buffer to store ready images for this purpose.
+
+(c) 2008 Alessio Caiazza, Cosimo Cecchi
+*/
+import it.lilik.capturemjpeg.*;
+
+private CaptureMJPEG capture;
+private PImage next_img = null;
+
+void setup() {
+  size (400,300);
+  capture = new CaptureMJPEG (this,
+                              "http://mynetworkcamera.foo/image?speed=20",
+                              "user",
+                              "password");
+  capture.startCapture();
+  frameRate(20);
+}
+            
+void draw() {
+  next_img = capture.getImage();
+  if (next_img != null) {
+    image(next_img, 0, 0);
+  }
+}           
+
+void stop()
+{
+  capture.dispose();
+}
+
diff -r e95d85cdf925bd9e07709fee525cd971f7971902 -r 4ddd1bb9cdffa629fe56403df1ad7da65f720862 docs/examples/vendor_specific_builder/vendor_specific_builder.pde
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/examples/vendor_specific_builder/vendor_specific_builder.pde	Sun May 03 17:26:26 2009 +0200
@@ -0,0 +1,38 @@
+/* 
+   CaptureMJPEG - example
+Usage of vendor-specific URL builders
+
+Note that when using vendor-specific URL builder, you must provide only 
+the host name to the constructor (without "http://").
+
+(c) 2008 Alessio Caiazza, Cosimo Cecchi
+*/
+import it.lilik.capturemjpeg.*;
+
+private CaptureMJPEG capture;
+private PImage next_img = null;
+
+void setup() {
+  size(400, 300);
+  background(0);
+  capture = new CaptureMJPEG (this,
+                              new SonyURL("mynetworkcamera.foo")
+                              .setFPS(20).getURL(),
+                            //new AxisURL("mynetworkcamera.foo")
+                            //.setDesiredFPS(20).getURL(),
+                              "user",
+                              "password");
+  capture.startCapture();
+  frameRate(20);
+}
+
+void draw() {
+  if (next_img != null) {
+    image(next_img, 0, 0);
+  }
+}
+
+void captureMJPEGEvent(PImage img) {
+  next_img = img;
+}
+