Functions | |
void | Begin_Shader_Search (void) |
These routines recall the name of each shader. More... | |
void | Begin_Shader_Search_By_Key (HC_KEY key) |
Starts a shader search beginning at the segment associated with the passed key. More... | |
HC_BOOLEAN | Find_Shader (char *sname) |
Retrieves the shader names, one at a time. The function returns false when all shaders have been returned. More... | |
void | End_Shader_Search (void) |
Terminates the shader search sequence and frees any involved memory. More... | |
void Begin_Shader_Search | ( | void | ) |
These routines recall the name of each shader.
This set of routines allows the user to "dump" all the shaders that exist in the database. It returns only the shader names. To find the details for each shader use Show_Shader() . For example
Begin_Shader_Search () while (Find_Shader (shader)) { Show_Shader (shader, def, source) print (shader, def, source) } End_Shader_Search ()
prints all the known shader names, their options and source. Begin_Shader_Search() initiates the search for each shader name.
Find_Shader() retrieves the shader names, one at a time. The function returns false when all shaders have been returned.
End_Shader_Search() terminates the sequence and frees any involved memory.
If an shader search is in progress and an shader becomes undefined via UnDefine_Shader(), it will not be returned by subsequent calls to Find_Shader(). If a shader is added, it will not be returned until the next shader search is begun.
void Begin_Shader_Search_By_Key | ( | HC_KEY | key | ) |
Starts a shader search beginning at the segment associated with the passed key.
key | - The unique identifier to a specific segment. |
No additional details. See Begin_Shader_Search().
void End_Shader_Search | ( | void | ) |
Terminates the shader search sequence and frees any involved memory.
No additional details. See Begin_Shader_Search().
HC_BOOLEAN Find_Shader | ( | char * | sname | ) |
Retrieves the shader names, one at a time. The function returns false when all shaders have been returned.
sname | - One shader name. Returned to user. Passed by reference always. |
No additional details. See Begin_Shader_Search().