renderer that supports point splatting More...

#include <point_renderer.h>

Inheritance diagram for cgv::render::point_renderer:

Public Member Functions
void	enable_attribute_array_manager (const context &ctx, attribute_array_manager &aam) override
	call this before setting attribute arrays to manage attribute array in given manager

void	disable_attribute_array_manager (const context &ctx, attribute_array_manager &aam) override
	call this after last render/draw call to ensure that no other users of renderer change attribute arrays of given manager

void	set_reference_point_size (float _reference_point_size)

void	set_y_view_angle (float y_view_angle)

template<typename T = float>
void	set_point_size_array (const context &ctx, const std::vector< T > &point_sizes)

void	remove_point_size_array (const context &ctx)
	remove the point size attribute

template<typename T = float>
void	set_depth_offset_array (const context &ctx, const std::vector< T > &depth_offsets)
	set per point depth offsets

void	remove_depth_offset_array (const context &ctx)
	remove the depth offset attribute

template<typename T = unsigned, typename C = cgv::media::color<float,cgv::media::RGB,cgv::media::OPACITY>>
void	set_indexed_color_array (const context &ctx, const std::vector< T > &color_indices, const std::vector< C > &palette)

void	remove_indexed_color_array (const context &ctx)
	remove the indexed color attribute

template<typename T = float>
void	set_group_point_sizes (const context &ctx, const std::vector< T > &group_point_sizes)

bool	validate_attributes (const context &ctx) const override
	check additionally the group attributes

bool	enable (context &ctx) override
	overload to activate group style

bool	disable (context &ctx) override
	disable renderer

void	draw (context &ctx, size_t start, size_t count, bool use_strips=false, bool use_adjacency=false, uint32_t strip_restart_index=-1) override
	convenience function to render with default settings

Public Member Functions inherited from cgv::render::group_renderer
void	set_group_index_array (const context &ctx, const std::vector< unsigned > &group_indices)
	method to set the group index attribute

void	set_group_index_array (const context &ctx, const unsigned *group_indices, size_t nr_elements)
	method to set the group index attribute

void	set_group_index_array (const context &ctx, type_descriptor element_type, const vertex_buffer &vbo, size_t offset_in_bytes, size_t nr_elements, unsigned stride_in_bytes=0)
	method to set the group index attribute from a vertex buffer object, the element type must be given as explicit template parameter

template<typename T >
void	set_group_index_array (const context &ctx, const vertex_buffer &vbo, size_t offset_in_bytes, size_t nr_elements, unsigned stride_in_bytes=0)
	template method to set the group index color attribute from a vertex buffer object, the element type must be given as explicit template parameter

void	remove_group_index_array (const context &ctx)
	remove the group index attribute

template<typename T >
void	set_group_colors (const context &ctx, const std::vector< T > &colors)
	template method to set the group colors from a vector of colors of type T

template<typename T >
void	set_group_colors (const context &ctx, const T *colors, size_t nr_elements)
	template method to set the group colors from a vector of colors of type T

template<typename T >
void	set_group_translations (const context &ctx, const std::vector< T > &group_translations)
	template method to set the group translations from a vector of vectors of type T, which should have 3 components

template<typename T >
void	set_group_translations (const context &ctx, const T *group_translations, size_t nr_elements)
	template method to set the group translations from a vector of vectors of type T, which should have 3 components

template<typename T >
void	set_group_rotations (const context &ctx, const std::vector< T > &group_rotations)
	template method to set the group rotation from a vector of quaternions of type T, which should have 4 components

template<typename T >
void	set_group_rotations (const context &ctx, const T *group_rotations, size_t nr_elements)
	template method to set the group rotation from a vector of quaternions of type T, which should have 4 components

Public Member Functions inherited from cgv::render::renderer
shader_compile_options &	ref_shader_options ()
	access to shader program compile options to update settings not handled by render style

shader_program &	ref_prog ()
	derived renderer classes have access to shader program

void	set_prog (shader_program &one_shot_prog)
	set external shader program up to next call to disable() or render()

void	draw_impl (context &ctx, PrimitiveType pt, size_t start, size_t count, bool use_strips=false, bool use_adjacency=false, uint32_t strip_restart_index=-1)
	default implementation of draw method with support for indexed rendering and different primitive types

void	draw_impl_instanced (context &ctx, PrimitiveType type, size_t start, size_t count, size_t instance_count, bool use_strips=false, bool use_adjacency=false, uint32_t strip_restart_index=-1)
	default implementation of instanced draw method with support for indexed rendering and different primitive types

	renderer ()
	construct and init attribute tracking flags

