AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-09 10:20:07 +00:00
Code Issues Projects Releases Wiki Activity
main
gtk/gdk/gdkdrawcontext.h

58 lines
2.2 KiB
C
Raw Permalink Normal View History

gdk: Add GdkDrawContext This will be the base class for GdkVulkanContext and GdkGLContext.
2016-11-28 16:22:35 +00:00
/* GDK - The GIMP Drawing Kit
*
* gdkdrawcontext.h: base class for rendering system support
*
* Copyright © 2016 Benjamin Otte
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
Convert headers to #pragma once The conversion was done by guard2one.
2023-03-31 19:11:10 +00:00
#pragma once
gdk: Add GdkDrawContext This will be the base class for GdkVulkanContext and GdkGLContext.
2016-11-28 16:22:35 +00:00
Use a single compilation symbol We use a compilation symbol in our build to allow the inclusion of specific headers while building GTK, to avoid the need to include only the global header. Each namespace has its own compilation symbol because we used to have different libraries, and strict symbol visibility between libraries; now that we have a single library, and we can use private symbols across namespaces while building GTK, we should have a single compilation symbol, and simplify the build rules.
2019-11-27 13:33:43 +00:00
#if !defined (__GDK_H_INSIDE__) && !defined (GTK_COMPILATION)
gdk: Add GdkDrawContext This will be the base class for GdkVulkanContext and GdkGLContext.
2016-11-28 16:22:35 +00:00
#error "Only <gdk/gdk.h> can be included directly."
#endif
#include <gdk/gdktypes.h>
G_BEGIN_DECLS
#define GDK_TYPE_DRAW_CONTEXT (gdk_draw_context_get_type ())
#define GDK_DRAW_CONTEXT(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GDK_TYPE_DRAW_CONTEXT, GdkDrawContext))
#define GDK_IS_DRAW_CONTEXT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GDK_TYPE_DRAW_CONTEXT))
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdk: Add GdkDrawContext This will be the base class for GdkVulkanContext and GdkGLContext.
2016-11-28 16:22:35 +00:00
GType gdk_draw_context_get_type (void) G_GNUC_CONST;
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdk: Move begin/end_frame() functions As they require a draw context and the draw context is already bound to the surface, it makes much more sense and reduces abiguity by moving these APIs to the draw context. As a side effect, we simplify GdkSurface APIs to a point where GdkSurface now does not concern itself with drawing anymore at all, apart from being the object that creates draw contexts.
2018-04-23 15:28:55 +00:00
GdkDisplay * gdk_draw_context_get_display (GdkDrawContext *context);
The big versioning cleanup Remove all the old 2.x and 3.x version annotations. GTK+ 4 is a new start, and from the perspective of a GTK+ 4 developer all these APIs have been around since the beginning.
2018-02-05 19:13:20 +00:00
GDK_AVAILABLE_IN_ALL
gdk: Move begin/end_frame() functions As they require a draw context and the draw context is already bound to the surface, it makes much more sense and reduces abiguity by moving these APIs to the draw context. As a side effect, we simplify GdkSurface APIs to a point where GdkSurface now does not concern itself with drawing anymore at all, apart from being the object that creates draw contexts.
2018-04-23 15:28:55 +00:00
GdkSurface * gdk_draw_context_get_surface (GdkDrawContext *context);
gdk: Add gdk_draw_context_get_frame_region() This does the same as gdk_drawing_context_get_clip().
2018-04-20 22:47:35 +00:00
gdk: Deprecate public begin/end_frame() APIs We are using so many internal extra features that it is no longer a good idea to use these functions. And they aren't really used anyway. These extra features are also constantly in flux and rely on internal APIs, so exposing them would just cause extra pain.
2024-08-09 03:34:45 +00:00
GDK_DEPRECATED_IN_4_16
gdk: Move begin/end_frame() functions As they require a draw context and the draw context is already bound to the surface, it makes much more sense and reduces abiguity by moving these APIs to the draw context. As a side effect, we simplify GdkSurface APIs to a point where GdkSurface now does not concern itself with drawing anymore at all, apart from being the object that creates draw contexts.
2018-04-23 15:28:55 +00:00
void gdk_draw_context_begin_frame (GdkDrawContext *context,
const cairo_region_t *region);
gdk: Deprecate public begin/end_frame() APIs We are using so many internal extra features that it is no longer a good idea to use these functions. And they aren't really used anyway. These extra features are also constantly in flux and rely on internal APIs, so exposing them would just cause extra pain.
2024-08-09 03:34:45 +00:00
GDK_DEPRECATED_IN_4_16
gdk: Move begin/end_frame() functions As they require a draw context and the draw context is already bound to the surface, it makes much more sense and reduces abiguity by moving these APIs to the draw context. As a side effect, we simplify GdkSurface APIs to a point where GdkSurface now does not concern itself with drawing anymore at all, apart from being the object that creates draw contexts.
2018-04-23 15:28:55 +00:00
void gdk_draw_context_end_frame (GdkDrawContext *context);
gdk: Introduce empty frames in GdkDrawContext We need a way to commit pending subsurface changes, even when no drawing happened for the frame. empty_frame() is that way.
2023-11-09 21:41:10 +00:00
gdk: Deprecate public begin/end_frame() APIs We are using so many internal extra features that it is no longer a good idea to use these functions. And they aren't really used anyway. These extra features are also constantly in flux and rely on internal APIs, so exposing them would just cause extra pain.
2024-08-09 03:34:45 +00:00
GDK_DEPRECATED_IN_4_16
drawcontext: Add gdk_draw_context_in_frame() API This makes the previous gdk_draw_context_is_drawing() function public under a new name. I decided against the old name because we use the term "frame" for a drawing operation, so I wanted to have this boolean flag reuse the term.
2018-04-23 16:24:29 +00:00
gboolean gdk_draw_context_is_in_frame (GdkDrawContext *context);
gdk: Deprecate public begin/end_frame() APIs We are using so many internal extra features that it is no longer a good idea to use these functions. And they aren't really used anyway. These extra features are also constantly in flux and rely on internal APIs, so exposing them would just cause extra pain.
2024-08-09 03:34:45 +00:00
GDK_DEPRECATED_IN_4_16
gdk: Move begin/end_frame() functions As they require a draw context and the draw context is already bound to the surface, it makes much more sense and reduces abiguity by moving these APIs to the draw context. As a side effect, we simplify GdkSurface APIs to a point where GdkSurface now does not concern itself with drawing anymore at all, apart from being the object that creates draw contexts.
2018-04-23 15:28:55 +00:00
const cairo_region_t * gdk_draw_context_get_frame_region (GdkDrawContext *context);
gdk: Add GdkDrawContext This will be the base class for GdkVulkanContext and GdkGLContext.
2016-11-28 16:22:35 +00:00
gdk: Dissolve gdk-autocleanup.h Move the autocleanup declarations into their respective headers. While we are at it, correct the autocleanup declaration for GdkEvent to use gdk_event_unref, not g_object_unref. Oops
2022-09-23 23:08:25 +00:00
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GdkDrawContext, g_object_unref)
gdk: Add GdkDrawContext This will be the base class for GdkVulkanContext and GdkGLContext.
2016-11-28 16:22:35 +00:00
G_END_DECLS
Reference in New Issue Copy Permalink