Merge lp:~unity-team/unity/unity.fix-594232 into lp:unity

[Mirco Müller]

This branch monitors GNOME's desktop-background settings (wallpaper and gradient). Upon startup of unity the correct image or gradient (or solid color) is rendered. Changes to those settings after unity was started are also taken into account.

Remaining features to be implemented are filed as bugs LP: #605788 (support all picture-options) and LP: #605442 (wallpaper-slideshows).

[Neil J. Patel (njpatel)]

Nice stuff!

review: Approve

=== modified file 'configure.ac'
--- configure.ac	2010-07-13 15:04:53 +0000
+++ configure.ac	2010-07-15 08:32:44 +0000
@@ -105,8 +105,10 @@
                   gio-2.0 >= $GTK_REQUIRED
                   gee-1.0
                   gconf-2.0
+                  gnome-desktop-2.0
                   indicator
                   libbamf >= 0.2
+                  libgnomeui-2.0
                   unique-1.0
                   unity-misc
                   x11)

=== modified file 'unity-private/Makefile.am'
--- unity-private/Makefile.am	2010-06-21 10:10:30 +0000
+++ unity-private/Makefile.am	2010-07-15 08:32:44 +0000
@@ -22,6 +22,7 @@
   -DINDICATORICONSDIR=\""$(INDICATORICONSDIR)"\" \
   -DGETTEXT_PACKAGE=\"$(GETTEXT_PACKAGE)\" \
   -DG_LOG_DOMAIN=\"libunity-private\" \
+  -DGNOME_DESKTOP_USE_UNSTABLE_API \
   $(BASE_CFLAGS) \
   $(MAINTAINER_CFLAGS) \
   -I$(top_srcdir)/unity/ \
@@ -51,6 +52,7 @@
   --pkg gee-1.0 \
   --pkg gio-unix-2.0 \
   --pkg gtk+-2.0 \
+  --pkg gnome-bg-2.0 \
   --pkg indicator \
   --pkg Bamf-0.2 \
   --pkg libwnck-1.0 \

=== modified file 'unity-private/testing/background.vala'
--- unity-private/testing/background.vala	2010-04-07 15:39:23 +0000
+++ unity-private/testing/background.vala	2010-07-15 08:32:44 +0000
@@ -15,115 +15,219 @@
  *
  * Authored by Neil Jagdish Patel <[e-mail]>
  *
