GLSL Program. More...

#include <vtkShaderProgram2.h>

Inheritance diagram for vtkShaderProgram2:

Collaboration diagram for vtkShaderProgram2:

Public Types
typedef vtkObject	Superclass

Public Types inherited from vtkObject
typedef vtkObjectBase	Superclass

Public Member Functions
virtual int	IsA (const char *type)

vtkShaderProgram2 *	NewInstance () const

void	PrintSelf (ostream &os, vtkIndent indent)

bool	HasVertexShaders ()

bool	HasTessellationControlShaders ()

bool	HasTessellationEvaluationShaders ()

bool	HasGeometryShaders ()

bool	HasFragmentShaders ()

bool	IsValid ()

void	Build ()

void	SendUniforms ()

void	PrintActiveUniformVariablesOnCout ()

bool	IsUsed ()

void	Use ()

void	Restore ()

void	RestoreFixedPipeline ()

int	GetLastBuildStatus ()

const char *	GetLastLinkLog ()

const char *	GetLastValidateLog ()

virtual void	ReleaseGraphicsResources ()

int	GetAttributeLocation (const char *name)

bool	DisplayListUnderCreationInCompileMode ()

int	GetUniformLocation (const char *name)

void	SetUniformi (const char *name, int val)

void	SetUniform1i (const char name, int val)

void	SetUniform2i (const char name, int val)

void	SetUniform3i (const char name, int val)

void	SetUniform4i (const char name, int val)

void	SetUniformf (int loc, float val)

void	SetUniform1f (int loc, float *val)

void	SetUniform2f (int loc, float *val)

void	SetUniform3f (int loc, float *val)

void	SetUniform4f (int loc, float *val)

void	SetUniformi (int loc, int val)

void	SetUniform1i (int loc, int *val)

void	SetUniform2i (int loc, int *val)

void	SetUniform3i (int loc, int *val)

void	SetUniform4i (int loc, int *val)

template<typename T >
void	SetUniform1ft (const char name, T value)

template<typename T >
void	SetUniform2ft (const char name, T value)

template<typename T >
void	SetUniform3ft (const char name, T value)

template<typename T >
void	SetUniform4ft (const char name, T value)

template<typename T >
void	SetUniform1it (int loc, T *value)

template<typename T >
void	SetUniform2it (int loc, T *value)

template<typename T >
void	SetUniform3it (int loc, T *value)

template<typename T >
void	SetUniform4it (int loc, T *value)

template<typename T >
void	SetUniform1ft (int loc, T *value)

template<typename T >
void	SetUniform2ft (int loc, T *value)

template<typename T >
void	SetUniform3ft (int loc, T *value)

template<typename T >
void	SetUniform4ft (int loc, T *value)


virtual bool	GetPrintErrors ()

virtual void	SetPrintErrors (bool)


void	SetContext (vtkRenderWindow *context)

vtkRenderWindow *	GetContext ()


virtual vtkShader2Collection *	GetShaders ()


void	PrintActiveUniformVariables (ostream &os, vtkIndent indent)


void	UseProgram ()

void	UnuseProgram ()


virtual vtkUniformVariables *	GetUniformVariables ()

virtual void	SetUniformVariables (vtkUniformVariables *variables)


virtual void	SetGeometryTypeIn (int)

virtual int	GetGeometryTypeIn ()


virtual void	SetGeometryVerticesOut (int)

virtual int	GetGeometryVerticesOut ()


virtual void	SetGeometryTypeOut (int)

virtual int	GetGeometryTypeOut ()


void	SetUniformf (const char *name, float val)

void	SetUniform1f (const char name, float val)

void	SetUniform2f (const char name, float val)

void	SetUniform3f (const char name, float val)

void	SetUniform4f (const char name, float val)


template<typename T >
void	SetUniform1it (const char name, T value)

template<typename T >
void	SetUniform2it (const char name, T value)

template<typename T >
void	SetUniform3it (const char name, T value)

template<typename T >
void	SetUniform4it (const char name, T value)

Public Member Functions inherited from vtkObject
vtkObject *	NewInstance () const

virtual void	DebugOn ()

virtual void	DebugOff ()

bool	GetDebug ()

void	SetDebug (bool debugFlag)

virtual void	Modified ()

virtual unsigned long	GetMTime ()

unsigned long	AddObserver (unsigned long event, vtkCommand *, float priority=0.0f)

unsigned long	AddObserver (const char event, vtkCommand , float priority=0.0f)

