Access to an attribute as a double regardless its type. More...

#include <geogram/basic/attributes.h>

Inheritance diagram for GEO::ScalarAttributeAdapterBase:

Classes
class	Accessor
	Accessor class used by ScalarAttributeAdapter to implement indexing operator. More...

class	ConstAccessor
	Accessor class used by ScalarAttributeAdapter to implement indexing operator (const version). More...

Public Types
enum	ElementType { ET_NONE =0 , ET_UINT8 =1 , ET_INT8 =2 , ET_UINT32 =3 , ET_INT32 =4 , ET_FLOAT32 =5 , ET_FLOAT64 =6 , ET_VEC2 =7 , ET_VEC3 =8 }
	Internal representation of the attribute. More...

Public Member Functions
	ScalarAttributeAdapterBase ()
	ScalarAttributeAdapterBase constructor.

	ScalarAttributeAdapterBase (const AttributesManager &manager, const std::string &name)
	ScalarAttributeAdapterBase constructor.

bool	is_bound () const
	Tests whether an Attribute is bound.

void	unbind ()
	Unbinds this Attribute.

void	bind_if_is_defined (const AttributesManager &manager, const std::string &name)
	Binds this Attribute to an AttributesManager if it already exists in the AttributesManager.

	~ScalarAttributeAdapterBase ()
	ReadonlyScalarAttributeAdapterBase destructor.

index_t	size () const
	Gets the size.

ElementType	element_type () const
	Gets the internal representation of the elements.

index_t	element_index () const
	Gets the element index.

const AttributeStore *	attribute_store () const
	Gets the AttributeStore.

Public Member Functions inherited from GEO::AttributeStoreObserver
	AttributeStoreObserver ()
	Creates a new uninitialied AttributeStore.

void	notify (Memory::pointer base_addr, index_t size, index_t dim)
	Callback function, called by the AttributeStore whenever it is modified.

index_t	size () const
	Gets the size.

index_t	dimension () const
	Gets the dimension.

index_t	nb_elements () const
	Gets the total number of elements.

Memory::pointer	base_addr () const
	Gets a pointer to the storage.

void	register_me (AttributeStore *store)
	Registers this observer to an AttributeStore.

void	unregister_me (AttributeStore *store)
	Unregisters this observer from an AttributeStore.

void	disconnect ()
	Disconnects this AttributeStoreObserver from its AttributeStore.

bool	disconnected () const
	Tests whether this AttributeStoreObserver was disconnected.

Static Public Member Functions
static bool	is_defined (const AttributesManager &manager, const std::string &name)
	Tests whether an attribute with the specified name and with a type that can be converted to double exists in an AttributesManager.

static bool	can_be_bound_to (const AttributeStore *store)
	Tests whether a ScalarAttributeAdapterBase can be bound to a given attribute store.

static index_t	nb_scalar_elements_per_item (const AttributeStore *store)
	Gets the number of scalar components per item in an AttributeStore.

Protected Member Functions
double	get_element_as_double (index_t i) const
	Gets an attribute value.

template<class T >
T	get_element (index_t i, index_t multiplier=1) const
	Gets an element.

double	set_element_as_double (index_t i, double value)
	Sets an attribute value.

template<class T >
void	set_element (T value, index_t i, index_t multiplier=1) const
	Sets an element.

Static Protected Member Functions
static std::string	attribute_base_name (const std::string &name)
	Gets the base attribute name from a compound name.

static index_t	attribute_element_index (const std::string &name)
	Gets the base attribute name from a compound name.

static ElementType	element_type (const AttributeStore *store)
	Gets the element type stored in an AttributeStore.

Protected Attributes
const AttributesManager *	manager_

const AttributeStore *	store_

ElementType	element_type_

index_t	element_index_

Protected Attributes inherited from GEO::AttributeStoreObserver
Memory::pointer	base_addr_

index_t	size_

index_t	dimension_

bool	disconnected_

Detailed Description

Access to an attribute as a double regardless its type.

The attribute can be an element of a vector attribute.

Definition at line 1741 of file attributes.h.

Member Enumeration Documentation

◆ ElementType

enum GEO::ScalarAttributeAdapterBase::ElementType

Internal representation of the attribute.

Definition at line 1748 of file attributes.h.

Constructor & Destructor Documentation

◆ ScalarAttributeAdapterBase() [1/2]