+ * FIXME: wallpaper-slideshows are not yet supported by this class
  */
 
 namespace Unity.Testing
 {
   public class Background : Ctk.Bin
   {
-    /* Gnome Desktop background gconf keys */
-    private string BG_DIR    = "/desktop/gnome/background";
-    private string BG_FILE   = "/desktop/gnome/background/picture_filename";
-    private string BG_OPTION = "/desktop/gnome/background/picture_options";
-
+    private string BG_DIR        = "/desktop/gnome/background";
+    private string BG_PIC_OPTS   = "/desktop/gnome/background/picture_options";
+    private string BG_SHADE_TYPE = "/desktop/gnome/background/color_shading_type";
+    private string BG_PRIM_COL   = "/desktop/gnome/background/primary_color";
+    private string BG_SEC_COL    = "/desktop/gnome/background/secondary_color";
+    private string BG_FILENAME   = "/desktop/gnome/background/picture_filename";
+
+    private string DEFAULT_PIC_OPTS   = "none";
+    private string DEFAULT_SHADE_TYPE = "solid";
+    private string DEFAULT_AMBIANCE_COL = "#2C2C00001E1E"; // Ubuntu Dark Purple
+    private string DEFAULT_RADIANCE_COL = "#AEAEA7A79F9F"; // Ubuntu Grey
+    private string DEFAULT_FILENAME   = "/usr/share/backgrounds/warty-final.png";
+
+    private Clutter.CairoTexture bg_gradient;
+    private Clutter.Texture      bg_image;
+    private Gnome.BG             gbg;
+    private GConf.Client         client;
+
+    private string pic_opts;
+    private string shade_type;
+    private string prim_col;
+    private string sec_col;
     private string filename;
-    private string option;
-
-    private Clutter.Texture bg;
 
     construct
     {
       START_FUNCTION ();
-      var client = GConf.Client.get_default ();
-
-      /* Setup the initial properties and notifies */
+
+      this.gbg = new Gnome.BG ();
+      this.client = GConf.Client.get_default ();
+
+      /* register monitoring background-directory with gconf */
       try
         {
-          client.add_dir (this.BG_DIR, GConf.ClientPreloadType.NONE);
+          this.client.add_dir (this.BG_DIR, GConf.ClientPreloadType.NONE);
         }
       catch (GLib.Error e)
         {
+          warning ("Background: Unable to monitor background-settings: %s",
+                   e.message);
+        }
+
+      /* load values from gconf */
+      try
+        {
+          this.pic_opts = this.client.get_string (this.BG_PIC_OPTS);
+        }
+      catch (Error e)
+        {
+          this.pic_opts = DEFAULT_PIC_OPTS;
+        }
+
+      try
+        {
+          this.shade_type = this.client.get_string (this.BG_SHADE_TYPE);
+        }
+      catch (Error e)
+        {
+          this.shade_type = DEFAULT_SHADE_TYPE;
+        }
+
+      try
+        {
+          this.prim_col = this.client.get_string (this.BG_PRIM_COL);
+        }
+      catch (Error e)
+        {
+          this.prim_col = DEFAULT_AMBIANCE_COL;
+        }
+
+      try
+        {
+          this.sec_col = this.client.get_string (this.BG_SEC_COL);
+        }
+      catch (Error e)
+        {
+          this.sec_col = DEFAULT_AMBIANCE_COL;
+        }
+
+      try
+        {
+          this.filename = this.client.get_string (this.BG_FILENAME);
+        }
+      catch (Error e)
+        {
+          this.filename = DEFAULT_FILENAME;
+        }
+
+      /* register monitor */
+      try
+       {
+          this.client.notify_add (this.BG_DIR, this._on_gconf_changed);
+        }
+      catch (Error e)
+        {
           warning ("Background: Unable to monitor background: %s", e.message);
         }
 
-      try
-        {
-          this.filename = client.get_string (this.BG_FILE);
-        }
-      catch (Error e)
-        {
-          this.filename = "/usr/share/backgrounds/warty-final.png";
-        }
-
-      try
-        {
-          client.notify_add (this.BG_FILE, this.on_filename_changed);
-        }
-      catch (Error e)
-        {
-          warning ("Background: Unable to monitor background filename: %s",
-                   e.message);
-        }
-      try
-        {
-          this.option = client.get_string (this.BG_OPTION);
-        }
-      catch (Error e)
-        {
-          this.option = "wallpaper";
-        }
-      try
-        {
-          client.notify_add (this.BG_OPTION, this.on_option_changed);
-        }
-      catch (Error e)
-        {
-          warning ("Background: Unable to monitor background options: %s",
-                   e.message);
-        }
-
-      /* The texture that will show the background */
-      this.bg = new Clutter.Texture ();
-      this.bg.set_load_async (true);
-      this.add_actor (this.bg);
-      this.bg.show ();
-
-      /* Load the texture */
-      this.ensure_layout ();
+      this.bg_gradient = new Clutter.CairoTexture (1, 1);
+      this.bg_gradient.name = "bg_gradient";
+      this.bg_image = new Clutter.Texture ();
+      this.bg_image.name = "bg_image";
+
+      // setting async. loading to TRUE here, requires hooking up to
+      // "allocation-changed" for the texture-image, otherwise we cannot get
+      // valid values for a texture-images base-size, which is needed to
+      // correctly handle image-placement... this sucks balls!!!
+      this.bg_image.set_load_async (true);
+      this.bg_image.load_finished.connect (_handle_image_placement);
+
+      this.gbg.load_from_preferences (client);
+
+      // this is needed for the bg_gradient to have the correct size
+      this.allocation_changed.connect (_on_allocation_changed);
+
       END_FUNCTION ();
     }
 
-    private void on_filename_changed (GConf.Client client,
-                                      uint         cxnid,
-                                      GConf.Entry  entry)
-    {
-      var new_filename = entry.get_value ().get_string ();
-
-      if (new_filename == this.filename)
-        return;
-
-      this.filename = new_filename;
-      this.ensure_layout ();
-    }
-
-    private void on_option_changed (GConf.Client client,
-                                     uint         cxnid,
-                                     GConf.Entry  entry)
-    {
-      var new_option = entry.get_value ().get_string ();
-
-      if (new_option == this.option)
-        return;
-
-      this.option = new_option;
-      this.ensure_layout ();
-    }
-
-    private void ensure_layout ()
-    {
+    private void
+    _handle_image_placement ()
+    {
+      Gnome.BGPlacement placement = this.gbg.get_placement ();
+
+      switch (placement)
+        {
+          case Gnome.BGPlacement.TILED:
+            {
+              this.bg_image.set_repeat (true, true);
+              this.bg_image.set_sync_size (true);
+              this.x = 0.0f;
+              this.y = 0.0f;
+            }
+          break;
+
+          case Gnome.BGPlacement.ZOOMED:
+            {
+              this.bg_image.set_repeat (false, false);
+              this.bg_image.set_sync_size (false);
+              this.bg_image.set_keep_aspect_ratio (true);
+              this.x = 0.0f;
+              this.y = 0.0f;
+            }
+          break;
+
+          case Gnome.BGPlacement.CENTERED:
+            {
+              this.bg_image.set_repeat (false, false);
+              this.bg_image.set_sync_size (false);
+              this.bg_image.set_keep_aspect_ratio (false);
+              this.x = 0.0f;
+              this.y = 0.0f;
+            }
+          break;
+
+          case Gnome.BGPlacement.SCALED:
+            {
+              this.bg_image.set_keep_aspect_ratio (true);
+              this.bg_image.set_sync_size (false);
+              this.x = 0.0f;
+              this.y = 0.0f;
+            }
+          break;
+
+          case Gnome.BGPlacement.FILL_SCREEN:
+            {
+              this.bg_image.set_keep_aspect_ratio (false);
+              this.x = 0.0f;
+              this.y = 0.0f;
+            }
+          break;
+
+          case Gnome.BGPlacement.SPANNED:
+            {
+              this.bg_image.set_repeat (false, false);
+              this.bg_image.set_sync_size (true);
+              this.bg_image.set_keep_aspect_ratio (true);
+              this.x = 0.0f;
+              this.y = 0.0f;
+            }
+          break;
+        }
+    }
+
+    private void
+    _on_allocation_changed ()
+    {
+      if (this.filename != "")
+        _update_image ();
+      else
+        _update_gradient ();
+    }
+
+    private void
+    _update_image ()
+    {
+
+      if (this.find_child_by_name ("bg_image") != this.bg_image)
+        {
+          this.remove_actor (this.bg_gradient);
+          this.add_actor (this.bg_image);
+          this.bg_image.show ();
+        }
+
       try
         {
-          this.bg.set_from_file (this.filename);
+          this.bg_image.set_from_file (this.filename);
         }
       catch (Error e)
         {
@@ -131,8 +235,190 @@
                    this.filename,
                    e.message);
         }
-
-      this.queue_relayout ();
+    }
+
+    private void
+    _update_gradient ()
+    {
+      Gnome.BGColorType type;
+      Gdk.Color         primary;
+      Gdk.Color         secondary;
+
+      if (this.find_child_by_name ("bg_gradient") != this.bg_gradient)
+        {
+          this.remove_actor (this.bg_image);
+          this.add_actor (this.bg_gradient);
+          this.bg_gradient.show ();
+        }
+
+      this.x = 0.0f;
+      this.y = 0.0f;
+
+      this.gbg.get_color (out type, out primary, out secondary);
+
+      this.bg_gradient.set_surface_size ((uint) this.width,
+                                         (uint) this.height);
+
+      switch (type)
+        {
+          case Gnome.BGColorType.SOLID:
+            {
+
+              Cairo.Context cr = this.bg_gradient.create ();
+              cr.set_operator (Cairo.Operator.OVER);
+              cr.scale (1.0f, 1.0f);
+              cr.set_source_rgb ((double) primary.red   / (double) 0xffff,
+                                 (double) primary.green / (double) 0xffff,
+                                 (double) primary.blue  / (double) 0xffff);
+              cr.rectangle (0.0f,
+                            0.0f,
+                            (double) this.width,
+                            (double) this.height);
+              cr.fill ();
+            }
+          break;
+
+          case Gnome.BGColorType.V_GRADIENT:
+            {
+              Cairo.Context cr  = this.bg_gradient.create ();
+              Cairo.Pattern pat = new Cairo.Pattern.linear (0.0f,
+                                                            0.0f,
+                                                            0.0f,
+                                                            (double) this.height);
+              cr.set_operator (Cairo.Operator.OVER);
+              cr.scale (1.0f, 1.0f);
+              pat.add_color_stop_rgb (0.0f,
+                                      (double) primary.red   / (double) 0xffff,
+                                      (double) primary.green / (double) 0xffff,
+                                      (double) primary.blue  / (double) 0xffff);
+              pat.add_color_stop_rgb (1.0f,
+                                      (double) secondary.red   / (double) 0xffff,
+                                      (double) secondary.green / (double) 0xffff,
+                                      (double) secondary.blue  / (double) 0xffff);
+              cr.set_source (pat);
+              cr.rectangle (0.0f,
+                            0.0f,
+                            (double) this.width,
+                            (double) this.height);
+              cr.fill ();
+            }
+          break;
+
+          case Gnome.BGColorType.H_GRADIENT:
+            {
+              Cairo.Context cr  = this.bg_gradient.create ();
+              Cairo.Pattern pat = new Cairo.Pattern.linear (0.0f,
+                                                            0.0f,
+                                                            (double) this.width,
+                                                            0.0f);
+              cr.set_operator (Cairo.Operator.OVER);
+              cr.scale (1.0f, 1.0f);
+              pat.add_color_stop_rgb (0.0f,
+                                      (double) primary.red   / (double) 0xffff,
+                                      (double) primary.green / (double) 0xffff,
+                                      (double) primary.blue  / (double) 0xffff);
+              pat.add_color_stop_rgb (1.0f,
+                                      (double) secondary.red   / (double) 0xffff,
+                                      (double) secondary.green / (double) 0xffff,
+                                      (double) secondary.blue  / (double) 0xffff);
+              cr.set_source (pat);
+              cr.rectangle (0.0f,
+                            0.0f,
+                            (double) this.width,
+                            (double) this.height);
+              cr.fill ();
+            }
+          break;
+        }
+    }
+
+    private void
+    _on_gconf_changed (GConf.Client client,
+                       uint         cxnid,
+                       GConf.Entry  entry)
+    {
+      bool   needs_update = false;
+      string new_value;
+
+      this.gbg.load_from_preferences (client);
+
+      try
+        {
+          new_value = this.client.get_string (this.BG_PIC_OPTS);
+        }
+      catch (Error e)
+        {
+          new_value = DEFAULT_PIC_OPTS;
+        }
+      if (new_value != this.pic_opts)
+      {
+        this.pic_opts = new_value;
+        needs_update = true;
+      }
+
+      try
+        {
+          new_value = this.client.get_string (this.BG_SHADE_TYPE);
+        }
+      catch (Error e)
+        {
+          new_value = DEFAULT_SHADE_TYPE;
+        }
+      if (new_value != this.shade_type)
+      {
+        this.shade_type = new_value;
+        needs_update = true;
+      }
+
+      try
+        {
+          new_value = this.client.get_string (this.BG_PRIM_COL);
+        }
+      catch (Error e)
+        {
+          new_value = DEFAULT_AMBIANCE_COL;
+        }
+      if (new_value != this.prim_col)
+      {
+        this.prim_col = new_value;
+        needs_update = true;
+      }
+
+      try
+        {
+          new_value = this.client.get_string (this.BG_SEC_COL);
+        }
+      catch (Error e)
+        {
+          new_value = DEFAULT_AMBIANCE_COL;
+        }
+      if (new_value != this.sec_col)
+        {
+          this.sec_col = new_value;
+          needs_update = true;
+        }
+
+      try
+        {
+          new_value = this.client.get_string (this.BG_FILENAME);
+        }
+      catch (Error e)
+       {
+         new_value = DEFAULT_FILENAME;
+       }
+      if (new_value != this.filename)
+      {
+        this.filename = new_value;
+        needs_update = true;
+      }
+
+      if (needs_update)
+        {
+          if (this.filename != "")
+            _update_image ();
+          else
+            _update_gradient ();
+        }
     }
   }
 }