vtkCommand *	GetCommand (unsigned long tag)

void	RemoveObserver (vtkCommand *)

void	RemoveObservers (unsigned long event, vtkCommand *)

void	RemoveObservers (const char event, vtkCommand )

int	HasObserver (unsigned long event, vtkCommand *)

int	HasObserver (const char event, vtkCommand )

void	RemoveObserver (unsigned long tag)

void	RemoveObservers (unsigned long event)

void	RemoveObservers (const char *event)

void	RemoveAllObservers ()

int	HasObserver (unsigned long event)

int	HasObserver (const char *event)

template<class U , class T >
unsigned long	AddObserver (unsigned long event, U observer, void(T::*callback)(), float priority=0.0f)

template<class U , class T >
unsigned long	AddObserver (unsigned long event, U observer, void(T::callback)(vtkObject , unsigned long, void *), float priority=0.0f)

template<class U , class T >
unsigned long	AddObserver (unsigned long event, U observer, bool(T::callback)(vtkObject , unsigned long, void *), float priority=0.0f)

int	InvokeEvent (unsigned long event, void *callData)

int	InvokeEvent (const char event, void callData)

int	InvokeEvent (unsigned long event)

int	InvokeEvent (const char *event)

Public Member Functions inherited from vtkObjectBase
const char *	GetClassName () const

virtual void	Delete ()

virtual void	FastDelete ()

void	Print (ostream &os)

virtual void	Register (vtkObjectBase *o)

virtual void	UnRegister (vtkObjectBase *o)

void	SetReferenceCount (int)

void	PrintRevisions (ostream &)

virtual void	PrintHeader (ostream &os, vtkIndent indent)

virtual void	PrintTrailer (ostream &os, vtkIndent indent)

int	GetReferenceCount ()

Static Public Member Functions
static vtkShaderProgram2 *	New ()

static int	IsTypeOf (const char *type)

static vtkShaderProgram2 *	SafeDownCast (vtkObjectBase *o)

static bool	IsSupported (vtkRenderWindow *context)

Static Public Member Functions inherited from vtkObject
static int	IsTypeOf (const char *type)

static vtkObject *	SafeDownCast (vtkObjectBase *o)

static vtkObject *	New ()

static void	BreakOnError ()

static void	SetGlobalWarningDisplay (int val)

static void	GlobalWarningDisplayOn ()

static void	GlobalWarningDisplayOff ()

static int	GetGlobalWarningDisplay ()

Static Public Member Functions inherited from vtkObjectBase
static int	IsTypeOf (const char *name)

static vtkObjectBase *	New ()

Protected Member Functions
virtual vtkObjectBase *	NewInstanceInternal () const

	vtkShaderProgram2 ()

virtual	~vtkShaderProgram2 ()

bool	LoadRequiredExtensions (vtkRenderWindow *context)

int	GetUniformLocationInternal (const char *name)

Protected Member Functions inherited from vtkObject
	vtkObject ()

virtual	~vtkObject ()

virtual void	RegisterInternal (vtkObjectBase *, int check)

virtual void	UnRegisterInternal (vtkObjectBase *, int check)

void	InternalGrabFocus (vtkCommand mouseEvents, vtkCommand keypressEvents=NULL)

void	InternalReleaseFocus ()

Protected Member Functions inherited from vtkObjectBase
	vtkObjectBase ()

virtual	~vtkObjectBase ()

virtual void	CollectRevisions (ostream &)

virtual void	ReportReferences (vtkGarbageCollector *)

	vtkObjectBase (const vtkObjectBase &)

void	operator= (const vtkObjectBase &)

Protected Attributes
unsigned int	Id

unsigned int	SavedId

vtkTimeStamp	LastLinkTime

vtkTimeStamp	LastSendUniformsTime

vtkShader2Collection *	Shaders

vtkUniformVariables *	UniformVariables

int	LastBuildStatus

char *	LastLinkLog

size_t	LastLinkLogCapacity

char *	LastValidateLog

size_t	LastValidateLogCapacity

bool	PrintErrors

vtkWeakPointer< vtkRenderWindow >	Context

bool	ExtensionsLoaded

int	GeometryTypeIn

int	GeometryTypeOut

int	GeometryVerticesOut

Protected Attributes inherited from vtkObject
bool	Debug

vtkTimeStamp	MTime

vtkSubjectHelper *	SubjectHelper

