Kohi Game Engine
texture_system.h
Go to the documentation of this file.
1 
15 #pragma once
16 
17 #include "renderer/renderer_types.h"
18 
20 typedef struct texture_system_config {
22  u32 max_texture_count;
23 } texture_system_config;
24 
26 #define DEFAULT_TEXTURE_NAME "default"
27 
29 #define DEFAULT_DIFFUSE_TEXTURE_NAME "default_DIFF"
30 
32 #define DEFAULT_SPECULAR_TEXTURE_NAME "default_SPEC"
33 
35 #define DEFAULT_NORMAL_TEXTURE_NAME "default_NORM"
36 
47 b8 texture_system_initialize(u64* memory_requirement, void* state, void* config);
48 
54 void texture_system_shutdown(void* state);
55 
66 KAPI texture* texture_system_acquire(const char* name, b8 auto_release);
67 
87 KAPI texture* texture_system_acquire_cube(const char* name, b8 auto_release);
88 
101 KAPI texture* texture_system_acquire_writeable(const char* name, u32 width, u32 height, u8 channel_count, b8 has_transparency);
102 
110 KAPI void texture_system_release(const char* name);
111 
129 KAPI void texture_system_wrap_internal(const char* name, u32 width, u32 height, u8 channel_count, b8 has_transparency, b8 is_writeable, b8 register_texture, void* internal_data, texture* out_texture);
130 
139 KAPI b8 texture_system_set_internal(texture* t, void* internal_data);
140 
151 KAPI b8 texture_system_resize(texture* t, u32 width, u32 height, b8 regenerate_internal_data);
152 
163 KAPI b8 texture_system_write_data(texture* t, u32 offset, u32 size, void* data);
164 
169 KAPI texture* texture_system_get_default_texture(void);
170 
175 KAPI texture* texture_system_get_default_diffuse_texture(void);
176 
181 KAPI texture* texture_system_get_default_specular_texture(void);
182 
187 KAPI texture* texture_system_get_default_normal_texture(void);
KAPI
#define KAPI
Import/export qualifier.
Definition: defines.h:177
u32
unsigned int u32
Unsigned 32-bit integer.
Definition: defines.h:25
b8
_Bool b8
8-bit boolean type
Definition: defines.h:58
u64
unsigned long long u64
Unsigned 64-bit integer.
Definition: defines.h:28
u8
unsigned char u8
Unsigned 8-bit integer.
Definition: defines.h:19
renderer_types.h
texture_system_config
The texture system configuration.
Definition: texture_system.h:20
texture_system_config::max_texture_count
u32 max_texture_count
The maximum number of textures that can be loaded at once.
Definition: texture_system.h:22
texture
Represents a texture.
Definition: resource_types.h:165
texture_system_acquire_writeable
KAPI texture * texture_system_acquire_writeable(const char *name, u32 width, u32 height, u8 channel_count, b8 has_transparency)
Attempts to acquire a writeable texture with the given name. This does not point to nor attempt to lo...
texture_system_wrap_internal
KAPI void texture_system_wrap_internal(const char *name, u32 width, u32 height, u8 channel_count, b8 has_transparency, b8 is_writeable, b8 register_texture, void *internal_data, texture *out_texture)
Wraps the provided internal data in a texture structure using the parameters provided....
texture_system_initialize
b8 texture_system_initialize(u64 *memory_requirement, void *state, void *config)
Initializes the texture system. Should be called twice; once to get the memory requirement (passing s...
texture_system_shutdown
void texture_system_shutdown(void *state)
Shuts down the texture system.
texture_system_get_default_diffuse_texture
KAPI texture * texture_system_get_default_diffuse_texture(void)
Gets a pointer to the default diffuse texture. No reference counting is done for default textures.
texture_system_config
struct texture_system_config texture_system_config
The texture system configuration.
texture_system_set_internal
KAPI b8 texture_system_set_internal(texture *t, void *internal_data)
Sets the internal data of a texture. Useful for replacing internal data from within the renderer for ...
texture_system_write_data
KAPI b8 texture_system_write_data(texture *t, u32 offset, u32 size, void *data)
Writes the given data to the provided texture. May only be used on writeable textures.
texture_system_acquire_cube
KAPI texture * texture_system_acquire_cube(const char *name, b8 auto_release)
Attempts to acquire a cubemap texture with the given name. If it has not yet been loaded,...
texture_system_get_default_texture
KAPI texture * texture_system_get_default_texture(void)
Gets a pointer to the default texture. No reference counting is done for default textures.
texture_system_acquire
KAPI texture * texture_system_acquire(const char *name, b8 auto_release)
Attempts to acquire a texture with the given name. If it has not yet been loaded, this triggers it to...
texture_system_get_default_specular_texture
KAPI texture * texture_system_get_default_specular_texture(void)
Gets a pointer to the default specular texture. No reference counting is done for default textures.
texture_system_get_default_normal_texture
KAPI texture * texture_system_get_default_normal_texture(void)
Gets a pointer to the default normal texture. No reference counting is done for default textures.
texture_system_release
KAPI void texture_system_release(const char *name)
Releases a texture with the given name. Ignores non-existant textures. Decreases the reference counte...
texture_system_resize
KAPI b8 texture_system_resize(texture *t, u32 width, u32 height, b8 regenerate_internal_data)
Resizes the given texture. May only be done on writeable textures. Potentially regenerates internal d...