=== modified file 'vapi/Makefile.am'
--- vapi/Makefile.am	2010-06-02 12:05:59 +0000
+++ vapi/Makefile.am	2010-07-15 08:32:44 +0000
@@ -14,4 +14,5 @@
   mutter-2.28.vapi \
   mutter-2.28.deps \
   unity-const.vapi \
-  unity-misc.vapi
+  unity-misc.vapi \
+  gnome-bg-2.0.vapi

=== added file 'vapi/gnome-bg-2.0.vapi'
--- vapi/gnome-bg-2.0.vapi	1970-01-01 00:00:00 +0000
+++ vapi/gnome-bg-2.0.vapi	2010-07-15 08:32:44 +0000
@@ -0,0 +1,242 @@
+/* gnome-desktop-2.0.vapi generated by vapigen, do not modify. */
+
+[CCode (cprefix = "Gnome", lower_case_cprefix = "gnome_")]
+namespace Gnome {
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class BG : GLib.Object {
+		[CCode (has_construct_function = false)]
+		public BG ();
+		public bool changes_with_time ();
+		public unowned Gdk.Pixbuf create_frame_thumbnail (Gnome.DesktopThumbnailFactory factory, Gdk.Screen screen, int dest_width, int dest_height, int frame_num);
+		public unowned Gdk.Pixmap create_pixmap (Gdk.Window window, int width, int height, bool root);
+		public unowned Gdk.Pixbuf create_thumbnail (Gnome.DesktopThumbnailFactory factory, Gdk.Screen screen, int dest_width, int dest_height);
+		public void draw (Gdk.Pixbuf dest, Gdk.Screen screen, bool is_root);
+		public void get_color (out Gnome.BGColorType type, out Gdk.Color primary, out Gdk.Color secondary);
+		public unowned string get_filename ();
+		public bool get_image_size (Gnome.DesktopThumbnailFactory factory, int best_width, int best_height, int width, int height);
+		public static unowned Gdk.Pixmap get_pixmap_from_root (Gdk.Screen screen);
+		public Gnome.BGPlacement get_placement ();
+		public bool has_multiple_sizes ();
+		public bool is_dark (int dest_width, int dest_height);
+		public void load_from_preferences (GConf.Client client);
+		public void save_to_preferences (GConf.Client client);
+		public void set_color (Gnome.BGColorType type, Gdk.Color primary, Gdk.Color secondary);
+		public void set_filename (string filename);
+		public static void set_pixmap_as_root (Gdk.Screen screen, Gdk.Pixmap pixmap);
+		public static unowned Gnome.BGCrossfade set_pixmap_as_root_with_crossfade (Gdk.Screen screen, Gdk.Pixmap pixmap);
+		public void set_placement (Gnome.BGPlacement placement);
+		public virtual signal void changed ();
+		public virtual signal void transitioned ();
+	}
+	[Compact]
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class BGClass {
+	}
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class BGCrossfade : GLib.Object {
+		[CCode (has_construct_function = false)]
+		public BGCrossfade (int width, int height);
+		public bool is_started ();
+		public bool set_end_pixmap (Gdk.Pixmap pixmap);
+		public bool set_start_pixmap (Gdk.Pixmap pixmap);
+		public void start (Gdk.Window window);
+		public void stop ();
+		[NoAccessorMethod]
+		public int height { get; construct; }
+		[NoAccessorMethod]
+		public int width { get; construct; }
+		public virtual signal void finished (GLib.Object window);
+	}
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class DesktopThumbnailFactory : GLib.Object {
+		[CCode (has_construct_function = false)]
+		public DesktopThumbnailFactory (Gnome.DesktopThumbnailSize size);
+		public bool can_thumbnail (string uri, string mime_type, ulong mtime);
+		public void create_failed_thumbnail (string uri, ulong mtime);
+		public unowned Gdk.Pixbuf generate_thumbnail (string uri, string mime_type);
+		public bool has_valid_failed_thumbnail (string uri, ulong mtime);
+		public unowned string lookup (string uri, ulong mtime);
+		public void save_thumbnail (Gdk.Pixbuf thumbnail, string uri, ulong original_mtime);
+	}
+	[Compact]
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class OutputInfo {
+		public double aspect;
+		public bool connected;
+		public weak string display_name;
+		public int height;
+		public weak string name;
+		public bool on;
+		public int pref_height;
+		public int pref_width;
+		public bool primary;
+		public uint product;
+		public int rate;
+		public Gnome.RRRotation rotation;
+		public uint serial;
+		public void* user_data;
+		[CCode (array_length = false)]
+		public weak string[] vendor;
+		public int width;
+		public int x;
+		public int y;
+	}
+	[Compact]
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class RRConfig {
+		public bool clone;
+		public weak Gnome.OutputInfo outputs;
+		public bool applicable (Gnome.RRScreen screen) throws GLib.Error;
+		public bool apply (Gnome.RRScreen screen) throws GLib.Error;
+		public static bool apply_from_filename (Gnome.RRScreen screen, string filename) throws GLib.Error;
+		public static bool apply_from_filename_with_time (Gnome.RRScreen screen, string filename, uint32 timestamp) throws GLib.Error;
+		public static bool apply_stored (Gnome.RRScreen screen) throws GLib.Error;
+		public bool apply_with_time (Gnome.RRScreen screen, uint32 timestamp) throws GLib.Error;
+		[CCode (has_construct_function = false)]
+		public RRConfig.current (Gnome.RRScreen screen);
+		public bool equal (Gnome.RRConfig config2);
+		public static unowned string get_backup_filename ();
+		public static unowned string get_intended_filename ();
+		public bool match (Gnome.RRConfig config2);
+		public void sanitize ();
+		public bool save () throws GLib.Error;
+		[CCode (has_construct_function = false)]
+		public RRConfig.stored (Gnome.RRScreen screen) throws GLib.Error;
+	}
+	[Compact]
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class RRCrtc {
+		public bool can_drive_output (Gnome.RROutput output);
+		public unowned Gnome.RRMode get_current_mode ();
+		public Gnome.RRRotation get_current_rotation ();
+		public bool get_gamma (int size, uint red, uint green, uint blue);
+		public uint32 get_id ();
+		public void get_position (int x, int y);
+		public Gnome.RRRotation get_rotations ();
+		public bool set_config (int x, int y, Gnome.RRMode mode, Gnome.RRRotation rotation, Gnome.RROutput[] outputs) throws GLib.Error;
+		public bool set_config_with_time (uint32 timestamp, int x, int y, Gnome.RRMode mode, Gnome.RRRotation rotation, Gnome.RROutput[] outputs) throws GLib.Error;
+		public void set_gamma (int size, uint red, uint green, uint blue);
+		public bool supports_rotation (Gnome.RRRotation rotation);
+	}
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class RRLabeler : GLib.Object {
+		[CCode (has_construct_function = false)]
+		public RRLabeler (Gnome.RRConfig config);
+		public void get_color_for_output (Gnome.OutputInfo output, Gdk.Color color_out);
+		public void hide ();
+	}
+	[Compact]
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class RRLabelerClass {
+	}
+	[Compact]
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class RRMode {
+		public int get_freq ();
+		public uint get_height ();
+		public uint32 get_id ();
+		public uint get_width ();
+	}
+	[Compact]
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class RROutput {
+		public bool can_clone (Gnome.RROutput clone);
+		public unowned string get_connector_type ();
+		public unowned Gnome.RRCrtc get_crtc ();
+		public unowned Gnome.RRMode get_current_mode ();
+		public uchar get_edid_data ();
+		public int get_height_mm ();
+		public uint32 get_id ();
+		public bool get_is_primary ();
+		public unowned string get_name ();
+		public void get_position (int x, int y);
+		public unowned Gnome.RRCrtc get_possible_crtcs ();
+		public unowned Gnome.RRMode get_preferred_mode ();
+		public int get_size_inches ();
+		public int get_width_mm ();
+		public bool is_connected ();
+		public bool is_laptop ();
+		public unowned Gnome.RRMode list_modes ();
+		public bool supports_mode (Gnome.RRMode mode);
+	}
+	[Compact]
+	[CCode (free_function = "gnome_rr_screen_destroy", cheader_filename = "libgnomeui/gnome-bg.h")]
+	public class RRScreen {
+		[CCode (has_construct_function = false)]
+		public RRScreen (Gdk.Screen screen, Gnome.RRScreenChanged callback, void* data) throws GLib.Error;
+		public unowned Gnome.RRCrtc get_crtc_by_id (uint32 id);
+		public unowned Gnome.RROutput get_output_by_id (uint32 id);
+		public unowned Gnome.RROutput get_output_by_name (string name);
+		public void get_ranges (int min_width, int max_width, int min_height, int max_height);
+		public void get_timestamps (uint32 change_timestamp_ret, uint32 config_timestamp_ret);
+		public unowned Gnome.RRMode list_clone_modes ();
+		public unowned Gnome.RRCrtc list_crtcs ();
+		public unowned Gnome.RRMode list_modes ();
+		public unowned Gnome.RROutput list_outputs ();
+		public bool refresh () throws GLib.Error;
+		public void set_primary_output (Gnome.RROutput output);
+		public void set_size (int width, int height, int mm_width, int mm_height);
+	}
+	[CCode (cprefix = "GNOME_BG_COLOR_", has_type_id = false, cheader_filename = "libgnomeui/gnome-bg.h")]
+	public enum BGColorType {
+		SOLID,
+		H_GRADIENT,
+		V_GRADIENT
+	}
+	[CCode (cprefix = "GNOME_BG_PLACEMENT_", has_type_id = false, cheader_filename = "libgnomeui/gnome-bg.h")]
+	public enum BGPlacement {
+		TILED,
+		ZOOMED,
+		CENTERED,
+		SCALED,
+		FILL_SCREEN,
+		SPANNED
+	}
+	[CCode (cprefix = "GNOME_DESKTOP_THUMBNAIL_SIZE_", has_type_id = false, cheader_filename = "libgnomeui/gnome-bg.h")]
+	public enum DesktopThumbnailSize {
+		NORMAL,
+		LARGE
+	}
+	[CCode (cprefix = "GNOME_RR_ERROR_", has_type_id = false, cheader_filename = "libgnomeui/gnome-bg.h")]
+	public enum RRError {
+		UNKNOWN,
+		NO_RANDR_EXTENSION,
+		RANDR_ERROR,
+		BOUNDS_ERROR,
+		CRTC_ASSIGNMENT,
+		NO_MATCHING_CONFIG
+	}
+	[CCode (cprefix = "GNOME_RR_", has_type_id = false, cheader_filename = "libgnomeui/gnome-bg.h")]
+	public enum RRRotation {
+		ROTATION_0,
+		ROTATION_90,
+		ROTATION_180,
+		ROTATION_270,
+		REFLECT_X,
+		REFLECT_Y
+	}
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public delegate void RRScreenChanged (Gnome.RRScreen screen);
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public const string BG_KEY_DIR;
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public const string RR_CONNECTOR_TYPE_PANEL;
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public static bool desktop_thumbnail_has_uri (Gdk.Pixbuf pixbuf, string uri);
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public static bool desktop_thumbnail_is_valid (Gdk.Pixbuf pixbuf, string uri, ulong mtime);
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public static unowned string desktop_thumbnail_md5 (string uri);
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public static unowned string desktop_thumbnail_path_for_uri (string uri, Gnome.DesktopThumbnailSize size);
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public static unowned Gdk.Pixbuf desktop_thumbnail_scale_down_pixbuf (Gdk.Pixbuf pixbuf, int dest_width, int dest_height);
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public static unowned Gnome.RRMode rr_create_clone_modes (Gnome.RRScreen screen);
+	[CCode (cheader_filename = "libgnomeui/gnome-bg.h")]
+	public static GLib.Quark rr_error_quark ();
+	[CCode (cname = "ubuntu_compute_virtual_size_for_configuration", cheader_filename = "libgnomeui/gnome-bg.h")]
+	public static void ubuntu_compute_virtual_size_for_configuration (Gnome.RRConfig config, int ret_width, int ret_height);
+	[CCode (cname = "ubuntu_gnome_rr_config_save_desired", cheader_filename = "libgnomeui/gnome-bg.h")]
+	public static bool ubuntu_gnome_rr_config_save_desired (Gnome.RRConfig configuration) throws GLib.Error;
+}