Add Chromium-only Blender WebEngine parity work

blender-5.2.0/source/blender/gpu/GPU_immediate.hh

@@ -0,0 +1,149 @@
+/* SPDX-FileCopyrightText: 2016 Blender Authors
+ *
+ * SPDX-License-Identifier: GPL-2.0-or-later */
+
+/** \file
+ * \ingroup gpu
+ *
+ * GPU immediate mode work-alike
+ */
+
+#pragma once
+
+#include "GPU_batch.hh"
+#include "GPU_immediate_util.hh" /* IWYU pragma: export */
+#include "GPU_primitive.hh"
+#include "GPU_shader.hh"
+#include "GPU_texture.hh"
+#include "GPU_vertex_format.hh"
+
+namespace blender {
+
+namespace gpu {
+class UniformBuf;
+}  // namespace gpu
+
+/** Returns a cleared vertex format, ready for #add_attr. */
+GPUVertFormat *immVertexFormat();
+
+/** Every #immBegin must have a program bound first. */
+void immBindShader(gpu::Shader *shader);
+/** Call after your last immEnd, or before binding another program. */
+void immUnbindProgram();
+/**
+ * Check if there is a shader bound.
+ *
+ * Useful to trigger asserts when immediate mode drawing and
+ * batch based drawing are mixed. It isn't allowed to have an immediate mode shader bound when a
+ * batch is drawn.
+ *
+ * TODO: We should move these asserts to batch drawing, but didn't do that as it was never forced.
+ */
+bool immIsShaderBound();
+
+/** Must supply exactly vertex_len vertices. */
+void immBegin(GPUPrimType, uint vertex_len);
+/** Can supply fewer vertices. */
+void immBeginAtMost(GPUPrimType, uint max_vertex_len);
+void immEnd(); /* finishes and draws. */
+
+/* - #immBegin a batch, then use standard `imm*` functions as usual.
+ * - #immEnd will finalize the batch instead of drawing.
+ *
+ * Then you can draw it as many times as you like!
+ * Partially replaces the need for display lists. */
+
+gpu::Batch *immBeginBatch(GPUPrimType, uint vertex_len);
+gpu::Batch *immBeginBatchAtMost(GPUPrimType, uint vertex_len);
+
+/* Provide attribute values that can change per vertex. */
+/* First vertex after immBegin must have all its attributes specified. */
+/* Skipped attributes will continue using the previous value for that attr_id. */
+void immAttr1f(uint attr_id, float x);
+void immAttr2f(uint attr_id, float x, float y);
+void immAttr3f(uint attr_id, float x, float y, float z);
+void immAttr4f(uint attr_id, float x, float y, float z, float w);
+
+void immAttr2i(uint attr_id, int x, int y);
+
+void immAttr1u(uint attr_id, uint x);
+
+void immAttr2fv(uint attr_id, const float data[2]);
+void immAttr3fv(uint attr_id, const float data[3]);
+void immAttr4fv(uint attr_id, const float data[4]);
+
+void immAttr4ub(uint attr_id, unsigned char r, unsigned char g, unsigned char b, unsigned char a);
+
+void immAttr4ubv(uint attr_id, const unsigned char data[4]);
+
+/* Explicitly skip an attribute.
+ * This advanced option kills automatic value copying for this attr_id. */
+
+void immAttrSkip(uint attr_id);
+
+/* Provide one last attribute value & end the current vertex.
+ * This is most often used for 2D or 3D position (similar to #glVertex). */
+
+void immVertex2f(uint attr_id, float x, float y);
+void immVertex3f(uint attr_id, float x, float y, float z);
+void immVertex4f(uint attr_id, float x, float y, float z, float w);
+
+void immVertex2i(uint attr_id, int x, int y);
+
+void immVertex2fv(uint attr_id, const float data[2]);
+void immVertex3fv(uint attr_id, const float data[3]);
+
+void immVertex2iv(uint attr_id, const int data[2]);
+
+/* Provide uniform values that don't change for the entire draw call. */
+
+void immUniform1i(const char *name, int x);
+void immUniform1f(const char *name, float x);
+void immUniform2f(const char *name, float x, float y);
+void immUniform2fv(const char *name, const float data[2]);
+void immUniform3f(const char *name, float x, float y, float z);
+void immUniform3fv(const char *name, const float data[3]);
+void immUniform4f(const char *name, float x, float y, float z, float w);
+void immUniform4fv(const char *name, const float data[4]);
+/**
+ * Note array index is not supported for name (i.e: "array[0]").
+ */
+void immUniformArray4fv(const char *bare_name, const float *data, int count);
+void immUniformMatrix4fv(const char *name, const float data[4][4]);
+
+void immBindTexture(const char *name, gpu::Texture *tex);
+void immBindTextureSampler(const char *name, gpu::Texture *tex, GPUSamplerState state);
+void immBindUniformBuf(const char *name, gpu::UniformBuf *ubo);
+
+/* Convenience functions for setting "uniform vec4 color". */
+/* The RGB functions have implicit alpha = 1.0. */
+
+void immUniformColor4f(float r, float g, float b, float a);
+void immUniformColor4fv(const float rgba[4]);
+void immUniformColor3f(float r, float g, float b);
+void immUniformColor3fv(const float rgb[3]);
+void immUniformColor3fvAlpha(const float rgb[3], float a);
+
+void immUniformColor3ub(unsigned char r, unsigned char g, unsigned char b);
+void immUniformColor4ub(unsigned char r, unsigned char g, unsigned char b, unsigned char a);
+void immUniformColor3ubv(const unsigned char rgb[3]);
+void immUniformColor3ubvAlpha(const unsigned char rgb[3], unsigned char a);
+void immUniformColor4ubv(const unsigned char rgba[4]);
+
+/**
+ * Extend #immBindShader to use Blender's library of built-in shader programs.
+ * Use #immUnbindProgram() when done.
+ */
+void immBindBuiltinProgram(GPUBuiltinShader shader_id);
+
+/** Extend #immUniformColor to take Blender's themes. */
+void immUniformThemeColor(int color_id);
+void immUniformThemeColorAlpha(int color_id, float a);
+void immUniformThemeColor3(int color_id);
+void immUniformThemeColorShade(int color_id, int offset);
+void immUniformThemeColorShadeAlpha(int color_id, int color_offset, int alpha_offset);
+void immUniformThemeColorBlendShade(int color_id1, int color_id2, float fac, int offset);
+void immUniformThemeColorBlend(int color_id1, int color_id2, float fac);
+void immThemeColorShadeAlpha(int colorid, int coloffset, int alphaoffset);
+
+}  // namespace blender