brl/mutter
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
3649e5d828
mutter/clutter/deprecated/clutter-main.h

97 lines
4.0 KiB
C
Raw Normal View History

build: Add inclusion guards and license notices
2011-12-28 13:32:00 -05:00
/*
* Clutter.
*
* An OpenGL based 'interactive canvas' library.
*
* Copyright (C) 2011 Intel Corp
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
#error "Only <clutter/clutter.h> can be included directly."
#endif
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
#ifndef __CLUTTER_MAIN_DEPRECATED_H__
#define __CLUTTER_MAIN_DEPRECATED_H__
#include <clutter/clutter-types.h>
build: Fix compilation
2011-11-03 11:03:16 -04:00
#include <clutter/clutter-input-device.h>
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
G_BEGIN_DECLS
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
void clutter_threads_init (void);
Deprecate clutter_threads_enter()/leave() Acquiring the Clutter lock to mark critical sections is not portable, and not recommended to implement threaded applications with Clutter. The recommended pattern is to use worker threads, and schedule UI updates inside idle or timeout handlers within the main loop. We should enforce this pattern by deprecating the threads_enter()/leave() functions. For compatibility concerns, we need internal API to acquire the main lock during frame processing dispatch. https://bugzilla.gnome.org/show_bug.cgi?id=679450
2012-07-05 09:30:26 -04:00
CLUTTER_DEPRECATED_IN_1_12
void clutter_threads_enter (void);
CLUTTER_DEPRECATED_IN_1_12
void clutter_threads_leave (void);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_6
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
guint clutter_threads_add_frame_source (guint fps,
GSourceFunc func,
gpointer data);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_6
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
guint clutter_threads_add_frame_source_full (gint priority,
guint fps,
GSourceFunc func,
gpointer data,
GDestroyNotify notify);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_8_FOR(clutter_stage_set_motion_events_enabled)
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
void clutter_set_motion_events_enabled (gboolean enable);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_8_FOR(clutter_stage_get_motion_events_enabled)
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
gboolean clutter_get_motion_events_enabled (void);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_stage_ensure_redraw)
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
void clutter_redraw (ClutterStage *stage);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10_FOR(cogl_pango_font_map_clear_glyph_cache)
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
void clutter_clear_glyph_cache (void);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_backend_set_font_options)
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
void clutter_set_font_flags (ClutterFontFlags flags);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_backend_get_font_options)
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
ClutterFontFlags clutter_get_font_flags (void);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_device_manager_get_device)
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
ClutterInputDevice * clutter_get_input_device_for_id (gint id_);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_input_device_grab)
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.
2011-11-07 15:24:13 -05:00
void clutter_grab_pointer_for_device (ClutterActor *actor,
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
gint id_);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10_FOR(clutter_input_device_ungrab)
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.
2011-11-07 15:24:13 -05:00
void clutter_ungrab_pointer_for_device (gint id_);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10
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.
2011-11-07 15:24:13 -05:00
void clutter_set_default_frame_rate (guint frames_per_sec);
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10
Deprecate clutter_get_timestamp() This function should have never been made public in the first place; its output depends on a configuration option of Clutter, and it's basically useful only for internal debugging.
2011-11-15 12:47:00 -05:00
gulong clutter_get_timestamp (void);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10
Deprecate some more old, useless API We still ship clutter_get_show_fps() and clutter_get_debug_enabled() as public entry points. Yet another case of missing API review prior to the 1.0 release, so really the bucket stops around my desk. Let's deprecate these two useless functions, and reduce the API footprint of Clutter.
2011-11-15 12:58:25 -05:00
gboolean clutter_get_debug_enabled (void);
Update the deprecation macros Use the new versioned macros instead of the generic ones.
2012-02-27 10:10:13 -05:00
CLUTTER_DEPRECATED_IN_1_10
Deprecate some more old, useless API We still ship clutter_get_show_fps() and clutter_get_debug_enabled() as public entry points. Yet another case of missing API review prior to the 1.0 release, so really the bucket stops around my desk. Let's deprecate these two useless functions, and reduce the API footprint of Clutter.
2011-11-15 12:58:25 -05:00
gboolean clutter_get_show_fps (void);
main: Move deprecated symbols to a separate header The number of deprecations in clutter-main.h makes the header harder to parse, and more confusing. We can use a separate header under the deprecated subdirectory to hold all the deprecated symbols.
2011-11-02 08:32:09 -04:00
G_END_DECLS
#endif /* __CLUTTER_MAIN_DEPRECATED_H__ */
Reference in New Issue Copy Permalink