mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-08 17:50:10 +00:00
32625381fa
The new renderers don't support them due to the required complexity of integrating them with Vulkan and the assumptions those nodes make about the renderer (the GL renderer exports its internal APIs into the GLShader). There haven't been any complaints that I'm aware of since 4.14 was released where the default renderer does not support the nodes, so usage in public seems to be close to nonexistant. The 2 uses I know of were workarounds about missing features in GTK that have stopped since GTK now supports them: 1. GStreamer used in to do premultiplication when the old GL renderer did not do so in hardware but on the CPU. 2. Adwaita used it for masking before the mask node wa added in 4.10.
170 lines
8.1 KiB
C
170 lines
8.1 KiB
C
/* GSK - The GTK Scene Kit
|
|
*
|
|
* Copyright 2020 Red Hat Inc
|
|
*
|
|
* 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/>.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#if !defined (__GSK_H_INSIDE__) && !defined (GTK_COMPILATION)
|
|
#error "Only <gsk/gsk.h> can be included directly."
|
|
#endif
|
|
|
|
#include <stdarg.h>
|
|
|
|
#include <gsk/gsktypes.h>
|
|
#include <gsk/gskenums.h>
|
|
|
|
G_GNUC_BEGIN_IGNORE_DEPRECATIONS
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GSK_TYPE_SHADER_ARGS_BUILDER (gsk_shader_args_builder_get_type ())
|
|
|
|
/**
|
|
* GskShaderArgsBuilder:
|
|
*
|
|
* An object to build the uniforms data for a `GskGLShader`.
|
|
*/
|
|
typedef struct _GskGLShader GskGLShader GDK_DEPRECATED_TYPE_IN_4_16_FOR(GtkGLArea);
|
|
typedef struct _GskShaderArgsBuilder GskShaderArgsBuilder GDK_DEPRECATED_TYPE_IN_4_16_FOR(GtkGLArea);
|
|
|
|
#define GSK_TYPE_GL_SHADER (gsk_gl_shader_get_type ())
|
|
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
G_DECLARE_FINAL_TYPE (GskGLShader, gsk_gl_shader, GSK, GL_SHADER, GObject)
|
|
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
GskGLShader * gsk_gl_shader_new_from_bytes (GBytes *sourcecode);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
GskGLShader * gsk_gl_shader_new_from_resource (const char *resource_path);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
gboolean gsk_gl_shader_compile (GskGLShader *shader,
|
|
GskRenderer *renderer,
|
|
GError **error);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
GBytes * gsk_gl_shader_get_source (GskGLShader *shader);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
const char * gsk_gl_shader_get_resource (GskGLShader *shader);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
int gsk_gl_shader_get_n_textures (GskGLShader *shader);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
int gsk_gl_shader_get_n_uniforms (GskGLShader *shader);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
const char * gsk_gl_shader_get_uniform_name (GskGLShader *shader,
|
|
int idx);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
int gsk_gl_shader_find_uniform_by_name (GskGLShader *shader,
|
|
const char *name);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
GskGLUniformType gsk_gl_shader_get_uniform_type (GskGLShader *shader,
|
|
int idx);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
int gsk_gl_shader_get_uniform_offset (GskGLShader *shader,
|
|
int idx);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
gsize gsk_gl_shader_get_args_size (GskGLShader *shader);
|
|
|
|
|
|
/* Helpers for managing shader args */
|
|
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
GBytes * gsk_gl_shader_format_args_va (GskGLShader *shader,
|
|
va_list uniforms);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
GBytes * gsk_gl_shader_format_args (GskGLShader *shader,
|
|
...) G_GNUC_NULL_TERMINATED;
|
|
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
float gsk_gl_shader_get_arg_float (GskGLShader *shader,
|
|
GBytes *args,
|
|
int idx);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
gint32 gsk_gl_shader_get_arg_int (GskGLShader *shader,
|
|
GBytes *args,
|
|
int idx);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
guint32 gsk_gl_shader_get_arg_uint (GskGLShader *shader,
|
|
GBytes *args,
|
|
int idx);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
gboolean gsk_gl_shader_get_arg_bool (GskGLShader *shader,
|
|
GBytes *args,
|
|
int idx);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
void gsk_gl_shader_get_arg_vec2 (GskGLShader *shader,
|
|
GBytes *args,
|
|
int idx,
|
|
graphene_vec2_t *out_value);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
void gsk_gl_shader_get_arg_vec3 (GskGLShader *shader,
|
|
GBytes *args,
|
|
int idx,
|
|
graphene_vec3_t *out_value);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
void gsk_gl_shader_get_arg_vec4 (GskGLShader *shader,
|
|
GBytes *args,
|
|
int idx,
|
|
graphene_vec4_t *out_value);
|
|
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
GType gsk_shader_args_builder_get_type (void) G_GNUC_CONST;
|
|
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
GskShaderArgsBuilder *gsk_shader_args_builder_new (GskGLShader *shader,
|
|
GBytes *initial_values);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
GBytes * gsk_shader_args_builder_to_args (GskShaderArgsBuilder *builder);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
GBytes * gsk_shader_args_builder_free_to_args (GskShaderArgsBuilder *builder);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
GskShaderArgsBuilder *gsk_shader_args_builder_ref (GskShaderArgsBuilder *builder);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
void gsk_shader_args_builder_unref (GskShaderArgsBuilder *builder);
|
|
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
void gsk_shader_args_builder_set_float (GskShaderArgsBuilder *builder,
|
|
int idx,
|
|
float value);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
void gsk_shader_args_builder_set_int (GskShaderArgsBuilder *builder,
|
|
int idx,
|
|
gint32 value);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
void gsk_shader_args_builder_set_uint (GskShaderArgsBuilder *builder,
|
|
int idx,
|
|
guint32 value);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
void gsk_shader_args_builder_set_bool (GskShaderArgsBuilder *builder,
|
|
int idx,
|
|
gboolean value);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
void gsk_shader_args_builder_set_vec2 (GskShaderArgsBuilder *builder,
|
|
int idx,
|
|
const graphene_vec2_t *value);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
void gsk_shader_args_builder_set_vec3 (GskShaderArgsBuilder *builder,
|
|
int idx,
|
|
const graphene_vec3_t *value);
|
|
GDK_DEPRECATED_IN_4_16_FOR(GtkGLArea)
|
|
void gsk_shader_args_builder_set_vec4 (GskShaderArgsBuilder *builder,
|
|
int idx,
|
|
const graphene_vec4_t *value);
|
|
|
|
|
|
G_END_DECLS
|
|
|
|
G_GNUC_END_IGNORE_DEPRECATIONS
|