[rygel/rygel-0-16] server: VisualItem, ImageItem, VideoItem: Document some properties.

[Jens Georg <jensgeorg src gnome org>]

commit bb818a5a949b9b60b912e5c256686f5ce74fad78
Author: Murray Cumming <murrayc openismus com>
Date:   Wed Sep 19 11:55:29 2012 +0200

    server: VisualItem, ImageItem, VideoItem: Document some properties.
    
    The color depth documentation is from the UPnP ContentDirectory
    specification.
    
    Conflicts:
    	src/librygel-server/rygel-image-item.vala
    	src/librygel-server/rygel-video-item.vala
    	src/librygel-server/rygel-visual-item.vala

 src/librygel-server/rygel-image-item.vala  |   18 ++++++++++++++++++
 src/librygel-server/rygel-video-item.vala  |   18 ++++++++++++++++++
 src/librygel-server/rygel-visual-item.vala |   16 ++++++++++++++++
 3 files changed, 52 insertions(+), 0 deletions(-)
---
diff --git a/src/librygel-server/rygel-image-item.vala b/src/librygel-server/rygel-image-item.vala
index c1972ff..3d6b9c8 100644
--- a/src/librygel-server/rygel-image-item.vala
+++ b/src/librygel-server/rygel-image-item.vala
@@ -1,6 +1,7 @@
 /*
  * Copyright (C) 2008 Zeeshan Ali <zeenix gmail com>.
  * Copyright (C) 2010 Nokia Corporation.
+ * Copyright (C) 2012 Intel Corporation.
  *
  * Author: Zeeshan Ali (Khattak) <zeeshanak gnome org>
  *                               <zeeshan ali nokia com>
@@ -31,10 +32,27 @@ using Gee;
 public class Rygel.ImageItem : MediaItem, VisualItem {
     public new const string UPNP_CLASS = "object.item.imageItem";
 
+    //TODO: This property documentation is not used.
+    //See valadoc bug: https://bugzilla.gnome.org/show_bug.cgi?id=684367
+
+    /**
+     * The width of the image in pixels.
+     * A value of -1 means that the width is unknown and will not, or did not, appear in DIDL-Lite XML.
+     */
     public int width { get; set; default = -1; }
+
+    /**
+     * The height of the image in pixels.
+     * A value of -1 means that the height is unknown and will not, or did not, appear in DIDL-Lite XML.
+     */
     public int height { get; set; default = -1; }
     public int pixel_width { get; set; default = -1; }
     public int pixel_height { get; set; default = -1; }
+
+    /**
+     *The number of bits per pixel used to represent the image resource.
+     * A value of -1 means that the color depth is unknown and will not, or did not, appear in DIDL-Lite XML.
+     */
     public int color_depth { get; set; default = -1; }
 
     public ArrayList<Thumbnail> thumbnails { get; protected set; }
diff --git a/src/librygel-server/rygel-video-item.vala b/src/librygel-server/rygel-video-item.vala
index 36dbd04..f64a2fd 100644
--- a/src/librygel-server/rygel-video-item.vala
+++ b/src/librygel-server/rygel-video-item.vala
@@ -1,6 +1,7 @@
 /*
  * Copyright (C) 2008 Zeeshan Ali <zeenix gmail com>.
  * Copyright (C) 2010 Nokia Corporation.
+ * Copyright (C) 2012 Intel Corporation.
  *
  * Author: Zeeshan Ali (Khattak) <zeeshanak gnome org>
  *                               <zeeshan ali nokia com>
@@ -34,10 +35,27 @@ public class Rygel.VideoItem : AudioItem, VisualItem {
 
     public string author;
 
+    //TODO: This property documentation is not used.
+    //See valadoc bug: https://bugzilla.gnome.org/show_bug.cgi?id=684367
+
+    /**
+     * The width of the item in pixels.
+     * A value of -1 means that the width is unknown and will not, or did not, appear in DIDL-Lite XML.
+     */
     public int width { get; set; default = -1; }
+
+    /**
+     * The height of the item in pixels.
+     * A value of -1 means that the height is unknown and will not, or did not, appear in DIDL-Lite XML.
+     */
     public int height { get; set; default = -1; }
     public int pixel_width { get; set; default = -1; }
     public int pixel_height { get; set; default = -1; }
+
+    /**
+     * The number of bits per pixel used to represent the video resource.
+     * A value of -1 means that the color depth is unknown and will not, or did not, appear in DIDL-Lite XML.
+     */
     public int color_depth { get; set; default = -1; }
 
     public ArrayList<Thumbnail> thumbnails { get; protected set; }
diff --git a/src/librygel-server/rygel-visual-item.vala b/src/librygel-server/rygel-visual-item.vala
index 0352f65..5514495 100644
--- a/src/librygel-server/rygel-visual-item.vala
+++ b/src/librygel-server/rygel-visual-item.vala
@@ -1,6 +1,7 @@
 /*
  * Copyright (C) 2008 Zeeshan Ali <zeenix gmail com>.
  * Copyright (C) 2010 Nokia Corporation.
+ * Copyright (C) 2012 Intel Corporation.
  *
  * Author: Zeeshan Ali (Khattak) <zeeshanak gnome org>
  *                               <zeeshan ali nokia com>
@@ -30,10 +31,25 @@ using Gst;
  * An interface that visual (video and image) items must implement.
  */
 public interface Rygel.VisualItem : MediaItem {
+
+    /**
+     * The width of the item in pixels.
+     * A value of -1 means that the width is unknown and will not, or did not, appear in DIDL-Lite XML.
+     */
     public abstract int width { get; set; }
+
+    /**
+     * The height of the item in pixels.
+     * A value of -1 means that the height is unknown and will not, or did not, appear in DIDL-Lite XML.
+     */
     public abstract int height { get; set; }
     public abstract int pixel_width { get; set; }
     public abstract int pixel_height { get; set; }
+
+    /**
+     * The number of bits per pixel used to represent the video or image resource.
+     * A value of -1 means that the color depth is unknown and will not, or did not, appear in DIDL-Lite XML.
+     */
     public abstract int color_depth { get; set; }
 
     public abstract ArrayList<Thumbnail> thumbnails { get; protected set; }