gtk2/gdk/gdktextureprivate.h

#ifndef __GDK_TEXTURE_PRIVATE_H__
#define __GDK_TEXTURE_PRIVATE_H__

#include "gdktexture.h"

#include "gdkenums.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;

  GdkMemoryFormat format;
  int width;
  int height;

  gpointer render_key;
  gpointer render_data;
  GDestroyNotify render_notify;
};

struct _GdkTextureClass {
  GObjectClass parent_class;

  /* mandatory: Download in the given format into data */
  void                  (* download)                    (GdkTexture             *texture,
                                                         GdkMemoryFormat         format,
                                                         guchar                 *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);

void                    gdk_texture_do_download         (GdkTexture             *texture,
                                                         GdkMemoryFormat         format,
                                                         guchar                 *data,
                                                         gsize                   stride);
GdkMemoryFormat         gdk_texture_get_format          (GdkTexture             *self);
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
gdk: Split enums from types Add gdkenums.h for enums and keep gdktypes.h for types. Makes both files easier to read. 2021-10-25 00:14:18 +00:00			`#include "gdkenums.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
texture: Make format a property of GdkTexture For MemoryTexture, this is a simple change. For GLTexture, we need to query the format at texture creation. This sounds like a bad idea and extra work until one realizes that we'd need to do that anyway when using the texure the first time - either when downloading, or when trying to use it in a rendernode, where we will soon need that information to determine if the texture prefers high depth. 2021-10-07 00:41:30 +00:00			`GdkMemoryFormat format;`
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: Refactor downloading Pass a format do GdkTextureClass::download(). That way we can download data in any format. Also replace gdk_texture_download_texture() with gdk_memory_texture_from_texture() which again takes a format. The old functionality is still there for code that wants it: Just pass gdk_texture_get_format (texture) as the format argument. 2021-10-07 04:19:41 +00:00			`/* mandatory: Download in the given format into data */`
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: Refactor downloading Pass a format do GdkTextureClass::download(). That way we can download data in any format. Also replace gdk_texture_download_texture() with gdk_memory_texture_from_texture() which again takes a format. The old functionality is still there for code that wants it: Just pass gdk_texture_get_format (texture) as the format argument. 2021-10-07 04:19:41 +00:00			`GdkMemoryFormat format,`
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			`};`

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);`
gsk: Add GskTexture 2016-11-07 16:59:38 +00:00
texture: Refactor downloading Pass a format do GdkTextureClass::download(). That way we can download data in any format. Also replace gdk_texture_download_texture() with gdk_memory_texture_from_texture() which again takes a format. The old functionality is still there for code that wants it: Just pass gdk_texture_get_format (texture) as the format argument. 2021-10-07 04:19:41 +00:00			`void gdk_texture_do_download (GdkTexture *texture,`
			`GdkMemoryFormat format,`
			`guchar *data,`
			`gsize stride);`
texture: Make format a property of GdkTexture For MemoryTexture, this is a simple change. For GLTexture, we need to query the format at texture creation. This sounds like a bad idea and extra work until one realizes that we'd need to do that anyway when using the texure the first time - either when downloading, or when trying to use it in a rendernode, where we will soon need that information to determine if the texture prefers high depth. 2021-10-07 00:41:30 +00:00			`GdkMemoryFormat gdk_texture_get_format (GdkTexture *self);`
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__ */`