virtual	~renderer ()
	destructor deletes default renderer style

void	manage_singleton (context &ctx, const std::string &renderer_name, int &ref_count, int ref_count_change)
	used by derived classes to manage singletons

virtual void	set_attribute_array_manager (const context &ctx, attribute_array_manager *_aam_ptr=0)
	this function is deprecated, please use enable_attribute_array_manager() and disable_attribute_manager() instead

void	set_render_style (const render_style &rs)
	reference given render style

bool	build_program (context &ctx, shader_program &prog, const render_style &rs)
	build shader program for specific render style

virtual bool	init (context &ctx)
	call init() once before using renderer

template<typename T >
void	set_position (const context &ctx, const T &position)
	templated method to set the position attribute from a single position of type T

template<typename T >
void	set_position_array (const context &ctx, const std::vector< T > &positions)
	templated method to set the position attribute from a vector of positions of type T

template<typename T >
void	set_position_array (const context &ctx, const T *positions, size_t nr_elements, unsigned stride_in_bytes=0)
	templated method to set the position attribute from a vector of positions of type T

void	set_position_array (const context &ctx, type_descriptor element_type, const vertex_buffer &vbo, size_t offset_in_bytes, size_t nr_elements, unsigned stride_in_bytes)
	method to set the position attribute from a vertex buffer object

template<typename T >
void	set_position_array (const context &ctx, const vertex_buffer &vbo, size_t offset_in_bytes, size_t nr_elements, unsigned stride_in_bytes=0)
	template method to set the position attribute from a vertex buffer object, the element type must be given as explicit template parameter

void	remove_position_array (const context &ctx)
	remove the position attribute

template<typename T >
void	set_color (const context &ctx, const T &color)
	templated method to set the color attribute from a single color of type T

template<typename T >
void	set_color_array (const context &ctx, const std::vector< T > &colors)
	template method to set the color attribute from a vector of colors of type T

template<typename T >
void	set_color_array (const context &ctx, const T *colors, size_t nr_elements, unsigned stride_in_bytes=0)
	template method to set the color attribute from a vector of colors of type T

void	set_color_array (const context &ctx, type_descriptor element_type, const vertex_buffer &vbo, size_t offset_in_bytes, size_t nr_elements, unsigned stride_in_bytes=0)
	method to set the color attribute from a vertex buffer object, the element type must be given as explicit template parameter

template<typename T >
void	set_color_array (const context &ctx, const vertex_buffer &vbo, size_t offset_in_bytes, size_t nr_elements, unsigned stride_in_bytes=0)
	template method to set the color attribute from a vertex buffer object, the element type must be given as explicit template parameter

void	remove_color_array (const context &ctx)
	remove the color attribute

template<typename T >
bool	set_indices (const context &ctx, const std::vector< T > &indices, bool keep_on_cpu=false)
	Set the indices for indexed rendering from a vector.

template<typename T >
bool	set_indices (const context &ctx, const T *indices, size_t nr_indices, bool keep_on_cpu=false)
	Set the indices for indexed rendering from an array given as a pointer.

template<typename T >
bool	set_indices (const context &ctx, const vertex_buffer &vbo, size_t count)
	Set the indices for indexed rendering from a GPU buffer.

bool	has_indices () const
	return whether indices have been defined

void	remove_indices (const context &ctx)
	remove previously set indices

const vertex_buffer *	get_vertex_buffer_ptr (const context &ctx, const attribute_array_manager &aam, const std::string &attr_name)

const vertex_buffer *	get_index_buffer_ptr (const attribute_array_manager &aam)

bool	validate_and_enable (context &ctx)
	validate attributes and if successful, enable renderer

virtual bool	render (context &ctx, size_t start, size_t count, bool use_strips=false, bool use_adjacency=false, uint32_t strip_restart_index=-1)
	Convenience function that draws vertex or indexed element with this renderer.

virtual void	clear (const context &ctx)
	the clear function destructs the shader program

Protected Member Functions
std::string	get_default_prog_name () const override
	return the default shader program name

render_style *	create_render_style () const override
	create and return the default render style

Protected Member Functions inherited from cgv::render::renderer
bool	has_aam () const
	check for attribute array manager

bool	has_attribute (const context &ctx, const std::string &name)
	check for attribute

const render_style *	get_style_ptr () const
	access to render style

