mirror of
https://github.com/scratchfoundation/bgfx.git
synced 2024-11-25 09:08:22 -05:00
737 lines
23 KiB
C
737 lines
23 KiB
C
/*
|
|
* Copyright 2011-2015 Branimir Karadzic. All rights reserved.
|
|
* License: https://github.com/bkaradzic/bgfx/blob/master/LICENSE
|
|
*
|
|
* vim: set tabstop=4 expandtab:
|
|
*/
|
|
|
|
#ifndef BGFX_C99_H_HEADER_GUARD
|
|
#define BGFX_C99_H_HEADER_GUARD
|
|
|
|
#include <stdbool.h> // bool
|
|
#include <stdint.h> // uint32_t
|
|
#include <stdlib.h> // size_t
|
|
|
|
#include "bgfxdefines.h"
|
|
|
|
typedef enum bgfx_renderer_type
|
|
{
|
|
BGFX_RENDERER_TYPE_NULL,
|
|
BGFX_RENDERER_TYPE_DIRECT3D9,
|
|
BGFX_RENDERER_TYPE_DIRECT3D11,
|
|
BGFX_RENDERER_TYPE_DIRECT3D12,
|
|
BGFX_RENDERER_TYPE_METAL,
|
|
BGFX_RENDERER_TYPE_OPENGLES,
|
|
BGFX_RENDERER_TYPE_OPENGL,
|
|
BGFX_RENDERER_TYPE_VULKAN,
|
|
|
|
BGFX_RENDERER_TYPE_COUNT
|
|
|
|
} bgfx_renderer_type_t;
|
|
|
|
typedef enum bgfx_access
|
|
{
|
|
BGFX_ACCESS_READ,
|
|
BGFX_ACCESS_WRITE,
|
|
BGFX_ACCESS_READWRITE,
|
|
|
|
BGFX_ACCESS_COUNT
|
|
|
|
} bgfx_access_t;
|
|
|
|
typedef enum bgfx_attrib
|
|
{
|
|
BGFX_ATTRIB_POSITION,
|
|
BGFX_ATTRIB_NORMAL,
|
|
BGFX_ATTRIB_TANGENT,
|
|
BGFX_ATTRIB_BITANGENT,
|
|
BGFX_ATTRIB_COLOR0,
|
|
BGFX_ATTRIB_COLOR1,
|
|
BGFX_ATTRIB_INDICES,
|
|
BGFX_ATTRIB_WEIGHT,
|
|
BGFX_ATTRIB_TEXCOORD0,
|
|
BGFX_ATTRIB_TEXCOORD1,
|
|
BGFX_ATTRIB_TEXCOORD2,
|
|
BGFX_ATTRIB_TEXCOORD3,
|
|
BGFX_ATTRIB_TEXCOORD4,
|
|
BGFX_ATTRIB_TEXCOORD5,
|
|
BGFX_ATTRIB_TEXCOORD6,
|
|
BGFX_ATTRIB_TEXCOORD7,
|
|
|
|
BGFX_ATTRIB_COUNT
|
|
|
|
} bgfx_attrib_t;
|
|
|
|
typedef enum bgfx_attrib_type
|
|
{
|
|
BGFX_ATTRIB_TYPE_UINT8,
|
|
BGFX_ATTRIB_TYPE_INT16,
|
|
BGFX_ATTRIB_TYPE_HALF,
|
|
BGFX_ATTRIB_TYPE_FLOAT,
|
|
|
|
BGFX_ATTRIB_TYPE_COUNT
|
|
|
|
} bgfx_attrib_type_t;
|
|
|
|
typedef enum bgfx_texture_format
|
|
{
|
|
BGFX_TEXTURE_FORMAT_BC1,
|
|
BGFX_TEXTURE_FORMAT_BC2,
|
|
BGFX_TEXTURE_FORMAT_BC3,
|
|
BGFX_TEXTURE_FORMAT_BC4,
|
|
BGFX_TEXTURE_FORMAT_BC5,
|
|
BGFX_TEXTURE_FORMAT_BC6H,
|
|
BGFX_TEXTURE_FORMAT_BC7,
|
|
BGFX_TEXTURE_FORMAT_ETC1,
|
|
BGFX_TEXTURE_FORMAT_ETC2,
|
|
BGFX_TEXTURE_FORMAT_ETC2A,
|
|
BGFX_TEXTURE_FORMAT_ETC2A1,
|
|
BGFX_TEXTURE_FORMAT_PTC12,
|
|
BGFX_TEXTURE_FORMAT_PTC14,
|
|
BGFX_TEXTURE_FORMAT_PTC12A,
|
|
BGFX_TEXTURE_FORMAT_PTC14A,
|
|
BGFX_TEXTURE_FORMAT_PTC22,
|
|
BGFX_TEXTURE_FORMAT_PTC24,
|
|
|
|
BGFX_TEXTURE_FORMAT_UNKNOWN,
|
|
|
|
BGFX_TEXTURE_FORMAT_R1,
|
|
BGFX_TEXTURE_FORMAT_R8,
|
|
BGFX_TEXTURE_FORMAT_R16,
|
|
BGFX_TEXTURE_FORMAT_R16F,
|
|
BGFX_TEXTURE_FORMAT_R32,
|
|
BGFX_TEXTURE_FORMAT_R32F,
|
|
BGFX_TEXTURE_FORMAT_RG8,
|
|
BGFX_TEXTURE_FORMAT_RG16,
|
|
BGFX_TEXTURE_FORMAT_RG16F,
|
|
BGFX_TEXTURE_FORMAT_RG32,
|
|
BGFX_TEXTURE_FORMAT_RG32F,
|
|
BGFX_TEXTURE_FORMAT_BGRA8,
|
|
BGFX_TEXTURE_FORMAT_RGBA8,
|
|
BGFX_TEXTURE_FORMAT_RGBA16,
|
|
BGFX_TEXTURE_FORMAT_RGBA16F,
|
|
BGFX_TEXTURE_FORMAT_RGBA32,
|
|
BGFX_TEXTURE_FORMAT_RGBA32F,
|
|
BGFX_TEXTURE_FORMAT_R5G6B5,
|
|
BGFX_TEXTURE_FORMAT_RGBA4,
|
|
BGFX_TEXTURE_FORMAT_RGB5A1,
|
|
BGFX_TEXTURE_FORMAT_RGB10A2,
|
|
BGFX_TEXTURE_FORMAT_R11G11B10F,
|
|
|
|
BGFX_TEXTURE_FORMAT_UNKNOWN_DEPTH,
|
|
|
|
BGFX_TEXTURE_FORMAT_D16,
|
|
BGFX_TEXTURE_FORMAT_D24,
|
|
BGFX_TEXTURE_FORMAT_D24S8,
|
|
BGFX_TEXTURE_FORMAT_D32,
|
|
BGFX_TEXTURE_FORMAT_D16F,
|
|
BGFX_TEXTURE_FORMAT_D24F,
|
|
BGFX_TEXTURE_FORMAT_D32F,
|
|
BGFX_TEXTURE_FORMAT_D0S8,
|
|
|
|
BGFX_TEXTURE_FORMAT_COUNT
|
|
|
|
} bgfx_texture_format_t;
|
|
|
|
typedef enum bgfx_uniform_type
|
|
{
|
|
BGFX_UNIFORM_TYPE_INT1,
|
|
BGFX_UNIFORM_TYPE_END,
|
|
|
|
BGFX_UNIFORM_TYPE_VEC4,
|
|
BGFX_UNIFORM_TYPE_MAT3,
|
|
BGFX_UNIFORM_TYPE_MAT4,
|
|
|
|
BGFX_UNIFORM_TYPE_COUNT
|
|
|
|
} bgfx_uniform_type_t;
|
|
|
|
typedef enum bgfx_backbuffer_ratio
|
|
{
|
|
BGFX_BACKBUFFER_RATIO_EQUAL,
|
|
BGFX_BACKBUFFER_RATIO_HALF,
|
|
BGFX_BACKBUFFER_RATIO_QUARTER,
|
|
BGFX_BACKBUFFER_RATIO_EIGHTH,
|
|
BGFX_BACKBUFFER_RATIO_SIXTEENTH,
|
|
BGFX_BACKBUFFER_RATIO_DOUBLE,
|
|
|
|
BGFX_BACKBUFFER_RATIO_COUNT
|
|
|
|
} bgfx_backbuffer_ratio_t;
|
|
|
|
#define BGFX_HANDLE_T(_name) \
|
|
typedef struct _name { uint16_t idx; } _name##_t;
|
|
|
|
BGFX_HANDLE_T(bgfx_indirect_buffer_handle);
|
|
BGFX_HANDLE_T(bgfx_dynamic_index_buffer_handle);
|
|
BGFX_HANDLE_T(bgfx_dynamic_vertex_buffer_handle);
|
|
BGFX_HANDLE_T(bgfx_frame_buffer_handle);
|
|
BGFX_HANDLE_T(bgfx_index_buffer_handle);
|
|
BGFX_HANDLE_T(bgfx_program_handle);
|
|
BGFX_HANDLE_T(bgfx_shader_handle);
|
|
BGFX_HANDLE_T(bgfx_texture_handle);
|
|
BGFX_HANDLE_T(bgfx_uniform_handle);
|
|
BGFX_HANDLE_T(bgfx_vertex_buffer_handle);
|
|
BGFX_HANDLE_T(bgfx_vertex_decl_handle);
|
|
|
|
#undef BGFX_HANDLE_T
|
|
|
|
/**/
|
|
typedef void (*bgfx_release_fn_t)(void* _ptr, void* _userData);
|
|
|
|
/**/
|
|
typedef struct bgfx_memory
|
|
{
|
|
uint8_t* data;
|
|
uint32_t size;
|
|
|
|
} bgfx_memory_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_transform
|
|
{
|
|
float* data;
|
|
uint16_t num;
|
|
|
|
} bgfx_transform_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_hmd_eye
|
|
{
|
|
float rotation[4];
|
|
float translation[3];
|
|
float fov[4];
|
|
float adjust[3];
|
|
float pixelsPerTanAngle[2];
|
|
|
|
} bgfx_hmd_eye_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_hmd
|
|
{
|
|
bgfx_hmd_eye_t eye[2];
|
|
uint16_t width;
|
|
uint16_t height;
|
|
uint32_t deviceWidth;
|
|
uint32_t deviceHeight;
|
|
uint8_t flags;
|
|
|
|
} bgfx_hmd_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_vertex_decl
|
|
{
|
|
uint32_t hash;
|
|
uint16_t stride;
|
|
uint16_t offset[BGFX_ATTRIB_COUNT];
|
|
uint8_t attributes[BGFX_ATTRIB_COUNT];
|
|
|
|
} bgfx_vertex_decl_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_transient_index_buffer
|
|
{
|
|
uint8_t* data;
|
|
uint32_t size;
|
|
bgfx_index_buffer_handle_t handle;
|
|
uint32_t startIndex;
|
|
|
|
} bgfx_transient_index_buffer_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_transient_vertex_buffer
|
|
{
|
|
uint8_t* data;
|
|
uint32_t size;
|
|
uint32_t startVertex;
|
|
uint16_t stride;
|
|
bgfx_vertex_buffer_handle_t handle;
|
|
bgfx_vertex_decl_handle_t decl;
|
|
|
|
} bgfx_transient_vertex_buffer_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_instance_data_buffer
|
|
{
|
|
uint8_t* data;
|
|
uint32_t size;
|
|
uint32_t offset;
|
|
uint32_t num;
|
|
uint16_t stride;
|
|
bgfx_vertex_buffer_handle_t handle;
|
|
|
|
} bgfx_instance_data_buffer_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_texture_info
|
|
{
|
|
bgfx_texture_format_t format;
|
|
uint32_t storageSize;
|
|
uint16_t width;
|
|
uint16_t height;
|
|
uint16_t depth;
|
|
uint8_t numMips;
|
|
uint8_t bitsPerPixel;
|
|
bool cubeMap;
|
|
|
|
} bgfx_texture_info_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_caps_gpu
|
|
{
|
|
uint16_t vendorId;
|
|
uint16_t deviceId;
|
|
|
|
} bgfx_caps_gpu_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_caps
|
|
{
|
|
bgfx_renderer_type_t rendererType;
|
|
|
|
uint64_t supported;
|
|
|
|
uint32_t maxDrawCalls;
|
|
uint16_t maxTextureSize;
|
|
uint16_t maxViews;
|
|
uint8_t maxFBAttachments;
|
|
uint8_t numGPUs;
|
|
|
|
uint16_t vendorId;
|
|
uint16_t deviceId;
|
|
bgfx_caps_gpu_t gpu[4];
|
|
|
|
uint8_t formats[BGFX_TEXTURE_FORMAT_COUNT];
|
|
|
|
} bgfx_caps_t;
|
|
|
|
/**/
|
|
typedef enum bgfx_fatal
|
|
{
|
|
BGFX_FATAL_DEBUG_CHECK,
|
|
BGFX_FATAL_MINIMUM_REQUIRED_SPECS,
|
|
BGFX_FATAL_INVALID_SHADER,
|
|
BGFX_FATAL_UNABLE_TO_INITIALIZE,
|
|
BGFX_FATAL_UNABLE_TO_CREATE_TEXTURE,
|
|
BGFX_FATAL_DEVICE_LOST,
|
|
|
|
BGFX_FATAL_COUNT
|
|
|
|
} bgfx_fatal_t;
|
|
|
|
#ifndef BGFX_SHARED_LIB_BUILD
|
|
# define BGFX_SHARED_LIB_BUILD 0
|
|
#endif // BGFX_SHARED_LIB_BUILD
|
|
|
|
#ifndef BGFX_SHARED_LIB_USE
|
|
# define BGFX_SHARED_LIB_USE 0
|
|
#endif // BGFX_SHARED_LIB_USE
|
|
|
|
#if defined(_MSC_VER)
|
|
# if BGFX_SHARED_LIB_BUILD
|
|
# define BGFX_SHARED_LIB_API __declspec(dllexport)
|
|
# elif BGFX_SHARED_LIB_USE
|
|
# define BGFX_SHARED_LIB_API __declspec(dllimport)
|
|
# else
|
|
# define BGFX_SHARED_LIB_API
|
|
# endif // BGFX_SHARED_LIB_*
|
|
#else
|
|
# define BGFX_SHARED_LIB_API
|
|
#endif // defined(_MSC_VER)
|
|
|
|
#if defined(__cplusplus)
|
|
# define BGFX_C_API extern "C" BGFX_SHARED_LIB_API
|
|
#else
|
|
# define BGFX_C_API BGFX_SHARED_LIB_API
|
|
#endif // defined(__cplusplus)
|
|
|
|
/**/
|
|
typedef struct bgfx_callback_interface
|
|
{
|
|
const struct bgfx_callback_vtbl* vtbl;
|
|
|
|
} bgfx_callback_interface_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_callback_vtbl
|
|
{
|
|
void (*fatal)(bgfx_callback_interface_t* _this, bgfx_fatal_t _code, const char* _str);
|
|
void (*trace)(bgfx_callback_interface_t* _this, const char* _str);
|
|
uint32_t (*cache_read_size)(bgfx_callback_interface_t* _this, uint64_t _id);
|
|
bool (*cache_read)(bgfx_callback_interface_t* _this, uint64_t _id, void* _data, uint32_t _size);
|
|
void (*cache_write)(bgfx_callback_interface_t* _this, uint64_t _id, const void* _data, uint32_t _size);
|
|
void (*screen_shot)(bgfx_callback_interface_t* _this, const char* _filePath, uint32_t _width, uint32_t _height, uint32_t _pitch, const void* _data, uint32_t _size, bool _yflip);
|
|
void (*capture_begin)(bgfx_callback_interface_t* _this, uint32_t _width, uint32_t _height, uint32_t _pitch, bgfx_texture_format_t _format, bool _yflip);
|
|
void (*capture_end)(bgfx_callback_interface_t* _this);
|
|
void (*capture_frame)(bgfx_callback_interface_t* _this, const void* _data, uint32_t _size);
|
|
|
|
} bgfx_callback_vtbl_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_reallocator_interface
|
|
{
|
|
const struct bgfx_reallocator_vtbl* vtbl;
|
|
|
|
} bgfx_reallocator_interface_t;
|
|
|
|
/**/
|
|
typedef struct bgfx_reallocator_vtbl
|
|
{
|
|
void* (*alloc)(bgfx_reallocator_interface_t* _this, size_t _size, size_t _align, const char* _file, uint32_t _line);
|
|
void (*free)(bgfx_reallocator_interface_t* _this, void* _ptr, size_t _align, const char* _file, uint32_t _line);
|
|
void* (*realloc)(bgfx_reallocator_interface_t* _this, void* _ptr, size_t _size, size_t _align, const char* _file, uint32_t _line);
|
|
|
|
} bgfx_reallocator_vtbl_t;
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_vertex_decl_begin(bgfx_vertex_decl_t* _decl, bgfx_renderer_type_t _renderer);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_vertex_decl_add(bgfx_vertex_decl_t* _decl, bgfx_attrib_t _attrib, uint8_t _num, bgfx_attrib_type_t _type, bool _normalized, bool _asInt);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_vertex_decl_skip(bgfx_vertex_decl_t* _decl, uint8_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_vertex_decl_end(bgfx_vertex_decl_t* _decl);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_vertex_pack(const float _input[4], bool _inputNormalized, bgfx_attrib_t _attr, const bgfx_vertex_decl_t* _decl, void* _data, uint32_t _index);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_vertex_unpack(float _output[4], bgfx_attrib_t _attr, const bgfx_vertex_decl_t* _decl, const void* _data, uint32_t _index);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_vertex_convert(const bgfx_vertex_decl_t* _destDecl, void* _destData, const bgfx_vertex_decl_t* _srcDecl, const void* _srcData, uint32_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API uint16_t bgfx_weld_vertices(uint16_t* _output, const bgfx_vertex_decl_t* _decl, const void* _data, uint16_t _num, float _epsilon);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_image_swizzle_bgra8(uint32_t _width, uint32_t _height, uint32_t _pitch, const void* _src, void* _dst);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_image_rgba8_downsample_2x2(uint32_t _width, uint32_t _height, uint32_t _pitch, const void* _src, void* _dst);
|
|
|
|
/**/
|
|
BGFX_C_API uint8_t bgfx_get_supported_renderers(bgfx_renderer_type_t _enum[BGFX_RENDERER_TYPE_COUNT]);
|
|
|
|
/**/
|
|
BGFX_C_API const char* bgfx_get_renderer_name(bgfx_renderer_type_t _type);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_init(bgfx_renderer_type_t _type, uint16_t _vendorId, uint16_t _deviceId, bgfx_callback_interface_t* _callback, bgfx_reallocator_interface_t* _allocator);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_shutdown();
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_reset(uint32_t _width, uint32_t _height, uint32_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API uint32_t bgfx_frame();
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_renderer_type_t bgfx_get_renderer_type();
|
|
|
|
/**/
|
|
BGFX_C_API const bgfx_caps_t* bgfx_get_caps();
|
|
|
|
/**/
|
|
BGFX_C_API const bgfx_hmd_t* bgfx_get_hmd();
|
|
|
|
/**/
|
|
BGFX_C_API const bgfx_memory_t* bgfx_alloc(uint32_t _size);
|
|
|
|
/**/
|
|
BGFX_C_API const bgfx_memory_t* bgfx_copy(const void* _data, uint32_t _size);
|
|
|
|
/**/
|
|
BGFX_C_API const bgfx_memory_t* bgfx_make_ref(const void* _data, uint32_t _size);
|
|
|
|
/**/
|
|
BGFX_C_API const bgfx_memory_t* bgfx_make_ref_release(const void* _data, uint32_t _size, bgfx_release_fn_t _releaseFn, void* _userData);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_debug(uint32_t _debug);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_dbg_text_clear(uint8_t _attr, bool _small);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_dbg_text_printf(uint16_t _x, uint16_t _y, uint8_t _attr, const char* _format, ...);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_dbg_text_image(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height, const void* _data, uint16_t _pitch);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_index_buffer_handle_t bgfx_create_index_buffer(const bgfx_memory_t* _mem, uint16_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_destroy_index_buffer(bgfx_index_buffer_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_vertex_buffer_handle_t bgfx_create_vertex_buffer(const bgfx_memory_t* _mem, const bgfx_vertex_decl_t* _decl, uint16_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_destroy_vertex_buffer(bgfx_vertex_buffer_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_dynamic_index_buffer_handle_t bgfx_create_dynamic_index_buffer(uint32_t _num, uint16_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_dynamic_index_buffer_handle_t bgfx_create_dynamic_index_buffer_mem(const bgfx_memory_t* _mem, uint16_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_update_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle, uint32_t _startIndex, const bgfx_memory_t* _mem);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_destroy_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_dynamic_vertex_buffer_handle_t bgfx_create_dynamic_vertex_buffer(uint32_t _num, const bgfx_vertex_decl_t* _decl, uint16_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_dynamic_vertex_buffer_handle_t bgfx_create_dynamic_vertex_buffer_mem(const bgfx_memory_t* _mem, const bgfx_vertex_decl_t* _decl, uint16_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_update_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle, uint32_t _startVertex, const bgfx_memory_t* _mem);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_destroy_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API bool bgfx_check_avail_transient_index_buffer(uint32_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API bool bgfx_check_avail_transient_vertex_buffer(uint32_t _num, const bgfx_vertex_decl_t* _decl);
|
|
|
|
/**/
|
|
BGFX_C_API bool bgfx_check_avail_instance_data_buffer(uint32_t _num, uint16_t _stride);
|
|
|
|
/**/
|
|
BGFX_C_API bool bgfx_check_avail_transient_buffers(uint32_t _numVertices, const bgfx_vertex_decl_t* _decl, uint32_t _numIndices);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_alloc_transient_index_buffer(bgfx_transient_index_buffer_t* _tib, uint32_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_alloc_transient_vertex_buffer(bgfx_transient_vertex_buffer_t* _tvb, uint32_t _num, const bgfx_vertex_decl_t* _decl);
|
|
|
|
/**/
|
|
BGFX_C_API bool bgfx_alloc_transient_buffers(bgfx_transient_vertex_buffer_t* _tvb, const bgfx_vertex_decl_t* _decl, uint32_t _numVertices, bgfx_transient_index_buffer_t* _tib, uint32_t _numIndices);
|
|
|
|
/**/
|
|
BGFX_C_API const bgfx_instance_data_buffer_t* bgfx_alloc_instance_data_buffer(uint32_t _num, uint16_t _stride);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_indirect_buffer_handle_t bgfx_create_indirect_buffer(uint32_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_destroy_indirect_buffer(bgfx_indirect_buffer_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_shader_handle_t bgfx_create_shader(const bgfx_memory_t* _mem);
|
|
|
|
/**/
|
|
BGFX_C_API uint16_t bgfx_get_shader_uniforms(bgfx_shader_handle_t _handle, bgfx_uniform_handle_t* _uniforms, uint16_t _max);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_destroy_shader(bgfx_shader_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_program_handle_t bgfx_create_program(bgfx_shader_handle_t _vsh, bgfx_shader_handle_t _fsh, bool _destroyShaders);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_program_handle_t bgfx_create_compute_program(bgfx_shader_handle_t _csh, bool _destroyShaders);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_destroy_program(bgfx_program_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_calc_texture_size(bgfx_texture_info_t* _info, uint16_t _width, uint16_t _height, uint16_t _depth, bool _cubeMap, uint8_t _numMips, bgfx_texture_format_t _format);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_texture_handle_t bgfx_create_texture(const bgfx_memory_t* _mem, uint32_t _flags, uint8_t _skip, bgfx_texture_info_t* _info);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_texture_handle_t bgfx_create_texture_2d(uint16_t _width, uint16_t _height, uint8_t _numMips, bgfx_texture_format_t _format, uint32_t _flags, const bgfx_memory_t* _mem);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_texture_handle_t bgfx_create_texture_2d_scaled(bgfx_backbuffer_ratio_t _ratio, uint8_t _numMips, bgfx_texture_format_t _format, uint32_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_texture_handle_t bgfx_create_texture_3d(uint16_t _width, uint16_t _height, uint16_t _depth, uint8_t _numMips, bgfx_texture_format_t _format, uint32_t _flags, const bgfx_memory_t* _mem);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_texture_handle_t bgfx_create_texture_cube(uint16_t _size, uint8_t _numMips, bgfx_texture_format_t _format, uint32_t _flags, const bgfx_memory_t* _mem);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_update_texture_2d(bgfx_texture_handle_t _handle, uint8_t _mip, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height, const bgfx_memory_t* _mem, uint16_t _pitch);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_update_texture_3d(bgfx_texture_handle_t _handle, uint8_t _mip, uint16_t _x, uint16_t _y, uint16_t _z, uint16_t _width, uint16_t _height, uint16_t _depth, const bgfx_memory_t* _mem);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_update_texture_cube(bgfx_texture_handle_t _handle, uint8_t _side, uint8_t _mip, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height, const bgfx_memory_t* _mem, uint16_t _pitch);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_destroy_texture(bgfx_texture_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_frame_buffer_handle_t bgfx_create_frame_buffer(uint16_t _width, uint16_t _height, bgfx_texture_format_t _format, uint32_t _textureFlags);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_frame_buffer_handle_t bgfx_create_frame_buffer_scaled(bgfx_backbuffer_ratio_t _ratio, bgfx_texture_format_t _format, uint32_t _textureFlags);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_frame_buffer_handle_t bgfx_create_frame_buffer_from_handles(uint8_t _num, bgfx_texture_handle_t* _handles, bool _destroyTextures);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_frame_buffer_handle_t bgfx_create_frame_buffer_from_nwh(void* _nwh, uint16_t _width, uint16_t _height, bgfx_texture_format_t _depthFormat);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_destroy_frame_buffer(bgfx_frame_buffer_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API bgfx_uniform_handle_t bgfx_create_uniform(const char* _name, bgfx_uniform_type_t _type, uint16_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_destroy_uniform(bgfx_uniform_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_clear_color(uint8_t _index, const float _rgba[4]);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_view_name(uint8_t _id, const char* _name);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_view_rect(uint8_t _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_view_scissor(uint8_t _id, uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_view_clear(uint8_t _id, uint16_t _flags, uint32_t _rgba, float _depth, uint8_t _stencil);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_view_clear_mrt(uint8_t _id, uint16_t _flags, float _depth, uint8_t _stencil, uint8_t _0, uint8_t _1, uint8_t _2, uint8_t _3, uint8_t _4, uint8_t _5, uint8_t _6, uint8_t _7);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_view_seq(uint8_t _id, bool _enabled);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_view_frame_buffer(uint8_t _id, bgfx_frame_buffer_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_view_transform(uint8_t _id, const void* _view, const void* _proj);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_view_transform_stereo(uint8_t _id, const void* _view, const void* _projL, uint8_t _flags, const void* _projR);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_view_remap(uint8_t _id, uint8_t _num, const void* _remap);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_marker(const char* _marker);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_state(uint64_t _state, uint32_t _rgba);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_stencil(uint32_t _fstencil, uint32_t _bstencil);
|
|
|
|
/**/
|
|
BGFX_C_API uint16_t bgfx_set_scissor(uint16_t _x, uint16_t _y, uint16_t _width, uint16_t _height);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_scissor_cached(uint16_t _cache);
|
|
|
|
/**/
|
|
BGFX_C_API uint32_t bgfx_set_transform(const void* _mtx, uint16_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API uint32_t bgfx_alloc_transform(bgfx_transform_t* _transform, uint16_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_transform_cached(uint32_t _cache, uint16_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_uniform(bgfx_uniform_handle_t _handle, const void* _value, uint16_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_index_buffer(bgfx_index_buffer_handle_t _handle, uint32_t _firstIndex, uint32_t _numIndices);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_dynamic_index_buffer(bgfx_dynamic_index_buffer_handle_t _handle, uint32_t _firstIndex, uint32_t _numIndices);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_transient_index_buffer(const bgfx_transient_index_buffer_t* _tib, uint32_t _firstIndex, uint32_t _numIndices);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_vertex_buffer(bgfx_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _numVertices);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle, uint32_t _numVertices);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_transient_vertex_buffer(const bgfx_transient_vertex_buffer_t* _tvb, uint32_t _startVertex, uint32_t _numVertices);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_instance_data_buffer(const bgfx_instance_data_buffer_t* _idb, uint32_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_instance_data_from_vertex_buffer(bgfx_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_instance_data_from_dynamic_vertex_buffer(bgfx_dynamic_vertex_buffer_handle_t _handle, uint32_t _startVertex, uint32_t _num);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_program(bgfx_program_handle_t _handle);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_texture(uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_texture_handle_t _handle, uint32_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_texture_from_frame_buffer(uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_frame_buffer_handle_t _handle, uint8_t _attachment, uint32_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API uint32_t bgfx_submit(uint8_t _id, int32_t _depth);
|
|
|
|
/**/
|
|
BGFX_C_API uint32_t bgfx_submit_indirect(uint8_t _id, bgfx_indirect_buffer_handle_t _indirectHandle, uint16_t _start, uint16_t _num, int32_t _depth);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_image(uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_texture_handle_t _handle, uint8_t _mip, bgfx_access_t _access, bgfx_texture_format_t _format);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_image_from_frame_buffer(uint8_t _stage, bgfx_uniform_handle_t _sampler, bgfx_frame_buffer_handle_t _handle, uint8_t _attachment, bgfx_access_t _access, bgfx_texture_format_t _format);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_compute_index_buffer(uint8_t _stage, bgfx_index_buffer_handle_t _handle, bgfx_access_t _access);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_compute_vertex_buffer(uint8_t _stage, bgfx_vertex_buffer_handle_t _handle, bgfx_access_t _access);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_compute_dynamic_index_buffer(uint8_t _stage, bgfx_dynamic_index_buffer_handle_t _handle, bgfx_access_t _access);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_compute_dynamic_vertex_buffer(uint8_t _stage, bgfx_dynamic_vertex_buffer_handle_t _handle, bgfx_access_t _access);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_set_compute_indirect_buffer(uint8_t _stage, bgfx_indirect_buffer_handle_t _handle, bgfx_access_t _access);
|
|
|
|
/**/
|
|
BGFX_C_API uint32_t bgfx_dispatch(uint8_t _id, bgfx_program_handle_t _handle, uint16_t _numX, uint16_t _numY, uint16_t _numZ, uint8_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API uint32_t bgfx_dispatch_indirect(uint8_t _id, bgfx_program_handle_t _handle, bgfx_indirect_buffer_handle_t _indirectHandle, uint16_t _start, uint16_t _num, uint8_t _flags);
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_discard();
|
|
|
|
/**/
|
|
BGFX_C_API void bgfx_save_screen_shot(const char* _filePath);
|
|
|
|
#endif // BGFX_C99_H_HEADER_GUARD
|