main: Deprecate clutter_set_default_frame_rate()

Setting the default frame rate does not do anything even remotely
useful, unless synchronization to the vertical refresh rate is also
disabled - which can only be done through environment variable or
through configuration file. Having a programmatic way to change the
default frame rate is, thus, completely pointless.

Changing the default frame rate through environment variable and
configuration file is still allowed.

diff --git a/clutter/clutter-main.c b/clutter/clutter-main.c
index be520fd..c24d399 100644 (file)
--- a/clutter/clutter-main.c
+++ b/clutter/clutter-main.c
@@ -2701,19 +2701,14 @@ clutter_get_default_frame_rate (void)
  * is possible, this value is ignored.
  *
  * Since: 0.6
+ *
+ * Deprecated: 1.10: This function does not do anything any more.
  */
 void
 clutter_set_default_frame_rate (guint frames_per_sec)
 {
-  ClutterMainContext *context;
-
-  context = _clutter_context_get_default ();
-
-  if (context->frame_rate != frames_per_sec)
-    context->frame_rate = frames_per_sec;
 }
 
-
 static void
 on_grab_actor_destroy (ClutterActor       *actor,
                        ClutterInputDevice *device)

diff --git a/clutter/clutter-main.h b/clutter/clutter-main.h
index 3cd7846..175356b 100644 (file)
--- a/clutter/clutter-main.h
+++ b/clutter/clutter-main.h
@@ -127,9 +127,6 @@ guint                   clutter_threads_add_repaint_func        (GSourceFunc
                                                                  GDestroyNotify notify);
 void                    clutter_threads_remove_repaint_func     (guint          handle_id);
 
-void                    clutter_set_default_frame_rate          (guint          frames_per_sec);
-guint                   clutter_get_default_frame_rate          (void);
-
 void                    clutter_grab_pointer                    (ClutterActor  *actor);
 void                    clutter_ungrab_pointer                  (void);
 ClutterActor *          clutter_get_pointer_grab                (void);
@@ -141,6 +138,8 @@ PangoFontMap *          clutter_get_font_map                    (void);
 
 ClutterTextDirection    clutter_get_default_text_direction      (void);
 
+guint                   clutter_get_default_frame_rate          (void);
+
 G_END_DECLS
 
 #endif /* _CLUTTER_MAIN_H__ */

diff --git a/clutter/deprecated/clutter-main.h b/clutter/deprecated/clutter-main.h
index 342d42d..4ec39b6 100644 (file)
--- a/clutter/deprecated/clutter-main.h
+++ b/clutter/deprecated/clutter-main.h
@@ -42,11 +42,14 @@ CLUTTER_DEPRECATED_FOR(clutter_device_manager_get_device)
 ClutterInputDevice *    clutter_get_input_device_for_id         (gint id_);
 
 CLUTTER_DEPRECATED_FOR(clutter_input_device_grab)
-void             clutter_grab_pointer_for_device                (ClutterActor     *actor,
+void                    clutter_grab_pointer_for_device         (ClutterActor     *actor,
                                                                  gint              id_);
 
 CLUTTER_DEPRECATED_FOR(clutter_input_device_ungrab)
-void             clutter_ungrab_pointer_for_device              (gint              id_);
+void                    clutter_ungrab_pointer_for_device       (gint              id_);
+
+CLUTTER_DEPRECATED
+void                    clutter_set_default_frame_rate          (guint             frames_per_sec);
 
 G_END_DECLS