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;

  /* mandatory: Download into a GdkMemoryTexture */
  GdkTexture *          (* download_texture)            (GdkTexture             *texture);
  /* optional */
  void                  (* download)                    (GdkTexture             *texture,
                                                         guchar                 *data,
                                                         gsize                   stride);
  void                  (* download_float)              (GdkTexture             *texture,
                                                         float                  *data,
                                                         gsize                   stride);
};

gboolean                gdk_texture_can_load            (GBytes                 *bytes);

GdkTexture *            gdk_texture_new_for_surface     (cairo_surface_t        *surface);
cairo_surface_t *       gdk_texture_download_surface    (GdkTexture             *texture);
/* NB: GdkMemoryTexture */
GdkTexture *            gdk_texture_download_texture    (GdkTexture             *texture);

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
texture: Add gdk_texture_download_texture() A private vfunc that downloads a texture as a GdkMemoryTexture in whatever format the texture deems best. There are multiple reasons for this: * GLES cannot download the Cairo format. But it can download some format and then just delegate to the GdkMemoryTexture implementation. * All the other download vfuncs (including the ones still coming) can be implemented via download_texture() and delegation, making the interface easier. * We want to implement image loading and saving support. By using download_texture(), we can save in the actual format of the texture. * A potential GdkCompressedTexture could be implemented by just providing this one vfunc as a compress() step. 2021-09-12 02:42:24 +00:00			`/* mandatory: Download into a GdkMemoryTexture */`
			`GdkTexture * (* download_texture) (GdkTexture *texture);`
			`/* optional */`
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,`
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);`
texture: Add gdk_texture_download_float() 2021-09-10 00:40:21 +00:00			`void (* download_float) (GdkTexture *texture,`
			`float *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			`};`

texture: Add private can_load() function ... and use it to load textures in gtk_picture_set_from_file(). 2021-09-14 15:40:09 +00:00			`gboolean gdk_texture_can_load (GBytes *bytes);`

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: Add gdk_texture_download_texture() A private vfunc that downloads a texture as a GdkMemoryTexture in whatever format the texture deems best. There are multiple reasons for this: * GLES cannot download the Cairo format. But it can download some format and then just delegate to the GdkMemoryTexture implementation. * All the other download vfuncs (including the ones still coming) can be implemented via download_texture() and delegation, making the interface easier. * We want to implement image loading and saving support. By using download_texture(), we can save in the actual format of the texture. * A potential GdkCompressedTexture could be implemented by just providing this one vfunc as a compress() step. 2021-09-12 02:42:24 +00:00			`/* NB: GdkMemoryTexture */`
			`GdkTexture * gdk_texture_download_texture (GdkTexture *texture);`
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__ */`