GEO::ScalarAttributeAdapterBase::ScalarAttributeAdapterBase ( )

inline

ScalarAttributeAdapterBase constructor.

Definition at line 1810 of file attributes.h.

◆ ScalarAttributeAdapterBase() [2/2]

GEO::ScalarAttributeAdapterBase::ScalarAttributeAdapterBase	(	const AttributesManager &	manager,
		const std::string &	name
	)

inline

ScalarAttributeAdapterBase constructor.

Retrieves a persistent attribute attached to a given AttributesManager.

Parameters

[in]	manager	a reference to the AttributesManager
[in]	name	name of the attribute with an optional index, for instance, "foobar[5]" refers to the 5th coordinate of the "foobar" vector attribute.

Definition at line 1826 of file attributes.h.

◆ ~ScalarAttributeAdapterBase()

GEO::ScalarAttributeAdapterBase::~ScalarAttributeAdapterBase ( )

inline

ReadonlyScalarAttributeAdapterBase destructor.

The attribute is not destroyed, it can be retrieved later by binding with the same name. To destroy the attribute, use destroy() instead.

Definition at line 1876 of file attributes.h.

Member Function Documentation

◆ attribute_base_name()

static std::string GEO::ScalarAttributeAdapterBase::attribute_base_name ( const std::string & name )

staticprotected

Gets the base attribute name from a compound name.

Parameters

[in] name the string with the attribute name and optional index. For instance, "foobar[5]" refers to the 5th coordinate of the "foobar" vector attribute.

Returns: the attribute name. For instance, for "foobar[5]", it returns "foobar".

◆ attribute_element_index()

static index_t GEO::ScalarAttributeAdapterBase::attribute_element_index ( const std::string & name )

staticprotected

Gets the base attribute name from a compound name.

Parameters

[in] name the string with the attribute name and optional index. For instance, "foobar[5]" refers to the 5th coordinate of the "foobar" vector attribute.

Returns: the index or zero if no index was specified. For instance, for "foobar[5]" it returns 5, and for "foobar" it returns 0

◆ attribute_store()

const AttributeStore * GEO::ScalarAttributeAdapterBase::attribute_store ( ) const

inline

Gets the AttributeStore.

Returns: a const pointer to the AttributeStore.

Definition at line 1928 of file attributes.h.

◆ bind_if_is_defined()

void GEO::ScalarAttributeAdapterBase::bind_if_is_defined	(	const AttributesManager &	manager,
		const std::string &	name
	)

Binds this Attribute to an AttributesManager if it already exists in the AttributesManager.

Parameters

[in]	manager	a reference to the AttributesManager
[in]	name	name of the attribute with an optional index, for instance, "foobar[5]" refers to the 5th coordinate of the "foobar" vector attribute.

Precondition: !is_bound()

◆ can_be_bound_to()

static bool GEO::ScalarAttributeAdapterBase::can_be_bound_to ( const AttributeStore * store )

inlinestatic

Tests whether a ScalarAttributeAdapterBase can be bound to a given attribute store.

Parameters

[in] store a pointer to the attribute store.

Return values

true	if it can be bound
false	otherwise

Definition at line 1940 of file attributes.h.

◆ element_index()

index_t GEO::ScalarAttributeAdapterBase::element_index ( ) const

inline

Gets the element index.

Returns: the index of the elements accessed in the bound attribute, or 0 if the bound attribute is scalar.

Definition at line 1920 of file attributes.h.

◆ element_type() [1/2]

ElementType GEO::ScalarAttributeAdapterBase::element_type ( ) const

inline

Gets the internal representation of the elements.

Returns: one of ET_NONE (if unbound), ET_UINT8, ET_INT8, ET_UINT32, ET_INT32, ET_FLOAT32, ET_FLOAT64, ET_VEC2, ET_VEC3

Definition at line 1910 of file attributes.h.

◆ element_type() [2/2]

static ElementType GEO::ScalarAttributeAdapterBase::element_type ( const AttributeStore * store )

staticprotected

Gets the element type stored in an AttributeStore.

Parameters

[in] store a const pointer to the AttributeStore

Returns: one of ET_UINT8, ET_INT8, ET_UINT32, ET_INT32, ET_FLOAT32, ET_FLOAT64 if the type of the attribute is compatible with those types, or ET_NONE if it is incompatible.

◆ get_element()

template<class T >

