AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
4f0cf475a5
gtk2/gtk/gtksnapshot.h

166 lines
10 KiB
C
Raw Normal View History

gtk: Add gtk_widget_snapshot() It's functionally equivalent to gtk_widget_get_render_node() but uses a GtkSnapshot argument to carry the state.
2016-11-07 18:10:49 +00:00
/* GTK - The GIMP Toolkit
* Copyright (C) 2016 Benjamin Otte <otte@gnome.org>
*
* 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/>.
*/
/*
* Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
* file for a list of people on the GTK+ Team. See the ChangeLog
* files for a list of changes. These files are distributed with
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#ifndef __GTK_SNAPSHOT_H__
#define __GTK_SNAPSHOT_H__
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif
#include <gsk/gsk.h>
snapshot: Add gtk_snapshot_render_background() and gtk_snapshot_render_frame() to be direct replacements for the old gtk_render_*() functions. Use them to replace Cairo usage completely in gtk_window_snapshot().
2016-11-13 15:16:39 +00:00
#include <gtk/gtktypes.h>
gtk: Add gtk_widget_snapshot() It's functionally equivalent to gtk_widget_get_render_node() but uses a GtkSnapshot argument to carry the state.
2016-11-07 18:10:49 +00:00
G_BEGIN_DECLS
GDK_AVAILABLE_IN_3_90
snapshot: Name api parameters consistently gtk-doc gets upset otherwise.
2016-11-18 12:57:10 +00:00
void gtk_snapshot_push (GtkSnapshot *snapshot,
snapshot: Change how gtk_snapshot_push/pop works Instead of appending a container node and adding the nodes to it as they come in, we now collect the nodes until gtk_snapshot_pop() is called and then hand them out in a container node. The caller of gtk_snapshot_push() is then responsible for doing whatever he wants with the created node. Another addigion is the keep_coordinates flag to gtk_snapshot_push() which allows callers to keep the current offset and clip region or discard it. Discarding is useful when doing transforms, keeping it is useful when inserting effect nodes (like the ones I'm about to add).
2016-12-13 01:33:15 +00:00
gboolean keep_coordinates,
snapshot: Add gtk_snapshot_render_background() and gtk_snapshot_render_frame() to be direct replacements for the old gtk_render_*() functions. Use them to replace Cairo usage completely in gtk_window_snapshot().
2016-11-13 15:16:39 +00:00
const char *name,
snapshot: Change how gtk_snapshot_push/pop works Instead of appending a container node and adding the nodes to it as they come in, we now collect the nodes until gtk_snapshot_pop() is called and then hand them out in a container node. The caller of gtk_snapshot_push() is then responsible for doing whatever he wants with the created node. Another addigion is the keep_coordinates flag to gtk_snapshot_push() which allows callers to keep the current offset and clip region or discard it. Discarding is useful when doing transforms, keeping it is useful when inserting effect nodes (like the ones I'm about to add).
2016-12-13 01:33:15 +00:00
...) G_GNUC_PRINTF (3, 4);
snapshot: Add gtk_snapshot_render_background() and gtk_snapshot_render_frame() to be direct replacements for the old gtk_render_*() functions. Use them to replace Cairo usage completely in gtk_window_snapshot().
2016-11-13 15:16:39 +00:00
GDK_AVAILABLE_IN_3_90
snapshot: Work on pushing and popping again It is now possible to call push() subfunctions for simple container nodes with just a single child. So you can for example gtk_snapshot_push_clip() a clip region that all the nodes that get appended later will then obey. gtk_snapshot_pop() will then not return a container node, but a clip node containing the container node (and similar for the transform example). This is implemented internally by providing a "collect function" when pushing that is called when popping to collects all the accumulated nodes and combine them into the single node that gets returned. To simplify things even more, gtk_snapshot_pop_and_append() has been added, which pops the currently pushed node and appends it to the parent. The icon rendering code has been converted to this approach.
2016-12-13 08:40:24 +00:00
void gtk_snapshot_push_transform (GtkSnapshot *snapshot,
const graphene_matrix_t*transform,
const char *name,
...) G_GNUC_PRINTF (3, 4);
GDK_AVAILABLE_IN_3_90
snapshot: Implement gtk_snapshot_push_opacity() Use it in GtkWidget's opacity handling.
2016-12-17 07:06:59 +00:00
void gtk_snapshot_push_opacity (GtkSnapshot *snapshot,
double opacity,
const char *name,
...) G_GNUC_PRINTF (3, 4);
GDK_AVAILABLE_IN_3_90
snapshot: Add gtk_snapshot_push_color_matrix() So far, this is unused.
2016-12-31 00:14:59 +00:00
void gtk_snapshot_push_color_matrix (GtkSnapshot *snapshot,
const graphene_matrix_t*color_matrix,
const graphene_vec4_t *color_offset,
const char *name,
gsk: Add GskRepeatNode Also add gtk_snapshot_push_repeat() and use that to draw backgrounds. With that change, CSS background snapshots are created without Cairo nodes.
2017-01-01 18:52:18 +00:00
...) G_GNUC_PRINTF (4, 5);
GDK_AVAILABLE_IN_3_90
void gtk_snapshot_push_repeat (GtkSnapshot *snapshot,
const graphene_rect_t *bounds,
const graphene_rect_t *child_bounds,
const char *name,
snapshot: Add gtk_snapshot_push_color_matrix() So far, this is unused.
2016-12-31 00:14:59 +00:00
...) G_GNUC_PRINTF (4, 5);
GDK_AVAILABLE_IN_3_90
snapshot: Work on pushing and popping again It is now possible to call push() subfunctions for simple container nodes with just a single child. So you can for example gtk_snapshot_push_clip() a clip region that all the nodes that get appended later will then obey. gtk_snapshot_pop() will then not return a container node, but a clip node containing the container node (and similar for the transform example). This is implemented internally by providing a "collect function" when pushing that is called when popping to collects all the accumulated nodes and combine them into the single node that gets returned. To simplify things even more, gtk_snapshot_pop_and_append() has been added, which pops the currently pushed node and appends it to the parent. The icon rendering code has been converted to this approach.
2016-12-13 08:40:24 +00:00
void gtk_snapshot_push_clip (GtkSnapshot *snapshot,
const graphene_rect_t *bounds,
const char *name,
...) G_GNUC_PRINTF (3, 4);
GDK_AVAILABLE_IN_3_90
gsk: Add support for rounded clip rectangles Also add support to GtkSnapshot, so people can push rounded clips.
2016-12-13 20:59:28 +00:00
void gtk_snapshot_push_rounded_clip (GtkSnapshot *snapshot,
const GskRoundedRect *bounds,
const char *name,
...) G_GNUC_PRINTF (3, 4);
GDK_AVAILABLE_IN_3_90
gsk: Add GskShadowNode ... and make the icon rendering code use it. This requires moving even more shadow renering code into GSK, but so be it. At least the "shadows not implemented" warning is now gone!
2016-12-18 23:45:35 +00:00
void gtk_snapshot_push_shadow (GtkSnapshot *snapshot,
const GskShadow *shadow,
gsize n_shadows,
const char *name,
...) G_GNUC_PRINTF (4, 5);
GDK_AVAILABLE_IN_3_90
snapshot: Change how gtk_snapshot_push/pop works Instead of appending a container node and adding the nodes to it as they come in, we now collect the nodes until gtk_snapshot_pop() is called and then hand them out in a container node. The caller of gtk_snapshot_push() is then responsible for doing whatever he wants with the created node. Another addigion is the keep_coordinates flag to gtk_snapshot_push() which allows callers to keep the current offset and clip region or discard it. Discarding is useful when doing transforms, keeping it is useful when inserting effect nodes (like the ones I'm about to add).
2016-12-13 01:33:15 +00:00
GskRenderNode * gtk_snapshot_pop (GtkSnapshot *snapshot) G_GNUC_WARN_UNUSED_RESULT;
snapshot: Work on pushing and popping again It is now possible to call push() subfunctions for simple container nodes with just a single child. So you can for example gtk_snapshot_push_clip() a clip region that all the nodes that get appended later will then obey. gtk_snapshot_pop() will then not return a container node, but a clip node containing the container node (and similar for the transform example). This is implemented internally by providing a "collect function" when pushing that is called when popping to collects all the accumulated nodes and combine them into the single node that gets returned. To simplify things even more, gtk_snapshot_pop_and_append() has been added, which pops the currently pushed node and appends it to the parent. The icon rendering code has been converted to this approach.
2016-12-13 08:40:24 +00:00
GDK_AVAILABLE_IN_3_90
void gtk_snapshot_pop_and_append (GtkSnapshot *snapshot);
snapshot: Completely reengineer API We now try to emulate cairo_t: We keep a stack of nodes via push/pop and a transform matrix. So whenever a new node is added to the snapshot, we transform it by the current transform matrix and append it to the current node.
2016-11-11 23:37:54 +00:00
GDK_AVAILABLE_IN_3_90
snapshot: Name api parameters consistently gtk-doc gets upset otherwise.
2016-11-18 12:57:10 +00:00
void gtk_snapshot_translate_2d (GtkSnapshot *snapshot,
snapshot: Completely reengineer API We now try to emulate cairo_t: We keep a stack of nodes via push/pop and a transform matrix. So whenever a new node is added to the snapshot, we transform it by the current transform matrix and append it to the current node.
2016-11-11 23:37:54 +00:00
int x,
int y);
gsk: gsk_render_node_set_transform() => GskTransformNode Instead of having a setter for the transform, have a GskTransformNode. Most of the oprations that GTK does do not require a transform, so it doesn't make sense to have it as a primary attribute. Also, changing the transform requires updating the uniforms of the GL renderer, so we're happy if we can avoid that.
2016-12-12 23:11:06 +00:00
GDK_AVAILABLE_IN_3_90
void gtk_snapshot_get_offset (GtkSnapshot *snapshot,
double *x,
double *y);
snapshot: Completely reengineer API We now try to emulate cairo_t: We keep a stack of nodes via push/pop and a transform matrix. So whenever a new node is added to the snapshot, we transform it by the current transform matrix and append it to the current node.
2016-11-11 23:37:54 +00:00
GDK_AVAILABLE_IN_3_90
snapshot: Name api parameters consistently gtk-doc gets upset otherwise.
2016-11-18 12:57:10 +00:00
void gtk_snapshot_append_node (GtkSnapshot *snapshot,
snapshot: Completely reengineer API We now try to emulate cairo_t: We keep a stack of nodes via push/pop and a transform matrix. So whenever a new node is added to the snapshot, we transform it by the current transform matrix and append it to the current node.
2016-11-11 23:37:54 +00:00
GskRenderNode *node);
GDK_AVAILABLE_IN_3_90
snapshot: Name api parameters consistently gtk-doc gets upset otherwise.
2016-11-18 12:57:10 +00:00
cairo_t * gtk_snapshot_append_cairo_node (GtkSnapshot *snapshot,
snapshot: Completely reengineer API We now try to emulate cairo_t: We keep a stack of nodes via push/pop and a transform matrix. So whenever a new node is added to the snapshot, we transform it by the current transform matrix and append it to the current node.
2016-11-11 23:37:54 +00:00
const graphene_rect_t *bounds,
const char *name,
...) G_GNUC_PRINTF(3, 4);
snapshot: Add API for colors and textures
2016-12-13 03:22:13 +00:00
GDK_AVAILABLE_IN_3_90
void gtk_snapshot_append_texture_node (GtkSnapshot *snapshot,
GskTexture *texture,
const graphene_rect_t *bounds,
const char *name,
...) G_GNUC_PRINTF (4, 5);
GDK_AVAILABLE_IN_3_90
void gtk_snapshot_append_color_node (GtkSnapshot *snapshot,
const GdkRGBA *color,
const graphene_rect_t *bounds,
const char *name,
...) G_GNUC_PRINTF (4, 5);
gtk: Add gtk_widget_snapshot() It's functionally equivalent to gtk_widget_get_render_node() but uses a GtkSnapshot argument to carry the state.
2016-11-07 18:10:49 +00:00
snapshot: Add gtk_css_gadget_snapshot() Including a snpahsot() vfunc, wee!
2016-11-13 19:47:34 +00:00
GDK_AVAILABLE_IN_3_90
gboolean gtk_snapshot_clips_rect (GtkSnapshot *snapshot,
const graphene_rect_t *bounds);
snapshot: Add gtk_snapshot_render_background() and gtk_snapshot_render_frame() to be direct replacements for the old gtk_render_*() functions. Use them to replace Cairo usage completely in gtk_window_snapshot().
2016-11-13 15:16:39 +00:00
GDK_AVAILABLE_IN_3_90
snapshot: Name api parameters consistently gtk-doc gets upset otherwise.
2016-11-18 12:57:10 +00:00
void gtk_snapshot_render_background (GtkSnapshot *snapshot,
snapshot: Add gtk_snapshot_render_background() and gtk_snapshot_render_frame() to be direct replacements for the old gtk_render_*() functions. Use them to replace Cairo usage completely in gtk_window_snapshot().
2016-11-13 15:16:39 +00:00
GtkStyleContext *context,
gdouble x,
gdouble y,
gdouble width,
gdouble height);
GDK_AVAILABLE_IN_3_90
snapshot: Name api parameters consistently gtk-doc gets upset otherwise.
2016-11-18 12:57:10 +00:00
void gtk_snapshot_render_frame (GtkSnapshot *snapshot,
snapshot: Add gtk_snapshot_render_background() and gtk_snapshot_render_frame() to be direct replacements for the old gtk_render_*() functions. Use them to replace Cairo usage completely in gtk_window_snapshot().
2016-11-13 15:16:39 +00:00
GtkStyleContext *context,
gdouble x,
gdouble y,
gdouble width,
gdouble height);
snapshot: Port to GtkSwitch Included is the addition of gtk_snapshot_render_layout(), which is meant to replace gtk_render_layout().
2016-11-13 22:54:30 +00:00
GDK_AVAILABLE_IN_3_90
snapshot: Name api parameters consistently gtk-doc gets upset otherwise.
2016-11-18 12:57:10 +00:00
void gtk_snapshot_render_focus (GtkSnapshot *snapshot,
snapshot: Convert GtkLabel and GtkAccelLabel Also adds gtk_snapshot_render_insertion_cursor().
2016-11-14 21:58:58 +00:00
GtkStyleContext *context,
gdouble x,
gdouble y,
gdouble width,
gdouble height);
GDK_AVAILABLE_IN_3_90
snapshot: Name api parameters consistently gtk-doc gets upset otherwise.
2016-11-18 12:57:10 +00:00
void gtk_snapshot_render_layout (GtkSnapshot *snapshot,
snapshot: Port to GtkSwitch Included is the addition of gtk_snapshot_render_layout(), which is meant to replace gtk_render_layout().
2016-11-13 22:54:30 +00:00
GtkStyleContext *context,
gdouble x,
gdouble y,
PangoLayout *layout);
snapshot: Convert GtkLabel and GtkAccelLabel Also adds gtk_snapshot_render_insertion_cursor().
2016-11-14 21:58:58 +00:00
GDK_AVAILABLE_IN_3_90 /* in gtkstylecontext.c */
void gtk_snapshot_render_insertion_cursor (GtkSnapshot *snapshot,
GtkStyleContext *context,
gdouble x,
gdouble y,
PangoLayout *layout,
int index,
PangoDirection direction);
snapshot: Convert GtkImage and GtkIconHelper Adds a bunch of new APIs to render textures with theming. FIXME: Cannot draw shadows for textures.
2016-11-15 05:19:16 +00:00
GDK_AVAILABLE_IN_3_90
void gtk_snapshot_render_icon (GtkSnapshot *snapshot,
GtkStyleContext *context,
GdkPixbuf *pixbuf,
gdouble x,
gdouble y);
snapshot: Add gtk_snapshot_render_background() and gtk_snapshot_render_frame() to be direct replacements for the old gtk_render_*() functions. Use them to replace Cairo usage completely in gtk_window_snapshot().
2016-11-13 15:16:39 +00:00
gtk: Add gtk_widget_snapshot() It's functionally equivalent to gtk_widget_get_render_node() but uses a GtkSnapshot argument to carry the state.
2016-11-07 18:10:49 +00:00
G_END_DECLS
#endif /* __GTK_SNAPSHOT_H__ */
Reference in New Issue Copy Permalink