This class defines an attribute that stores a Nimble::Size(F) object. More...

#include <Valuable/AttributeSize.hpp>

Inheritance diagram for Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >:

Public Member Functions
virtual QString	asString (bool *const ok, Layer layer) const
	Converts the value object to a string. More...

	AttributeSizeT (Node *host, const QByteArray &name, const QByteArray &widthName, const QByteArray &heightName, const SizeClass &size=SizeClass(), bool transit=false)
	Constructor. More...

virtual void	clearValue (Layer layout)
	Unsets the value from a specific layer. More...

virtual bool	deserialize (const ArchiveElement &element)
	Deserializes (reads) this object from serializer element. More...

virtual void	eventProcess (const QByteArray &, Radiant::BinaryData &data)
	Process a message. More...

bool	handleShorthand (const Valuable::StyleValue &value, Radiant::ArrayMap< Valuable::Attribute *, Valuable::StyleValue > &expanded)
	If attribute supports shorthand properties, this should be used to parse those. More...

ElementType	height () const

virtual bool	isChanged () const

virtual bool	isValueDefinedOnLayer (Layer layer) const
	Returns true if width or height is defined on the given layer. More...

	operator const SizeClass () const

const SizeClass	operator* () const

AttributeSizeT &	operator= (const AttributeSizeT &size)

AttributeSizeT &	operator= (Nimble::Vector2T< ElementType > vec)

AttributeSizeT &	operator= (const SizeClass &size)

virtual bool	set (ElementType v, Layer layer=USER, ValueUnit unit=VU_UNKNOWN)

virtual bool	set (const Nimble::Vector2f &v, Layer layer=USER, QList< ValueUnit > units=QList< ValueUnit >())
	Sets the value of the object.

bool	set (const Nimble::SizeF &v, Layer layer=USER, ValueUnit widthUnit=VU_PXS, ValueUnit heightUnit=VU_PXS)

virtual void	setAsDefaults ()
	Sets the current USER attribute value as the default value and clears the USER value. More...

bool	setHeight (ElementType h, Layer layer=USER, ValueUnit unit=VU_PXS)

void	setSrc (Nimble::Vector2T< ElementType > src)

bool	setWidth (ElementType w, Layer layer=USER, ValueUnit unit=VU_PXS)

SizeClass	value () const

ElementType	width () const

Public Member Functions inherited from Valuable::Attribute
long	addListener (ListenerFunc func, int role=CHANGE_ROLE)
	Adds a listener that is invoked whenever the value is changed. More...

long	addListener (Node *listener, ListenerFunc func, int role=CHANGE_ROLE)
	Adds a listener that is invoked whenever the value is changed. More...

long	addListener (v8::Persistent< v8::Function > func, int role=CHANGE_ROLE)
	Adds a JavaScript listener that is invoked whenever the value is changed. More...

virtual float	asFloat (bool *const ok=0, Layer layer=LAYER_CURRENT) const
	Converts the value object in a floating point number. More...

virtual int	asInt (bool *const ok=0, Layer layer=LAYER_CURRENT) const
	Converts the value object in an integer. More...

	Attribute (const Attribute &o)
	Create a copy of the given Attribute WITHOUT the link to host, listeners, or the attribute name. More...

	Attribute (Node *host, const QByteArray &name, bool transit=false)
	Constructs a new value object and attaches it to its host. More...

virtual Attribute *	attribute (const QByteArray &name) const
	Gets an Attribute with the given name. More...

virtual void	emitChange ()
	Invokes the change valueChanged function of all listeners.

void	eventProcessFloat (const char *id, float v)
	Utility function for sending a float message to the object.

void	eventProcessInt (const char *id, int v)
	Utility function for sending an int message to the object.

void	eventProcessString (const char *id, const QString &str)
	Utility function for sending string message to the object.

void	eventProcessString (const char id, const char str)
	Utility function for sending string message to the object.

void	eventProcessVector2 (const char *id, Nimble::Vector2)
	Utility function for sending a Nimble::Vector2f message to the object.

