diguyGraphicsShaderTechnique.h

Go to the documentation of this file.

/*
 *  Copyright (C) 1992-2013 Boston Dynamics
 *  ALL RIGHTS RESERVED.
 *
 *  These coded instructions, statements, and computer Techniques
 *  contain unpublished proprietary information of Boston Dynamics
 *  and are protected by Copyright Laws of the United States.
 *  They may not be used, duplicated, or disclosed in any form, in
 *  whole or in part, without the prior written consent from Boston
 *  Dynamics.
 *
 *  RESTRICTED RIGHTS LEGEND
 *  Use, duplication, or disclosure by the government is subject
 *  to restrictions as set forth in FAR 52.227.19(c)(2) or
 *  subparagraph (c)(1)(ii) of the Rights in Technical Data and
 *  Computer Software clause at DFARS 252.227-7013 and/or in
 *  similar or successor clauses in the FAR, or the DOD or NASA
 *  FAR Supplement, or to subparagraphs (c)(1) and (c)(2) of the
 *  Commercial Computer Software--Restricted Rights at 48 CFR
 *  52.227-19, as applicable.  Unpublished-rights reserved under
 *  the Copyright Laws of the United States.
 *  Contractor/Manufacturer is:
 *  Boston Dynamics/78 Fourth Avenue/Waltham MA 02451.
 */

/*********************************************************************/
#ifndef __diguyGraphicsShaderTechnique_H
#define __diguyGraphicsShaderTechnique_H


#ifdef SWIG
%module diguyGraphicsShaderTechnique
#else
#define CPLUSPLUS_ONLY
#endif

#ifdef CPLUSPLUS_ONLY

#include <diguy_constants.h>
#include <declspec_diguy.h>

class diguyGraphicsLink;
class diguyGraphicsShaderInstance;
class diguyGraphicsShaderProgram;
class bdiShaderTechnique;

#endif

/****************************************************************************/
struct diguyShaderPickDescription
{
        diguyShaderPickDescription() : 
                m_shader_instance(NULL), 
                m_current_render_pass(0),
                m_current_render_flags(0),
                m_shader_lod(-1),
                m_render_distance(0),
                m_shader_lod_bias(1),
                m_num_active_point_lights(0)
        {
                ;
        }

        int m_current_render_pass;
        
        int m_current_render_flags;
        
        int m_shader_lod;

        float m_render_distance;

        float m_shader_lod_bias;

        int m_max_quality_level;

        int m_num_active_point_lights;

        diguyGraphicsShaderInstance * m_shader_instance;
};

/****************************************************************************/
class BDI_DECLSPEC_diguy diguyGraphicsShaderTechnique
{

public:

/*****************************************************************************/
        /*l
         *b  Returns:
         **
         **    the name of the shader technique.  This pointer will
         **    never be NULL.
         */
        const char* get_name();

        /*l
         *b  Description:
         **
         **    Returns the number of lod shaders the technique has.
         */
        int get_num_shader_lod_programs();

        /*l
         *b  Description:
         **
         **    Returns the shader program at a lod index.
         */
        diguyGraphicsShaderProgram* get_shader_lod_program_at_index(int index);

        /*l
         *b  Description:
         **
         **    Returns the distance that a shader lod switches out at.
         */
        float get_shader_lod_range_at_index(int index);

        /*l
         *b  Description:
         **
         **    Returns a shader based on the rendering distance.
         */
        diguyGraphicsShaderProgram * get_shader_by_distance(float distance, int max_quality_level);
        
        /*l
         *b  Description:
         **
         **    Returns the shader index based on the rendering distance.
         */
        int get_program_index_by_distance(float distance, int max_quality_level);

        /*l
         *b  Description:
         **
         **    Returns the shader specified for intersections.
         */
        diguyGraphicsShaderProgram* get_intersection_shader();

        /*l
         *b  Description:
         **
         **    Returns the shader specified for shadow map generation.
         */
        diguyGraphicsShaderProgram* get_shadow_pass_shader();

/*****************************************************************************/
        /*l
         *b  Description:
         **
         **    This function allows you create a new shader that uses the same 
         **    vertex and pixel files as the one passed in. The user is then able 
         **    modify the subclassed shader before calling load().
         **    This function should allow end users to create an arbitrary number of
         **    shader permutations and then return them via overriding pick_shader_program().
         **    See diguyOglGraphicsShaderTechnique::build() for an example of it's usage.
         **    Override pick_shader_program() to return a procedurally created shader.
         */
        diguyGraphicsShaderProgram * find_or_create_shader_variation(diguyGraphicsShaderProgram * program, const char * new_name);

        /*l
         *b  Description:
         **
         **    Adds an additional shader program to the technique these will get  
         **    automatically updated if any of the shader uniform functions are used.
         **    These are mostly for convenience. Users will probably want their own
         **    data structures to store shader lookup tables.
         **/
        void add_additional_shader(diguyGraphicsShaderProgram* program);

        /*l
         *b  Returns:
         **    The number of shaders that have been procedurally added to the technique.
         */
        int get_num_additional_shaders();

        /*l
         *b  Returns:
         **    A pointer to the procedural shaders that has been procedurally added to 
         **    the technique.
         */
        diguyGraphicsShaderProgram* get_additional_shader_at_index(int index);

/*****************************************************************************/
        /*l
         *b  Description:
         **
         **    Convenience functions. Loops through all shaders in this technique
         **    and sets uniform variables if they exist.
         **
         *b  Callable From:
         **
         *-    - C++
         *-    - Script
         */
        int set_variable_float(const char* name, float value, int set_current = 1, int set_initial = 0);
        int set_variable_vec2(const char* name, float x, float y, int set_current = 1, int set_initial = 0);
        int set_variable_vec3(const char* name, float x, float y, float z, int set_current = 1, int set_initial = 0);
        int set_variable_vec4(const char* name, float x, float y, float z, float w, int set_current = 1, int set_initial = 0);
        int set_variable_int(const char* name, int value, int set_current = 1, int set_initial = 0);

/*****************************************************************************/
        /*l
         *b  Description:
         **
         **    Allows users to use a subclass to override the default shader LOD system 
         **    see diguyOglGraphicsShaderTechnique::pick_shader_program() for an example 
         **    of it's usage.
         **/
        virtual diguyGraphicsShaderProgram * pick_shader_program(const diguyShaderPickDescription & desc);
        
        
        /*l
         *b  Description:
         **
         **    Allows users to do their own post shader load behavior.
         **/
        virtual void build();

#ifdef CPLUSPLUS_ONLY

        bdiShaderTechnique* get_internal_data() {return m_internal_data;}

protected:

        /*l
         **    A protected constructor.  Constructors are called automatically
         **    by DI-Guy.
         */
        diguyGraphicsShaderTechnique(void* internal_data);

        /*l
         **    A protected destructor.  Destructors are called automatically
         **    by DI-Guy.
         */
        virtual ~diguyGraphicsShaderTechnique();

private:

        /*l
         **    A pointer to internal data.
         */
        bdiShaderTechnique* m_internal_data;

        friend class bdiShaderTechnique;
        friend class bdiGeometryFactory;
#endif
};


#endif /* __diguyGraphicsShaderTechnique_H */