wlroots/include/wlr/render/gles2.h

/*
 * This an unstable interface of wlroots. No guarantees are made regarding the
 * future consistency of this API.
 */
#ifndef WLR_USE_UNSTABLE
#error "Add -DWLR_USE_UNSTABLE to enable unstable wlroots features"
#endif

#ifndef WLR_RENDER_GLES2_H
#define WLR_RENDER_GLES2_H

#include <GLES2/gl2.h>
#include <wlr/render/wlr_renderer.h>

struct wlr_egl;

struct wlr_renderer *wlr_gles2_renderer_create_with_drm_fd(int drm_fd);
struct wlr_renderer *wlr_gles2_renderer_create(struct wlr_egl *egl);

struct wlr_egl *wlr_gles2_renderer_get_egl(struct wlr_renderer *renderer);
bool wlr_gles2_renderer_check_ext(struct wlr_renderer *renderer,
	const char *ext);
/**
 * Returns the OpenGL FBO of current buffer.
 */
GLuint wlr_gles2_renderer_get_current_fbo(struct wlr_renderer *wlr_renderer);

struct wlr_gles2_texture_attribs {
	GLenum target; /* either GL_TEXTURE_2D or GL_TEXTURE_EXTERNAL_OES */
	GLuint tex;

	bool has_alpha;
};

bool wlr_renderer_is_gles2(struct wlr_renderer *wlr_renderer);
bool wlr_texture_is_gles2(struct wlr_texture *texture);
void wlr_gles2_texture_get_attribs(struct wlr_texture *texture,
	struct wlr_gles2_texture_attribs *attribs);

#endif
Initial pass on API stability guarantees This introduces -DWLR_USE_UNSTABLE and adds information regarding the stability status to all headers. I started with a conservative set of headers to mark as stable: - types/wlr_matrix.h - util/edges.h - util/log.h - util/region.h - xcursor.h 2018-07-13 12:40:56 +00:00			`/*`
			`* This an unstable interface of wlroots. No guarantees are made regarding the`
			`* future consistency of this API.`
			`*/`
			`#ifndef WLR_USE_UNSTABLE`
			`#error "Add -DWLR_USE_UNSTABLE to enable unstable wlroots features"`
			`#endif`

Use more consistent include guard names 2017-09-23 08:26:01 +00:00			`#ifndef WLR_RENDER_GLES2_H`
			`#define WLR_RENDER_GLES2_H`

render/gles2: provide public API to access GL texture Prior to this commit, compositors needed to render the texture to an intermediate off-screen buffer using wlr_renderer APIs if they wanted to use a custom rendering path (e.g. render to a 3D scene). A new wlr_gles2_texture_get_attribs exposes the GL texture target and ID so that compositors can render wlr_textures with their own shaders. An example of a compositor doing so is available at [1]. [1]: https://git.sr.ht/~sircmpwn/wxrc/tree/3db905b7842ac42cf1878876e647005b41f00a52/src/render.c#L227 2019-11-06 10:19:52 +00:00			`#include <GLES2/gl2.h>`
render: split render.h into wlr_renderer.h and wlr_texture.h 2018-03-19 22:16:29 +00:00			`#include <wlr/render/wlr_renderer.h>`
Switch to GLES2 Closes #13 2017-06-23 15:38:45 +00:00
Implement drm (egl) buffer attaching 2017-08-09 19:25:34 +00:00			`struct wlr_egl;`
Untie wlr_backend from wlr_renderer 2018-03-31 22:49:43 +00:00
render/gles2: introduce wlr_gles2_renderer_create_with_drm_fd 2021-04-20 18:48:22 +00:00			`struct wlr_renderer *wlr_gles2_renderer_create_with_drm_fd(int drm_fd);`
Untie wlr_backend from wlr_renderer 2018-03-31 22:49:43 +00:00			`struct wlr_renderer wlr_gles2_renderer_create(struct wlr_egl egl);`
Switch to GLES2 Closes #13 2017-06-23 15:38:45 +00:00
Introduce wlr_renderer_get_egl 2019-11-07 18:38:45 +00:00			`struct wlr_egl wlr_gles2_renderer_get_egl(struct wlr_renderer renderer);`
render/gles2: add wlr_gles2_renderer_check_ext 2020-04-21 12:52:47 +00:00			`bool wlr_gles2_renderer_check_ext(struct wlr_renderer *renderer,`
			`const char *ext);`
render: add get native paint target of renderer Add wlr_pixman_buffer_get_current_image for wlr_pixman_renderer. Add wlr_gles2_buffer_get_current_fbo for wlr_gles2_renderer. Allow get the FBO/pixman_image_t, the compositor can be add some action for FBO(for eg, attach a depth buffer), or without pixman render to pixman_image_t(for eg, use QPainter of Qt instead of pixman). 2021-05-28 05:53:24 +00:00			`/**`
			`* Returns the OpenGL FBO of current buffer.`
			`*/`
			`GLuint wlr_gles2_renderer_get_current_fbo(struct wlr_renderer *wlr_renderer);`
Introduce wlr_renderer_get_egl 2019-11-07 18:38:45 +00:00
render/gles2: provide public API to access GL texture Prior to this commit, compositors needed to render the texture to an intermediate off-screen buffer using wlr_renderer APIs if they wanted to use a custom rendering path (e.g. render to a 3D scene). A new wlr_gles2_texture_get_attribs exposes the GL texture target and ID so that compositors can render wlr_textures with their own shaders. An example of a compositor doing so is available at [1]. [1]: https://git.sr.ht/~sircmpwn/wxrc/tree/3db905b7842ac42cf1878876e647005b41f00a52/src/render.c#L227 2019-11-06 10:19:52 +00:00			`struct wlr_gles2_texture_attribs {`
			`GLenum target; /* either GL_TEXTURE_2D or GL_TEXTURE_EXTERNAL_OES */`
			`GLuint tex;`

			`bool has_alpha;`
			`};`

render/gles2: add wlr_renderer_is_gles2 Export the interface used to determine whether the wlr_renderer object is gles2. 2021-05-28 06:06:49 +00:00			`bool wlr_renderer_is_gles2(struct wlr_renderer *wlr_renderer);`
render/gles2: provide public API to access GL texture Prior to this commit, compositors needed to render the texture to an intermediate off-screen buffer using wlr_renderer APIs if they wanted to use a custom rendering path (e.g. render to a 3D scene). A new wlr_gles2_texture_get_attribs exposes the GL texture target and ID so that compositors can render wlr_textures with their own shaders. An example of a compositor doing so is available at [1]. [1]: https://git.sr.ht/~sircmpwn/wxrc/tree/3db905b7842ac42cf1878876e647005b41f00a52/src/render.c#L227 2019-11-06 10:19:52 +00:00			`bool wlr_texture_is_gles2(struct wlr_texture *texture);`
			`void wlr_gles2_texture_get_attribs(struct wlr_texture *texture,`
			`struct wlr_gles2_texture_attribs *attribs);`

Switch to GLES2 Closes #13 2017-06-23 15:38:45 +00:00			`#endif`