c1bc70b711
A lot of files were missing copyright field in the header and
the Blender Foundation contributed to them in a sense of bug
fixing and general maintenance.
This change makes it explicit that those files are at least
partially copyrighted by the Blender Foundation.
Note that this does not make it so the Blender Foundation is
the only holder of the copyright in those files, and developers
who do not have a signed contract with the foundation still
hold the copyright as well.
Another aspect of this change is using SPDX format for the
header. We already used it for the license specification,
and now we state it for the copyright as well, following the
FAQ:
https://reuse.software/faq/
153 lines
4.2 KiB
C++
153 lines
4.2 KiB
C++
/* SPDX-FileCopyrightText: 2020 Blender Foundation
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
/** \file
|
|
* \ingroup gpu
|
|
*
|
|
* Encapsulation of Frame-buffer states (attached textures, viewport, scissors).
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "MEM_guardedalloc.h"
|
|
|
|
#include "gpu_framebuffer_private.hh"
|
|
|
|
namespace blender::gpu {
|
|
|
|
class GLStateManager;
|
|
|
|
/**
|
|
* Implementation of FrameBuffer object using OpenGL.
|
|
*/
|
|
class GLFrameBuffer : public FrameBuffer {
|
|
/* For debugging purpose. */
|
|
friend class GLTexture;
|
|
|
|
private:
|
|
/** OpenGL handle. */
|
|
GLuint fbo_id_ = 0;
|
|
/** Context the handle is from. Frame-buffers are not shared across contexts. */
|
|
GLContext *context_ = nullptr;
|
|
/** State Manager of the same contexts. */
|
|
GLStateManager *state_manager_ = nullptr;
|
|
/** Copy of the GL state. Contains ONLY color attachments enums for slot binding. */
|
|
GLenum gl_attachments_[GPU_FB_MAX_COLOR_ATTACHMENT] = {0};
|
|
/** Internal frame-buffers are immutable. */
|
|
bool immutable_ = false;
|
|
/** True is the frame-buffer has its first color target using the GPU_SRGB8_A8 format. */
|
|
bool srgb_ = false;
|
|
/** True is the frame-buffer has been bound using the GL_FRAMEBUFFER_SRGB feature. */
|
|
bool enabled_srgb_ = false;
|
|
|
|
public:
|
|
/**
|
|
* Create a conventional frame-buffer to attach texture to.
|
|
*/
|
|
GLFrameBuffer(const char *name);
|
|
|
|
/**
|
|
* Special frame-buffer encapsulating internal window frame-buffer.
|
|
* (i.e.: #GL_FRONT_LEFT, #GL_BACK_RIGHT, ...)
|
|
* \param ctx: Context the handle is from.
|
|
* \param target: The internal GL name (i.e: #GL_BACK_LEFT).
|
|
* \param fbo: The (optional) already created object for some implementation. Default is 0.
|
|
* \param w: Buffer width.
|
|
* \param h: Buffer height.
|
|
*/
|
|
GLFrameBuffer(const char *name, GLContext *ctx, GLenum target, GLuint fbo, int w, int h);
|
|
|
|
~GLFrameBuffer();
|
|
|
|
void bind(bool enabled_srgb) override;
|
|
|
|
/**
|
|
* This is a rather slow operation. Don't check in normal cases.
|
|
*/
|
|
bool check(char err_out[256]) override;
|
|
|
|
void clear(eGPUFrameBufferBits buffers,
|
|
const float clear_col[4],
|
|
float clear_depth,
|
|
uint clear_stencil) override;
|
|
void clear_multi(const float (*clear_cols)[4]) override;
|
|
void clear_attachment(GPUAttachmentType type,
|
|
eGPUDataFormat data_format,
|
|
const void *clear_value) override;
|
|
|
|
/* Attachment load-stores are currently no-op's in OpenGL. */
|
|
void attachment_set_loadstore_op(GPUAttachmentType /*type*/,
|
|
eGPULoadOp /*load_action*/,
|
|
eGPUStoreOp /*store_action*/) override{};
|
|
|
|
void read(eGPUFrameBufferBits planes,
|
|
eGPUDataFormat format,
|
|
const int area[4],
|
|
int channel_len,
|
|
int slot,
|
|
void *r_data) override;
|
|
|
|
/**
|
|
* Copy \a src at the give offset inside \a dst.
|
|
*/
|
|
void blit_to(eGPUFrameBufferBits planes,
|
|
int src_slot,
|
|
FrameBuffer *dst,
|
|
int dst_slot,
|
|
int dst_offset_x,
|
|
int dst_offset_y) override;
|
|
|
|
void apply_state();
|
|
|
|
private:
|
|
void init();
|
|
void update_attachments();
|
|
void update_drawbuffers();
|
|
|
|
MEM_CXX_CLASS_ALLOC_FUNCS("GLFrameBuffer");
|
|
};
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Enums Conversion
|
|
* \{ */
|
|
|
|
static inline GLenum to_gl(const GPUAttachmentType type)
|
|
{
|
|
#define ATTACHMENT(X) \
|
|
case GPU_FB_##X: { \
|
|
return GL_##X; \
|
|
} \
|
|
((void)0)
|
|
|
|
switch (type) {
|
|
ATTACHMENT(DEPTH_ATTACHMENT);
|
|
ATTACHMENT(DEPTH_STENCIL_ATTACHMENT);
|
|
ATTACHMENT(COLOR_ATTACHMENT0);
|
|
ATTACHMENT(COLOR_ATTACHMENT1);
|
|
ATTACHMENT(COLOR_ATTACHMENT2);
|
|
ATTACHMENT(COLOR_ATTACHMENT3);
|
|
ATTACHMENT(COLOR_ATTACHMENT4);
|
|
ATTACHMENT(COLOR_ATTACHMENT5);
|
|
ATTACHMENT(COLOR_ATTACHMENT6);
|
|
ATTACHMENT(COLOR_ATTACHMENT7);
|
|
default:
|
|
BLI_assert(0);
|
|
return GL_COLOR_ATTACHMENT0;
|
|
}
|
|
#undef ATTACHMENT
|
|
}
|
|
|
|
static inline GLbitfield to_gl(const eGPUFrameBufferBits bits)
|
|
{
|
|
GLbitfield mask = 0;
|
|
mask |= (bits & GPU_DEPTH_BIT) ? GL_DEPTH_BUFFER_BIT : 0;
|
|
mask |= (bits & GPU_STENCIL_BIT) ? GL_STENCIL_BUFFER_BIT : 0;
|
|
mask |= (bits & GPU_COLOR_BIT) ? GL_COLOR_BUFFER_BIT : 0;
|
|
return mask;
|
|
}
|
|
|
|
/** \} */
|
|
|
|
} // namespace blender::gpu
|