void	eventProcessVector3 (const char *id, Nimble::Vector3)
	Utility function for sending a Vector3 message to the object.

void	eventProcessVector4 (const char *id, Nimble::Vector4)
	Utility function for sending a Vector4 message to the object.

Node *	host () const
	The host object of the value object (is any). More...

bool	layerForSerialization (SerializationOptions flags, Layer &layer) const

const QByteArray &	name () const
	Returns the name of the object.

const Attribute &	operator= (const Attribute &)
	Create a copy of the given Attribute WITHOUT the link to host, listeners, or the attribute name. More...

Attribute *	ownerShorthand () const

QByteArray	path () const
	Returns the path (separated by '/'s) from the root.

void	removeHost ()
	Sets the host pointer to zero and removes this object from the host. More...

bool	removeListener (Node *listener, int role=ALL_ROLES)
	Removes a listener from the listener list. More...

bool	removeListener (long id)
	Removes a listener from the listener list. More...

void	removeListeners (int role=ALL_ROLES)
	Removes listeners from the listener list.

virtual ArchiveElement	serialize (Archive &archive) const
	The object is serialized using its name as a tag name. More...

virtual bool	set (float v, Layer layer=USER, ValueUnit unit=VU_UNKNOWN)
	Sets the value of the object.

virtual bool	set (int v, Layer layer=USER, ValueUnit unit=VU_UNKNOWN)
	Sets the value of the object.

virtual bool	set (const QString &v, Layer layer=USER, ValueUnit unit=VU_UNKNOWN)
	Sets the value of the object.

virtual bool	set (const Nimble::Vector3f &v, Layer layer=USER, QList< ValueUnit > units=QList< ValueUnit >())
	Sets the value of the object.

virtual bool	set (const Nimble::Vector4f &v, Layer layer=USER, QList< ValueUnit > units=QList< ValueUnit >())
	Sets the value of the object.

virtual bool	set (const StyleValue &value, Layer layer=USER)
	Sets the value of the object.

void	setName (const QByteArray &s)
	Sets the name of the object.

void	setOwnerShorthand (Attribute *owner)

virtual QByteArray	type () const
	Get the type id of the attribute. More...

Public Member Functions inherited from Valuable::Serializable
virtual bool	deserializeXML (const DOMElement &element)
	Deserializes (reads) this object from an XML element. More...

bool	isSerializable () const

void	setSerializable (bool v)

Additional Inherited Members
Public Types inherited from Valuable::Attribute
enum	Layer { DEFAULT = 0, STYLE, USER, STYLE_IMPORTANT, LAYER_COUNT, LAYER_CURRENT }
	Attribute has multiple independent attribute values on LAYER_COUNT different layers. More...

typedef std::function< void()>	ListenerFunc
	Callback function type in the listener API.

enum	ListenerRole { DELETE_ROLE = 1 << 0, CHANGE_ROLE = 1 << 1, ALL_ROLES = (CHANGE_ROLE << 1) -1 }
	Different listener roles, used when adding a new listener.

enum	ValueUnit { VU_UNKNOWN, VU_PXS, VU_PERCENTAGE, VU_EMS, VU_EXS }
	Units of a value. More...

Protected Member Functions inherited from Valuable::Attribute
virtual void	emitDelete ()
	Invokes the change valueDeleted function of all listeners.

Detailed Description

template<typename ElementType, class SizeClass, class ElementAttribute>
class Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >

This class defines an attribute that stores a Nimble::Size(F) object.

Constructor & Destructor Documentation

template<typename ElementType , class SizeClass , class ElementAttribute >

Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >::AttributeSizeT	(	Node *	host,
		const QByteArray &	name,
		const QByteArray &	widthName,
		const QByteArray &	heightName,
		const SizeClass &	size = `SizeClass()`,
		bool	transit = `false`
	)

inline

Constructor.

Parameters

host	host node
name	name of the size attribute
widthName	name for attribute alias to width of the size
heightName	name for attribute alias to height of the size
size	initial value
transit	(ignored)

