mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-10 10:50:10 +00:00
105 lines
2.8 KiB
C
105 lines
2.8 KiB
C
/* GDK - The GIMP Drawing Kit
|
|
*
|
|
* gdkcairocontext.c: Cairo wrappers
|
|
*
|
|
* Copyright © 2018 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/>.
|
|
*/
|
|
|
|
#include "config.h"
|
|
|
|
#include "gdkcairocontext.h"
|
|
|
|
#include "gdkcairocontextprivate.h"
|
|
|
|
#include "gdkcairo.h"
|
|
#include "gdkinternals.h"
|
|
|
|
/**
|
|
* SECTION:gdkcairocontext
|
|
* @Title: GdkCairoContext
|
|
* @Short_description: Cairo draw context
|
|
*
|
|
* #GdkCairoContext is an object representing the platform-specific
|
|
* draw context.
|
|
*
|
|
* #GdkCairoContexts are created for a #GdkDisplay using
|
|
* gdk_surface_create_cairo_context(), and the context can then be used
|
|
* to draw on that #GdkSurface.
|
|
*/
|
|
|
|
/**
|
|
* GdkCairoContext:
|
|
*
|
|
* The GdkCairoContext struct contains only private fields and should not
|
|
* be accessed directly.
|
|
*/
|
|
|
|
typedef struct _GdkCairoContextPrivate GdkCairoContextPrivate;
|
|
|
|
struct _GdkCairoContextPrivate {
|
|
gpointer unused;
|
|
};
|
|
|
|
G_DEFINE_ABSTRACT_TYPE_WITH_CODE (GdkCairoContext, gdk_cairo_context, GDK_TYPE_DRAW_CONTEXT,
|
|
G_ADD_PRIVATE (GdkCairoContext))
|
|
|
|
static void
|
|
gdk_cairo_context_class_init (GdkCairoContextClass *klass)
|
|
{
|
|
}
|
|
|
|
static void
|
|
gdk_cairo_context_init (GdkCairoContext *self)
|
|
{
|
|
}
|
|
|
|
/**
|
|
* gdk_cairo_context_cairo_create:
|
|
* @self: a #GdkCairoContext that is currently drawing
|
|
*
|
|
* Retrieves a Cairo context to be used to draw on the #GdkSurface
|
|
* of @context. A call to gdk_draw_context_begin_frame() with this
|
|
* @context must have been done or this function will return %NULL.
|
|
*
|
|
* The returned context is guaranteed to be valid until
|
|
* gdk_draw_context_end_frame() is called.
|
|
*
|
|
* Returns: (transfer full) (nullable): a Cairo context to be used
|
|
* to draw the contents of the #GdkSurface. %NULL is returned
|
|
* when @context is not drawing.
|
|
*/
|
|
cairo_t *
|
|
gdk_cairo_context_cairo_create (GdkCairoContext *self)
|
|
{
|
|
GdkDrawContext *draw_context;
|
|
cairo_t *cr;
|
|
|
|
g_return_val_if_fail (GDK_IS_CAIRO_CONTEXT (self), NULL);
|
|
|
|
draw_context = GDK_DRAW_CONTEXT (self);
|
|
|
|
if (!gdk_draw_context_is_in_frame (draw_context))
|
|
return NULL;
|
|
|
|
cr = GDK_CAIRO_CONTEXT_GET_CLASS (self)->cairo_create (self);
|
|
|
|
gdk_cairo_region (cr, gdk_draw_context_get_frame_region (draw_context));
|
|
cairo_clip (cr);
|
|
|
|
return cr;
|
|
}
|
|
|