bool	attributes_persist () const
	return whether attributes persist after a call to disable

virtual void	update_shader_program_options (shader_compile_options &options) const
	overload to update the shader program compile options based on the current render style; only called if internal shader program is used

virtual bool	build_shader_program (context &ctx, shader_program &prog, const shader_compile_options &options) const
	overload to change default behaviour and build a custom shader program based on the passed options

template<typename T >
const T &	get_style () const
	access to style

int	get_prog_attribute_location (const context &ctx, const std::string &name, bool error_check=true)

template<typename T >
bool	set_attribute_array (const context &ctx, const std::string &name, const T &array)

template<typename T >
bool	set_attribute_array (const context &ctx, const std::string &name, const T *array_ptr, size_t nr_elements, unsigned stride)

bool	set_attribute_array (const context &ctx, const std::string &name, type_descriptor element_type, const vertex_buffer &vbo, size_t offset_in_bytes, size_t nr_elements, unsigned stride_in_bytes)

template<typename C , typename T >
bool	set_composed_attribute_array (const context &ctx, const std::string &name, const C *array_ptr, size_t nr_elements, const T &elem)
	in case that several attributes are stored interleaved, call this function for the first and ref_composed_attribute_array() for all others

template<typename C , typename T >
bool	ref_composed_attribute_array (const context &ctx, const std::string &name, const std::string &name_ref, const C *array_ptr, size_t nr_elements, const T &elem)
	in case that several attributes are stored interleaved, call set_composed_attribute_array() for the first and this function for all others

bool	remove_attribute_array (const context &ctx, const std::string &name)

Protected Attributes
bool	has_point_sizes = false

bool	has_group_point_sizes = false

bool	has_indexed_colors = false

bool	has_depth_offsets = false

float	reference_point_size = 0.01f

float	y_view_angle = 45.0f

Protected Attributes inherited from cgv::render::group_renderer
bool	has_group_indices = false

bool	has_group_colors = false

bool	has_group_translations = false

bool	has_group_rotations = false

Protected Attributes inherited from cgv::render::renderer
bool	has_colors = false
	track whether color attribute is defined

bool	has_positions = false
	track whether position attribute is defined

Detailed Description

renderer that supports point splatting

Definition at line 51 of file point_renderer.h.

Member Function Documentation

◆ create_render_style()

render_style * cgv::render::point_renderer::create_render_style ( ) const

inlineoverrideprotectedvirtual

create and return the default render style

Implements cgv::render::renderer.

Definition at line 63 of file point_renderer.h.

◆ disable()

bool cgv::render::point_renderer::disable ( context & ctx )

overridevirtual

disable renderer

Reimplemented from cgv::render::group_renderer.

Definition at line 120 of file point_renderer.cxx.

References cgv::render::renderer::attributes_persist(), cgv::render::point_render_style::blend_points, and cgv::render::group_renderer::disable().

◆ disable_attribute_array_manager()

void cgv::render::point_renderer::disable_attribute_array_manager	(	const context &	ctx,
		attribute_array_manager &	aam
	)

overridevirtual

call this after last render/draw call to ensure that no other users of renderer change attribute arrays of given manager

Reimplemented from cgv::render::group_renderer.

Definition at line 28 of file point_renderer.cxx.

References cgv::render::group_renderer::disable_attribute_array_manager().

◆ draw()

void cgv::render::point_renderer::draw	(	context &	ctx,
		size_t	start,
		size_t	count,
		bool	use_strips = `false`,
		bool	use_adjacency = `false`,
		uint32_t	strip_restart_index = `-1`
	)

overridevirtual

convenience function to render with default settings

Reimplemented from cgv::render::renderer.

Definition at line 134 of file point_renderer.cxx.

References cgv::render::renderer::draw_impl().

◆ enable()

bool cgv::render::point_renderer::enable ( context & ctx )

overridevirtual

overload to activate group style

Reimplemented from cgv::render::group_renderer.

Definition at line 81 of file point_renderer.cxx.

◆ enable_attribute_array_manager()

void cgv::render::point_renderer::enable_attribute_array_manager	(	const context &	ctx,
		attribute_array_manager &	aam
	)

overridevirtual

call this before setting attribute arrays to manage attribute array in given manager

Reimplemented from cgv::render::group_renderer.

Definition at line 17 of file point_renderer.cxx.

References cgv::render::group_renderer::enable_attribute_array_manager(), and cgv::render::renderer::has_attribute().

◆ get_default_prog_name()