Protected Attributes inherited from vtkObjectBase
vtkAtomicInt32	ReferenceCount

vtkWeakPointerBase **	WeakPointers

Detailed Description

GLSL Program.

vtkShaderProgram2 represents an implementation of the programmable OpenGL pipeline. It consists of a list of vtkShader2 object. Each vtkShader2 is a piece of source code associated with one of the shader units (vertex, fragment, geometry).

Tests:: vtkShaderProgram2 (Tests)

Definition at line 67 of file vtkShaderProgram2.h.

Member Typedef Documentation

typedef vtkObject vtkShaderProgram2::Superclass

Definition at line 71 of file vtkShaderProgram2.h.

Constructor & Destructor Documentation

vtkShaderProgram2::vtkShaderProgram2 ( )

protected

virtual vtkShaderProgram2::~vtkShaderProgram2 ( )

protectedvirtual

Member Function Documentation

static vtkShaderProgram2* vtkShaderProgram2::New ( )

static

static int vtkShaderProgram2::IsTypeOf ( const char * type )

static

virtual int vtkShaderProgram2::IsA ( const char * name )

virtual

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

static vtkShaderProgram2* vtkShaderProgram2::SafeDownCast ( vtkObjectBase * o )

static

virtual vtkObjectBase* vtkShaderProgram2::NewInstanceInternal ( ) const

protectedvirtual

Reimplemented from vtkObject.

vtkShaderProgram2* vtkShaderProgram2::NewInstance ( ) const

void vtkShaderProgram2::PrintSelf	(	ostream &	os,
		vtkIndent	indent
	)

virtual

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkObject.

static bool vtkShaderProgram2::IsSupported ( vtkRenderWindow * context )

static

Returns if the context supports the required extensions. Extensions are loaded when the context is set.

virtual bool vtkShaderProgram2::GetPrintErrors ( )

virtual

Tell if vtkErrorMacro should be called when there is a build error or not. It is useful to switch it to false when building a shader is a way to test if some OpenGL implementation support it or not. Initial value is true. Build errors are always reported in the status flags and log whatever is the value of PrintErrors flag.

virtual void vtkShaderProgram2::SetPrintErrors ( bool )

virtual

Tell if vtkErrorMacro should be called when there is a build error or not. It is useful to switch it to false when building a shader is a way to test if some OpenGL implementation support it or not. Initial value is true. Build errors are always reported in the status flags and log whatever is the value of PrintErrors flag.

void vtkShaderProgram2::SetContext ( vtkRenderWindow * context )

Get/Set the context. This does not increase the reference count of the context to avoid reference loops. SetContext() may raise an error is the OpenGL context does not support the required OpenGL extensions.

vtkRenderWindow* vtkShaderProgram2::GetContext ( )

Get/Set the context. This does not increase the reference count of the context to avoid reference loops. SetContext() may raise an error is the OpenGL context does not support the required OpenGL extensions.

virtual vtkShader2Collection* vtkShaderProgram2::GetShaders ( )

virtual

The list of shaders. Initially, the list is empty.

Postcondition: result_exists: result!=0

bool vtkShaderProgram2::HasVertexShaders ( )

Tells if at least one of the shaders is a vertex shader. If yes, it means the vertex processing of the fixed-pipeline is bypassed. If no, it means the vertex processing of the fixed-pipeline is used.

bool vtkShaderProgram2::HasTessellationControlShaders ( )

Tells if at least one of the shaders is a tessellation control shader.

bool vtkShaderProgram2::HasTessellationEvaluationShaders ( )

Tells if at least one of the shaders is a tessellation evaluation shader.

bool vtkShaderProgram2::HasGeometryShaders ( )

Tells if at least one of the shaders is a geometry shader.

bool vtkShaderProgram2::HasFragmentShaders ( )

Tells if at least one of the shaders is a fragment shader. If yes, it means the fragment processing of the fixed-pipeline is bypassed. If no, it means the fragment processing of the fixed-pipeline is used.

bool vtkShaderProgram2::IsValid ( )

Tell if the shader program is valid with the current OpenGL state.

Precondition: context_is_set: this->GetContext()!=0; current_context_matches: this->Context()->IsCurrent(); built this->GetLastBuildStatus()==VTK_SHADER_PROGRAM2_LINK_SUCCEEDED

void vtkShaderProgram2::Build ( )

If not done yet, compile all the shaders and link the program. The status of the build can then be query with GetLastBuildStatus() and GetLastLinkLog().

