ShaderPool¶
-
class
ShaderPool
¶ This is the preferred interface for loading shaders for the
TextNode
system. It is similar toModelPool
andTexturePool
in that it unifies references to the same filename.Inheritance diagram
-
void
add_shader
(Filename const &filename, Shader *shader)¶ Adds the indicated already-loaded shader to the pool. The shader will always replace any previously-loaded shader in the pool that had the same filename.
-
int
garbage_collect
(void)¶ Releases only those shaders in the pool that have a reference count of exactly 1; i.e. only those shaders that are not being used outside of the pool. Returns the number of shaders released.
-
bool
has_shader
(Filename const &filename)¶ Returns true if the shader has ever been loaded, false otherwise.
-
void
list_contents
(std::ostream &out)¶ Lists the contents of the shader pool to the indicated output stream.
-
ConstPointerTo<Shader>
load_shader
(Filename const &filename)¶ Loads the given filename up into a shader, if it has not already been loaded, and returns the new shader. If a shader with the same filename was previously loaded, returns that one instead. If the shader file cannot be found, returns NULL.
-
void
release_all_shaders
(void)¶ Releases all shaders in the pool and restores the pool to the empty state.
-
void
release_shader
(Filename const &filename)¶ Removes the indicated shader from the pool, indicating it will never be loaded again; the shader may then be freed. If this function is never called, a reference count will be maintained on every shader every loaded, and shaders will never be freed.
-
bool
verify_shader
(Filename const &filename)¶ Loads the given filename up into a shader, if it has not already been loaded, and returns true to indicate success, or false to indicate failure. If this returns true, it is guaranteed that a subsequent call to
load_shader()
with the same shader name will return a valid Shader pointer.
-
static void
write
(std::ostream &out)¶ Lists the contents of the shader pool to the indicated output stream.
-
void