std::string cgv::render::point_renderer::get_default_prog_name ( ) const

inlineoverrideprotectedvirtual

return the default shader program name

Implements cgv::render::renderer.

Definition at line 61 of file point_renderer.h.

◆ remove_depth_offset_array()

void cgv::render::point_renderer::remove_depth_offset_array ( const context & ctx )

remove the depth offset attribute

Definition at line 39 of file point_renderer.cxx.

◆ remove_indexed_color_array()

void cgv::render::point_renderer::remove_indexed_color_array ( const context & ctx )

remove the indexed color attribute

Definition at line 43 of file point_renderer.cxx.

◆ remove_point_size_array()

void cgv::render::point_renderer::remove_point_size_array ( const context & ctx )

remove the point size attribute

Definition at line 35 of file point_renderer.cxx.

◆ set_depth_offset_array()

template<typename T = float>

void cgv::render::point_renderer::set_depth_offset_array	(	const context &	ctx,
		const std::vector< T > &	depth_offsets
	)

inline

set per point depth offsets

Definition at line 80 of file point_renderer.h.

◆ set_group_point_sizes()

template<typename T = float>

void cgv::render::point_renderer::set_group_point_sizes	(	const context &	ctx,
		const std::vector< T > &	group_point_sizes
	)

inline

Definition at line 94 of file point_renderer.h.

◆ set_indexed_color_array()

template<typename T = unsigned, typename C = cgv::media::color<float,cgv::media::RGB,cgv::media::OPACITY>>

void cgv::render::point_renderer::set_indexed_color_array	(	const context &	ctx,
		const std::vector< T > &	color_indices,
		const std::vector< C > &	palette
	)

inline

Definition at line 85 of file point_renderer.h.

◆ set_point_size_array()

template<typename T = float>

void cgv::render::point_renderer::set_point_size_array	(	const context &	ctx,
		const std::vector< T > &	point_sizes
	)

inline

Definition at line 75 of file point_renderer.h.

◆ set_reference_point_size()

void cgv::render::point_renderer::set_reference_point_size ( float _reference_point_size )

Definition at line 48 of file point_renderer.cxx.

◆ set_y_view_angle()

void cgv::render::point_renderer::set_y_view_angle ( float y_view_angle )

Definition at line 53 of file point_renderer.cxx.

◆ validate_attributes()

bool cgv::render::point_renderer::validate_attributes ( const context & ctx ) const

overridevirtual

check additionally the group attributes

Reimplemented from cgv::render::group_renderer.

Definition at line 57 of file point_renderer.cxx.

References cgv::render::context::error(), cgv::render::renderer::has_colors, cgv::render::group_render_style::use_group_color, cgv::render::point_render_style::use_group_point_size, and cgv::render::group_renderer::validate_attributes().

Member Data Documentation

◆ has_depth_offsets

bool cgv::render::point_renderer::has_depth_offsets = false

protected

Definition at line 57 of file point_renderer.h.

◆ has_group_point_sizes

bool cgv::render::point_renderer::has_group_point_sizes = false

protected

Definition at line 55 of file point_renderer.h.

◆ has_indexed_colors

bool cgv::render::point_renderer::has_indexed_colors = false

protected

Definition at line 56 of file point_renderer.h.

◆ has_point_sizes

bool cgv::render::point_renderer::has_point_sizes = false

protected

Definition at line 54 of file point_renderer.h.

◆ reference_point_size

float cgv::render::point_renderer::reference_point_size = 0.01f

protected

Definition at line 58 of file point_renderer.h.

◆ y_view_angle

float cgv::render::point_renderer::y_view_angle = 45.0f

protected

Definition at line 59 of file point_renderer.h.

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

libs/cgv_gl/point_renderer.h
libs/cgv_gl/point_renderer.cxx

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ create_render_style()

◆ disable()

◆ disable_attribute_array_manager()

◆ draw()

◆ enable()

◆ enable_attribute_array_manager()

◆ get_default_prog_name()

◆ remove_depth_offset_array()

◆ remove_indexed_color_array()

◆ remove_point_size_array()

◆ set_depth_offset_array()

◆ set_group_point_sizes()

◆ set_indexed_color_array()

◆ set_point_size_array()

◆ set_reference_point_size()

◆ set_y_view_angle()

◆ validate_attributes()

Member Data Documentation

◆ has_depth_offsets

◆ has_group_point_sizes

◆ has_indexed_colors

◆ has_point_sizes

◆ reference_point_size

◆ y_view_angle