Documentation: add Itdb_ArtworkFormat (NEEDS WORK!)

1 files changed, 21 insertions, 2 deletions

diff --git a/src/itdb_device.h b/src/itdb_device.h
index 0d1839f..c2fdb07 100644
--- a/src/itdb_device.h
+++ b/src/itdb_device.h
@@ -100,13 +100,32 @@ struct _Itdb_Device
     gint timezone_shift;
 };
 
+/**
+ * Itdb_ArtworkFormat:
+ * @format_id:          the format id
+ * @width:              width of the image
+ * @height:             height of the image
+ * @format:             an #ItdbThumbFormat
+ * @padding:            padding (not found in SysInfoExtended -- added for
+ *                      compatibility with hardcoded artwork formats)
+ * @crop:               whether to crop the image or not
+ * @rotation:           the rotation of the image
+ * @back_color:         background color
+ * @display_width:      display width
+ * @interlaced:         whether artwork is interlaced or not
+ * @align_row_bytes:    whether artwork is aligned on row bytes or not
+ * @color_adjustment:   color adjustment
+ * @gamma:              image gamma value
+ * @associated_format:  associated format
+ *
+ * Structure representing iTunes artwork format
+ */
 struct _Itdb_ArtworkFormat {
         gint format_id;
         gint width;
         gint height;
         ItdbThumbFormat format;
-        gint32 padding; /* not found in SysInfoExtended, added
-                         * for compatibility with hardcoded artwork formats */
+        gint32 padding;
         gboolean crop;
         gint rotation;
         guchar back_color[4];