Panda3D
Static Public Member Functions

ShaderPool Class Reference

This is the preferred interface for loading shaders for the TextNode system. More...

#include "shaderPool.h"

List of all members.

Static Public Member Functions

static void add_shader (const Filename &filename, Shader *shader)
 Adds the indicated already-loaded shader to the pool.
static CPT (Shader) load_shader(const Filename &filename)
static int garbage_collect ()
 Releases only those shaders in the pool that have a reference count of exactly 1; i.e.
static bool has_shader (const Filename &filename)
 Returns true if the shader has ever been loaded, false otherwise.
static void list_contents (ostream &out)
 Lists the contents of the shader pool to the indicated output stream.
static void release_all_shaders ()
 Releases all shaders in the pool and restores the pool to the empty state.
static void release_shader (const Filename &filename)
 Removes the indicated shader from the pool, indicating it will never be loaded again; the shader may then be freed.
static bool verify_shader (const Filename &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.
static void write (ostream &out)
 Lists the contents of the shader pool to the indicated output stream.

Detailed Description

This is the preferred interface for loading shaders for the TextNode system.

It is similar to ModelPool and TexturePool in that it unifies references to the same filename.

Definition at line 31 of file shaderPool.h.


Member Function Documentation

void ShaderPool::add_shader ( const Filename filename,
Shader shader 
) [inline, static]

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.

Definition at line 65 of file shaderPool.I.

int ShaderPool::garbage_collect ( ) [inline, static]

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.

Definition at line 103 of file shaderPool.I.

bool ShaderPool::has_shader ( const Filename filename) [inline, static]

Returns true if the shader has ever been loaded, false otherwise.

Definition at line 23 of file shaderPool.I.

void ShaderPool::list_contents ( ostream &  out) [inline, static]

Lists the contents of the shader pool to the indicated output stream.

Definition at line 114 of file shaderPool.I.

void ShaderPool::release_all_shaders ( ) [inline, static]

Releases all shaders in the pool and restores the pool to the empty state.

Definition at line 90 of file shaderPool.I.

void ShaderPool::release_shader ( const Filename filename) [inline, static]

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.

Definition at line 79 of file shaderPool.I.

bool ShaderPool::verify_shader ( const Filename filename) [inline, static]

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.

Definition at line 38 of file shaderPool.I.

void ShaderPool::write ( ostream &  out) [static]

Lists the contents of the shader pool to the indicated output stream.

Definition at line 31 of file shaderPool.cxx.


The documentation for this class was generated from the following files:
 All Classes Functions Variables Enumerations