T GEO::ScalarAttributeAdapterBase::get_element	(	index_t	i,
		index_t	multiplier = `1`
	)		const

inlineprotected

Gets an element.

Stored element type needs to match T, no verification is made

Parameters

[in]	i	index of the element
[in]	multiplier	multiplier applied to the index before fetching the raw pointer.

Definition at line 2031 of file attributes.h.

◆ get_element_as_double()

double GEO::ScalarAttributeAdapterBase::get_element_as_double ( index_t i ) const

inlineprotected

Gets an attribute value.

Parameters

[in] i the index of the item

Returns: the value of the property, convertex into a double

Precondition: is_bound() && i < size()

Definition at line 1990 of file attributes.h.

◆ is_bound()

bool GEO::ScalarAttributeAdapterBase::is_bound ( ) const

inline

Tests whether an Attribute is bound.

Return values

true	if this Attribute is bound
false	otherwise

Definition at line 1839 of file attributes.h.

◆ is_defined()

static bool GEO::ScalarAttributeAdapterBase::is_defined	(	const AttributesManager &	manager,
		const std::string &	name
	)

static

Tests whether an attribute with the specified name and with a type that can be converted to double exists in an AttributesManager.

Parameters

[in]	manager	a reference to the AttributesManager
[in]	name	the name of the attribute with an optional index, for instance, "foobar[5]" refers to the 5th coordinate of the "foobar" vector attribute.

◆ nb_scalar_elements_per_item()

static index_t GEO::ScalarAttributeAdapterBase::nb_scalar_elements_per_item ( const AttributeStore * store )

static

Gets the number of scalar components per item in an AttributeStore.

Parameters

[in] store a pointer to the attribute store.

Returns: the number of scalar components per item in an AttributeStore.

◆ set_element()

template<class T >

void GEO::ScalarAttributeAdapterBase::set_element	(	T	value,
		index_t	i,
		index_t	multiplier = `1`
	)		const

inlineprotected

Sets an element.

Stored element type needs to match T, no verification is made

Parameters

[in]	value	the value of the element to be stored
[in]	i	index of the element
[in]	multiplier	multiplier applied to the index before fetching the raw pointer.

Definition at line 2088 of file attributes.h.

◆ set_element_as_double()

double GEO::ScalarAttributeAdapterBase::set_element_as_double	(	index_t	i,
		double	value
	)

inlineprotected

Sets an attribute value.

Parameters

[in]	i	the index of the element
[in]	value	the new value of the element

Precondition: is_bound() && i < size()

Definition at line 2046 of file attributes.h.

◆ size()

index_t GEO::ScalarAttributeAdapterBase::size ( ) const

inline

Gets the size.

Returns: The number of items in this attribute.

Definition at line 1899 of file attributes.h.

◆ unbind()

void GEO::ScalarAttributeAdapterBase::unbind ( )

inline

Unbinds this Attribute.

Precondition: is_bound()

Definition at line 1847 of file attributes.h.

Member Data Documentation

◆ element_index_

index_t GEO::ScalarAttributeAdapterBase::element_index_

protected

Definition at line 2103 of file attributes.h.

◆ element_type_

ElementType GEO::ScalarAttributeAdapterBase::element_type_

protected

Definition at line 2102 of file attributes.h.

◆ manager_

const AttributesManager* GEO::ScalarAttributeAdapterBase::manager_

protected

Definition at line 2100 of file attributes.h.

◆ store_

const AttributeStore* GEO::ScalarAttributeAdapterBase::store_

protected

Definition at line 2101 of file attributes.h.

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

geogram/basic/attributes.h

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ ElementType

Constructor & Destructor Documentation

◆ ScalarAttributeAdapterBase() [1/2]

◆ ScalarAttributeAdapterBase() [2/2]

◆ ~ScalarAttributeAdapterBase()

Member Function Documentation

◆ attribute_base_name()

◆ attribute_element_index()

◆ attribute_store()

◆ bind_if_is_defined()

◆ can_be_bound_to()

◆ element_index()

◆ element_type() [1/2]

◆ element_type() [2/2]

◆ get_element()

◆ get_element_as_double()

◆ is_bound()

◆ is_defined()

◆ nb_scalar_elements_per_item()

◆ set_element()

◆ set_element_as_double()

◆ size()

◆ unbind()

Member Data Documentation

◆ element_index_

◆ element_type_

◆ manager_

◆ store_