gtk/gdk/gdktextureprivate.h

#ifndef __GDK_TEXTURE_PRIVATE_H__
#define __GDK_TEXTURE_PRIVATE_H__

#include "gdktexture.h"

G_BEGIN_DECLS

#define GDK_TEXTURE_CLASS(klass)            (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_TEXTURE, GdkTextureClass))
#define GDK_IS_TEXTURE_CLASS(klass)         (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_TEXTURE))
#define GDK_TEXTURE_GET_CLASS(obj)          (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_TEXTURE, GdkTextureClass))

struct _GdkTexture
{
  GObject parent_instance;

  int width;
  int height;

  gpointer render_key;
  gpointer render_data;
  GDestroyNotify render_notify;
};

struct _GdkTextureClass {
  GObjectClass parent_class;

  void                  (* download)                    (GdkTexture             *texture,
                                                         const GdkRectangle     *area,
                                                         guchar                 *data,
                                                         gsize                   stride);
};

gpointer                gdk_texture_new                 (const GdkTextureClass  *klass,
                                                         int                     width,
                                                         int                     height);
GdkTexture *            gdk_texture_new_for_surface     (cairo_surface_t        *surface);
cairo_surface_t *       gdk_texture_download_surface    (GdkTexture             *texture);
void                    gdk_texture_download_area       (GdkTexture             *texture,
                                                         const GdkRectangle     *area,
                                                         guchar                 *data,
                                                         gsize                   stride);

gboolean                gdk_texture_set_render_data     (GdkTexture             *self,
                                                         gpointer                key,
                                                         gpointer                data,
                                                         GDestroyNotify          notify);
void                    gdk_texture_clear_render_data   (GdkTexture             *self);
gpointer                gdk_texture_get_render_data     (GdkTexture             *self,
                                                         gpointer                key);

G_END_DECLS

#endif /* __GDK_TEXTURE_PRIVATE_H__ */
GskTexture => GdkTexture We want this thing to replace GdkPixbuf, so it has to live in GDK. 2017-11-02 20:39:00 +00:00			`#ifndef __GDK_TEXTURE_PRIVATE_H__`
			`#define __GDK_TEXTURE_PRIVATE_H__`
gsk: Add GskTexture 2016-11-07 16:59:38 +00:00
GskTexture => GdkTexture We want this thing to replace GdkPixbuf, so it has to live in GDK. 2017-11-02 20:39:00 +00:00			`#include "gdktexture.h"`
gsk: Add GskTexture 2016-11-07 16:59:38 +00:00
			`G_BEGIN_DECLS`

GskTexture => GdkTexture We want this thing to replace GdkPixbuf, so it has to live in GDK. 2017-11-02 20:39:00 +00:00			`#define GDK_TEXTURE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_TEXTURE, GdkTextureClass))`
			`#define GDK_IS_TEXTURE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_TEXTURE))`
			`#define GDK_TEXTURE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_TEXTURE, GdkTextureClass))`
gsk: Add GskTexture 2016-11-07 16:59:38 +00:00
GskTexture => GdkTexture We want this thing to replace GdkPixbuf, so it has to live in GDK. 2017-11-02 20:39:00 +00:00			`struct _GdkTexture`
gsk: Add GskTexture 2016-11-07 16:59:38 +00:00			`{`
gsk: Turn GskTexture into a GObject 2017-01-01 12:40:13 +00:00			`GObject parent_instance;`
gsk: Add GskTexture 2016-11-07 16:59:38 +00:00
			`int width;`
			`int height;`
gsktexture: Allow attaching render data to textures This allows renderers (or anyone really) to attach "render data" to textures. Only the first render data sticks. You can gsk_texture_set_render_data() with the key you will use to look the data up again, and if no data has been set yet, yours will be set. You can retrieve this data via gsk_texture_get_render_data() later on. If your data has been cleared, NULL will be returned. When gsk_texture_clear_render_data() is called (which the texture will call when it is finalized), your destory notify will be called and you have to release your render data. The GL driver uses this to attach texture ids to GskTextures. 2016-11-16 04:37:20 +00:00
			`gpointer render_key;`
			`gpointer render_data;`
			`GDestroyNotify render_notify;`
gsk: Add GskTexture 2016-11-07 16:59:38 +00:00			`};`