Member Function Documentation

template<typename ElementType , class SizeClass , class ElementAttribute >

virtual QString Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >::asString	(	bool *const	ok,
		Layer	layer
	)		const

inlinevirtual

Converts the value object to a string.

Parameters

ok	If non-null, *ok is set to true/false on success/error

Returns: Object as a string, the default implementation returns an empty string

Reimplemented from Valuable::Attribute.

template<typename ElementType , class SizeClass , class ElementAttribute >

virtual void Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >::clearValue ( Layer layer )

inlinevirtual

Unsets the value from a specific layer.

Parameters

layer layer to clear, must not be DEFAULT, since DEFAULT layer should always be set

Reimplemented from Valuable::Attribute.

template<typename ElementType , class SizeClass , class ElementAttribute >

virtual bool Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >::deserialize ( const ArchiveElement & element )

inlinevirtual

Deserializes (reads) this object from serializer element.

Parameters

element Serialized element that holds the data that should be deserialized.

Returns: Returns true if the read process worked correctly, and false otherwise.

Implements Valuable::Serializable.

template<typename ElementType , class SizeClass , class ElementAttribute >

virtual void Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >::eventProcess	(	const QByteArray &	id,
		Radiant::BinaryData &	data
	)

inlinevirtual

Process a message.

This method is a key element in the event-passing system. It is used to deliver information between objects. The information contains two parts:

Identifier: A character string that gives the address for the adjustment
Data: A binary blob that contains information for the message

This function is overridden in number of classes that need to receive and process events. In a typical case, when overriding this function, you should either process the message, or call the function of the parent class.

void MyClass::eventProcess(const QByteArray & type, Radiant::BinaryData & data)
{
  if(type == "jump")
    doJump();
  else if(type == "crawl") {
    bool ok;
    int speed = data.readInt32(&ok);
    if(ok)
      doCrawl(speed);
  }
  else
    Parent::eventProcess(type, data);
}

Parameters

id	The indentifier for the message. Typically this is quite human-readable
data	Binary blob that contains the argument data in easily parseable format.

Reimplemented from Valuable::Attribute.

template<typename ElementType , class SizeClass , class ElementAttribute >

bool Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >::handleShorthand	(	const Valuable::StyleValue &	value,
		Radiant::ArrayMap< Valuable::Attribute *, Valuable::StyleValue > &	expanded
	)

inlinevirtual

If attribute supports shorthand properties, this should be used to parse those.

For example "background: url('image.png') repeat" is a shorhand for setting background-image to "url('image.png')" and background-repeat to "repeat".

Parameters

[in]	value	shorthand value
[out]	expanded	shorthand property split to parts. With the previous background-example map should have two values.

Returns: true if shorthand was successfully handled

See Also: http://www.w3.org/TR/CSS21/about.html#shorthand

Reimplemented from Valuable::Attribute.

template<typename ElementType , class SizeClass , class ElementAttribute >

virtual bool Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >::isChanged ( ) const

inlinevirtual

Returns: true if the current value of the object is different from the default value. Default implementation always returns true

Reimplemented from Valuable::Attribute.

template<typename ElementType , class SizeClass , class ElementAttribute >

virtual bool Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >::isValueDefinedOnLayer ( Layer layer ) const

inlinevirtual

Returns true if width or height is defined on the given layer.

Parameters

layer Layer to inspect

Returns: False if neither width nor height is defined on given layer

Reimplemented from Valuable::Attribute.

template<typename ElementType , class SizeClass , class ElementAttribute >

virtual void Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >::setAsDefaults ( )

inlinevirtual

Sets the current USER attribute value as the default value and clears the USER value.

Reimplemented from Valuable::Attribute.

Public Member Functions

Additional Inherited Members

Detailed Description

template<typename ElementType, class SizeClass, class ElementAttribute> class Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >

Constructor & Destructor Documentation

Member Function Documentation

template<typename ElementType, class SizeClass, class ElementAttribute>
class Valuable::AttributeSizeT< ElementType, SizeClass, ElementAttribute >