Precondition: context_is_set: this->GetContext()!=0; current_context_matches: this->GetContext()->IsCurrent()

void vtkShaderProgram2::SendUniforms ( )

Send the uniform variables values to the program.

Precondition: context_is_set: this->GetContext()!=0; current_context_matches: this->GetContext()->IsCurrent(); built this->GetLastBuildStatus()==VTK_SHADER_PROGRAM2_LINK_SUCCEEDED

void vtkShaderProgram2::PrintActiveUniformVariables	(	ostream &	os,
		vtkIndent	indent
	)

Introspection. Return the list of active uniform variables of the program.

Precondition: context_is_set: this->GetContext()!=0; current_context_matches: this->Context()->IsCurrent(); built this->GetLastBuildStatus()==VTK_SHADER_PROGRAM2_LINK_SUCCEEDED

void vtkShaderProgram2::PrintActiveUniformVariablesOnCout ( )

Call PrintActiveUniformVariables on cout. Useful for calling inside gdb.

Precondition: context_is_set: this->GetContext()!=0; current_context_matches: this->Context()->IsCurrent(); built this->GetLastBuildStatus()==VTK_SHADER_PROGRAM2_LINK_SUCCEEDED

bool vtkShaderProgram2::IsUsed ( )

Tell if the program is the one currently used by OpenGL.

Precondition: context_is_set: this->GetContext()!=0; current_context_matches: this->GetContext()->IsCurrent()

void vtkShaderProgram2::Use ( )

Use the shader program. It saves the current shader program or fixed-pipeline in use. As a side affect it also set the uniform variables. If you don't want that then see UseProgram.

Precondition: context_is_set: this->GetContext()!=0; current_context_matches: this->GetContext()->IsCurrent()

void vtkShaderProgram2::Restore ( )

Restore the previous shader program (or fixed-pipeline).

Precondition: context_is_set: this->GetContext()!=0; current_context_matches: this->GetContext()->IsCurrent()

void vtkShaderProgram2::RestoreFixedPipeline ( )

Force the current shader program to be the fixed-pipeline. Warning: this call will be compiled if called inside a display list creation.

Precondition: context_is_set: this->GetContext()!=0; current_context_matches: this->GetContext()->IsCurrent()

void vtkShaderProgram2::UseProgram ( )

Simple direct use of the program without side affects and with error check. The Unuse version restores the default program.

void vtkShaderProgram2::UnuseProgram ( )

Simple direct use of the program without side affects and with error check. The Unuse version restores the default program.

int vtkShaderProgram2::GetLastBuildStatus ( )

Tells if the last build: failed during compilation of one of the shader, fails during link of the program or succeeded to link the program. Initial value is VTK_SHADER_PROGRAM2_COMPILE_FAILED.

Postcondition: valid_value: result== VTK_SHADER_PROGRAM2_COMPILE_FAILED || result==VTK_SHADER_PROGRAM2_LINK_FAILED || result==VTK_SHADER_PROGRAM2_LINK_SUCCEEDED

const char* vtkShaderProgram2::GetLastLinkLog ( )

Return the log of the last link as a string. Initial value is the empty string ""='\0'.

Postcondition: result_exists: result!=0

const char* vtkShaderProgram2::GetLastValidateLog ( )

Return the log of the last call to IsValid as a string. Initial value is the empty string ""='\0'.

Postcondition: result_exists: result!=0

virtual void vtkShaderProgram2::ReleaseGraphicsResources ( )

virtual

Release OpenGL resource (program id and sub-resources).

int vtkShaderProgram2::GetAttributeLocation ( const char * name )

Returns the generic attribute location. The shader must be bound before calling this.

Precondition: context_is_set: this->GetContext()!=0; current_context_matches: this->GetContext()->IsCurrent(); name_exists: name!=0; built: this->GetLastBuildStatus()==VTK_SHADER_PROGRAM2_LINK_SUCCEEDED

virtual vtkUniformVariables* vtkShaderProgram2::GetUniformVariables ( )

virtual

Get/Set the list of uniform variables values. Initial value is an empty list (not null pointer).

virtual void vtkShaderProgram2::SetUniformVariables ( vtkUniformVariables * variables )

virtual

Get/Set the list of uniform variables values. Initial value is an empty list (not null pointer).

bool vtkShaderProgram2::DisplayListUnderCreationInCompileMode ( )

