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

173 lines
11 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);
Add gtk_snapshot_push_blur() This function is similar to the other push functions. This one uses the newly created blur node.
2017-09-03 03:50:39 +00:00
GDK_AVAILABLE_IN_3_92
void gtk_snapshot_push_blur (GtkSnapshot *snapshot,
double radius,
const char *name,
...) G_GNUC_PRINTF (3, 4);
snapshot: Implement gtk_snapshot_push_opacity() Use it in GtkWidget's opacity handling.
2016-12-17 07:06:59 +00:00
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: Add gtk_snapshot_push_blend() and use it for backgrounds.
2017-01-12 22:20:31 +00:00
void gtk_snapshot_push_blend (GtkSnapshot *snapshot,
GskBlendMode blend_mode,
const char *name,
...) G_GNUC_PRINTF (3, 4);
GDK_AVAILABLE_IN_3_90
Add gtk_snapshot_push_cross_fade() ... and use it. The function is a bit awkward because it requires 2 calls to gtk_snapshot_pop(), but once you accept that, it's very convenient to use, as can be seen by the 2 implementations.
2017-01-12 21:00:38 +00:00
void gtk_snapshot_push_cross_fade (GtkSnapshot *snapshot,
double progress,
const char *name,
...) G_GNUC_PRINTF (3, 4);
GDK_AVAILABLE_IN_3_90
snapshot: Redo pop() API gtk_snapshot_pop() => removed gtk_snapshot_pop_and_append() => gtk_snapshot_pop() So now there is no way to get a rendernode out of the snapshotting API until you gtk_snapshot_finish().
2017-01-12 23:39:59 +00:00
void gtk_snapshot_pop (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: Rename gtk_snapshot_translate_2d() It's now called gtk_snapshot_offset().
2017-01-13 13:36:56 +00:00
void gtk_snapshot_offset (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,
GtkSnapshot: Always use int for the translation We already take ints when setting the translation, so it can't currently take any other values. Additionally, I was seeing large costs in int -> double -> int for the rects in gtk_snapshot_clips_rect(), as all callers really are ints (widget allocations) and the clip region is int-based. This change completely cleared a 2% rectangle_init_from_graphene from the profile and is likely to have nice performance effects elsewhere too.
2017-01-11 15:14:03 +00:00
int *x,
int *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: Rename append APIs Instead of having gtk_snapshot_append_foo_node(), just have gtk_snapshot_append_foo(). Nobody needs to know that this internally uses nodes.
2017-01-13 03:46:09 +00:00
cairo_t * gtk_snapshot_append_cairo (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
snapshot: Rename append APIs Instead of having gtk_snapshot_append_foo_node(), just have gtk_snapshot_append_foo(). Nobody needs to know that this internally uses nodes.
2017-01-13 03:46:09 +00:00
void gtk_snapshot_append_texture (GtkSnapshot *snapshot,
GskTexture => GdkTexture We want this thing to replace GdkPixbuf, so it has to live in GDK.
2017-11-02 20:39:00 +00:00
GdkTexture *texture,
snapshot: Add API for colors and textures
2016-12-13 03:22:13 +00:00
const graphene_rect_t *bounds,
const char *name,
...) G_GNUC_PRINTF (4, 5);
GDK_AVAILABLE_IN_3_90
snapshot: Rename append APIs Instead of having gtk_snapshot_append_foo_node(), just have gtk_snapshot_append_foo(). Nobody needs to know that this internally uses nodes.
2017-01-13 03:46:09 +00:00
void gtk_snapshot_append_color (GtkSnapshot *snapshot,
snapshot: Add API for colors and textures
2016-12-13 03:22:13 +00:00
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,
GtkSnapshot: Always use int for the translation We already take ints when setting the translation, so it can't currently take any other values. Additionally, I was seeing large costs in int -> double -> int for the rects in gtk_snapshot_clips_rect(), as all callers really are ints (widget allocations) and the clip region is int-based. This change completely cleared a 2% rectangle_init_from_graphene from the profile and is likely to have nice performance effects elsewhere too.
2017-01-11 15:14:03 +00:00
const cairo_rectangle_int_t *bounds);
snapshot: Add gtk_css_gadget_snapshot() Including a snpahsot() vfunc, wee!
2016-11-13 19:47:34 +00:00
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: 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