From 24e0ef10b419479553ba1292852ba939a1b10e78 Mon Sep 17 00:00:00 2001
From: Ben Fry <fry@processing.org>
Date: Mon, 3 Jun 2013 15:44:56 -0400
Subject: [PATCH] add warnings about unofficial API

---
 .../video/src/processing/video/Capture.java          | 12 ++++++++++++
 java/libraries/video/src/processing/video/Movie.java | 12 ++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/java/libraries/video/src/processing/video/Capture.java b/java/libraries/video/src/processing/video/Capture.java
index cf63e2df1..b7627b267 100644
--- a/java/libraries/video/src/processing/video/Capture.java
+++ b/java/libraries/video/src/processing/video/Capture.java
@@ -236,6 +236,8 @@ public class Capture extends PImage implements PConstants {
 
   /**
    * Disposes all the native resources associated to this capture device.
+   * 
+   * NOTE: This is not official API and may/will be removed at any time.
    */
   public void dispose() {
     if (pipeline != null) {
@@ -1070,6 +1072,8 @@ public class Capture extends PImage implements PConstants {
    * The color conversion mask is automatically set to the one required to
    * copy the frames to OpenGL.
    *
+   * NOTE: This is not official API and may/will be removed at any time.
+   * 
    * @param Object dest
    */
   public void setBufferSink(Object sink) {
@@ -1080,6 +1084,8 @@ public class Capture extends PImage implements PConstants {
 
   /**
    * Sets the object to use as destination for the frames read from the stream.
+   * 
+   * NOTE: This is not official API and may/will be removed at any time.
    *
    * @param Object dest
    * @param String mask
@@ -1090,11 +1096,17 @@ public class Capture extends PImage implements PConstants {
   }
 
 
+  /**
+   * NOTE: This is not official API and may/will be removed at any time.
+   */
   public boolean hasBufferSink() {
     return bufferSink != null;
   }
 
 
+  /**
+   * NOTE: This is not official API and may/will be removed at any time.
+   */
   public synchronized void disposeBuffer(Object buf) {
     ((Buffer)buf).dispose();
   }
diff --git a/java/libraries/video/src/processing/video/Movie.java b/java/libraries/video/src/processing/video/Movie.java
index c982b37c7..7e55b10a3 100644
--- a/java/libraries/video/src/processing/video/Movie.java
+++ b/java/libraries/video/src/processing/video/Movie.java
@@ -101,6 +101,8 @@ public class Movie extends PImage implements PConstants {
 
   /**
    * Disposes all the native resources associated to this movie.
+   * 
+   * NOTE: This is not official API and may/will be removed at any time.
    */
   public void dispose() {
     if (playbin != null) {
@@ -834,6 +836,8 @@ public class Movie extends PImage implements PConstants {
    * Sets the object to use as destination for the frames read from the stream.
    * The color conversion mask is automatically set to the one required to
    * copy the frames to OpenGL.
+   * 
+   * NOTE: This is not official API and may/will be removed at any time.
    *
    * @param Object dest
    */
@@ -846,6 +850,8 @@ public class Movie extends PImage implements PConstants {
   /**
    * Sets the object to use as destination for the frames read from the stream.
    *
+   * NOTE: This is not official API and may/will be removed at any time.
+   *
    * @param Object dest
    * @param String mask
    */
@@ -855,11 +861,17 @@ public class Movie extends PImage implements PConstants {
   }
 
 
+  /**
+   * NOTE: This is not official API and may/will be removed at any time.
+   */
   public boolean hasBufferSink() {
     return bufferSink != null;
   }
 
 
+  /**
+   * NOTE: This is not official API and may/will be removed at any time.
+   */
   public synchronized void disposeBuffer(Object buf) {
     ((Buffer)buf).dispose();
   }