Refactor and document classes under main org.freedesktop.gstreamer package. Move event classes to event package, message classes to message package, query classes to query package, and webrtc classes to webrtc package. Delete various unused classes, and deprecate methods to be removed later.

Author: neilcsmith-net

src/org/freedesktop/gstreamer/Bin.java

@@ -1,4 +1,5 @@
 /* 
+ * Copyright (c) 2019 Neil C Smith
  * Copyright (C) 2007 Wayne Meissner
  * Copyright (C) 1999,2000 Erik Walthinsen <[email protected]>
  *                    2000 Wim Taymans <[email protected]>
@@ -20,13 +21,12 @@
 
 package org.freedesktop.gstreamer;
 
-import org.freedesktop.gstreamer.lowlevel.IntegerEnum;
-import org.freedesktop.gstreamer.lowlevel.annotations.DefaultEnumValue;
+import org.freedesktop.gstreamer.glib.NativeFlags;
 
 /**
  * A set of buffer flags used to describe properties of a {@link Buffer}.
  */
-public enum BufferFlag implements IntegerEnum {
+public enum BufferFlag implements NativeFlags<BufferFlag> {
 
     /**  
      * the {@link Buffer} is live data and should be discarded in the PAUSED state.
@@ -93,12 +93,21 @@ public enum BufferFlag implements IntegerEnum {
      */
     SYNC_AFTER(MiniObjectFlags.LAST.intValue() << 11),
 
+    /**
+     * This buffer is important and should not be dropped. This can be used to
+     * mark important buffers, e.g. to flag RTP packets carrying keyframes or
+     * codec setup data for RTP Forward Error Correction purposes, or to prevent
+     * still video frames from being dropped by elements due to QoS. (Since
+     * 1.14)
+
+     */
+    @Gst.Since(minor = 14)
+    NON_DROPPABLE(MiniObjectFlags.LAST.intValue() << 12),
+    
     /* padding */
-    LAST(MiniObjectFlags.LAST.intValue() << 16),
+    LAST(MiniObjectFlags.LAST.intValue() << 16);
 
-    /** The value used for unknown native values */
-    @DefaultEnumValue
-    UNKNOWN(~0);
+    private final int value;
 
     private BufferFlag(int value) {
         this.value = value;
@@ -111,5 +120,4 @@ public final int intValue() {
         return value;
     }
 
-    private final int value;
 }

src/org/freedesktop/gstreamer/Buffer.java

@@ -1,4 +1,5 @@
 /*
+ * Copyright (c) 2019 Neil C Smith
  * Copyright (c) 2016 Christophe Lafolet
  *
  * This file is part of gstreamer-java.
@@ -21,30 +22,51 @@
 
 import com.sun.jna.Pointer;
 
+/**
+ * A BufferPool is an object that can be used to pre-allocate and recycle
+ * buffers of the same size and with the same properties.
+ * <p>
+ *  See upstream documentation at
+ * <a href="https://gstreamer.freedesktop.org/data/doc/gstreamer/stable/gstreamer/html/GstBufferPool.html"
+ * >https://gstreamer.freedesktop.org/data/doc/gstreamer/stable/gstreamer/html/GstBufferPool.html</a>
+ */
 public class BufferPool extends GstObject {
 
     public static final String GTYPE_NAME = "GstBufferPool";
 
+    /**
+     * Creates a new instance of BufferPool
+     */
+    public BufferPool() {
+        this(initializer(GstBufferPoolAPI.GSTBUFFERPOOL_API.ptr_gst_buffer_pool_new()));
+    }
+    
     /**
      * This constructor is for internal use only.
      * @param init initialization data.
      */
-    public BufferPool(final Initializer init) {
+    BufferPool(final Initializer init) {
         super(init);
     }
 
     /**
-     * Creates a new instance of BufferPool
+     * Configure the BufferPool with the given parameters.
+     * 
+     * @param caps the {@link Caps} for the buffers
+     * @param size the size of each buffer, not including prefix and padding
+     * @param min_buffers the minimum amount of buffers to allocate
+     * @param max_buffers the maximum amount of buffers to allocate or 0 for unlimited
      */
-    public BufferPool() {
-        this(initializer(GstBufferPoolAPI.GSTBUFFERPOOL_API.ptr_gst_buffer_pool_new()));
-    }
-
     public void setParams(Caps caps, int size, int min_buffers, int max_buffers) {
     	Structure config = GstBufferPoolAPI.GSTBUFFERPOOL_API.gst_buffer_pool_get_config(this);
     	GstBufferPoolAPI.GSTBUFFERPOOL_API.gst_buffer_pool_config_set_params(config, caps, size, min_buffers, max_buffers);
     }
 
+    /**
+     * Query the {@link Caps} configured on the BufferPool.
+     * 
+     * @return Caps configured on the BufferPool
+     */
     public Caps getCaps() {
     	Structure config = GstBufferPoolAPI.GSTBUFFERPOOL_API.gst_buffer_pool_get_config(this);
     	Pointer[] ptr = new Pointer[1];