617858e453
This unifies vertex and texture data formats into a single base enum class. `TextureFormat` and `VertexFormat` then mask the invalid format for their respective usage. Having a base enum allows casting between `TextureFormat` and `VertexFormat` possible (needed for Buffer Textures). It also makes it easier to write and read data to buffers/textures as each format will have an associated host type. These enum is generated from MACRO expansion. This allow to centralize all information about the formats in one place. This avoid duplicating the list of enums for each backend. This only creates the new enum. Porting older enums will be done in other PRs. Normalized integer CPU format are missing and waiting for #130640 Rel #130632 Pull Request: https://projects.blender.org/blender/blender/pulls/138069
134 lines
5.1 KiB
C++
134 lines
5.1 KiB
C++
/* 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"
|
|
|
|
struct GPUUniformBuf;
|
|
|
|
/** Returns a cleared vertex format, ready for #add_attr. */
|
|
GPUVertFormat *immVertexFormat();
|
|
|
|
/** Every #immBegin must have a program bound first. */
|
|
void immBindShader(GPUShader *shader);
|
|
/** Call after your last immEnd, or before binding another program. */
|
|
void immUnbindProgram();
|
|
|
|
/** 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. */
|
|
|
|
blender::gpu::Batch *immBeginBatch(GPUPrimType, uint vertex_len);
|
|
blender::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, GPUTexture *tex);
|
|
void immBindTextureSampler(const char *name, GPUTexture *tex, GPUSamplerState state);
|
|
void immBindUniformBuf(const char *name, GPUUniformBuf *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(eGPUBuiltinShader 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);
|