Tells if a display list is under construction with GL_COMPILE mode. Return false if there is no display list under construction of if the mode is GL_COMPILE_AND_EXECUTE. Used internally and provided as a public method for whoever find it useful.

Precondition: context_is_set: this->GetContext()!=0; current_context_matches: this->GetContext()->IsCurrent()

virtual void vtkShaderProgram2::SetGeometryTypeIn ( int )

virtual

Specific to the geometry shader part of the program. Relevant only when HasGeometryShaders() is true. From OpenGL 3.2, it is replaced by an input layout qualifier in GLSL 1.50. The input primitive type on which the geometry shader operate. It can be VTK_GEOMETRY_SHADER_IN_TYPE_POINTS, VTK_GEOMETRY_SHADER_IN_TYPE_LINES, VTK_GEOMETRY_SHADER_IN_TYPE_LINES_ADJACENCY, VTK_GEOMETRY_SHADER_IN_TYPE_TRIANGLES or VTK_GEOMETRY_SHADER_IN_TYPE_TRIANGLES_ADJACENCY Initial value is VTK_GEOMETRY_SHADER_IN_TYPE_POINTS.

virtual int vtkShaderProgram2::GetGeometryTypeIn ( )

virtual

Specific to the geometry shader part of the program. Relevant only when HasGeometryShaders() is true. From OpenGL 3.2, it is replaced by an input layout qualifier in GLSL 1.50. The input primitive type on which the geometry shader operate. It can be VTK_GEOMETRY_SHADER_IN_TYPE_POINTS, VTK_GEOMETRY_SHADER_IN_TYPE_LINES, VTK_GEOMETRY_SHADER_IN_TYPE_LINES_ADJACENCY, VTK_GEOMETRY_SHADER_IN_TYPE_TRIANGLES or VTK_GEOMETRY_SHADER_IN_TYPE_TRIANGLES_ADJACENCY Initial value is VTK_GEOMETRY_SHADER_IN_TYPE_POINTS.

virtual void vtkShaderProgram2::SetGeometryVerticesOut ( int )

virtual

Specific to the geometry shader part of the program. Relevant only when HasGeometryShaders() is true. This is a pre OpenGL 3.2 geometry shader setting. From OpenGL 3.2, it is replaced by an output layout qualifier in GLSL 1.50. The maximum number of vertices the geometry shader will emit in one invocation. If a geometry shader, in one invocation, emits more vertices than this value, these emits may have no effect. Initial value is 1.

virtual int vtkShaderProgram2::GetGeometryVerticesOut ( )

virtual

Specific to the geometry shader part of the program. Relevant only when HasGeometryShaders() is true. This is a pre OpenGL 3.2 geometry shader setting. From OpenGL 3.2, it is replaced by an output layout qualifier in GLSL 1.50. The maximum number of vertices the geometry shader will emit in one invocation. If a geometry shader, in one invocation, emits more vertices than this value, these emits may have no effect. Initial value is 1.

virtual void vtkShaderProgram2::SetGeometryTypeOut ( int )

virtual

Specific to the geometry shader part of the program. Relevant only when HasGeometryShaders() is true. From OpenGL 3.2, it is replaced by an output layout qualifier in GLSL 1.50. The output primitive type generated by the geometry shader. It can be VTK_GEOMETRY_SHADER_OUT_TYPE_POINTS, VTK_GEOMETRY_SHADER_OUT_TYPE_LINE_STRIP or VTK_GEOMETRY_SHADER_OUT_TYPE_TRIANGLE_STRIP. Initial value is VTK_GEOMETRY_SHADER_OUT_TYPE_POINTS.

virtual int vtkShaderProgram2::GetGeometryTypeOut ( )

virtual

Specific to the geometry shader part of the program. Relevant only when HasGeometryShaders() is true. From OpenGL 3.2, it is replaced by an output layout qualifier in GLSL 1.50. The output primitive type generated by the geometry shader. It can be VTK_GEOMETRY_SHADER_OUT_TYPE_POINTS, VTK_GEOMETRY_SHADER_OUT_TYPE_LINE_STRIP or VTK_GEOMETRY_SHADER_OUT_TYPE_TRIANGLE_STRIP. Initial value is VTK_GEOMETRY_SHADER_OUT_TYPE_POINTS.

int vtkShaderProgram2::GetUniformLocation ( const char * name )

Get a uniform's location. Low level API

void vtkShaderProgram2::SetUniformf	(	const char *	name,
		float	val
	)

inline