Graphite  Version 3
An experimental 3D geometry processing program
OGF::Shader Class Referenceabstract

Base class for Grob shader. More...

#include <OGF/scene_graph_gfx/shaders/shader.h>

Inheritance diagram for OGF::Shader:
OGF::Node OGF::Object GEO::Counted OGF::LuaGrobShader OGF::MeshGrobShader OGF::VoxelGrobShader OGF::PlainLuaGrobShader OGF::PDBMeshGrobShader OGF::ParamMeshGrobShader OGF::PlainMeshGrobShader OGF::PlainVoxelGrobShader OGF::ExplodedViewMeshGrobShader

Public Member Functions

 Shader (Grob *grob)
 Shader constructor. More...
 
 ~Shader () override
 Shader destructor.
 
virtual void draw ()
 Draws the Grob. More...
 
virtual void pick_object (index_t object_id)=0
 Draws the Grob in picking mode. More...
 
virtual void blink ()
 Draws the current object several times, while chaning the value of one graphic attribute (e.g. mesh on/off), to draw attentin towards it. More...
 
virtual void update ()
 Redraws the scene. More...
 
bool get_multi () const
 Tests whether multi shader mode is active. More...
 
Grobget_grob () const
 Gets the grob. More...
 
GLdouble * latest_modelview ()
 
GLdouble * latest_project ()
 
GLint * latest_viewport ()
 
bool dark_mode () const
 Tests whether dark mode is set. More...
 
- Public Member Functions inherited from OGF::Node
 Node (Node *parent=nullptr)
 Node constructor. More...
 
virtual ~Node ()
 Node destructor.
 
virtual void add_child (Node *child)
 Adds a child to this Node. More...
 
virtual void remove_child (Node *child)
 Removes a child from this Node. \parma[in] child a pointer to the child to be removed.
 
Nodeget_parent () const
 Gets the parent. More...
 
- Public Member Functions inherited from OGF::Object
 Object (bool transient=false)
 Object constructor. More...
 
virtual ~Object ()
 Object destructor.
 
virtual MetaClassmeta_class () const
 Gets the meta class. More...
 
virtual void set_meta_class (MetaClass *mclass)
 Sets the meta class. More...
 
unsigned int id () const
 Gets the identifier of this object. More...
 
std::string string_id () const
 Gets the unique string identifier. More...
 
bool has_method (const std::string &method_name) const
 Tests whether a method is defined. More...
 
virtual bool invoke_method (const std::string &method_name, const ArgList &args, Any &ret_val)
 Invokes a method by method name and argument list, and gets the return value. More...
 
bool invoke_method (const std::string &method_name, const ArgList &args)
 Invokes a method by method name and argument list. More...
 
bool invoke_method (const std::string &method_name)
 Invokes a method by method name. More...
 
bool has_property (const std::string &prop_name) const
 Tests whether a property is defined. More...
 
virtual bool get_property (const std::string &prop_name, std::string &prop_value) const
 Gets a property. More...
 
virtual Connectionconnect_signal_to_slot (const std::string &signal_name, Object *to, const std::string &slot_name)
 Connects a signal with a slot of another object. More...
 
virtual void add_connection (Connection *connection)
 Adds a connection to this object. More...
 
virtual void remove_connection (Connection *connection)
 Removes a connection to this object. More...
 
virtual void get_element (index_t i, Any &value) const
 Gets an element by index. More...
 
virtual void set_element (index_t i, const Any &value)
 Sets an element by index. More...
 
virtual void search (const std::string &needle, const std::string &path="")
 Displays the names of all objects that contain a substring. More...
 
bool get_signals_enabled () const
 Tests wheter signals are enabled. More...
 
void set_signals_enabled (bool value)
 Enables or disables signals. More...
 
bool get_slots_enabled () const
 Tests wheter slots are enabled. More...
 
void set_slots_enabled (bool value)
 Enables or disables slots. More...
 
MetaClassget_meta_class () const
 Gets the meta class. More...
 
std::string get_string_id () const
 Gets the unique string identifier. More...
 
virtual std::string get_doc () const
 Gets the documentation. More...
 
virtual Sign compare (const Object *other) const
 Compares this object with another one. More...
 
virtual bool is_a (const MetaType *type) const
 Tests whether this object inherits a given type. More...
 
void disconnect ()
 Removes all connections from signals of this objects. More...
 
void enable_signals ()
 Enables signals.
 
void disable_signals ()
 Disables signals.
 
void enable_slots ()
 Enables slots.
 
void disable_slots ()
 Disables slots.
 
void set_properties (const ArgList &args)
 Sets several properties in a single call. More...
 
virtual bool set_property (const std::string &name, const std::string &value)
 Sets an individual property. More...
 
void help () const
 Displays some help about this object. More...
 
virtual bool set_property (const std::string &name, const Any &value)
 Sets an individual property. More...
 
virtual bool get_property (const std::string &prop_name, Any &prop_value) const
 Gets a property. More...
 
- Public Member Functions inherited from GEO::Counted
void ref () const
 Increments the reference count. More...
 
void unref () const
 Decrements the reference count. More...
 
bool is_shared () const
 Check if the object is shared. More...
 
int nb_refs () const
 Gets the number of references that point to this object. More...
 

Public Attributes

 __pad0__: void set_multi(bool value)
 