GskTexture => GdkTexture We want this thing to replace GdkPixbuf, so it has to live in GDK. 2017-11-02 20:39:00 +00:00			`struct _GdkTextureClass {`
gsk: Turn GskTexture into a GObject 2017-01-01 12:40:13 +00:00			`GObjectClass parent_class;`
gsk: Rework GskTexture We do no longer bind textures to a renderer, instead they are a way for applications to provide texture data. For now, that's it. We've reverted to uploading it from scratch every frame. 2016-11-16 03:14:32 +00:00
GskTexture => GdkTexture We want this thing to replace GdkPixbuf, so it has to live in GDK. 2017-11-02 20:39:00 +00:00			`void (* download) (GdkTexture *texture,`
texture: Change download vfunc A problem with textures is that they can become too big for GPU memory, which would require tiling. But for tiling we only need to download the pixels needed by the tile. Similarly, there might be interest to not upload full textures if a renderer knows it only needs a small part. Both of these methods require the ability to specify an area of the texture to be downloaded. So change the download vfunc to include this parameter now before we add even more textures later. A private gdk_texture_download_area() function has also been added, but nobody is using it yet. 2018-03-12 16:17:30 +00:00			`const GdkRectangle *area,`
gsk: Add gsk_texture_download() API Now users can download pixels and make everything slooooooow. 2016-12-21 21:11:52 +00:00			`guchar *data,`
			`gsize stride);`
gsk: Rework GskTexture We do no longer bind textures to a renderer, instead they are a way for applications to provide texture data. For now, that's it. We've reverted to uploading it from scratch every frame. 2016-11-16 03:14:32 +00:00			`};`

GskTexture => GdkTexture We want this thing to replace GdkPixbuf, so it has to live in GDK. 2017-11-02 20:39:00 +00:00			`gpointer gdk_texture_new (const GdkTextureClass *klass,`
gsk: Rework GskTexture We do no longer bind textures to a renderer, instead they are a way for applications to provide texture data. For now, that's it. We've reverted to uploading it from scratch every frame. 2016-11-16 03:14:32 +00:00			`int width,`
			`int height);`
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 * gdk_texture_new_for_surface (cairo_surface_t *surface);`
			`cairo_surface_t * gdk_texture_download_surface (GdkTexture *texture);`
texture: Change download vfunc A problem with textures is that they can become too big for GPU memory, which would require tiling. But for tiling we only need to download the pixels needed by the tile. Similarly, there might be interest to not upload full textures if a renderer knows it only needs a small part. Both of these methods require the ability to specify an area of the texture to be downloaded. So change the download vfunc to include this parameter now before we add even more textures later. A private gdk_texture_download_area() function has also been added, but nobody is using it yet. 2018-03-12 16:17:30 +00:00			`void gdk_texture_download_area (GdkTexture *texture,`
			`const GdkRectangle *area,`
			`guchar *data,`
			`gsize stride);`
gsk: Add GskTexture 2016-11-07 16:59:38 +00:00
GskTexture => GdkTexture We want this thing to replace GdkPixbuf, so it has to live in GDK. 2017-11-02 20:39:00 +00:00			`gboolean gdk_texture_set_render_data (GdkTexture *self,`
gsktexture: Allow attaching render data to textures This allows renderers (or anyone really) to attach "render data" to textures. Only the first render data sticks. You can gsk_texture_set_render_data() with the key you will use to look the data up again, and if no data has been set yet, yours will be set. You can retrieve this data via gsk_texture_get_render_data() later on. If your data has been cleared, NULL will be returned. When gsk_texture_clear_render_data() is called (which the texture will call when it is finalized), your destory notify will be called and you have to release your render data. The GL driver uses this to attach texture ids to GskTextures. 2016-11-16 04:37:20 +00:00			`gpointer key,`
			`gpointer data,`
			`GDestroyNotify notify);`
GskTexture => GdkTexture We want this thing to replace GdkPixbuf, so it has to live in GDK. 2017-11-02 20:39:00 +00:00			`void gdk_texture_clear_render_data (GdkTexture *self);`
			`gpointer gdk_texture_get_render_data (GdkTexture *self,`
gsktexture: Allow attaching render data to textures This allows renderers (or anyone really) to attach "render data" to textures. Only the first render data sticks. You can gsk_texture_set_render_data() with the key you will use to look the data up again, and if no data has been set yet, yours will be set. You can retrieve this data via gsk_texture_get_render_data() later on. If your data has been cleared, NULL will be returned. When gsk_texture_clear_render_data() is called (which the texture will call when it is finalized), your destory notify will be called and you have to release your render data. The GL driver uses this to attach texture ids to GskTextures. 2016-11-16 04:37:20 +00:00			`gpointer key);`

gsk: Add GskTexture 2016-11-07 16:59:38 +00:00			`G_END_DECLS`

GskTexture => GdkTexture We want this thing to replace GdkPixbuf, so it has to live in GDK. 2017-11-02 20:39:00 +00:00			`#endif /* __GDK_TEXTURE_PRIVATE_H__ */`