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/
119 lines
4.0 KiB
C
119 lines
4.0 KiB
C
/* SPDX-FileCopyrightText: 2016 Blender Foundation.
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
/** \file
|
|
* \ingroup draw
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "BLI_compiler_attrs.h"
|
|
#include "BLI_sys_types.h"
|
|
|
|
#include "GPU_batch.h"
|
|
|
|
#define MAX_INSTANCE_DATA_SIZE 64 /* Can be adjusted for more */
|
|
|
|
#define DRW_BUFFER_VERTS_CHUNK 128
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct GHash;
|
|
struct GPUUniformAttrList;
|
|
|
|
typedef struct DRWInstanceData DRWInstanceData;
|
|
typedef struct DRWInstanceDataList DRWInstanceDataList;
|
|
typedef struct DRWSparseUniformBuf DRWSparseUniformBuf;
|
|
|
|
/**
|
|
* Return a pointer to the next instance data space.
|
|
*/
|
|
void *DRW_instance_data_next(DRWInstanceData *idata);
|
|
DRWInstanceData *DRW_instance_data_request(DRWInstanceDataList *idatalist, uint attr_size);
|
|
|
|
/**
|
|
* This manager allows to distribute existing batches for instancing
|
|
* attributes. This reduce the number of batches creation.
|
|
* Querying a batch is done with a vertex format. This format should
|
|
* be static so that its pointer never changes (because we are using
|
|
* this pointer as identifier [we don't want to check the full format
|
|
* that would be too slow]).
|
|
*/
|
|
GPUVertBuf *DRW_temp_buffer_request(DRWInstanceDataList *idatalist,
|
|
GPUVertFormat *format,
|
|
int *vert_len);
|
|
/**
|
|
* \note Does not return a valid drawable batch until DRW_instance_buffer_finish has run.
|
|
* Initialization is delayed because instancer or geom could still not be initialized.
|
|
*/
|
|
GPUBatch *DRW_temp_batch_instance_request(DRWInstanceDataList *idatalist,
|
|
GPUVertBuf *buf,
|
|
GPUBatch *instancer,
|
|
GPUBatch *geom);
|
|
/**
|
|
* \note Use only with buf allocated via DRW_temp_buffer_request.
|
|
*/
|
|
GPUBatch *DRW_temp_batch_request(DRWInstanceDataList *idatalist,
|
|
GPUVertBuf *buf,
|
|
GPUPrimType type);
|
|
|
|
/**
|
|
* Upload all instance data to the GPU as soon as possible.
|
|
*/
|
|
void DRW_instance_buffer_finish(DRWInstanceDataList *idatalist);
|
|
|
|
void DRW_instance_data_list_reset(DRWInstanceDataList *idatalist);
|
|
void DRW_instance_data_list_free_unused(DRWInstanceDataList *idatalist);
|
|
void DRW_instance_data_list_resize(DRWInstanceDataList *idatalist);
|
|
|
|
/* Sparse chunked UBO manager. */
|
|
|
|
/**
|
|
* Allocate a chunked UBO with the specified item and chunk size.
|
|
*/
|
|
DRWSparseUniformBuf *DRW_sparse_uniform_buffer_new(unsigned int item_size,
|
|
unsigned int chunk_size);
|
|
/**
|
|
* Flush data from ordinary memory to UBOs.
|
|
*/
|
|
void DRW_sparse_uniform_buffer_flush(DRWSparseUniformBuf *buffer);
|
|
/**
|
|
* Clean all buffers and free unused ones.
|
|
*/
|
|
void DRW_sparse_uniform_buffer_clear(DRWSparseUniformBuf *buffer, bool free_all);
|
|
/**
|
|
* Frees the buffer.
|
|
*/
|
|
void DRW_sparse_uniform_buffer_free(DRWSparseUniformBuf *buffer);
|
|
/**
|
|
* Checks if the buffer contains any allocated chunks.
|
|
*/
|
|
bool DRW_sparse_uniform_buffer_is_empty(DRWSparseUniformBuf *buffer);
|
|
/**
|
|
* Bind the UBO for the given chunk, if present. A NULL buffer pointer is handled as empty.
|
|
*/
|
|
void DRW_sparse_uniform_buffer_bind(DRWSparseUniformBuf *buffer, int chunk, int location);
|
|
/**
|
|
* Unbind the UBO for the given chunk, if present. A NULL buffer pointer is handled as empty.
|
|
*/
|
|
void DRW_sparse_uniform_buffer_unbind(DRWSparseUniformBuf *buffer, int chunk);
|
|
/**
|
|
* Returns a pointer to the given item of the given chunk, allocating memory if necessary.
|
|
*/
|
|
void *DRW_sparse_uniform_buffer_ensure_item(DRWSparseUniformBuf *buffer, int chunk, int item);
|
|
|
|
/* Uniform attribute UBO management. */
|
|
|
|
struct GHash *DRW_uniform_attrs_pool_new(void);
|
|
void DRW_uniform_attrs_pool_flush_all(struct GHash *table);
|
|
void DRW_uniform_attrs_pool_clear_all(struct GHash *table);
|
|
struct DRWSparseUniformBuf *DRW_uniform_attrs_pool_find_ubo(struct GHash *table,
|
|
const struct GPUUniformAttrList *key);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|