- Public Attributes inherited from OGF::Node
 __pad0__: Node* ith_child(index_t i) const { ogf_assert(i < get_nb_children())
 
return children_ [i]
 
 __pad1__: size_t get_nb_children() const { return children_.size()
 
- Public Attributes inherited from OGF::Object
 __pad0__: virtual index_t get_nb_elements() const
 
 __pad1__: bool equals(const Object* other) const
 

Protected Member Functions

Texturecreate_texture_from_file (const std::string &file_name, GLint filtering=GL_LINEAR, GLint wrapping=GL_CLAMP_TO_EDGE)
 Creates a texture from an image file. More...
 
Texturecreate_texture_from_colormap_name (const std::string &name, GLint filtering=GL_LINEAR, GLint wrapping=GL_CLAMP_TO_EDGE)
 Creates a texture from a colormap by name. More...
 
Grobgrob () const
 Gets the Grob. More...
 
- Protected Member Functions inherited from OGF::Node
void swap_children (Node *n1, Node *n2)
 Swaps two children by indices. More...
 
- Protected Member Functions inherited from OGF::Object
virtual bool emit_signal (const std::string &signal_name, const ArgList &args, bool called_from_slot=false)
 Emits a signal and calls the slots it is connected to. More...
 
- Protected Member Functions inherited from GEO::Counted
 Counted ()
 Creates a reference counted object. More...
 
virtual ~Counted ()
 Destroys a reference counted object. More...
 

Protected Attributes

bool no_grob_update_
 If true, then each shader update does not trigger a grob update. More...
 

Friends

class ShaderManager
 

Additional Inherited Members

- Static Public Member Functions inherited from OGF::Object
static Objectid_to_object (unsigned int id)
 Gets an object from a unique object id. More...
 
- Static Public Member Functions inherited from GEO::Counted
static void ref (const Counted *counted)
 Increments the reference count. More...
 
static void unref (const Counted *counted)
 Decrements the reference count. More...
 

Detailed Description

Base class for Grob shader.

A Grob shader is responsible for drawing the object onto the screen and picking elements of the object.

Definition at line 64 of file shader.h.

Constructor & Destructor Documentation

◆ Shader()

OGF::Shader::Shader ( Grob grob)

Shader constructor.

Parameters
[in]groba pointer to the Grob this Shader is responsible of.

Member Function Documentation

◆ blink()

virtual void OGF::Shader::blink ( )
virtual

Draws the current object several times, while chaning the value of one graphic attribute (e.g. mesh on/off), to draw attentin towards it.

This function is used if object highlighting is activated.

Reimplemented in OGF::PlainVoxelGrobShader, OGF::VoxelGrobShader, OGF::PlainMeshGrobShader, OGF::MeshGrobShader, OGF::PlainLuaGrobShader, and OGF::LuaGrobShader.

◆ create_texture_from_colormap_name()

Texture* OGF::Shader::create_texture_from_colormap_name ( const std::string &  name,
GLint  filtering = GL_LINEAR,
GLint  wrapping = GL_CLAMP_TO_EDGE 
)
protected

Creates a texture from a colormap by name.

Parameters
[in]namename of the colormap
Returns
a pointer to the created texture. Ownership is transfered to caller (that can store it in a Texture_var)

◆ create_texture_from_file()

Texture* OGF::Shader::create_texture_from_file ( const std::string &  file_name,
GLint  filtering = GL_LINEAR,
GLint  wrapping = GL_CLAMP_TO_EDGE 
)
protected

Creates a texture from an image file.

Parameters
[in]file_namethe image file name
[in]filteringthe OpenGL filtering mode
[in]wrappingthe wrapping mode for texture coordinates
Returns
a pointer to the created texture. Ownership is transfered to caller (that can store it in a Texture_var)

◆ dark_mode()

bool OGF::Shader::dark_mode ( ) const

Tests whether dark mode is set.

Return values
trueif gui colors are rather dark
falseotherwise

◆ draw()

virtual void OGF::Shader::draw ( )
virtual

◆ get_grob()

Grob* OGF::Shader::get_grob ( ) const
inline

Gets the grob.

Returns
a pointer to the Grob associated with this Shader.

Definition at line 142 of file shader.h.

◆ get_multi()

bool OGF::Shader::get_multi ( ) const

Tests whether multi shader mode is active.

In multi shader mode, several shaders can be active for the same object, i.e. all the shaders that have multi mode activated are drawn. For instance, this makes it possible to display an object with a scalar attribute painted on it and several vector attributes superimposed.

Return values
trueif multi shader mode is active
falseotherwise

◆ grob()

Grob* OGF::Shader::grob ( ) const
inlineprotected

Gets the Grob.

Returns
a pointer to the Grob this Shader is associated with

Definition at line 197 of file shader.h.

◆ pick_object()

virtual void OGF::Shader::pick_object ( index_t  object_id)
pure virtual

Draws the Grob in picking mode.

In picking mode, drawing is replaced by filling the pixel values with 32 bits ids, while ZBuffer is still activated. Thus, after drawing the whole scene, one can find for a given pixel which object is visible by reading the 32 bit id encoded in the pixel color.

Parameters
[in]object_idall the pixels covered by the object will be assigned this value

Implemented in OGF::PlainVoxelGrobShader, OGF::VoxelGrobShader, OGF::PlainMeshGrobShader, OGF::MeshGrobShader, OGF::PlainLuaGrobShader, and OGF::LuaGrobShader.

◆ update()

virtual void OGF::Shader::update ( )
virtual

Redraws the scene.

This function is called whenever the object changes or its shader attributes change.

Reimplemented in OGF::PlainVoxelGrobShader, OGF::PDBMeshGrobShader, OGF::ParamMeshGrobShader, and OGF::PlainLuaGrobShader.

Member Data Documentation

◆ no_grob_update_

bool OGF::Shader::no_grob_update_
protected

If true, then each shader update does not trigger a grob update.

Can be set by derived classes constructors.

Definition at line 220 of file shader.h.


The documentation for this class was generated from the following file: